Document workspace ownership, resource semantics and agent lifecycle
This commit is contained in:
@@ -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)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user