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 -9
View File
@@ -1,18 +1,18 @@
# 11. 资源访问与呈现
客户端是 Endorphin 资源的查看与运行环境。它可以访问获准查看的 namespace、函数、类和结果值,并根据当前资源的类型及访问状态选择呈现方式。
客户端是 Endorphin 资源的查看与运行环境。它可以访问获准查看的 namespace、函数、类、agent、基础内容和结果值,并根据当前资源的类型及访问状态选择呈现方式。
界面由普通函数返回的可渲染值表达,不使用独立的 scene 声明或 render 块。本章定义资源定位、函数查看、调用与结果呈现之间的关系;顶级类型及其契约仍待定义,见[规范状态](../appendices/specification-status.md#资源访问与呈现)。
## 11.1 资源定位与访问
namespace key 定位代码归属及检索范围,函数名或类名选择其中的声明。定位声明、查看定义与发起调用是不同的访问行为。
namespace key 定位资源归属及检索范围,函数名、类名或 agent 名选择其中的声明。定位声明、查看定义与发起调用是不同的访问行为;基础内容和实例的成员标识形式仍待定义。
```text
namespace:alice:shop.pricing
namespace:atelier:shop.pricing
声明:discountedPrice
namespace:alice:shop.data
namespace:atelier:shop.data
声明:Product
```
@@ -20,13 +20,17 @@ namespace:alice:shop.data
| 访问对象 | 当前资源的含义 | 呈现或使用方式 |
| --- | --- | --- |
| namespace | 获准访问的逻辑代码集合 | 查看代码视图及其成员 |
| namespace | 获准访问的资源组织范围 | 查看允许访问的成员;代码成员形成代码视图 |
| 函数定义 | 参数、返回类型与函数体 | 查看定义,或准备相应调用 |
| 类定义 | 类型及其结构 | 查看类型定义,不自动取得业务对象 |
| agent 定义 | 成员、工具及运行控制规则 | 查看定义,不自动创建实例或启动任务 |
| 基础内容 | 数值、文本、媒体或 GIS 数据的类型化内容 | 按内容类型使用或呈现,导入编码不直接决定语言类型 |
| 函数调用结果 | 本次执行产生的值 | 按结果类型呈现,或供后续程序使用 |
查看 namespace 不表示执行其中全部函数,也不保证包含全部下级 namespace。查看定义的权限与调用权限分别适用;代码定位本身不授予权限。
读取实现源码使用 r,编辑资源使用 w,使用已定义的程序能力使用 x。调用按业务契约产生写入不因此要求调用者获得整个归属范围的编辑权;只有 x 时的接口信息范围和执行身份仍待定义,见[用户身份与 workspace 权限](02-user-identity.md#26-rwx-的操作分工)。
## 11.2 函数本身与返回值
函数本身具有可调用的类型,调用完成后取得的值具有结果类型。二者不能混同;尚未调用时,返回类型描述结果约束,不表示结果已经存在。
@@ -34,14 +38,14 @@ namespace:alice:shop.data
以下示例使用[函数与调用](09-functions-and-calls.md)中的声明,假定 discountedPrice 可查看且可调用:
```text
查看 alice:shop.pricing 中的 discountedPrice
查看 atelier:shop.pricing 中的 discountedPrice
→ 取得函数定义
提供 price = 100、discount = 10 并调用
→ 取得结果 90
```
前一种访问查看函数本身,后一种访问处理整数结果。函数没有因为参数未填写而改变类型。
前一种访问查看函数本身,后一种访问处理数值结果。函数没有因为参数未填写而改变类型。
## 11.3 参数就绪与调用状态
@@ -64,7 +68,7 @@ namespace:alice:shop.data
函数使用普通参数、表达式、调用与 return 表达界面逻辑。客户端取得可渲染类型的结果后渲染界面;其他结果依据相应类型的呈现约定处理。界面构造表达式与可渲染类型的正式名称尚未定义,本章不引入占位类型或专用 UI 文法。
下面是访问行为示意,不是源码。假定 `bob:shop.ui` 中存在可访问的 productPage,接收一个商品编号,并返回可渲染值:
下面是访问行为示意,不是源码。假定 `market:shop.ui` 中存在可访问的 productPage,接收一个商品编号,并返回可渲染值:
```text
打开 productPage,尚未提供商品编号
@@ -96,7 +100,7 @@ namespace:alice:shop.data
## 11.6 按类型呈现的边界
按资源类型选择处理方式是客户端的呈现方向。顶级类型的名称、集合、继承或协议关系,以及不同类型对应的展示契约,统一保留在[规范状态](../appendices/specification-status.md#资源访问与呈现)中。
按资源类型选择处理方式是客户端的呈现方向。基础数值、文本、媒体与 GIS 类别及其格式归一化见[资源、类型与类](07-types-and-classes.md);agent 的使用语义见[Agent](13-agents.md)。完整顶级类型名称、继承或协议关系,以及不同类型对应的展示契约,统一保留在[规范状态](../appendices/specification-status.md#资源访问与呈现)中。
平台不能仅凭对象字段或方法的结构认定其属于可渲染类型或实现了展示能力。类型身份与兼容规则见[类型与类](07-types-and-classes.md#76-类型身份与兼容);具体展示能力关系仍待定义。