@agentunion/fastaun-browser 0.5.1 → 0.5.2

package/_packed_docs/INDEX.md

@@ -12,24 +12,26 @@
 | [AUN SDK 重构修改清单](AUN_SDK_重构修改清单.md) | 本轮 SDK 重构的实际修改点、测试结果和遗留事项 |
 | [AUNClient 拆分重构执行方案](design/AUNClient拆分重构执行方案.md) | Python / Go / TS / JS SDK AUNClient 内部拆分边界、执行步骤和验收矩阵 |
 | [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md) | AUNClient 完全门面化、ClientRuntime 单一状态源和四端分批迁移步骤 |
-| [跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md) | 多语言 SDK 同网同服、test-runner 控制面的跨语言 E2E 方案 |
-| [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md) | SDK bootstrap 能力声明 + 服务端 policy 控制 1DH/per-AID wrap 的兼容方案 |
+| [跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md) | 多语言 SDK 同网同服、test-runner 控制面的跨语言 E2E 方案 |
+| [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md) | SDK bootstrap 能力声明 + 服务端 policy 控制 1DH/per-AID wrap 的兼容方案 |
+| [E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md) | 当前 V2-only P2P / Group 明文与加密主链路、设备密钥注册和 pull/ack 时序 |
 | [AUN RPC Trace 增强设计](design/2026-05-22-aun-rpc-trace-enhancement.md) | RPC trace 诊断字段与 enter/exit span 设计 |
-| [AUN 服务端消息通信诊断面板方案](design/AUN服务端消息通信诊断面板方案.md) | aun-console 消息通信页的服务端可观察诊断面板总体方案 |
-| [服务端消息通信诊断面板 P0 方案](design/服务端消息通信诊断面板P0方案.md) | aun-console 消息通信页的服务端可观察 P0 诊断面板 |
-| [AUN 反向代理服务方案与 TDD 实施计划](design/AUN反向代理服务方案与TDD实施计划.md) | AUN Service Proxy、service_proxy 服务模块、SDK service-proxy-client、URL 路由、隧道协议、Web 边界和分阶段 TDD 落地计划 |
-| [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md) | 远程 agent.md per-AID 本地文件/IndexedDB 缓存、消息信封与 RPC 响应 ETag 透传方案 |
+| [AUN 服务端消息通信诊断面板方案](design/AUN服务端消息通信诊断面板方案.md) | aun-console 消息通信页的服务端可观察诊断面板总体方案 |
+| [服务端消息通信诊断面板 P0 方案](design/服务端消息通信诊断面板P0方案.md) | aun-console 消息通信页的服务端可观察 P0 诊断面板 |
+| [消息收件箱统一迁移方案](design/消息收件箱统一迁移方案.md) | P2P `message_inbox` 与群消息 `group_inbox` 的统一读模型、后台回填和旧表清理方案 |
+| [AUN 反向代理服务方案与 TDD 实施计划](design/AUN反向代理服务方案与TDD实施计划.md) | AUN Service Proxy、service_proxy 服务模块、SDK service-proxy-client、URL 路由、隧道协议、Web 边界和分阶段 TDD 落地计划 |
+| [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md) | 远程 agent.md per-AID 本地文件/IndexedDB 缓存、Gateway `_meta.agent_md_etags` 角色、消息信封 ETag 和注入节流方案 |
 | [SDK 文档索引](sdk/INDEX.md) | SDK 使用手册、RPC 手册、E2EE、Storage VFS、Group FS 和 Collab 的子索引 |
 | [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md) | SDK 文档按行区间渐进式查阅方法 |
 | [AUN CLI 手册](cli/CLI手册.md) | Python CLI 源码位置、安装运行入口、全局选项、profile 配置和主要命令集 |
 | [AUN CLI 设计文档](cli/AUN-CLI设计文档.md) | `python/src/aun_cli` 当前实现架构、命令注册面、配置解析、SDK 桥接和实现边界 |
 | [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、类 Linux 权限、mount/symlink、服务端分层和 direct backend 上传下载 |
 | [AUN Storage SDK 存储分层设计](<aun-fs/SDK存储分层设计.md>) | Python SDK StorageVFS / StorageLowLevel 接口契约、返回类型、错误映射和跨语言对齐要求 |
-| [AUN Storage CLI-fs 命令设计](<aun-fs/CLI-fs命令设计.md>) | `aun fs` 命令语义、寻址规则、输出格式、CLI 工程改造和端到端场景 |
-| [AUN Storage 分阶段实施计划](<aun-fs/分阶段实施计划.md>) | AUN Storage VFS + CLI 的 6 阶段 TDD 实施计划、P1-P6 实际执行记录和验收口径 |
-| [AUN FS POSIX 覆盖与补全计划](<aun-fs/aun-fs-completion-plan.md>) | Storage VFS 与 Group FS 对照 POSIX 命令的当前复审基线、缺口优先级、接口确认点和 step-by-step TDD 补全计划 |
-| [群文件系统 group.fs POSIX 化详细设计](<aun-fs/group-fs/group.fs-POSIX化详细设计.md>) | 统一为 `group.fs.*`、`client.group.fs.*` 和 `aun group fs` 的 POSIX 风格群文件系统设计；包含群自有区角色 ACL、`parents` 和 JS string 语义 |
-| [群自有区角色 ACL 写权限实施方案](<aun-fs/group-fs/群自有区角色ACL写权限实施方案.md>) | 群自有区 owner 默认写、admin 需 owner 显式 `role:admin` ACL 授权、group/storage 分工、Storage 写审计、显式撤销/查询和 TDD 执行计划 |
+| [AUN Storage CLI-fs 命令设计](<aun-fs/CLI-fs命令设计.md>) | `aun fs` 命令语义、寻址规则、输出格式、CLI 工程改造和端到端场景 |
+| [AUN Storage 分阶段实施计划](<aun-fs/分阶段实施计划.md>) | AUN Storage VFS + CLI 的 6 阶段 TDD 实施计划、P1-P6 实际执行记录和验收口径 |
+| [AUN FS POSIX 覆盖与补全计划](<aun-fs/aun-fs-completion-plan.md>) | Storage VFS 与 Group FS 对照 POSIX 命令的当前复审基线、缺口优先级、接口确认点和 step-by-step TDD 补全计划 |
+| [群文件系统 group.fs POSIX 化详细设计](<aun-fs/group-fs/group.fs-POSIX化详细设计.md>) | 统一为 `group.fs.*`、`client.group.fs.*` 和 `aun group fs` 的 POSIX 风格群文件系统设计；包含群自有区角色 ACL、`parents` 和 JS string 语义 |
+| [群自有区角色 ACL 写权限实施方案](<aun-fs/group-fs/群自有区角色ACL写权限实施方案.md>) | 群自有区 owner 默认写、admin 需 owner 显式 `role:admin` ACL 授权、group/storage 分工、Storage 写审计、显式撤销/查询和 TDD 执行计划 |
 | [群文件系统 group.fs POSIX 化分阶段实施计划](<aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md>) | group.fs 重构的 8 阶段实施计划，每阶段包含目标、IPO、Step-by-step、用例集、Checklist、验收与回滚，并记录 Phase 8 单域/双域 Docker 与四语言互操作验收 |
 | [系统目录保护方案](protocol/16-系统目录保护方案.md) | `memberdata` 与 `group_data` 的系统目录保护、`group_data` 目录树隐藏与读下载/写保护边界、Group FS 间接访问和真实 owner AID 配额归属 |
 | [collab 协作层服务端编排设计](<aun-fs/collab/2026-06-10-collab层服务端编排详细设计.md>) | collab 服务端编排、台账、diff3、snapshot、export/adopt、群协作注册表和四语言薄 SDK 设计 |
@@ -57,23 +59,23 @@
 
 ### SDK 使用与协议
 
-- Python / TS / Go / JS SDK 使用手册、RPC 参数、E2EE 机制、Storage VFS、Group FS、Collab GC/reflog/reset → [SDK 文档索引](sdk/INDEX.md)
+- Python / TS / Go / JS SDK 使用手册、RPC 参数、E2EE V2 机制、Storage VFS、Group FS、Collab GC/reflog/reset → [SDK 文档索引](sdk/INDEX.md)
 - 按主题和行区间查 SDK 文档 → [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md)
 - Python CLI 源码位置、安装运行入口、全局选项、profile 配置、身份/消息/群组/Storage/Group FS/Collab/诊断等命令用法 → [AUN CLI 手册](cli/CLI手册.md)
 - Python CLI 当前实现架构、`main.py` 命令注册、`CLISession` SDK 桥接、配置解析和实现边界 → [AUN CLI 设计文档](cli/AUN-CLI设计文档.md)
 - Storage SDK VFS、控制面/数据面分离、类 Linux 权限、mount/symlink、direct backend 上传下载和服务端分层 → [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>)
 - StorageVFS / StorageLowLevel 接口契约、NodeView/ObjectView、错误映射和跨语言对齐 → [AUN Storage SDK 存储分层设计](<aun-fs/SDK存储分层设计.md>)
-- `aun fs` 命令语义、AID 路径解析、输出格式和 CLI 到 SDK 的调用边界 → [AUN Storage CLI-fs 命令设计](<aun-fs/CLI-fs命令设计.md>)
-- AUN Storage 6 阶段 TDD 计划、P1/P2/P3/P4/P5/P6 实际执行记录、阶段实施前详细计划和 Docker 验证纪律 → [AUN Storage 分阶段实施计划](<aun-fs/分阶段实施计划.md>)
-- Storage VFS / Group FS 对 POSIX 命令的覆盖现状、过期状态修正、`lstat/readlink/quota/setfacl/du/head/tail/touch/getfacl` 的分阶段 TDD 补全步骤和新增 RPC 确认点 → [AUN FS POSIX 覆盖表](<aun-fs/aun-fs-posix-coverage.md>)、[AUN FS POSIX 补全计划](<aun-fs/aun-fs-completion-plan.md>)
-- `group.fs.*` POSIX 风格群文件系统、`client.group.fs.*`、`aun group fs`、`cp/mv` 上传下载心智、群自有区角色 ACL 与 `group_aid` 签名、`parents` 语义、JS string 差异、服务端 memberdata 映射和 SDK 数据面编排 → [群文件系统 group.fs POSIX 化详细设计](<aun-fs/group-fs/group.fs-POSIX化详细设计.md>)
-- 群自有区 owner 默认写、admin 需 owner 显式 `role:admin` ACL 授权与撤销/查询、group 与 storage 鉴权分工、Storage 写审计 → [群自有区角色 ACL 写权限实施方案](<aun-fs/group-fs/群自有区角色ACL写权限实施方案.md>)
+- `aun fs` 命令语义、AID 路径解析、输出格式和 CLI 到 SDK 的调用边界 → [AUN Storage CLI-fs 命令设计](<aun-fs/CLI-fs命令设计.md>)
+- AUN Storage 6 阶段 TDD 计划、P1/P2/P3/P4/P5/P6 实际执行记录、阶段实施前详细计划和 Docker 验证纪律 → [AUN Storage 分阶段实施计划](<aun-fs/分阶段实施计划.md>)
+- Storage VFS / Group FS 对 POSIX 命令的覆盖现状、过期状态修正、`lstat/readlink/quota/setfacl/du/head/tail/touch/getfacl` 的分阶段 TDD 补全步骤和新增 RPC 确认点 → [AUN FS POSIX 覆盖表](<aun-fs/aun-fs-posix-coverage.md>)、[AUN FS POSIX 补全计划](<aun-fs/aun-fs-completion-plan.md>)
+- `group.fs.*` POSIX 风格群文件系统、`client.group.fs.*`、`aun group fs`、`cp/mv` 上传下载心智、群自有区角色 ACL 与 `group_aid` 签名、`parents` 语义、JS string 差异、服务端 memberdata 映射和 SDK 数据面编排 → [群文件系统 group.fs POSIX 化详细设计](<aun-fs/group-fs/group.fs-POSIX化详细设计.md>)
+- 群自有区 owner 默认写、admin 需 owner 显式 `role:admin` ACL 授权与撤销/查询、group 与 storage 鉴权分工、Storage 写审计 → [群自有区角色 ACL 写权限实施方案](<aun-fs/group-fs/群自有区角色ACL写权限实施方案.md>)
 - `memberdata` 和 `group_data` 系统目录保护、`group_data` 目录树隐藏但读/下载不刻意隐藏、普通写入口保护、group.fs 授权写入路径、真实 owner AID 配额计入 → [系统目录保护方案](protocol/16-系统目录保护方案.md)
 - group.fs 8 阶段重构步骤、每阶段 IPO、Step-by-step、用例集、Checklist、验收、回滚和 Phase 8 Docker 完成记录 → [群文件系统 group.fs POSIX 化分阶段实施计划](<aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md>)
 - collab 协作层服务端编排、`collab.*` RPC、版本台账、snapshot、群协作注册表和后续四语言 SDK/CLI/E2E 计划 → [collab 协作层服务端编排设计](<aun-fs/collab/2026-06-10-collab层服务端编排详细设计.md>)、[Plan 1](<aun-fs/collab/2026-06-10-collab服务端编排-plan1.md>)、[Plan 2](<aun-fs/collab/2026-06-12-collab协作层-plan2.md>)、[Plan 3](<aun-fs/collab/2026-06-12-collab协作层-plan3.md>)
 - `client.notify()` 在线轻量通知、AID/群路由、跨域 federation 和不离线存储边界 → [Notify 通知方案](sdk/Notify通知方案.md)
 - 协议细节、子协议和消息格式 → [协议文档目录](protocol/)
-- agent.md 远程缓存、`remote_etag` / `local_etag`、消息信封 ETag 透传 → [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md)
+- agent.md 远程缓存、`remote_etag` / `local_etag`、`requester` / `peer` / `group` 角色、消息信封与 Gateway `_meta` ETag 透传 → [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md)
 
 ### Service Proxy 与服务暴露
 
@@ -84,15 +86,16 @@
 
 ### 诊断与可观测性
 
-- RPC trace span、跨模块诊断字段、安全字段白名单 → [AUN RPC Trace 增强设计](design/2026-05-22-aun-rpc-trace-enhancement.md)
-- aun-console 消息通信服务端可观察总体面板、事实/推断边界 → [AUN 服务端消息通信诊断面板方案](design/AUN服务端消息通信诊断面板方案.md)
-- 服务端可观察的消息通信 P0 面板、过滤语义、数据来源 → [服务端消息通信诊断面板 P0 方案](design/服务端消息通信诊断面板P0方案.md)
-- 测试日志路径、测试输出、容器日志查看 → [aun测试运行指南](aun测试运行指南.md)
+- RPC trace span、跨模块诊断字段、安全字段白名单 → [AUN RPC Trace 增强设计](design/2026-05-22-aun-rpc-trace-enhancement.md)
+- aun-console 消息通信服务端可观察总体面板、事实/推断边界 → [AUN 服务端消息通信诊断面板方案](design/AUN服务端消息通信诊断面板方案.md)
+- 服务端可观察的消息通信 P0 面板、过滤语义、数据来源 → [服务端消息通信诊断面板 P0 方案](design/服务端消息通信诊断面板P0方案.md)
+- P2P `message_inbox`、群消息 `group_inbox`、迁移期 fallback、后台 batch 回填和旧表 drop 收口 → [消息收件箱统一迁移方案](design/消息收件箱统一迁移方案.md)
+- 测试日志路径、测试输出、容器日志查看 → [aun测试运行指南](aun测试运行指南.md)
 - 跨语言 E2E trace 字段、日志产物、失败分类 → [跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
 
 ### E2EE 与跨语言一致性
 
-- SDK E2EE API、会话管理、ProtectedHeaders → [SDK 文档索引](sdk/INDEX.md)
+- SDK E2EE V2 API、会话管理、ProtectedHeaders、P2P/Group 当前主链路 → [SDK 文档索引](sdk/INDEX.md)、[E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md)
 - E2EE V2 1DH/per-AID wrap、bootstrap 能力声明、服务端 fanout → [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md)
 - 共享测试向量、transcript 回放、Python / TS / Go / JS 互通 → [aun测试运行指南](aun测试运行指南.md)、[跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
 
@@ -102,7 +105,7 @@
 
 ### aun测试运行指南
 
-记录当前 AUN 服务与 SDK 在 Docker 单域、双域环境中的实际测试入口。包含 Python、TypeScript、Go、JavaScript 四语言测试矩阵，Python / TypeScript / Go / JavaScript 跨语言容器 E2E 的 83 用例矩阵，覆盖 P2P 明文/E2EE、群聊 pairwise 明文/E2EE、三/四成员同群矩阵、storage ticket/ACL、group.fs 与 group.fs POSIX、collab 与 collab ACL、连续消息、ack、预期失败和混合明文/E2EE 场景，另包含固定身份目录、容器名、典型命令、浏览器 E2E、双域 federation 测试、Service Proxy 单域/双域 E2E 入口、message/group WAL 回归检查和数据保护规则。
+记录当前 AUN 服务与 SDK 在 Docker 单域、双域环境中的实际测试入口。包含 Python、TypeScript、Go、JavaScript 四语言测试矩阵，Python / TypeScript / Go / JavaScript 跨语言容器 E2E 的 83 用例矩阵，覆盖 P2P 明文/E2EE、群聊 pairwise 明文/E2EE、三/四成员同群矩阵、storage ticket/ACL、group.fs 与 group.fs POSIX、collab 与 collab ACL、连续消息、ack、预期失败和混合明文/E2EE 场景，另包含固定身份目录、bench-pairs16 性能身份池、uvloop bench 环境变量、Gateway 客户端 mock 网络延迟、`--perf-trace` 开关、容器名、典型命令、浏览器 E2E、双域 federation 测试、Service Proxy 单域/双域 E2E 入口、message/group WAL 回归检查和数据保护规则。
 
 ### AUN SDK 重构修改清单
 
@@ -132,21 +135,25 @@
 
 记录 aun-console“消息通信”页面的服务端可观察诊断总体方案。方案明确只展示 Gateway、Message/Group、Federation、Service Plane 和模块业务指标可观察事实，不依赖 SDK 诊断模式，不读取 SDK 本地状态，并定义发送端、接收端、消息 ID、Group ID、关键词和任意方向过滤语义。服务端自主 Trace 默认关闭，只能通过面板临时开启。
 
-### 服务端消息通信诊断面板 P0 方案
-
-定义 aun-console 消息通信页的 P0 服务端诊断面板。范围限定为 Gateway、Message/Group、Federation 和 Service Plane 可观察事实，不采集 SDK 本地状态。文档给出发送端、接收端、消息 ID、Group ID 和任意方向过滤语义，并定义服务端 Trace、投递路径、Pull/ACK/GAP、E2EE、Federation、Service Plane 六个子标签，其中服务端自主 Trace 是默认关闭的运行时开关，`message.ack` 需区分 RPC 与同名事件的设备字段语义。
-
-### AUN 反向代理服务方案与 TDD 实施计划
+### 服务端消息通信诊断面板 P0 方案
+
+定义 aun-console 消息通信页的 P0 服务端诊断面板。范围限定为 Gateway、Message/Group、Federation 和 Service Plane 可观察事实，不采集 SDK 本地状态。文档给出发送端、接收端、消息 ID、Group ID 和任意方向过滤语义，并定义服务端 Trace、投递路径、Pull/ACK/GAP、E2EE、Federation、Service Plane 六个子标签，其中服务端自主 Trace 是默认关闭的运行时开关，`message.ack` 需区分 RPC 与同名事件的设备字段语义。
+
+### 消息收件箱统一迁移方案
+
+定义 P2P `message_inbox` 与群消息 `group_inbox` 的统一 receiver 读模型。方案要求 SDK RPC 契约不变，`group_events` 保持独立；迁移期新写入只写新 inbox，旧表仅作为 source/fallback，后台仅在 writer queue 空闲时 batch 回填并删除旧 batch，确认完成后再执行旧表 drop 和旧 DDL/fallback 收口。
+
+### AUN 反向代理服务方案与 TDD 实施计划
 
 定义 AUN Service Proxy / AUN 服务代理的整体方案：服务侧新增 `service_proxy` 模块，`service-proxy-server` 负责公网 HTTP/HTTPS 入口、WSS 隧道、在线连接索引和协议桥接；SDK 侧 `service-proxy-client` 负责 provider 侧 embedded registry、本地 endpoint 调用和服务摘要上报。方案明确去掉 ACP GlobalRegistry/RSA 同步，URL 以 `https://proxy.{issuer}/{user_name}/{svc_name}/...` 为 canonical，`https://{user_name}.{issuer}/proxy/{svc_name}/...` 由 NameService 跳转；Web 服务推荐 host-root 模式，目录式 path-prefix 只做受限转发。文档还按 Phase 0 到 Phase 11 给出 TDD 实施步骤，记录 Phase 10 已新增宿主机进程内 7 类 HTTP/SSE/WS/NameService/Web/ACL/双域边界 E2E，以及单域和双域 Docker E2E 脚本入口；真实 Docker 执行仍需先满足模块启用、镜像包含新模块和 `/ws/client` AUN 身份 resolver 前置条件。
 
 ### 远程 agent.md 缓存与 ETag 透传方案
 
-定义每个远程 AID 在 SDK 内存和本地持久化记录中维护一条 agent.md 状态：Python / TypeScript / Go 使用 `{aun_path}/AIDs/{aid}/agent.md` 与 `agentmd.json`，浏览器 JavaScript 使用 IndexedDB logical key。方案同时规定 `message.send` 响应向发送端透传 `to` 的 agent.md ETag，消息信封向接收端透传 `from` 的 agent.md ETag，并给出按需下载、无条件 GET、304 兼容、竞态和跨 SDK 一致性规则。
+定义每个远程 AID 在 SDK 内存和本地持久化记录中维护一条 agent.md 状态：Python / TypeScript / Go 使用 `{aun_path}/AIDs/{aid}/agent.md` 与 `agentmd.json`，浏览器 JavaScript 使用 IndexedDB logical key。方案规定 Gateway 在 RPC response / event push 的 `_meta.agent_md_etags` 中按 `requester`、`peer`、`group` 注入元数据，保留旧别名兼容，并通过 300 秒正缓存、60 秒负缓存和默认 60 秒发送节流控制热路径开销；Message Service V2 P2P 信封携带 `agent_md.sender`。四端 SDK 自动观察 `_meta` 和信封 `agent_md.sender/group`，写入 `remote_etag` / `last_modified`，并遵守按需下载、无条件 GET、304 兼容、竞态和跨 SDK 一致性规则。
 
 ### SDK 文档索引
 
-`docs/sdk/INDEX.md` 是 SDK 手册的三层子索引，覆盖快速开始、WebSocket 协议、核心概念、连接认证、E2EE、API 手册、错误处理、最佳实践、payload、Service Proxy、Storage VFS、Group FS、Collab GC/reflog/reset 和各类 RPC 手册。
+`docs/sdk/INDEX.md` 是 SDK 手册的三层子索引，覆盖快速开始、WebSocket 协议、核心概念、连接认证、E2EE V2、API 手册、错误处理、最佳实践、payload、Service Proxy、Storage VFS、Group FS、Collab GC/reflog/reset 和各类 RPC 手册。
 
 ### Service Proxy RPC 手册
 
@@ -158,7 +165,7 @@
 
 ### AUN CLI 手册
 
-面向 CLI 使用者，说明 Python CLI 位于 `D:\modelunion\kite\aun-sdk-core\python\src\aun_cli`，安装后入口为 `aun`，也可通过 `python -m aun_cli` 运行。文档列出全局选项、`~/.aun/cli.toml` profile 配置、身份、P2P 消息、群组、`aun group fs`、`aun fs`、对象存储、Collab、agent.md、keys、诊断和 bench 命令集；其中 Storage VFS 覆盖 `touch/du/quota/getfacl`，Group FS 覆盖 `setfacl/getfacl` 角色 ACL，并给出常用示例和退出码。
+面向 CLI 使用者，说明 Python CLI 位于 `D:\modelunion\kite\aun-sdk-core\python\src\aun_cli`，安装后入口为 `aun`，也可通过 `python -m aun_cli` 运行。文档列出全局选项、`~/.aun/cli.toml` profile 配置、身份、P2P 消息、群组、`aun group fs`、`aun fs`、对象存储、Collab、agent.md、keys、诊断和 bench 命令集；其中 Storage VFS 覆盖 `touch/du/quota/getfacl`，Group FS 覆盖 `setfacl/getfacl` 角色 ACL，并给出常用示例和退出码。
 
 ### AUN CLI 设计文档
 
@@ -176,21 +183,21 @@
 
 定义 `aun fs` 命令组的用户语义和工程落地方式。文档覆盖 `ls/stat/cat/cp/mv/rm/mkdir/ln/df` 等命令、`<AID>:<path>` 寻址规则、操作者身份来源、Typer 命令组注册、路径解析工具、现有 `storage_core.py` 迁移、端到端场景和输出格式规范。
 
-### AUN Storage 分阶段实施计划
-
-把 AUN Storage 架构、SDK 分层和 CLI 设计落地为 6 个 TDD 阶段。文档记录 P1 VFS 基础读写层、P2 symlink 原语、P3 `storage.fs.*` 统一 RPC、P4 ACL/token、P5 四语言 SDK/CLI 对齐和 P6 mount/umount 的实际修改范围、执行顺序、单元/集成/E2E 覆盖内容、Docker 内 Python/TS/Go 实测结果、JS 浏览器 Playwright Storage VFS P6 E2E 补跑结果、公网验证口径修正，以及 P6 退群自动失效和完整虚拟卷生命周期等遗留边界；并在每阶段开始前展开服务端表/RPC 变更、任务依赖图、可并行工作包、TDD 执行步骤和 Docker 验证纪律。
-
-### AUN FS POSIX 覆盖与补全计划
-
-`aun-fs-posix-coverage.md` 按 POSIX 命令对照 Storage VFS 与 Group FS 的 CLI、SDK、LowLevel、RPC 覆盖情况，列出 `touch/du/readlink/lstat/group.fs.getfacl/head/tail/quota/group fs setfacl` 等缺口和架构不适用项。`aun-fs-completion-plan.md` 在 2026-06-26 代码复审后修正过期判断，记录当前真实基线，并按 TDD 拆解 Phase 0 基线护栏、P0-A CLI 快速补齐、P0-B 客户端聚合、P0-C `storage.fs.touch` 与 `group.fs.get_acl/list_acl` 新 RPC、SDK 别名和低优先级能力；每项包含 Red/Green/Refactor、涉及文件、验收命令、接口确认点和回滚策略。
-
-### 群文件系统 group.fs POSIX 化详细设计
-
-定义群文件系统对外模型：统一为 `group.fs.*`、`client.group.fs.*` 和 `aun group fs`。文档规定群自有区与成员 `memberdata` 由 `group_aid:/...` 路径表达；群自有区允许当前 `group_aid` 证书签名、默认 `role:owner`、以及 owner 通过 `group.fs.set_acl` 显式授权后的 `role:admin` 写入，撤销使用 `group.fs.remove_acl`，查询使用 `group.fs.get_acl/list_acl`；`group_aid:/memberdata/{member_ref}/...` 在服务端映射到 `member_aid:/group_data/{group_aid}/...`，跨域成员必须使用完整 AID；上传、下载和远程复制统一用 `cp`，不提供 `read/write/put/get` 主入口，数据面由 SDK 编排，group 服务只负责控制面。
+### AUN Storage 分阶段实施计划
+
+把 AUN Storage 架构、SDK 分层和 CLI 设计落地为 6 个 TDD 阶段。文档记录 P1 VFS 基础读写层、P2 symlink 原语、P3 `storage.fs.*` 统一 RPC、P4 ACL/token、P5 四语言 SDK/CLI 对齐和 P6 mount/umount 的实际修改范围、执行顺序、单元/集成/E2E 覆盖内容、Docker 内 Python/TS/Go 实测结果、JS 浏览器 Playwright Storage VFS P6 E2E 补跑结果、公网验证口径修正，以及 P6 退群自动失效和完整虚拟卷生命周期等遗留边界；并在每阶段开始前展开服务端表/RPC 变更、任务依赖图、可并行工作包、TDD 执行步骤和 Docker 验证纪律。
+
+### AUN FS POSIX 覆盖与补全计划
+
+`aun-fs-posix-coverage.md` 按 POSIX 命令对照 Storage VFS 与 Group FS 的 CLI、SDK、LowLevel、RPC 覆盖情况，列出 `touch/du/readlink/lstat/group.fs.getfacl/head/tail/quota/group fs setfacl` 等缺口和架构不适用项。`aun-fs-completion-plan.md` 在 2026-06-26 代码复审后修正过期判断，记录当前真实基线，并按 TDD 拆解 Phase 0 基线护栏、P0-A CLI 快速补齐、P0-B 客户端聚合、P0-C `storage.fs.touch` 与 `group.fs.get_acl/list_acl` 新 RPC、SDK 别名和低优先级能力；每项包含 Red/Green/Refactor、涉及文件、验收命令、接口确认点和回滚策略。
+
+### 群文件系统 group.fs POSIX 化详细设计
+
+定义群文件系统对外模型：统一为 `group.fs.*`、`client.group.fs.*` 和 `aun group fs`。文档规定群自有区与成员 `memberdata` 由 `group_aid:/...` 路径表达；群自有区允许当前 `group_aid` 证书签名、默认 `role:owner`、以及 owner 通过 `group.fs.set_acl` 显式授权后的 `role:admin` 写入，撤销使用 `group.fs.remove_acl`，查询使用 `group.fs.get_acl/list_acl`；`group_aid:/memberdata/{member_ref}/...` 在服务端映射到 `member_aid:/group_data/{group_aid}/...`，跨域成员必须使用完整 AID；上传、下载和远程复制统一用 `cp`，不提供 `read/write/put/get` 主入口，数据面由 SDK 编排，group 服务只负责控制面。
 
 ### 群自有区角色 ACL 写权限实施方案
 
-定义群自有区写权限调整方案。群自有区是 `owner_aid = group_aid` 下除系统保留根外的整个 namespace，不与群主或管理员个人 storage 混用；owner 默认可写，admin 只有在 owner 通过 `group.fs.set_acl` 显式授予 `role:admin` ACL 后可写，并通过 `group.fs.remove_acl` 撤销、`group.fs.get_acl/list_acl` 查询。方案还规定 `group.set_role` 只改变 membership、不联动 ACL，`memberdata` / `group_data` 规则不变，Storage 写权限与控制面写入口均记录 `storage.write_auth` 审计，并给出 storage、group.fs、collab 和 CLI 的 TDD 执行计划。
+定义群自有区写权限调整方案。群自有区是 `owner_aid = group_aid` 下除系统保留根外的整个 namespace，不与群主或管理员个人 storage 混用；owner 默认可写，admin 只有在 owner 通过 `group.fs.set_acl` 显式授予 `role:admin` ACL 后可写，并通过 `group.fs.remove_acl` 撤销、`group.fs.get_acl/list_acl` 查询。方案还规定 `group.set_role` 只改变 membership、不联动 ACL，`memberdata` / `group_data` 规则不变，Storage 写权限与控制面写入口均记录 `storage.write_auth` 审计，并给出 storage、group.fs、collab 和 CLI 的 TDD 执行计划。
 
 ### 系统目录保护方案
 

package/_packed_docs/KITE_DOCS_GUIDE.md

@@ -16,7 +16,7 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 - SDK 使用与协议：`docs/INDEX.md` L57-75。
 - Service Proxy 与服务暴露：`docs/INDEX.md` L76-81。
 - 诊断与可观测性：`docs/INDEX.md` L83-89。
-- E2EE 与跨语言一致性：`docs/INDEX.md` L91-95。
+- E2EE 与跨语言一致性：`docs/INDEX.md` L94-98。
 
 ### Step 3：需要判断文档价值时读 Layer 3 摘要
 
@@ -35,16 +35,19 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | AUNClient 巨类拆分重构执行方案 | `docs/design/AUNClient拆分重构执行方案.md` L3-252、L253-698、L699-803 |
 | AUNClient 完全门面化与 Runtime 状态迁移细化方案 | `docs/design/AUNClient门面化与Runtime状态迁移细化方案.md` |
 | 测试环境数据保护规则 | `docs/aun测试运行指南.md` L45-60 |
-| 单域 Docker 测试容器和命令 | `docs/aun测试运行指南.md` L105-494 |
-| 跨语言容器 E2E 执行方式 | `docs/aun测试运行指南.md` L139-263 |
+| 单域 Docker 测试容器和命令 | `docs/aun测试运行指南.md` L105-494 |
+| P2P bench 标准流程、bench-pairs16、uvloop、Gateway mock 延迟和 perf-trace | `docs/aun测试运行指南.md` L318-385 |
+| 跨语言容器 E2E 执行方式 | `docs/aun测试运行指南.md` L139-263 |
 | 双域 federation 测试容器和命令 | `docs/aun测试运行指南.md` L496-694 |
 | 何时 rebuild / restart | `docs/aun测试运行指南.md` L696-739 |
 | 测试故障排查 | `docs/aun测试运行指南.md` L742-779 |
 | 跨语言容器 E2E 背景与目标 | `docs/design/跨语言容器E2E测试方案.md` L5-35 |
-| E2EE V2 1DH/per-AID wrap 方案 | `docs/design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md` |
-| 服务端消息通信诊断总体方案 | `docs/design/AUN服务端消息通信诊断面板方案.md` L3-47 |
-| 服务端消息通信 P0 诊断面板 | `docs/design/服务端消息通信诊断面板P0方案.md` L3-73 |
-| AUN Service Proxy 总体架构、参考项目与边界 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L3-127 |
+| E2EE V2 1DH/per-AID wrap 方案 | `docs/design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md` |
+| E2EE V2 当前 P2P/Group 主链路 | `docs/sdk/E2EE_V2消息通信时序图.md` |
+| 服务端消息通信诊断总体方案 | `docs/design/AUN服务端消息通信诊断面板方案.md` L3-47 |
+| 服务端消息通信 P0 诊断面板 | `docs/design/服务端消息通信诊断面板P0方案.md` L3-73 |
+| P2P / Group 消息 inbox 统一迁移与旧表清理 | `docs/design/消息收件箱统一迁移方案.md` |
+| AUN Service Proxy 总体架构、参考项目与边界 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L3-127 |
 | AUN Service Proxy URL、注册、隧道协议和 Web 边界 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L129-384 |
 | AUN Service Proxy 服务列表注册、双注册和 wakeup 路由 | `docs/sdk/09-proxy-rpc-manual.md` L1-226、`docs/protocol/06-服务协议.md` L43-204 |
 | AUN Service Proxy 不影响现有接口的约束 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L385-422 |
@@ -59,19 +62,19 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | 跨语言日志、trace、身份隔离、CLI 定位 | `docs/design/跨语言容器E2E测试方案.md` L514-576 |
 | 失败分类与落地阶段 | `docs/design/跨语言容器E2E测试方案.md` L579-625 |
 | 与现有测试环境的关系和验收标准 | `docs/design/跨语言容器E2E测试方案.md` L627-665 |
-| agent.md 远程缓存目标与字段 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L5-86 |
-| agent.md ETag 透传时序图 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L88-185 |
-| agent.md 服务端与 SDK 实现流程 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L187-268 |
-| agent.md 本地持久化、竞态和测试点 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L269-317 |
+| agent.md 远程缓存目标与字段 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L5-127 |
+| agent.md ETag 透传时序图 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L129-239 |
+| agent.md 服务端与 SDK 实现流程 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L241-319 |
+| agent.md 本地持久化、竞态和测试点 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L321-370 |
 | SDK API、RPC、E2EE、Storage VFS、Group FS、Collab GC/reflog/reset 使用细节 | `docs/sdk/AUN_DOCS_GUIDE.md` |
-| AUN Python CLI 源码位置、安装入口、全局选项、profile 配置和主要命令集 | `docs/cli/CLI手册.md` L3-322 |
+| AUN Python CLI 源码位置、安装入口、全局选项、profile 配置和主要命令集 | `docs/cli/CLI手册.md` L3-325 |
 | AUN Python CLI 当前实现架构、命令注册、SDK 桥接和实现边界 | `docs/cli/AUN-CLI设计文档.md` L3-265 |
 | AUN Storage 架构、SDK VFS、direct backend 数据面、类 Linux 权限和 mount/symlink | `docs/aun-fs/AUN Storage架构设计.md` L16-47、L74-120、L183-228、L289-315 |
 | AUN Storage SDK VFS / LowLevel 接口契约和错误映射 | `docs/aun-fs/SDK存储分层设计.md` L20-112、L169-317 |
-| AUN Storage CLI `aun fs` 命令语义和输出格式 | `docs/aun-fs/CLI-fs命令设计.md` L26-61、L89-207、L279-399 |
-| AUN Storage 分阶段 TDD 计划、P1/P2/P3/P4/P5/P6 执行记录、P6 mount/umount 验收和阶段验证纪律 | `docs/aun-fs/分阶段实施计划.md` L24-37、L108-1013、L1015-1071 |
-| AUN FS POSIX 覆盖现状、过期状态修正、缺口优先级和 step-by-step TDD 补全计划 | `docs/aun-fs/aun-fs-posix-coverage.md` L14-224、`docs/aun-fs/aun-fs-completion-plan.md` L9-66、L93-142、L144-257、L259-353、L355-608、L698-790 |
-| group.fs POSIX 化群文件系统详细设计、memberdata 服务端映射、SDK 数据面编排、群自有区角色 ACL 授权/撤销/查询、`parents` 和 `cp/mv` 语义 | `docs/aun-fs/group-fs/group.fs-POSIX化详细设计.md` L1-611 |
+| AUN Storage CLI `aun fs` 命令语义和输出格式 | `docs/aun-fs/CLI-fs命令设计.md` L26-61、L89-207、L279-399 |
+| AUN Storage 分阶段 TDD 计划、P1/P2/P3/P4/P5/P6 执行记录、P6 mount/umount 验收和阶段验证纪律 | `docs/aun-fs/分阶段实施计划.md` L24-37、L108-1013、L1015-1071 |
+| AUN FS POSIX 覆盖现状、过期状态修正、缺口优先级和 step-by-step TDD 补全计划 | `docs/aun-fs/aun-fs-posix-coverage.md` L14-224、`docs/aun-fs/aun-fs-completion-plan.md` L9-66、L93-142、L144-257、L259-353、L355-608、L698-790 |
+| group.fs POSIX 化群文件系统详细设计、memberdata 服务端映射、SDK 数据面编排、群自有区角色 ACL 授权/撤销/查询、`parents` 和 `cp/mv` 语义 | `docs/aun-fs/group-fs/group.fs-POSIX化详细设计.md` L1-611 |
 | 群自有区 owner 默认写、admin 需 owner 显式 `role:admin` ACL 授权与撤销、Storage 写审计和 TDD 计划 | `docs/aun-fs/group-fs/群自有区角色ACL写权限实施方案.md` |
 | `memberdata` / `group_data` 系统目录保护、`group_data` 目录树隐藏与读下载/写保护边界、Group FS 授权路径和配额归属 | `docs/protocol/16-系统目录保护方案.md` |
 | group.fs POSIX 化分阶段实施计划、每阶段 IPO、Step-by-step、用例集、Checklist、验收、回滚和 Phase 8 Docker 完成记录 | `docs/aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md` L1-1324 |