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
+7 -8
View File
@@ -7,7 +7,7 @@
以下是故意包含错误的反例:
```text
use alice.shop.ui::{Column, Text}
use atelier.shop.ui::{Column, Text}
```
> 导入后就能直接调用所有组件了。
@@ -26,19 +26,19 @@ use alice.shop.ui::{Column, Text}
use 指定当前代码依赖的 namespace。它引用一个完整 namespace key。
代码归属:`bob:shop.checkout`。以下是该代码视图中的导入声明:
代码归属:`market:shop.checkout`。以下是该代码视图中的导入声明:
```endorphin
use alice:shop.pricing
use atelier:shop.pricing
```
| 部分 | 含义 |
| --- | --- |
| `alice` | 依赖来源的用户名 |
| `:` | 用户名与 namespace 路径的分隔符 |
| `atelier` | 依赖来源的 workspace handle |
| `:` | workspace handle 与 namespace 路径的分隔符 |
| `shop.pricing` | namespace 路径,点号分隔层级 |
该声明引用 alice 的定价 namespace。当前代码仍属于 bob:shop.checkout;引用目标不会改变自身归属。
该声明引用 atelier workspace 的定价 namespace。当前代码仍属于 market:shop.checkout;引用目标不会改变自身归属。
每个 use 引用一个 namespace,不附加类名、函数名或选择性名称列表。引用用于指定依赖来源,不会自动执行其中的函数,也不构成访问授权。
@@ -46,11 +46,10 @@ use alice:shop.pricing
## 必须保留的区别
“完整 namespace 引用”不意味着“所有成员都自动可见”。官方 UI 组件来源尚未定义,也不能因为例子需要显示界面就将 Column 或 Text 放到 alice 的库名下。
“完整 namespace 引用”不意味着“所有成员都自动可见”。官方 UI 组件来源尚未定义,也不能因为例子需要显示界面就将 Column 或 Text 放到 atelier 的库名下。
## 验收
读者可回答三件事:key 如何分解;当前代码属于谁;导入是否授予访问权。源码形状可由现有检查工具辅助检查,归属、授权和可见性说明需人工核对。
[对应任务](../tasks/TASK-03.md) · [示例目录](README.md)