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
+11 -12
View File
@@ -1,6 +1,6 @@
# EX-01 把对话说明改成概念指南
读者目标:区分用户名与显示名,并判断哪个值用于 namespace key。依据是当前 guide/02-user-identity.md;以下成稿用于说明写作方法。
读者目标:区分 workspace handle、显示名与用户身份,并判断哪个值用于 namespace key。依据是当前 guide/02-user-identity.md;以下成稿用于说明写作方法。
## 原稿
@@ -10,28 +10,28 @@
## 写作判断
先保留已确定的核心:handle 唯一;显示名用于展示;key 使用 handle。将未定义的字符、大小写和改名细节放入准确的边界说明。社交平台类比只用于辅助理解。
原稿混合了用户身份与资源定位。按当前主定义改写:workspace handle 唯一;workspace 显示名用于展示;key 使用 workspace handle;用户负责操作和作者身份。将未定义的字符、大小写和改名细节放入准确的边界说明。
此处适合定义、两个对象的对照和一个 key 例子,不需要编造注册代码或身份认证 API。采用 DOC-001、004、013、015、018。
## 成稿示范
### 用户名与显示名
### Workspace handle 与显示名
用户名(handle)用于唯一定位用户及其 namespace。显示名用于展示姓名或昵称,不承担唯一定位职责。
Workspace handle 用于唯一定位 workspace 及其 namespace。workspace 显示名用于展示名称,不承担唯一定位职责。用户作为 workspace 成员参与协作,用户身份不充当资源 key 前缀。
两个用户可以使用相同的显示名“林”,但必须使用不同的用户名。例如,用户名为 alice 和 bob 的两位用户都可以将显示名设为“林”。
两个 workspace 可以使用相同的显示名“工作室”,但必须使用不同的 handle。例如 atelier 与 market 都可以将显示名设为“工作室”。
| key | 定位的用户 | namespace 路径 |
| key | 定位的 workspace | namespace 路径 |
| --- | --- | --- |
| `alice:shop` | alice | shop |
| `bob:shop` | bob | shop |
| `atelier:shop` | atelier | shop |
| `market:shop` | market | shop |
这两个 key 指向不同的 namespace。查询时使用用户名,不能用相同的显示名替代冒号前的部分。
这两个 key 指向不同的 namespace。查询时使用 workspace handle,不能用相同的显示名或某位成员的名字替代冒号前的部分。
代码归属使用完整 key,除用户名外还需要至少一级 namespace 路径。知道 key 只说明能够标识目标,不等于获得读取或执行权限。
资源归属使用完整 key,除 workspace handle 外还需要至少一级 namespace 路径。成员变动不改变资源归属;知道 key 只说明能够标识目标,不等于获得读取或执行权限。
用户名的字符规则、大小写比较和改名行为尚未定义,参见语言文档中的“规范状态—身份与权限”。
workspace handle 的字符规则、大小写比较和改名行为尚未定义,参见语言文档中的“规范状态—Workspace 名称与生命周期”。
## 为什么这样安排
@@ -47,4 +47,3 @@
- 验证:这是基于当前文本规则的作者推演,没有调用身份系统。
[对应任务](../tasks/TASK-02.md) · [示例目录](README.md)