@agentunion/fastaun-browser 0.4.13 → 0.5.0

package/_packed_docs/sdk/09-stream-rpc-manual.md

@@ -273,3 +273,5 @@ async with aiohttp.ClientSession() as session:
 | -33405 | Stream invalid params | 参数无效（如缺少 stream_id） |
 | -33406 | Stream rate limited | 速率限制 |
 | -33407 | Stream internal error | 服务内部错误 |
+
+

package/_packed_docs/sdk/AUN_DOCS_GUIDE.md

@@ -6,12 +6,15 @@ AUN SDK 文档位于 `docs/sdk/`，索引文件 `docs/sdk/INDEX.md` 分三层：
 
 当前 SDK 聚焦三主体模型：
 
-- `AIDStore`：注册、加载、列举、解析和证书运维。
-- `AID`：不可变身份值对象，负责签名、验签和 agent.md 签验。
-- `AUNClient`：认证、连接、状态机、事件和 RPC。
-- `ServiceProxyClient`：Python SDK 的 Service Proxy provider 侧客户端，负责 Gateway 控制面注册和 proxy-server 数据面隧道注册。
+- `AIDStore`：注册、加载、列举、解析和证书运维。
+- `AID`：不可变身份值对象，负责签名、验签和 agent.md 签验。
+- `AUNClient`：认证、连接、状态机、事件和 RPC。
+- `ServiceProxyClient`：Python SDK 的 Service Proxy provider 侧客户端，负责 Gateway 控制面注册和 proxy-server 数据面隧道注册。
+
+业务 RPC 的底层参数见 `09-*-rpc-manual.md`，可通过 `client.call(method, params)` 调用；Storage、Collab、Group FS、Service Proxy 等具备高层门面的能力以对应专项文档为准。`message.send`、`message.thought.put`、`group.send`、`group.thought.put` 的业务 payload 见 `09-payload-reference.md`。在线轻量通知和跨域 federation notify 方案见 `Notify通知方案.md`。
 
-业务操作统一通过 `client.call(method, params)` 调用；消息、群组、存储、meta、stream、proxy 的参数见 `09-*-rpc-manual.md`。`message.send`、`message.thought.put`、`group.send`、`group.thought.put` 的业务 payload 见 `09-payload-reference.md`。在线轻量通知和跨域 federation notify 方案见 `Notify通知方案.md`。
+Storage 的 SDK VFS、控制面/数据面分离、direct backend 上传下载、类 Linux 权限、mount/symlink 和服务端分层见 `AUN Storage架构设计.md`。
+Group FS 的 `group.fs.*` RPC、`client.group.fs.*` 门面、`aun group fs` CLI、`cp/mv` 语义、群自有区 `group_aid` 写身份、`parents` 语义、JS string 差异和 memberdata 服务端映射见 `09-group-rpc-manual.md`。Collab 的 `gc`、`reflog`、`revert`、`clone` 及版本化文档/标签语义见 `09-collab-rpc-manual.md`。
 
 ## 渐进式查阅流程
 
@@ -27,9 +30,12 @@ AUN SDK 文档位于 `docs/sdk/`，索引文件 `docs/sdk/INDEX.md` 分三层：
 - 连接与状态：AUNClient / 九态状态机 / Gateway / 重连
 - E2EE：默认加密、ProtectedHeaders、P2P / Group V2
 - RPC 与事件：`client.call()`、`client.on()`、`client.notify()`、RPC 手册
-- Service Proxy：`ServiceProxyClient`、`proxy.register_services`、proxy-server `register_services`
-- agent.md：`AIDStore.upload_agent_md()`、`AIDStore.download_agent_md()`、`AIDStore.check_agent_md()`
-- 错误处理：Result、异常、错误码、重试
+- Storage：SDK VFS、direct backend 数据面、`storage.*` low-level RPC、类 Linux 权限、mount/symlink、Storage Service 分层
+- 群文件系统：`group.fs.*`、`client.group.fs.*`、`aun group fs`、`cp/mv` 上传下载、群自有区 `group_aid` 写身份、`parents`、JS string 差异和 memberdata 服务端映射（见 `09-group-rpc-manual.md`）
+- 协作（collab）：`collab.*` 版本化文档、乐观锁 CAS commit、三方合并、标签、GC、reflog、revert（见 `09-collab-rpc-manual.md`）
+- Service Proxy：`ServiceProxyClient`、`proxy.register_services`、proxy-server `register_services`
+- agent.md：`AIDStore.upload_agent_md()`、`AIDStore.download_agent_md()`、`AIDStore.check_agent_md()`
+- 错误处理：Result、异常、错误码、重试
 
 ### Step 3：读 Layer 3 摘要
 
@@ -44,12 +50,13 @@ AUN SDK 文档位于 `docs/sdk/`，索引文件 `docs/sdk/INDEX.md` 分三层：
 | 03 | [核心概念](03-核心概念.md) | AID、状态机、认证、E2EE |
 | 04 | [连接与认证](04-连接与认证.md) | AIDStore、连接、网关发现、事件 |
 | 05 | [E2EE加密通信](05-E2EE加密通信.md) | E2EE、ProtectedHeaders、密钥管理 |
-| 06 | [API手册](06-API手册.md) | AIDStore / AID / AUNClient / ServiceProxyClient / 事件 / RPC |
-| 07 | [错误处理](07-错误处理.md) | Result、异常、错误码、重试 |
-| 08 | [最佳实践](08-最佳实践.md) | 幂等、多 AID、资源清理、测试数据 |
-| 09 | `09-*-rpc-manual.md` | 各服务 RPC 参数和响应 |
-| 09 | [Service Proxy RPC手册](09-proxy-rpc-manual.md) | `proxy.*` 控制面和 proxy-server 数据面注册 |
-| 09 | [AID托管API手册](09-custody-api-manual.md) | 可选 custody HTTP 服务 |
+| 06 | [API手册](06-API手册.md) | AIDStore / AID / AUNClient / ServiceProxyClient / 事件 / RPC |
+| 07 | [错误处理](07-错误处理.md) | Result、异常、错误码、重试 |
+| 08 | [最佳实践](08-最佳实践.md) | 幂等、多 AID、资源清理、测试数据 |
+| - | [AUN Storage架构设计](<AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、类 Linux 权限、mount/symlink、服务端分层 |
+| 09 | `09-*-rpc-manual.md` | 各服务 RPC 参数和响应 |
+| 09 | [Service Proxy RPC手册](09-proxy-rpc-manual.md) | `proxy.*` 控制面和 proxy-server 数据面注册 |
+| 09 | [AID托管API手册](09-custody-api-manual.md) | 可选 custody HTTP 服务 |
 
 ## 常见查阅场景
 
@@ -57,13 +64,19 @@ AUN SDK 文档位于 `docs/sdk/`，索引文件 `docs/sdk/INDEX.md` 分三层：
 |------|----------|
 | 首次使用 SDK | [01-快速开始](01-快速开始.md) |
 | 理解新构造入口 | [01-快速开始](01-快速开始.md)、[06-API手册](06-API手册.md) |
-| 注册或加载 AID | [04-连接与认证](04-连接与认证.md) |
-| 发布、下载或检查 agent.md | [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md) |
-| 状态机和重连 | [03-核心概念](03-核心概念.md)、[04-连接与认证](04-连接与认证.md) |
+| 注册或加载 AID | [04-连接与认证](04-连接与认证.md) |
+| 发布、下载或检查 agent.md | [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md) |
+| 状态机和重连 | [03-核心概念](03-核心概念.md)、[04-连接与认证](04-连接与认证.md) |
 | 查方法签名 | [06-API手册](06-API手册.md) |
 | 查消息或群组 RPC | 对应 `09-*-rpc-manual.md` |
-| 查 notify 在线轻量通知 / 跨域 federation | [Notify通知方案.md](Notify通知方案.md) |
-| 查 Service Proxy 服务注册和路由 | [06-API手册](06-API手册.md)、[09-proxy-rpc-manual.md](09-proxy-rpc-manual.md) |
-| 查 payload 格式 | [09-payload-reference.md](09-payload-reference.md) |
+| 查群文件系统 RPC / SDK / CLI 入口、群自有区写身份、`parents` 和 JS string 差异 | [09-group-rpc-manual.md](09-group-rpc-manual.md)、[06-API手册](06-API手册.md) |
+| 查 Storage 架构、SDK VFS、权限模型、mount/symlink 和上传下载链路 | [AUN Storage架构设计.md](<AUN Storage架构设计.md>) |
+| 查 Storage RPC 参数 | [09-storage-rpc-manual.md](09-storage-rpc-manual.md) |
+| 查协作（版本化文档/乐观锁/标签/GC/reflog/revert）RPC | [09-collab-rpc-manual.md](09-collab-rpc-manual.md) |
+| 查 notify 在线轻量通知 / 跨域 federation | [Notify通知方案.md](Notify通知方案.md) |
+| 查 Service Proxy 服务注册和路由 | [06-API手册](06-API手册.md)、[09-proxy-rpc-manual.md](09-proxy-rpc-manual.md) |
+| 查 payload 格式 | [09-payload-reference.md](09-payload-reference.md) |
 | 排查错误 | [07-错误处理](07-错误处理.md) |
 | 写测试或 demo | [08-最佳实践](08-最佳实践.md) |
+
+

package/_packed_docs/sdk/E2EE_V2/346/266/210/346/201/257/351/200/232/344/277/241/346/227/266/345/272/217/345/233/276.md

@@ -169,3 +169,5 @@ sequenceDiagram
 | GROUP 明文 | `group.send(encrypt=false)` | `group_messages` + `group_events` | `group.v2.pull` 合并明文行 | 不解密 |
 | GROUP 加密 | `group.v2.send` 承载 `e2ee.group_encrypted` | `v2_group_messages` + `v2_group_wraps` | `group.v2.pull` | 接收方 SDK |
 
+
+

package/_packed_docs/sdk/INDEX.md

@@ -19,13 +19,17 @@
 | [08-最佳实践](08-最佳实践.md) | 幂等连接 · 多 AID · 资源清理 · 测试数据保护 |
 | [09-payload-reference](09-payload-reference.md) | message / group / thought payload 格式 |
 | [09-message-rpc-manual](09-message-rpc-manual.md) | P2P 消息 RPC |
-| [09-group-rpc-manual](09-group-rpc-manual.md) | 群组 RPC |
-| [09-storage-rpc-manual](09-storage-rpc-manual.md) | 存储 RPC |
-| [09-meta-rpc-manual](09-meta-rpc-manual.md) | meta RPC 和信任根 |
-| [09-stream-rpc-manual](09-stream-rpc-manual.md) | stream RPC |
-| [09-proxy-rpc-manual](09-proxy-rpc-manual.md) | Service Proxy 控制面 RPC 和数据面隧道注册 |
-| [09-custody-api-manual](09-custody-api-manual.md) | 可选 AID 托管 HTTP API |
-| [Notify通知方案](Notify通知方案.md) | `client.notify()` 在线轻量通知、跨域 federation 和可靠消息分工 |
+| [09-group-rpc-manual](09-group-rpc-manual.md) | 群组 RPC（含 `group.fs.*` 群文件系统 RPC、群自有区写身份和 `parents` 语义） |
+| [09-storage-rpc-manual](09-storage-rpc-manual.md) | 存储 RPC（对象 + POSIX VFS / 卷 / 软链 / ACL / token） |
+| [09-collab-rpc-manual](09-collab-rpc-manual.md) | 协作 RPC（版本化文档 / 乐观锁 / 三方合并 / 标签 / GC / reflog / revert） |
+| [group.fs POSIX 化详细设计](../aun-fs/group-fs/group.fs-POSIX化详细设计.md) | 下一版 `client.group.fs.*` / `aun group fs` / `group.fs.*` 群文件系统设计，含群自有区写身份、`parents` 和 JS string 语义 |
+| [group.fs POSIX 化分阶段实施计划](../aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md) | group.fs 重构的 IPO、Step-by-step、用例集、Checklist、验收和回滚 |
+| [AUN Storage架构设计](<AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、服务端分层、类 Linux 权限、mount/symlink 与关键时序 |
+| [09-meta-rpc-manual](09-meta-rpc-manual.md) | meta RPC 和信任根 |
+| [09-stream-rpc-manual](09-stream-rpc-manual.md) | stream RPC |
+| [09-proxy-rpc-manual](09-proxy-rpc-manual.md) | Service Proxy 控制面 RPC 和数据面隧道注册 |
+| [09-custody-api-manual](09-custody-api-manual.md) | 可选 AID 托管 HTTP API |
+| [Notify通知方案](Notify通知方案.md) | `client.notify()` 在线轻量通知、跨域 federation 和可靠消息分工 |
 
 ---
 
@@ -41,7 +45,7 @@
 
 ### 连接与状态
 
-- 九态状态机、device_id / slot_id 隔离键 → [03-核心概念](03-核心概念.md)
+- 九态状态机、device_id / slot_id 隔离键 → [03-核心概念](03-核心概念.md)
 - `connect()` 选项、长短连接、网关发现 → [04-连接与认证](04-连接与认证.md)
 - capability getter、事件、生命周期 API → [06-API手册](06-API手册.md)
 - 裸 WebSocket 握手 → [02-WebSocket协议](02-WebSocket协议.md)
@@ -56,15 +60,18 @@
 
 ### RPC 与事件
 
-- `client.call()` / `client.on()` → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)
-- `client.notify()` 在线轻量通知、跨域 federation、在线/离线边界 → [Notify通知方案](Notify通知方案.md)
+- `client.call()` / `client.on()` → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)
+- `client.notify()` 在线轻量通知、跨域 federation、在线/离线边界 → [Notify通知方案](Notify通知方案.md)
 - Message RPC → [09-message-rpc-manual](09-message-rpc-manual.md)
-- Group RPC → [09-group-rpc-manual](09-group-rpc-manual.md)
-- Storage RPC → [09-storage-rpc-manual](09-storage-rpc-manual.md)
-- Meta RPC → [09-meta-rpc-manual](09-meta-rpc-manual.md)
-- Stream RPC → [09-stream-rpc-manual](09-stream-rpc-manual.md)
-- Service Proxy RPC 和隧道注册 → [09-proxy-rpc-manual](09-proxy-rpc-manual.md)
-- Payload 格式 → [09-payload-reference](09-payload-reference.md)
+- Group RPC 与群文件系统 `group.fs.*` 控制面、群自有区写身份和 `parents` 语义 → [09-group-rpc-manual](09-group-rpc-manual.md)
+- 下一版群文件系统 `group.fs.*`、`client.group.fs.*`、`aun group fs`、`cp/mv` POSIX 化语义和 JS string 差异 → [group.fs POSIX 化详细设计](../aun-fs/group-fs/group.fs-POSIX化详细设计.md)、[分阶段实施计划](../aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md)
+- Storage 架构、SDK VFS、控制面/数据面分离、类 Linux 权限和 mount/symlink → [AUN Storage架构设计](<AUN Storage架构设计.md>)
+- Storage RPC（对象 + `storage.fs.*` / `storage.volume.*` / 软链 / ACL / token）→ [09-storage-rpc-manual](09-storage-rpc-manual.md)
+- Collab RPC（`collab.*` 版本化文档、乐观锁、标签、GC、reflog、revert）→ [09-collab-rpc-manual](09-collab-rpc-manual.md)
+- Meta RPC → [09-meta-rpc-manual](09-meta-rpc-manual.md)
+- Stream RPC → [09-stream-rpc-manual](09-stream-rpc-manual.md)
+- Service Proxy RPC 和隧道注册 → [09-proxy-rpc-manual](09-proxy-rpc-manual.md)
+- Payload 格式 → [09-payload-reference](09-payload-reference.md)
 
 ### 错误与测试
 
@@ -87,7 +94,7 @@
 
 ### 03-核心概念
 
-解释 AID 身份、三主体职责、device_id / slot_id 隔离键、九态状态机、认证挑战-响应、默认 E2EE 行为和 RPC/事件模型。
+解释 AID 身份、三主体职责、device_id / slot_id 隔离键、九态状态机、认证挑战-响应、默认 E2EE 行为和 RPC/事件模型。
 
 ### 04-连接与认证
 
@@ -99,7 +106,7 @@
 
 ### 06-API手册
 
-列出 AIDStore、AID、AUNClient、事件、ServiceProxyClient、E2EE 高级 API 和 RPC 手册索引，包含 Python / TS / JS / Go 的主要命名差异。
+列出 AIDStore、AID、AUNClient、事件、ServiceProxyClient、E2EE 高级 API 和 RPC 手册索引，包含 Python / TS / JS / Go 的主要命名差异。
 
 ### 07-错误处理
 
@@ -109,14 +116,24 @@
 
 给出幂等加载身份、连接、关闭、多 AID 管理、protected_headers、Flow Control 和测试数据保护建议。
 
-### 09-*-rpc-manual
-
-各业务服务的 RPC 参数、响应和错误语义。SDK 不为每个 RPC 提供一层业务 wrapper，应用直接通过 `client.call()` 调用。
-
-### 09-proxy-rpc-manual
-
-定义 Service Proxy 的 Gateway 控制面 `proxy.register_services` / `proxy.unregister_services` / `proxy.list_services`，以及 proxy-server 数据面 `register_services` 隧道消息、双注册顺序、服务列表一致性和 wakeup 路由语义。
-
-### Notify通知方案
-
-定义 `client.notify()` 的在线轻量通知语义、服务端/AID/群路由方式、跨域 federation 在线转发、无离线存储边界、安全约束，以及与 `message.send` / `group.send` 可靠应用事件的分工。
+### 09-*-rpc-manual
+
+各业务服务的 RPC 参数、响应和错误语义。Storage、Collab、Group FS、Service Proxy 等明确提供高层门面的能力应优先使用门面；需要精确控制底层参数时再通过 `client.call()` 调用业务 RPC。
+
+### AUN Storage架构设计
+
+定义 AUN Storage 的 SDK VFS、low-level storage client、Storage Service、Storage Core、Metadata Engine 和 Blob Backend 分层。文档明确主数据流量直连 backend、控制面走 `storage.*` RPC，底层 session/ticket/complete RPC 继续保留，但普通应用通过 SDK VFS 获得类 POSIX 文件操作语义；同时定义类 Linux mode/ACL、目录 `x` 位、mount/unmount、symlink/readlink/lstat、share link 与 direct backend ticket 的授权边界，并给出上传、下载、rename/move、delete/GC、路径解析和鉴权的 Mermaid 时序图。
+
+### 09-collab-rpc-manual
+
+定义协作层 `collab.*` RPC（共 21 个）：文档版本线（ls-files/create/show/commit/merge/log/diff/revert/prune）、运维备份迁移（gc/reflog/clone）、目录级标签（tag.create/list/show/diff/restore/rm/prune）、群内发现（ls-remote/unregister）。collab 编排并入 storage 服务进程，以调用者身份直调 storage 原语，授权下沉到 storage ACL。涵盖乐观锁 CAS commit 撞版本响应、三方合并冲突标记、forward-only 标签回滚、垃圾扫描和审计日志语义。
+
+### 09-proxy-rpc-manual
+
+定义 Service Proxy 的 Gateway 控制面 `proxy.register_services` / `proxy.unregister_services` / `proxy.list_services`，以及 proxy-server 数据面 `register_services` 隧道消息、双注册顺序、服务列表一致性和 wakeup 路由语义。
+
+### Notify通知方案
+
+定义 `client.notify()` 的在线轻量通知语义、服务端/AID/群路由方式、跨域 federation 在线转发、无离线存储边界、安全约束，以及与 `message.send` / `group.send` 可靠应用事件的分工。
+
+

package/_packed_docs/sdk/Notify/351/200/232/347/237/245/346/226/271/346/241/210.md

@@ -212,3 +212,5 @@ notify 专项测试覆盖：
 - 单域集成：AID 在线实时投递、group 在线成员投递。
 - E2E：`device_id` / `slot_id` 精确投递、离线不存储不补发。
 - 双域跨域：Python / TypeScript / Go / 浏览器 JavaScript 从 `aid.com` 在线投递到 `aid.net`。
+
+

package/_packed_docs/sdk/README.md

@@ -10,8 +10,8 @@ AUN（Agent Union Network）定义 Agent 之间安全通信的标准接口，基
 - **三主体 SDK 模型**：`AIDStore` 管理 keystore，`AID` 是不可变身份值对象，`AUNClient` 管理连接与会话。
 - **Gateway 连接**：当前各语言 SDK 稳定支持 Gateway 接入；Peer / Relay 仍处于协议定义或未实现状态。
 - **默认 E2EE**：P2P 和 Group V2 消息默认加密；普通明文消息需要显式关闭加密。
-- **统一 RPC / 事件 / Notify**：业务方法通过 `client.call(method, params)` 调用，事件通过 `client.on(event, handler)` 订阅；在线轻量通知通过 `client.notify()` 发送，支持同域和跨域在线 federation，详见 `Notify通知方案.md`。
-- **Service Proxy**：Python SDK 提供 `ServiceProxyClient`，provider 会先向 Gateway 注册 `proxy.*` 控制面服务列表，再在每条 proxy-server 隧道认证后注册数据面服务列表。
+- **统一 RPC / 事件 / Notify**：业务方法通过 `client.call(method, params)` 调用，事件通过 `client.on(event, handler)` 订阅；在线轻量通知通过 `client.notify()` 发送，支持同域和跨域在线 federation，详见 `Notify通知方案.md`。
+- **Service Proxy**：Python SDK 提供 `ServiceProxyClient`，provider 会先向 Gateway 注册 `proxy.*` 控制面服务列表，再在每条 proxy-server 隧道认证后注册数据面服务列表。
 
 ---
 
@@ -40,7 +40,7 @@ async def create_client(aid: str) -> AUNClient:
             raise RuntimeError(registered["error"]["message"])
         loaded = store.load(aid)
 
-    client = AUNClient(loaded["data"]["aid"])
+    client = AUNClient(loaded["data"]["aid"])
     await client.connect({"slot_id": "main", "auto_reconnect": True})
     return client
 
@@ -69,14 +69,14 @@ asyncio.run(main())
 
 ## 多语言构造约束
 
-| 语言 | 无身份构造 | 带身份构造 |
+| 语言 | 无身份构造 | 带身份构造 |
 |------|--------------|---------------|
 | Python | `AUNClient()` | `AUNClient(aid)` |
 | TypeScript | `new AUNClient()` | `new AUNClient(aid)` |
 | JavaScript | `new AUNClient()` | `new AUNClient(aid)` |
 | Go | `aun.NewAUNClientEmpty()` | `aun.NewAUNClient(aid)` |
 
-`aid` 必须是 `AIDStore.load()` 返回的 AID 对象，不是字符串。debug / verify_ssl / root_ca_path 等配置由 AID 携带，不再通过 `AUNClient` 构造参数传入。
+`aid` 必须是 `AIDStore.load()` 返回的 AID 对象，不是字符串。debug / verify_ssl / root_ca_path 等配置由 AID 携带，不再通过 `AUNClient` 构造参数传入。
 
 ---
 
@@ -108,22 +108,24 @@ Layer 1: 安全层   TLS + AUN E2EE
 | [03-核心概念](03-核心概念.md) | AID、AIDStore、AUNClient、九态状态机、E2EE |
 | [04-连接与认证](04-连接与认证.md) | 注册、加载、认证、连接、事件、agent.md |
 | [05-E2EE加密通信](05-E2EE加密通信.md) | E2EE 收发、ProtectedHeaders、密钥管理 |
-| [06-API手册](06-API手册.md) | AIDStore / AID / AUNClient / ServiceProxyClient / 事件 / RPC 索引 |
+| [06-API手册](06-API手册.md) | AIDStore / AID / AUNClient / ServiceProxyClient / 事件 / RPC 索引 |
 | [07-错误处理](07-错误处理.md) | Result、异常层级、错误码、重试策略 |
-| [08-最佳实践](08-最佳实践.md) | 幂等连接、多 AID、资源清理、测试数据保护 |
-| [Notify通知方案](Notify通知方案.md) | `client.notify()` 在线轻量通知、跨域 federation 和可靠消息分工 |
+| [08-最佳实践](08-最佳实践.md) | 幂等连接、多 AID、资源清理、测试数据保护 |
+| [AUN Storage架构设计](<AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、服务端分层、类 Linux 权限、mount/symlink 和关键时序 |
+| [Notify通知方案](Notify通知方案.md) | `client.notify()` 在线轻量通知、跨域 federation 和可靠消息分工 |
 
 RPC 专项手册：
 
 | 手册 | 范围 |
 |------|------|
 | [09-message-rpc-manual.md](09-message-rpc-manual.md) | P2P 消息、ack、thought |
-| [09-group-rpc-manual.md](09-group-rpc-manual.md) | 群组生命周期、成员、群消息、群 thought |
-| [09-storage-rpc-manual.md](09-storage-rpc-manual.md) | 文件和对象存储 |
-| [09-meta-rpc-manual.md](09-meta-rpc-manual.md) | ping / status / trust_roots |
-| [09-stream-rpc-manual.md](09-stream-rpc-manual.md) | 流式数据传输 |
-| [09-proxy-rpc-manual.md](09-proxy-rpc-manual.md) | Service Proxy 控制面 RPC 和数据面隧道注册 |
-| [09-payload-reference.md](09-payload-reference.md) | message / group payload 结构 |
+| [09-group-rpc-manual.md](09-group-rpc-manual.md) | 群组生命周期、成员、群消息、群 thought、Group FS |
+| [09-storage-rpc-manual.md](09-storage-rpc-manual.md) | 对象存储 + POSIX VFS（fs/卷/软链/ACL/token） |
+| [09-collab-rpc-manual.md](09-collab-rpc-manual.md) | 协作层：版本化文档、乐观锁、三方合并、目录快照 |
+| [09-meta-rpc-manual.md](09-meta-rpc-manual.md) | ping / status / trust_roots |
+| [09-stream-rpc-manual.md](09-stream-rpc-manual.md) | 流式数据传输 |
+| [09-proxy-rpc-manual.md](09-proxy-rpc-manual.md) | Service Proxy 控制面 RPC 和数据面隧道注册 |
+| [09-payload-reference.md](09-payload-reference.md) | message / group payload 结构 |
 | [09-custody-api-manual.md](09-custody-api-manual.md) | 可选 AID 托管 HTTP API |
 
-协议文档随 SDK 包分发，位于 `aun_core/docs/protocol/`。
+协议文档随 SDK 包分发，位于 `aun_core/docs/protocol/`。

package/dist/aid-store.d.ts

@@ -42,6 +42,20 @@ export type RekeyResult = {
     new_cert_not_after: Date;
     new_fingerprint: string;
 };
+export type ImportGroupIdentityOptions = {
+    private_key_pem?: string;
+    privateKeyPem?: string;
+    public_key_der_b64?: string;
+    publicKeyDerB64?: string;
+    curve?: string;
+    cert_pem?: string;
+    certPem?: string;
+    cert?: string;
+};
+export type ImportGroupIdentityResult = {
+    imported: true;
+    aid: string;
+};
 export type ChangeSeedResult = {
     changed: boolean;
     count: number;
@@ -74,8 +88,13 @@ export declare class AIDStore {
     load(aid: string): Promise<Result<{
         aid: AID;
     }>>;
+    loadAsync(aid: string): Promise<Result<{
+        aid: AID;
+    }>>;
     list(): Promise<Result<ListResult>>;
+    listAsync(): Promise<Result<ListResult>>;
     changeSeed(oldSeed: string, newSeed: string): Promise<Result<ChangeSeedResult>>;
+    changeSeedAsync(oldSeed: string, newSeed: string): Promise<Result<ChangeSeedResult>>;
     register(aid: string): Promise<Result<{
         registered: true;
     }>>;
@@ -91,6 +110,12 @@ export declare class AIDStore {
     diagnose(aid: string): Promise<Result<DiagnoseResult>>;
     renewCert(aid: string): Promise<Result<RenewCertResult>>;
     rekey(aid: string): Promise<Result<RekeyResult>>;
+    importGroupIdentity(aidOrOptions: string | (ImportGroupIdentityOptions & {
+        aid?: string;
+    }), options?: ImportGroupIdentityOptions): Promise<Result<ImportGroupIdentityResult>>;
+    importGroupIdentityAsync(aidOrOptions: string | (ImportGroupIdentityOptions & {
+        aid?: string;
+    }), options?: ImportGroupIdentityOptions): Promise<Result<ImportGroupIdentityResult>>;
     private _beginAidOperation;
     private _resolveGateway;
     private _loadCachedGatewayUrl;

package/dist/aid-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aid-store.d.ts","sourceRoot":"","sources":["../src/aid-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"aid-store.d.ts","sourceRoot":"","sources":["../src/aid-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAW/B,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAkB,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGpG,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,MAAM,EAAE;QAAE,eAAe,EAAE,OAAO,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAA;KAAE,CAAC;CACjE,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AAC1D,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AACpD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AACvM,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,kBAAkB,EAAE,IAAI,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AACnG,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,kBAAkB,EAAE,IAAI,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/F,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AACxE,MAAM,MAAM,gBAAgB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,UAAU,GAAG;IAAE,UAAU,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AA0MnD,qBAAa,QAAQ;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,eAAe,CAAiB;gBAE5B,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB;IA+CD,KAAK,IAAI,IAAI;IAOP,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,GAAG,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IA+FtD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,GAAG,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAI/C,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAqBzC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAIlC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAUrF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAI9E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,UAAU,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IAkC5D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAczD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAmCxE,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAQvF,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAQjF,OAAO,CAAC,oBAAoB;YASd,mBAAmB;IAiB3B,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IA2BzF,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAmCtD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAuCxD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IA+ChD,mBAAmB,CACvB,YAAY,EAAE,MAAM,GAAG,CAAC,0BAA0B,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACtE,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAkE7C,wBAAwB,CACtB,YAAY,EAAE,MAAM,GAAG,CAAC,0BAA0B,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACtE,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;YAI/B,kBAAkB;YAelB,eAAe;YA+Bf,qBAAqB;YAoBrB,kBAAkB;YAWlB,oBAAoB;CASnC"}

package/dist/aid-store.js

@@ -360,14 +360,15 @@ export class AIDStore {
         }
         // 有效期检查（对齐 Python cert_time_error）
         const validity = parseCertValidity(certPem);
-        if (validity) {
-            const now = Date.now();
-            if (now > validity.notAfter) {
-                return resultErr(codes.CERT_EXPIRED, `certificate expired for aid: ${target}`);
-            }
-            if (now < validity.notBefore) {
-                return resultErr(codes.CERT_NOT_YET_VALID, `certificate not yet valid for aid: ${target}`);
-            }
+        if (!validity) {
+            return resultErr(codes.CERT_PARSE_ERROR, `certificate validity parse failed for aid: ${target}`);
+        }
+        const now = Date.now();
+        if (now > validity.notAfter) {
+            return resultErr(codes.CERT_EXPIRED, `certificate expired for aid: ${target}`);
+        }
+        if (now < validity.notBefore) {
+            return resultErr(codes.CERT_NOT_YET_VALID, `certificate not yet valid for aid: ${target}`);
         }
         // CN 校验（对齐 Python cert_common_name 检查）
         const cn = parseCertCN(certPem);
@@ -434,6 +435,9 @@ export class AIDStore {
             }),
         });
     }
+    loadAsync(aid) {
+        return this.load(aid);
+    }
     async list() {
         try {
             const aids = await this._keystore.listIdentities();
@@ -455,6 +459,9 @@ export class AIDStore {
             return resultErr('LIST_IDENTITIES_FAILED', String(exc), exc);
         }
     }
+    listAsync() {
+        return this.list();
+    }
     async changeSeed(oldSeed, newSeed) {
         try {
             const changed = await this._keystore.changeSeed?.(oldSeed, newSeed);
@@ -465,6 +472,9 @@ export class AIDStore {
             return resultErr(codes.PRIVATE_KEY_PARSE_ERROR, String(exc), exc);
         }
     }
+    changeSeedAsync(oldSeed, newSeed) {
+        return this.changeSeed(oldSeed, newSeed);
+    }
     async register(aid) {
         const target = String(aid ?? '').trim();
         try {
@@ -750,6 +760,77 @@ export class AIDStore {
             return resultErr(codes.REKEY_FAILED, String(exc), exc);
         }
     }
+    async importGroupIdentity(aidOrOptions, options = {}) {
+        const fromObject = typeof aidOrOptions === 'object' && aidOrOptions !== null ? aidOrOptions : {};
+        const target = String(typeof aidOrOptions === 'string' ? aidOrOptions : fromObject.aid ?? '').trim();
+        const privateKeyPem = String(options.private_key_pem ?? options.privateKeyPem ?? fromObject.private_key_pem ?? fromObject.privateKeyPem ?? '').trim();
+        const declaredPublicKeyDerB64 = String(options.public_key_der_b64 ?? options.publicKeyDerB64 ?? fromObject.public_key_der_b64 ?? fromObject.publicKeyDerB64 ?? '').trim();
+        const curve = String(options.curve ?? fromObject.curve ?? 'P-256').trim() || 'P-256';
+        const certPem = String(options.cert_pem ?? options.certPem ?? options.cert ?? fromObject.cert_pem ?? fromObject.certPem ?? fromObject.cert ?? '').trim();
+        if (!target)
+            return resultErr(codes.INVALID_AID_FORMAT, 'importGroupIdentity requires a non-empty aid');
+        if (!privateKeyPem)
+            return resultErr(codes.PRIVATE_KEY_PARSE_ERROR, 'importGroupIdentity requires private_key_pem');
+        if (!declaredPublicKeyDerB64)
+            return resultErr(codes.KEYPAIR_MISMATCH, 'importGroupIdentity requires public_key_der_b64');
+        if (!certPem)
+            return resultErr(codes.CERT_PARSE_ERROR, 'importGroupIdentity requires cert_pem');
+        try {
+            const certPub = publicKeyDerB64(certPem);
+            if (!certPub)
+                return resultErr(codes.CERT_PARSE_ERROR, `certificate parse failed for aid: ${target}`);
+            const validity = parseCertValidity(certPem);
+            if (!validity)
+                return resultErr(codes.CERT_PARSE_ERROR, `certificate validity parse failed for aid: ${target}`);
+            const now = Date.now();
+            if (now > validity.notAfter)
+                return resultErr(codes.CERT_CHAIN_BROKEN, `importGroupIdentity returned certificate is expired`);
+            if (now < validity.notBefore)
+                return resultErr(codes.CERT_CHAIN_BROKEN, `importGroupIdentity returned certificate is not_yet_valid`);
+            const cn = parseCertCN(certPem);
+            if (cn !== target) {
+                return resultErr(codes.CERT_CHAIN_BROKEN, `importGroupIdentity returned certificate CN mismatch: expected ${target}, got ${cn ?? ''}`);
+            }
+            if (certPub !== declaredPublicKeyDerB64) {
+                return resultErr(codes.KEYPAIR_MISMATCH, 'importGroupIdentity returned certificate public key mismatch');
+            }
+            try {
+                const privateKey = await importPrivateKeyEcdsa(privateKeyPem);
+                const probe = new TextEncoder().encode('aun-group-identity-import-self-test');
+                const sig = await ecdsaSignDer(privateKey, probe);
+                const pubKey = await importCertPublicKeyEcdsa(certPem);
+                const ok = await ecdsaVerifyDer(pubKey, sig, probe);
+                if (!ok) {
+                    return resultErr(codes.KEYPAIR_MISMATCH, `private key does not match certificate for aid: ${target}`);
+                }
+            }
+            catch (exc) {
+                return resultErr(codes.PRIVATE_KEY_PARSE_ERROR, `private key parse failed for aid: ${target}`, exc);
+            }
+            await this._keystore.saveIdentity(target, {
+                aid: target,
+                private_key_pem: privateKeyPem,
+                public_key_der_b64: declaredPublicKeyDerB64,
+                curve,
+                cert: certPem,
+            });
+            const loaded = await this.load(target);
+            if (!loaded.ok) {
+                return resultErr(loaded.error.code, loaded.error.message);
+            }
+            const signProbe = await loaded.data.aid.sign('aun-group-identity-import-self-test');
+            if (!signProbe.ok) {
+                return resultErr(codes.KEYPAIR_MISMATCH, signProbe.error.message);
+            }
+            return resultOk({ imported: true, aid: target });
+        }
+        catch (exc) {
+            return resultErr(codes.CERT_PARSE_ERROR, String(exc), exc);
+        }
+    }
+    importGroupIdentityAsync(aidOrOptions, options = {}) {
+        return this.importGroupIdentity(aidOrOptions, options);
+    }
     async _beginAidOperation(gatewayUrl, aidObj) {
         const clientNonce = this._registerFlow.newClientNonce();
         const phase1 = await this._registerFlow.shortRpc(gatewayUrl, 'auth.aid_login1', {