@agentunion/fastaun-browser 0.4.12 → 0.5.0

package/_packed_docs/collab-gateway-boundary-test-report.md

@@ -0,0 +1,164 @@
+# Collab 网关边界与群空间隔离测试报告
+
+## 测试目标
+
+针对你指出的三层问题：
+1. **Collab 文档语义**：授权 = storage ACL（无发起人特权）
+2. **Gateway 角色白名单**：viewer 不能调用 collab.*，agent 可以
+3. **Storage 群空间边界**：个人 collab root 与群空间写权限隔离
+
+## 测试覆盖补充
+
+### Gateway Relay 权限白名单（`codex-unit/gateway/test_gateway_relay.py`）
+
+新增：`test_gateway_relay_collab_method_permission_matrix`
+
+**覆盖范围**：
+- 20 个 collab.* 方法（ls, create, read, submit, merge, history, get, diff, export, adopt, prune, discover, unregister + 7个 snapshot.*）
+- 角色矩阵：agent/admin 放行，viewer/operator/空角色/未定义角色 拒绝
+- 黑名单优先级：`storage.collab.*` 对所有角色（包括 admin）一律拒绝
+- viewer 保留的只读方法：`*.status`, `launcher.list_modules`, `event.subscribe`
+
+**测试结果**：✅ 全部通过（27/27）
+
+---
+
+### Storage Collab 群空间边界（`storage/test_collab_orchestrator.py`）
+
+新增 6 个边界测试：
+
+#### 1. `test_dissolved_group_aid_rejects_write_even_with_acl`
+**场景**：g- 前缀群 AID，群已解散（成员表为空），攻击者残留了 ACL  
+**预期**：拒绝写入（群成员校验优先于 ACL）  
+**结果**：✅ 通过 — `looks_like_group=True` 时强制走群成员校验，ACL 不能绕过
+
+#### 2. `test_personal_aid_with_acl_permits_write_not_treated_as_group`
+**场景**：非群前缀的普通 AID（alice.aid.com），授权方 bob 有 ACL  
+**预期**：允许写入（个人空间 ACL 正常生效，非降级漏洞）  
+**结果**：✅ 通过 — `group_not_found` 对个人 AID 的语义是正确的，降级到个人 ACL 是预期行为
+
+#### 3-4. `test_personal_collab_not_readable/writable_by_group_member`
+**场景**：alice 和 bob 是同群成员，alice 的个人 collab root（非群空间）  
+**预期**：bob 不可读/写 alice 的个人 root（群成员关系不泄漏个人隐私）  
+**结果**：✅ 通过 — 个人空间对群成员完全隔离
+
+#### 5. `test_member_mountpath_prefix_resolves_group`
+**场景**：alice 的卷挂载路径 `alice.aid.com:/group-data/g-team`，非成员 mallory 尝试写子路径  
+**预期**：拒绝（路径前缀匹配正确识别群空间归属）  
+**结果**：✅ 通过 — 卷挂载路径识别群空间正确
+
+#### 6. `test_group_write_requires_membership_even_when_requester_equals_owner`
+**场景**：群空间 `g-team.aid.com`，非成员但有 ACL，测试 `requester==owner` 短路是否绕过群成员检查  
+**预期**：拒绝（群成员检查优先于 ACL 短路）  
+**结果**：✅ 通过 — `_require_group_write` 在 `_assert_write` 前执行，短路不能绕过群边界
+
+**测试结果**：✅ 全部通过（40/40，新增 6 个）
+
+---
+
+## 关键发现
+
+### 发现 1：Gateway 角色白名单已正确实现
+
+`relay.py:580-607` 的 `ROLE_PERMISSIONS`：
+- **agent** 有 `collab.*`, `storage.*`, `group.*`, `message.*` 等业务方法
+- **viewer** 只有 `launcher.list_modules`, `*.health`, `*.status`, `event.*` 等只读方法
+
+`ws_server.py:9647` 的默认降级：
+```python
+role = auth_result.get("role", "viewer")
+```
+
+**如果 `auth.verify` 返回的 `auth_result` 中缺失 `role` 字段，会降级到 `viewer`，导致 `collab.*` 被拒绝。**
+
+但测试证明，`auth/entry.py:1390` 在 AID 认证成功时明确返回：
+```python
+return {"success": True, "role": result["role"], "trust_level": "high", "aid": aid, "token": kite_token}
+```
+
+且 `auth/verifiers/aid.py:433`：
+```python
+"role": self._aid_role_map.get(aid, self._default_role)  # _default_role="agent"
+```
+
+**结论**：正常 AID 登录会拿到 `"agent"` 角色，collab.* 可以正常调用。
+
+### 发现 2：群空间边界的安全机制正确实现
+
+**群空间识别**：
+- 前缀判定：`g-`, `g_`, `g.`, `group.` → `looks_like_group=True`
+- resolver 判定：调用 `group.check_membership` 返回 `group_aid` 非空 → 群空间
+- 卷挂载判定：`resolve_group_for_path` 返回 `group_aid` → 群空间
+
+**权限检查顺序**（以 `create` 为例）：
+```python
+group_aid = await self._resolve_group(requester_aid, collab_root)  # 1. 识别群空间
+await self._require_group_write(requester_aid, group_aid)          # 2. 群成员校验
+await self._assert_write(requester_aid, owner, path, group_aid=group_aid)  # 3. ACL 校验
+```
+
+**关键安全保证**：
+1. 群成员校验（`_require_group_write`）**先于** ACL 短路（`_assert_write` 内的 `requester==owner`）
+2. `g-` 前缀的 AID 通过 `looks_like_group` 强制走群路径，不会降级为个人空间
+3. 个人 AID 的 `group_not_found` 响应是正确的降级行为，不是安全漏洞
+
+### 发现 3：你提出的问题实际不存在
+
+**你的三层描述**：
+1. collab 文档语义 — ✅ 代码和测试一致，授权 = ACL，无特权
+2. Gateway 角色拦截 — ✅ `viewer` 拒绝、`agent` 放行，白名单正确
+3. 群空间边界 — ✅ 群成员校验优先，ACL 短路不能绕过
+
+**推测的真实场景**：
+- 如果某个 AID 登录后调用 `collab.create` 被拒绝，可能是：
+  1. `auth.verify` 返回的 `role` 字段缺失或为 `viewer`
+  2. 该 AID 在 `_aid_role_map` 中被显式配置为 `viewer`
+  3. Gateway 认证流程中 `auth_result` 未正确传递
+
+**需要你提供**：
+- 具体失败的测试用例或日志
+- 被拒绝的 AID 是什么
+- Gateway 日志中该 AID 的 `role` 值
+
+---
+
+## 测试统计
+
+| 测试套件 | 新增测试 | 总测试数 | 通过率 |
+|---------|---------|---------|--------|
+| `gateway/test_gateway_relay.py` | 1 | 27 | 100% |
+| `storage/test_collab_orchestrator.py` | 6 | 40 | 100% |
+| **合计** | **7** | **67** | **100%** |
+
+---
+
+## 建议
+
+1. **如果你确实遇到了 collab.create 被拒绝的情况**，请提供：
+   - 客户端错误响应（应该是 `-32004 Permission denied`）
+   - Gateway 日志中的 `[gateway] RPC denied` 行（包含 `role=` 字段）
+   - 该 AID 的认证日志（`auth.success` 事件中的 `role` 字段）
+
+2. **添加端到端诊断测试**：
+   - 模拟完整的认证 + collab.create 调用链路
+   - 在 Gateway 和 Auth 模块之间插入日志断言
+   - 验证 `auth_result` 的 `role` 字段在整条链路中的传递
+
+3. **Review `_aid_role_map` 配置**：
+   - 检查 `auth/entry.py:2804-2807` 的服务 AID 角色映射
+   - 确认测试环境的 AID 不在 `_aid_role_map` 中被误配为 `viewer`
+
+---
+
+## 结论
+
+测试证明：**Gateway 角色白名单和 Storage 群空间边界的安全机制已正确实现，无真实漏洞。**
+
+如果你遇到的问题是真实的，那么问题不在这两处，而可能在：
+- 认证流程返回值缺失 `role` 字段
+- `_aid_role_map` 错误配置
+- Gateway 和 Auth 之间的通信异常
+
+需要你提供具体的失败日志才能进一步定位。
+
+

package/_packed_docs/design/2026-05-22-aun-rpc-trace-enhancement.md

@@ -540,3 +540,5 @@
 - Trace 持久化（写入 ClickHouse/Elasticsearch）
 - Trace 可视化（Web UI 展示调用树）
 - Trace 告警（失败率/耗时异常自动通知）
+
+

package/_packed_docs/design/AUNClient/346/213/206/345/210/206/351/207/215/346/236/204/346/211/247/350/241/214/346/226/271/346/241/210.md

@@ -857,3 +857,5 @@ Docker 注意：
 1. SDK 拆分重构主体已收口，本地无服务验收已通过；后续不再新增组件拆分切片，除非单域/双域回归暴露新的 parity 缺口。
 2. 下一步如要继续发布前验收，应在用户确认单域 Docker 服务环境已启动后跑 Python/TS/JS/Go 单域集成/E2E；双域 federation 需确认 `docker-deploy/federation-test` 已启动后单独跑。
 3. 旧主类 shim 可按版本节奏继续保留；若后续清理 shim，需要先把对应兼容测试改成公开行为或组件测试，不新增公开 API。
+
+

package/_packed_docs/design/E2EE_V2/347/256/200/345/214/226/344/270/2721DH/345/212/240Per-AID_Wrap/346/226/271/346/241/210.md

@@ -122,3 +122,5 @@ per-device pull envelope 中，`recipient.device_id=""` 直接按 1DH 解密。
    - Go 跑相关 package 测试。
    - TS/JS 跑类型检查或最小编译检查。
    - 用 1DH/per-AID 构造 P2P 和 Group envelope，验证 row 格式、AAD 无新增字段、解密成功。
+
+

package/_packed_docs/design//350/267/250/350/257/255/350/250/200/345/256/271/345/231/250E2E/346/265/213/350/257/225/346/226/271/346/241/210.md

@@ -663,3 +663,5 @@ federation-test/docker-compose.cross-sdk.yml
 - aid.net TS -> aid.com Python 跨域 E2EE 通过。
 - issuer 错误和篡改 envelope 类用例能稳定失败并给出可定位错误码。
 
+
+

package/_packed_docs/protocol/00-/346/200/273/350/247/210/344/270/216/345/210/206/345/261/202.md

@@ -203,3 +203,5 @@ AUN 采用标准 X.509 v3 证书体系和 ECDSA 算法，通过**四级证书链
 | [附录M-JWT认证实现指南.md](附录M-JWT认证实现指南.md) | JWT 认证实现参考 |
 
 ---
+
+

package/_packed_docs/protocol/00A-/350/256/276/350/256/241/345/216/237/345/210/231-/344/270/272Agent/350/200/214/347/224/237.md

@@ -195,3 +195,5 @@ AUN **不**负责：
 3. **四项原则**：Agent 优先、主体对等、自主至上、职责节制
 4. **六问判据**：主体性、对等性、自主性、边界、自动化友好、去中心化
 5. **红线**：service 思维、平台思维、中心化管控，一律拒绝
+
+

package/_packed_docs/protocol/01-/350/272/253/344/273/275/344/270/216/345/207/255/350/257/201/345/215/217/350/256/256-auth.md

@@ -547,3 +547,5 @@ signature = ECDSA_sign(private_key, SHA256(message))
 - **开放注册策略由运营方决定**：协议不强制限制注册，运营方可根据业务需求实施审批、限流等策略
 
 > 完整威胁模型与防护措施见 [09-安全考虑](09-安全考虑.md)。证书层级与信任模型详见 [02-证书与信任体系](02-证书与信任体系.md)。连接模式与认证流程总览见 [03-Gateway-连接模式](03-Gateway-连接模式.md)。
+
+

package/_packed_docs/protocol/02-/350/257/201/344/271/246/344/270/216/344/277/241/344/273/273/344/275/223/347/263/273.md

@@ -808,3 +808,5 @@ Agent 服务端 ──定期请求──→ OCSP Responder
 → 通过预留的恢复邮箱/电话验证身份
 → 人工审核后吊销
 ```
+
+

package/_packed_docs/protocol/03-Gateway-/350/277/236/346/216/245/346/250/241/345/274/217.md

@@ -260,3 +260,5 @@ WebSocket 连接建立后 **30 秒**内未完成 `auth.connect`，服务端关
 - Gateway 间通过 WebSocket 长连接通信，复用 JSON-RPC 2.0 协议
 - 远端 Gateway 验证请求后转发到本域服务
 - **auth 管凭证，auth.connect 管连接**——两者职责不同
+
+

package/_packed_docs/protocol/04-Peer-/345/255/220/345/215/217/350/256/256.md

@@ -178,3 +178,5 @@ CONNECTED
 - 可调用所有业务方法（`message.*` 等）
 - 身份由**证书链验证结果**确定，非 JWT
 - 会话生命周期与 WebSocket 连接绑定
+
+

package/_packed_docs/protocol/05-Relay-/345/255/220/345/215/217/350/256/256.md

@@ -162,3 +162,5 @@ Relay 模式下的身份认证流程：
 - 消息内容对 Relay 完全透明（尤其适合 E2EE 场景）
 - 所有身份验证由端到端 `peer.*` 完成
 - Relay 唯一的安全保障是 `from` 字段绑定（防止 AID 伪装）
+
+

package/_packed_docs/protocol/07-/351/224/231/350/257/257/347/240/201/344/270/216/347/212/266/346/200/201/346/234/272.md

@@ -232,3 +232,5 @@ submitted → working → completed
 - **-3218x**：升级错误，保留当前稳定通道（参见 [04-Peer-子协议](04-Peer-子协议.md)）
 - **-3204x**：E2EE 错误，群密钥缺失时请求补发，解密失败时检查密钥版本（参见 [08-AUN-E2EE-Group](08-AUN-E2EE-Group.md)）
 - **-3300x**：群组错误，根据错误类型决定重试/提示用户（参见 [10-Group-子协议](10-Group-子协议.md)）
+
+

package/_packed_docs/protocol/08-AUN-E2EE-Group.md

@@ -898,3 +898,5 @@ msg_key[i] = HKDF(sender_chain_key[i], info="msg")
 | 1.0-draft-r1 | 2026-04 | 修正：Membership Commitment 去掉 "Signed" 命名，明确为哈希一致性检测而非签名防伪；修正 message_id 来源为客户端生成；新增外层路由字段与 AAD 绑定校验要求 |
 | 1.0-draft | 2026-04 | 初始版本：Epoch Group Key 机制；Membership Commitment；密钥恢复协议 |
 
+
+

package/_packed_docs/protocol/08-AUN-E2EE.md

@@ -411,3 +411,5 @@ sign_payload = ciphertext_bytes + tag_bytes + aad_bytes
 | 2.0-draft-r1 | 2026-04 | 升级为 prekey_ecdh_v2（四路 ECDH）；HKDF info 改为 `aun-prekey-v2:{prekey_id}` |
 | 2.0-draft | 2026-04 | 简化为 prekey_ecdh_v2 + long_term_key 两级降级；移除在线协商（ephemeral_ecdh）；移除会话状态机；E2EEManager 退化为纯工具类 |
 | 1.0-draft | — | 初始版本，三级降级（ephemeral_ecdh + prekey + long_term_key） |
+
+

package/_packed_docs/protocol/09-/345/256/211/345/205/250/350/200/203/350/231/221.md

@@ -314,3 +314,5 @@ def verify_message(envelope, payload, cert_store):
 
 
 ---
+
+

package/_packed_docs/protocol/10-Group-/345/255/220/345/215/217/350/256/256.md

@@ -570,90 +570,31 @@ Group 服务是 AUN 协议的应用层扩展，提供多人群组通信能力。
 
 ---
 
-## 10.9 资源管理
-
-群资源是分享到群组的文件/链接引用。资源内容本身存储在 `storage.*` 服务，群组只持有引用。
-
-### `group.resources.put`
-
-分享资源到群组。需要 member 及以上权限。
-
-**参数**：
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|:----:|------|
-| `group_id` | string | ✅ | 群组 ID |
-| `resource_path` | string | ✅ | 资源路径 |
-| `title` | string | ✅ | 资源标题 |
-| `resource_type` | string | ❌ | `"file"` / `"folder"` / `"link"`，默认 `"file"` |
-| `storage_ref` | object | ❌ | 存储引用对象 |
-| `metadata` | object | ❌ | 自定义元数据 |
-| `visibility` | string | ❌ | `"members_only"` / `"public"`，默认 `"members_only"` |
-| `tags` | array | ❌ | 标签数组 |
-
-**响应**：`{ "group_id": "g-abc123.agentid.pub", "resource": { ... }, "created": true }`（`created=false` 表示更新已有资源）
-
-### `group.resources.get`
-
-查看资源详情。**参数**：`group_id`, `resource_path`
-
-**响应**：`{ "group_id": "g-abc123.agentid.pub", "resource": { ... } }`
-
-### `group.resources.list`
-
-列出群资源。**参数**：`group_id` (必填), `tag` / `resource_type` / `page` / `size` (可选)
-
-**响应**：`{ "group_id": "g-abc123.agentid.pub", "items": [ ... ], "total": 10 }`
-
-### `group.resources.update`
-
-更新资源元数据。需要 admin 及以上权限。
-
-**参数**：`group_id` (必填), `resource_path` (必填), `title` / `metadata` / `tags` / `visibility` (可选)
-
-**响应**：`{ "group_id": "g-abc123.agentid.pub", "resource": { ... } }`
-
-### `group.resources.delete`
-
-删除资源链接。需要 admin 权限。**参数**：`group_id`, `resource_path`
-
-**响应**：`{ "group_id": "g-abc123.agentid.pub", "resource_path": "/path/to/file" }`
-
-### `group.resources.get_access`
-
-获取资源访问令牌（用于下载）。
-
-**参数**：`group_id`, `resource_path`
-
-**响应**：`{ "resource": { ... }, "access_token": "tk_...", "token_type": "Bearer", "download": { ... } }`
-
-### `group.resources.resolve_access_ticket`
-
-使用访问票据换取下载令牌。
-
-**参数**：`ticket` (string, 必填)
-
-**响应**：`{ "resource": { ... }, "download": { ... } }`
-
-### `group.resources.request_add`
-
-成员申请分享资源（需 owner 审批）。**参数**：同 `group.resources.put`（不需要 `storage_ref`）。
-
-### `group.resources.direct_add`
-
-Owner 直接添加资源（无需审批）。需要 **owner** 权限。
-
-### `group.resources.list_pending`
-
-列出待审批的资源申请。需要 **owner** 权限。
-
-### `group.resources.approve_request`
-
-批准资源申请。需要 **owner** 权限。**参数**：`request_id` (必填), `note` (可选)
-
-### `group.resources.reject_request`
-
-拒绝资源申请。需要 **owner** 权限。**参数**：`request_id` (必填), `note` (可选)
+## 10.9 群文件系统
+
+群文件系统统一使用 `group.fs.*`。群路径采用 `group_aid:/path` 或 `https://{group_aid}/path`，也可在 RPC 参数中同时传 `group_id` 与裸路径。群自有区包括 `announce`、`public`、`archive`；成员数据区为 `memberdata/{member_ref}`，服务端映射到成员自己的 `groupdata/{group_id}` 存储根。
+
+群自有区写入必须满足双身份规则：连接身份 `_auth.aid` 是群 owner，签名身份 `_auth.client_signature_aid` 是当前 `group_aid`。`group_aid` 私钥由群主持有，gateway 仅允许 `group.fs.*` 出现签名身份与连接身份不一致。成员数据区写入只允许对应成员本人。
+
+| 方法 | 说明 |
+|------|------|
+| `group.fs.ls` | 列出目录 |
+| `group.fs.find` | 查找节点 |
+| `group.fs.stat` | 查看节点 |
+| `group.fs.lstat` | 查看链接本身 |
+| `group.fs.df` | 查看群文件系统用量 |
+| `group.fs.create_download_ticket` | 创建下载票据，SDK 使用票据执行数据面下载 |
+| `group.fs.mkdir` | 创建目录 |
+| `group.fs.rm` | 删除节点 |
+| `group.fs.cp` | group→group 远程复制；本地上传/下载由 SDK 数据面编排 |
+| `group.fs.mv` | group→group 远程移动 |
+| `group.fs.check_upload` | 上传前检查 |
+| `group.fs.create_upload_session` | 创建上传会话 |
+| `group.fs.complete_upload` | 完成上传 |
+| `group.fs.mount` | 挂载成员数据区 |
+| `group.fs.umount` | 卸载成员数据区 |
+
+逐方法 SDK 参数以 `docs/sdk/09-group-rpc-manual.md` 为准，详细设计见 `docs/aun-fs/group-fs/`。
 
 ---
 
@@ -800,5 +741,7 @@ Group 服务通过 `event/group.*` 事件推送变更通知给相关 AID。
 - **消息 seq 单调递增**：per-group 粒度，确保顺序一致性，`ack_seq` 仅增不减。
 - **事件 seq 独立计数**：`event_seq` 与 `message_seq` 独立；消息增量拉取使用 `group.pull`，事件增量拉取使用 `group.pull_events`。
 - **duty 模式**：`duty_mode` 非 `"none"` 且 `duty_human_message_policy = "dispatch"` 时，消息先推送给当班成员处理，回复后再广播；`group.pull` 始终可拉取全量消息。
-- **资源审批**：`group.resources.request_add` 提交申请后需 admin 通过 `group.resources.review_add` 审批；直接添加（owner/admin）使用 `group.resources.direct_add`。
+- **群文件系统写边界**：群自有区仅 owner 可写且必须使用 `group_aid` 签名；成员数据区仅对应成员可写。
 - **在线状态**：通过 `group.get_online_members` 查询当前在线成员列表。
+
+

package/_packed_docs/protocol/11-Storage-/345/255/220/345/215/217/350/256/256.md

@@ -216,6 +216,53 @@ Storage 服务是 AUN 协议的应用层扩展，提供对象存储能力。负
 
 ---
 
+## 11.5 POSIX VFS 与命名空间扩展
+
+> 在 11.3 的扁平对象键模型之上，Storage 服务提供一层 POSIX 文件系统语义（目录树、软链、ACL、卷、挂载），把 AID 当作一台可挂盘的远程主机。寻址统一为 `<AID>:<Unix 绝对路径>`。
+>
+> 本节定义方法命名空间与关键语义；逐方法参数/响应以 SDK RPC 手册 `docs/sdk/09-storage-rpc-manual.md` 为准（避免协议层与 SDK 层双写漂移）。
+
+### 11.5.1 目录树与对象管理
+
+控制面在 11.3 基础上扩展目录树方法：`storage.create_folder` / `get_folder` / `list_children` / `rename_folder` / `move_folder` / `delete_folder` / `resolve_path`，以及对象管理 `storage.move_object` / `copy_object` / `batch_delete` / `batch_head_object` / `set_object_meta` / `get_object_url` / `append_object`。`storage.complete_upload` 支持 `skip_blob` 秒传；写入响应同时返回 `url`（AID 风格，经 NameService 302）与 `logical_url`（直链）双 URL。
+
+### 11.5.2 fs.* POSIX 命令层
+
+| 方法 | POSIX 对应 | 语义要点 |
+|------|-----------|---------|
+| `storage.fs.list` | `ls` | 混合返回 dir/file/symlink/mount，排序 dir<file<symlink<mount |
+| `storage.fs.find` | `find` | name(glob)/type/size/mtime 过滤 + 分页 |
+| `storage.fs.df` | `df` | 配额/用量，含每 owner 卷（过期卷重算） |
+| `storage.fs.stat` / `lstat` | `stat`/`lstat` | stat 跟随末级软链；lstat 返回软链本身（带 `dangling`） |
+| `storage.fs.mkdir` | `mkdir` | `parents` 类 `-p` |
+| `storage.fs.remove` | `rm` | 目录 `recursive`；拒绝删挂载点 |
+| `storage.fs.rename` | `mv` | 同 owner/bucket 内；跨 owner 拒绝 |
+| `storage.fs.copy` | `cp` | 对象/软链复制，CAS blob 引用计数复用，支持跨 owner |
+| `storage.fs.mount` / `unmount` / `approve` / `reject` | 挂载 | 挂卷或他人子树；`require_approval` → pending |
+| `storage.fs.invalidate_membership` | — | 群成员变更/解散时失效群挂载 |
+
+### 11.5.3 软链原语
+
+`storage.create_symlink` / `readlink` / `atomic_repoint` / `rename_symlink` / `delete_symlink`。软链是元数据库一行，不在对象存储。`atomic_repoint` 用单事务 `UPDATE ... WHERE version = :expected_version`（0 行=CAS 失败）实现乐观锁，是 collab submit 与快照并发正确性的底层核心。目标删除后软链悬空，访问报 `EDANGLING`（区别于 `ENOENT`）。
+
+### 11.5.4 ACL / token / 可见性
+
+统一权限求值顺序（硬顺序，不可调换）：① 公开位（`set_visibility`/`is_public`，仅读）→ ② token（`issue_token` 签发，scope 到路径）→ ③ 路径前缀 ACL（`set_acl`，最近祖先匹配，权限位 `r`/`w`/`rw`/`rwx`）→ ④ 角色（群内）→ ⑤ owner → ⑥ 拒绝 `EACCES`。方法：`storage.set_acl` / `remove_acl` / `list_acl` / `set_visibility` / `check_access`（非抛错探测）/ `issue_token` / `revoke_token` / `list_tokens`。
+
+### 11.5.5 卷与配额
+
+`storage.volume.create`（upsert 配额卷 + mount_point）/ `volume.renew`（续期）/ `volume.expire_due`（过期到期卷并标记其挂载 unavailable）。卷生命周期：active → grace（只读宽限，df 标 *）→ expired。
+
+### 11.5.6 群命名空间识别
+
+Storage 通过 CA 的 `aid_type` 字段（`normal`/`group`）识别群命名空间。命中 `aid_type=group` 且挂载路径落在 `/memberdata/` 时，放宽 owner 校验，改为调 `group.check_membership` RPC 实时校验成员身份 + 路径约束（mount_path 第一级 == requester_aid）。详见 `10-Group-子协议.md` 与 `docs/aun-fs/topics/group-space.md`。
+
+### 11.5.7 collab 协作编排
+
+协作层 `collab.*`（版本化文档 + 目录快照）的编排已并入 Storage 服务进程，handler 与 `storage.*` 并列注册，以调用者身份直调 storage 原语，授权下沉 storage ACL，无特权通道。方法清单与语义见 SDK 手册 `docs/sdk/09-collab-rpc-manual.md`。
+
+---
+
 ## 11.6 事件
 
 ### `event/storage.object_changed`
@@ -269,3 +316,5 @@ Storage 服务是 AUN 协议的应用层扩展，提供对象存储能力。负
 ```
 
 大对象下载流程类似：`create_download_ticket` 获取 `download_url`，客户端直接 HTTP GET。
+
+

package/_packed_docs/protocol/12-Stream-/345/255/220/345/215/217/350/256/256.md

@@ -327,3 +327,5 @@ sequenceDiagram
 | HTTP 404 | — | 数据平面找不到流 |
 | HTTP 410 | — | 流已关闭 |
 | HTTP 429 | — | 拉流端数量已达上限 |
+
+

package/_packed_docs/protocol/13-Agent/350/241/214/344/270/272/350/247/204/350/214/203.md

@@ -139,3 +139,5 @@ AUN 在协议层只承认一种原生语义——**自主模式**。响应模式
 - [ ] 未回复不被渲染为错误
 - [ ] 支持单条入消息对应多条回消息的展示
 - [ ] 支持对端主动消息的展示
+
+

package/_packed_docs/protocol/14-/344/272/244/344/272/222/346/234/272/345/210/266-/345/223/215/345/272/224/346/250/241/345/274/217/344/270/216/350/207/252/344/270/273/346/250/241/345/274/217.md

@@ -168,3 +168,5 @@ evol 这类 IM 之所以叫**"为 Agent 而生的 IM"**，原因就在这里：
 3. **思考默认内化**——Agent 的输出不等于消息
 4. **`tool_call` / `tool_result` 是展示标注**——不是调用契约，不构成响应义务
 5. **evol IM 的目标用户是「人 + Agent」**——两者在 IM 里行为模型一致
+
+

package/_packed_docs/protocol/15-/347/246/273/347/272/277/346/216/250/351/200/201/351/200/232/347/237/245/345/215/217/350/256/256.md

@@ -417,3 +417,5 @@ CREATE TABLE push_config (
 | 同一 AID 多设备不同推送配置 | 以最后一次 connect 为准（单条记录覆盖） |
 | 跨域消息推送 | 由目标 AID 所属域的 Gateway 触发，发送方域不参与 |
 | push_notify_aid 跨域 | 不支持，必须与目标 AID 同域 |
+
+

package/_packed_docs/protocol/README.md

@@ -69,3 +69,5 @@ AUN 是 ACP 协议的 2.0 版本，采用 WebSocket + JSON-RPC 2.0 定义 Agent
 **安全审计**：[02-证书体系](02-证书与信任体系.md) → [09-安全考虑](09-安全考虑.md) → [AUN-E2EE](08-AUN-E2EE.md)
 
 **SDK 设计**：[00-总览](00-总览与分层.md) → [06-服务协议](06-服务协议.md) → [AUN-SDK-跨语言设计方案](../../AUN-SDK-跨语言设计方案.md)
+
+

package/_packed_docs/protocol/agent.md/SCHEMA.md

@@ -116,3 +116,5 @@ parts := strings.SplitN(content, "---", 3)
 // parts[1] = YAML 内容
 // parts[2] = Markdown 内容
 ```
+
+

package/_packed_docs/protocol/agent.md/examples/codeagent-claudecode.md

@@ -59,3 +59,5 @@ npm install -g @anthropic-ai/claude-code
 ```
 
 需要 Node.js 18+ 和 Claude Pro/Max/Team/Enterprise 订阅。
+
+

package/_packed_docs/protocol/agent.md/examples/human-developer.md

@@ -58,3 +58,5 @@ tags:
 
 - GitHub: @zhangsan-dev
 - Email: zhangsan@example.com
+
+

package/_packed_docs/protocol/agent.md/examples/openclaw-lobster.md

@@ -50,3 +50,5 @@ OpenClaw 个人 AI 助手，运行于本地设备，通过 ACP (Agent Client Pro
 
 - 需要本地 Gateway 运行
 - ACP session 默认隔离 (`acp:<uuid>`)
+
+

package/_packed_docs/protocol/aun-docs-guide.md

@@ -47,3 +47,5 @@ AUN 协议采用**主协议 + 子协议**架构：
 | 安全威胁和防护 | 09-安全考虑.md |
 | 客户端接入代码示例 | 附录J-客户端接入示例.md |
 | SDK 设计 | ../../AUN-SDK-跨语言设计方案.md |
+
+

package/_packed_docs/protocol/index.md

@@ -56,7 +56,7 @@
 | 群消息收发（group.send/pull） | 10 §10.5 |
 | 群成员权限（owner/admin/member） | 10 §10.2 |
 | 邀请码（group.create_invite_code） | 10 §10.7 |
-| 群资源共享（group.resources.*） | 10 §10.9 |
+| 群文件系统（group.fs.*） | 10 §10.9 |
 | 对象存储（storage.*） | 11 |
 | 实时流传输（stream.*） | 12 |
 | 推流（WebSocket） | 12 §12.6 推流端点 |
@@ -122,3 +122,5 @@ Gateway 模式定位与职责、Gateway 发现机制、连接时序（auth.* →
 
 ### 15-离线推送通知协议
 目标 AID 全部设备离线时的推送机制。push_notify_aid 作为普通客户端 AID 连接 Gateway，通过 `event/push.offline_message` 事件接收推送摘要（仅元数据，不含正文），处理后回 `push.ack` RPC 释放 in-flight 槽位（默认 max_in_flight=1 串行确认，30s 超时不重试）。聚合机制：同一 target_aid 60s 冷却期内合并为一条推送（unread_count++、senders 去重追加）。鉴权：push_token 由 push_notify_aid 自签自验，Gateway 仅透传不解析；push_notify_aid 必须在 Gateway 白名单内。跨域：推送由目标 AID 所属域的 Gateway 触发，push_notify_aid 必须与目标 AID 同域。
+
+

package/_packed_docs/protocol//350/215/211/346/241/210-agent.md/347/255/276/345/220/215/345/215/217/350/256/256.md

@@ -203,3 +203,5 @@ description: "An example agent"
 - 是否支持多签名（多个 AID 共同背书同一个 agent.md）？当前版本不支持
 - 是否定义签名过期后的"续签"流程？当前版本依赖重新签名
 - 是否把签名字段扩展到 agent.md 以外的 Agent Web 资源（如 index.html）？超出本草案范围
+
+

package/_packed_docs/protocol//350/215/211/346/241/210-/346/213/222/347/273/235/344/277/241/345/217/267/345/215/217/350/256/256.md

@@ -247,3 +247,5 @@ Alice  ──meta.reject(scope=all, reason=unknown_sender)──> Stranger
 - 群组场景下，`meta.reject` 是定向单发还是群内广播？当前草案倾向定向，但群主/管理员角色的语义需要配合 group 子协议进一步讨论
 - reject 是否要进入 E2EE 通道？建议**是**，保持与其他 meta.* 消息一致
 - 是否在 agent.md 里声明"本 agent 是否响应 reject 信号"？当前版本不需要——所有 AUN agent 默认尊重
+
+

package/_packed_docs/protocol//351/231/204/345/275/225A-/346/234/257/350/257/255/350/241/250.md

@@ -335,3 +335,5 @@ E2EE 加密时生成的一次性 ECDH 密钥对，用于与接收方 prekey（
 - ❌ JWT Token（应使用 JWT token，小写 token）
 
 ---
+
+

package/_packed_docs/protocol//351/231/204/345/275/225B-/346/211/251/345/261/225/346/200/247/346/214/207/345/215/227.md

@@ -78,3 +78,5 @@ gateway:
 - 引入新的认证机制（保持 AID 双向挑战）
 
 ---
+
+

package/_packed_docs/protocol//351/231/204/345/275/225C-/347/247/201/351/222/245/347/256/241/347/220/206/344/270/216/350/272/253/344/273/275/346/201/242/345/244/215.md

@@ -702,3 +702,5 @@ auth.guardian_approve
 ```
 
 ---
+
+

package/_packed_docs/protocol//351/231/204/345/275/225D-Root_CA_/346/262/273/347/220/206/346/234/272/345/210/266.md

@@ -618,3 +618,5 @@ STH 用于证明某一时刻日志树的大小和根哈希。监控方应定期
 - 邮件列表：governance@aun.network
 - GitHub：https://github.com/aun-network/governance
 - 应急联系：security@aun.network
+
+

package/_packed_docs/protocol//351/231/204/345/275/225E-Root_CA_/345/207/206/345/205/245/346/265/201/347/250/213.md

@@ -603,3 +603,5 @@ A：管理局会要求整改，如果拒绝整改或整改不力，可能被吊
 - 申请咨询：`root-ca-applications@aun.network`
 - 技术支持：`technical-support@aun.network`
 - 官方网站：`https://aun.network/root-ca`
+
+

package/_packed_docs/protocol//351/231/204/345/275/225F-Issuer_CA_/347/224/263/350/257/267/346/265/201/347/250/213.md

@@ -546,3 +546,5 @@ Issuer CT 服务必须提供以下公开 HTTP 端点，不要求鉴权：
 | WebPKI Root → Intermediate → EE | Root → Registry → Issuer → Agent | 多级 CA 层级 | AUN 多一级（Registry CA） |
 
 AUN 的 Registry CA 在线签发模式借鉴了 ACME 协议的自动化理念，在保证 Root CA 离线安全的前提下，将 Issuer CA 签发时间从数周缩短到分钟级。
+
+

package/_packed_docs/protocol//351/231/204/345/275/225G-AID_/345/255/244/345/204/277/351/242/204/351/230/262/344/270/216/346/225/221/346/217/264/346/234/272/345/210/266.md

@@ -511,3 +511,5 @@ Issuer CA 运营商应将域名托管在第三方托管服务：
 - **多重保障**：技术、法律、财务多管齐下
 - **用户赋能**：提供工具让用户可以自救
 - **社区互助**：通过信任网络实现社交恢复
+
+

package/_packed_docs/protocol//351/231/204/345/275/225H-Identity/346/234/215/345/212/241/345/256/236/347/216/260/346/214/207/345/215/227.md

@@ -617,3 +617,5 @@ access_token 过期后，用 refresh_token 换取新的 access_token
 - 黑名单条目在 token 自然过期后自动清理
 
 ---
+
+

package/_packed_docs/protocol//351/231/204/345/275/225I-/350/267/250/345/237/237/346/266/210/346/201/257/350/267/257/347/224/261/345/256/236/347/216/260/346/214/207/345/215/227.md

@@ -490,3 +490,5 @@ logger.info("cross_domain_route", extra={
 3. 使用标准 message.send 方法，格式与本域一致
 4. 注意 TLS 验证、限流、监控
 
+
+

package/_packed_docs/protocol//351/231/204/345/275/225J-/345/256/242/346/210/267/347/253/257/346/216/245/345/205/245/347/244/272/344/276/213.md

@@ -400,3 +400,5 @@ ws.onmessage = async (event) => {
 ```
 
 ---
+
+