Document workspace ownership, resource semantics and agent lifecycle

This commit is contained in:
2026-10-09 18:06:25 +08:00
parent f7526ab2a0
commit 52f497671e
31 changed files with 748 additions and 232 deletions
+13 -12
View File
@@ -6,35 +6,36 @@ Endorphin 是一门兼顾前端与后端的云原生编程语言。它用共享
## 1.1 应用模型
Endorphin 应用由相互引用的声明组成:
Endorphin 应用由基础资源、变量引用和相互引用的声明组成。数值、文本、图片、视频、音频和 GIS 数据等基础内容由平台统一保存,变量指向这些资源,class 与 agent 组织更高级的结构。
| 声明 | 描述的内容 | 典型用途 |
| --- | --- | --- |
| 类 | 数据结构与字段类型 | 前后端共同理解商品数据 |
| 函数 | 输入、计算和输出 | 计算价格、组合业务步骤、返回界面值 |
| agent | 共有成员与模型驱动的执行规则 | 使用和实现工具、保留记忆、组织状态与控制流 |
客户端可以查看获准访问的资源,并按资源或函数结果的类型呈现内容。界面使用普通函数返回可渲染值表达,具体访问行为见[资源访问与呈现](11-resource-access-and-presentation.md)。
Agent 是后续扩展的应用领域;其声明与行为语法尚未定义,见[应用领域](../appendices/application-domains.md)。
Agent 作为语言声明纳入 namespace,可以实现新逻辑并引用已有函数;其工具、记忆、状态及运行控制见[Agent](13-agents.md)。基础资源与变量引用模型见[资源、类型与类](07-types-and-classes.md)。
## 1.2 代码组织
每段代码属于一个用户和至少一级 namespace。用户通过唯一用户名标识,namespace 通过完整 key 定位,例如:
每项独立登记的资源属于一个 workspace 和至少一级 namespace。workspace 通过唯一 handle 标识,namespace 通过完整 key 定位,例如:
```text
alice:shop.pricing
atelier:shop.pricing
```
`alice` 是用户名,`shop.pricing` 是 namespace 路径。代码归属保存在外部上下文与索引中,正文无需声明自己的 namespace。
`atelier` 是 workspace handle,`shop.pricing` 是 namespace 路径。用户以成员角色操作 workspace 中的资源;作者身份与资源归属分开记录。代码归属保存在外部上下文与索引中,正文无需声明自己的 namespace。
代码以独立代码段存储,通过索引形成 namespace 的可见代码视图。namespace 是语言的代码组织单位,源码文件不承担这一职责。
## 1.3 声明与调用
代码归属:`alice:shop.pricing`。该 namespace 定义价格计算函数:
代码归属:`atelier:shop.pricing`。该 namespace 定义价格计算函数:
```endorphin
function discountedPrice(price: Int, discount: Int): Int {
function discountedPrice(price: Number, discount: Number): Number {
return price - discount
}
```
@@ -51,8 +52,8 @@ discountedPrice(100, 10) → 90
Endorphin 将程序处理划分为两个阶段:
- **Preflight**:理解声明与引用,检查名称、类型和程序结构,建立关联索引,准备执行。
- **inflight**:使用实际输入解释执行逻辑,交付结果,并产生界面或其他业务效果。
- **Preflight**:理解声明与引用,检查名称、类型和程序结构,建立关联索引;定义生命周期还覆盖准备后的持续可引用、更新与退出。
- **inflight**:使用实际输入解释执行逻辑,交付结果;管理调用、实例和任务的存续、暂停与恢复,并产生界面或其他业务效果。
平台承担代码的解释执行;程序处理不要求开发者先完成独立构建,也不要求字节码转译。完整阶段职责见[Preflight 与 inflight](05-preflight-and-inflight.md)。
@@ -60,8 +61,8 @@ Endorphin 将程序处理划分为两个阶段:
## 1.5 本书范围
本书描述源码写法及其可观察行为,包括代码归属、声明、类型、表达式、调用、数据读取和 UI。通信协议、数据库绑定、缓存、部署和编排机制属于系统实现,不在语言介绍中展开。
本书描述源码写法及其可观察行为,包括资源、代码归属、声明、类型、变量引用、调用、数据读取、UI 和 agent。通信协议、数据库绑定、缓存、部署和编排机制属于系统实现,不在语言介绍中展开。
下一章首先说明参与代码定位的用户身份,再介绍 namespace 与程序结构。
下一章首先说明用户、workspace 与权限的关系,再介绍 namespace 与程序结构。
[下一章:用户身份](02-user-identity.md) · [目录](../README.md)
[下一章:用户身份与 workspace 权限](02-user-identity.md) · [目录](../README.md)