@agentunion/fastaun-browser 0.5.4 → 0.5.8

package/_packed_docs/agent.md/SCHEMA.md

@@ -4,18 +4,21 @@
 
 ## 限制
 
-- **文件大小**: 最大 4KB
+- **文件大小**: 被签名 payload 最大 4KB（尾部签名块不计入）
+- **签名块大小**: 尾部签名载体最大 2KB（2048 字节，按 UTF-8 原始字节计算）
+- **请求读取上限**: `PUT /agent.md` 最多读取 `payload_max + signature_max` 字节；超出即返回 `413 agent_md_too_large`，不执行证书查询、数据库或缓存写入
+- **编码**: UTF-8
 
 ## 文件格式
 
-agent.md 文件采用 **YAML frontmatter + Markdown 内容 + 签名块（可选，位于文件尾部）** 的格式：
+agent.md 文件采用 **YAML frontmatter + Markdown 内容 + 签名块（必需，位于文件尾部）** 的格式：
 
 ```markdown
 ---
 # YAML 元数据 (核心字段)
 aid: "agent-name.aid.pub"
 name: "Agent Name"
-type: "assistant"
+type: "agent"
 version: "1.0.0"
 description: "一句话描述"
 tags:
@@ -26,14 +29,15 @@ tags:
 # Markdown 正文内容
 详细说明、Skills、使用示例等...
 
-<!-- AUN-SIGNATURE
-cert_fingerprint: sha256:abc123...
-timestamp: 1715300000
-signature: MEUCIQDx...
--->
+<!-- AUN-SIGNATURE
+cert_fingerprint: sha256:abc123...
+public_key_fingerprint: sha256:def456...
+timestamp: 1715300000
+signature: MEUCIQDx...
+-->
 ```
 
-无签名的文件仍然合法，第一行直接以 `---` 开头。
+上传接收契约要求签名块存在且有效；无签名文件只可作为本地草稿或只读示例，不得通过 `PUT /agent.md`。
 
 ## 签名块规范
 
@@ -45,47 +49,57 @@ signature: MEUCIQDx...
 
 ```
 <!-- AUN-SIGNATURE
-cert_fingerprint: sha256:<hex>
-timestamp: <unix_seconds>
-signature: <base64_der>
--->
-```
-
-- **cert_fingerprint**: 签名证书的 SHA-256 指纹，格式 `sha256:<64位hex>`
-- **timestamp**: 签名时刻的 Unix 时间戳（秒）
-- **signature**: ECDSA P-256 签名的 DER 编码，Base64 表示
+cert_fingerprint: sha256:<hex>
+public_key_fingerprint: sha256:<hex>
+timestamp: <unix_seconds>
+signature: <base64_der>
+-->
+```
+
+- **cert_fingerprint**（必填）: X.509 证书 DER 的 SHA-256 指纹，格式 `sha256:<64位hex>`；不得使用公钥指纹代替
+- **public_key_fingerprint**（可选）: SubjectPublicKeyInfo DER 的 SHA-256 指纹，格式 `sha256:<64位hex>`
+- **timestamp**: 签名时刻的 Unix 时间戳（秒）
+- **signature**: ECDSA P-256 / SHA-256 签名的 DER 编码，使用严格 Base64 表示
 
 ### 签名计算
 
-1. **被签内容（payload）**：签名块开始标记 `<!-- AUN-SIGNATURE` 之前的全部字节
-2. **哈希**：对 payload 计算 SHA-256
-3. **签名**：使用 NIST P-256 私钥对哈希值进行 ECDSA 签名
+1. **被签内容（payload）**：签名块开始标记 `<!-- AUN-SIGNATURE` 之前的全部 UTF-8 字节，换行和空白均不得规范化
+2. **哈希**：对 payload 计算 SHA-256
+3. **签名**：使用证书对应的 NIST P-256 私钥执行 ECDSA 签名，结果采用 DER 编码
 
 ### 验签流程
 
-1. 检测文件尾部是否存在 `<!-- AUN-SIGNATURE` 签名块
+1. 检测文件尾部是否存在且只能存在一个 `<!-- AUN-SIGNATURE` 签名块
 2. 提取签名块中的 `cert_fingerprint`、`timestamp`、`signature`
 3. 剥离签名块，取剩余内容为 payload
 4. 对 payload 计算 SHA-256
-5. 通过 `cert_fingerprint` 查找对应证书，获取公钥
-6. 使用公钥验证 ECDSA 签名
+5. 通过 `cert_fingerprint` 查找对应证书，获取公钥
+6. 确认证书公钥为 NIST P-256，并使用 ECDSA / SHA-256 验证签名
 
 ### 约束
 
-- 签名块必须是文件的最后一个可见块（后面只允许可忽略的空白）
-- 签名块与正文之间应至少保留一个换行
-- 签名块不计入 4KB 文件大小限制
+- 签名块必须是文件的最后一个可见块（后面只允许可忽略的空白）
+- 签名块必须从新行开始，因此 payload 的最后一个原始字节必须是 `LF` 或 `CR`；SDK 不得自动补换行或改写 payload
+- frontmatter 与签名块均接受 `LF`、`CRLF` 或 `CR` 行尾；解析签名块时可识别行尾，但不得据此改写 payload
+- 签名块只能包含上述四个字段；除 `public_key_fingerprint` 外均为必填；重复字段和未知字段必须拒绝
+- 签名块不计入 4KB 文件大小限制，但自身不得超过 2048 字节；服务端必须在解析和证书查询前拒绝超限载体
+- `timestamp` 最多允许比服务端时间快 300 秒，不设置过去时间窗口，并且必须落在证书有效期内
+- `aid`、Host、Bearer Token 和签名证书 AID 必须一致
+- agent.md 上传签名算法固定为 ECDSA P-256 / SHA-256；其他曲线或密钥类型必须拒绝
+- 签名证书必须由当前 Issuer CA 返回，状态为 `active_signing` 且处于有效期内；证书 Subject CN 必须等于 AID
+- `PUT /agent.md` 成功验收后，文档不得仅因签名证书随后自然过期而失效；历史验签仍须确认 `timestamp` 落在该证书的有效期内
+- 服务端在数据库和缓存写入前完成全部校验；任一校验失败均拒绝接收
 
 ## YAML Schema (核心字段)
 
 ```yaml
 # ===== 身份标识 (必填) =====
-aid:
-  type: string
-  required: true
-  pattern: "^[a-zA-Z0-9_-]+\\.aid\\.pub$"
-  description: "Agent 的唯一身份标识 (AID 格式)"
-  example: "lobster.aid.pub"
+aid:
+  type: string
+  required: true
+  pattern: "^[A-Za-z0-9_][A-Za-z0-9_-]*(?:\\.[A-Za-z0-9_][A-Za-z0-9_-]*)+$"
+  description: "至少两个标签的 DNS 型 AID；Issuer 后缀不固定，比较时不区分大小写"
+  example: "lobster.agentid.pub"
 
 # ===== 基本信息 =====
 name:
@@ -94,16 +108,15 @@ name:
   description: "Agent 显示名称"
   example: "Code Reviewer"
 
-type:
-  type: string
-  required: true
-  enum:
-    - human          # 真人用户
-    - assistant      # 通用助手
-    - avatar         # 用户化身/分身
-    - openclaw       # OpenClaw AI 助手
-    - codeagent      # 代码编程 Agent
-  description: "Agent 类型"
+type:
+  type: string
+  required: true
+  predefined_values:  # 预设值，不是封闭枚举
+    - human          # 真人用户
+    - agent          # AI 助手
+    - group          # 群组
+  allow_extensions: true
+  description: "Agent 类型；允许使用未预设的扩展值"
 
 version:
   type: string
@@ -127,24 +140,36 @@ tags:
   description: "用于分类和检索"
 ```
 
-## Agent Type 说明
-
-| Type | 用途 | 示例 |
-|------|------|------|
-| `human` | 真人用户 | 开发者、管理员、终端用户 |
-| `assistant` | 通用对话助手 | 聊天机器人、客服 |
-| `avatar` | 用户分身 | 代表用户行动的 agent |
-| `openclaw` | OpenClaw AI 助手 | 本地个人助手、ACP 桥接 |
-| `codeagent` | 代码编程 Agent | Claude Code、Cursor Agent |
+## Agent Type 说明
+
+`type` 是可扩展字符串。下表只定义当前预设值；解析方必须保留并容忍未知类型，不得因其不在预设列表中拒绝 agent.md。
+
+| 预设 Type | 用途 | 示例 |
+|------|------|------|
+| `human` | 真人用户 | 开发者、管理员、终端用户 |
+| `agent` | 通用 Agent | 对话助手、代码 Agent、自动化 Agent |
+| `group` | 群组身份 | 项目团队、协作群组 |
 
 ## 示例文件
 
-| 文件 | Type | AID | 说明 |
-|------|------|-----|------|
-| [human-developer.md](examples/human-developer.md) | `human` | `zhangsan.aid.pub` | 全栈开发者 |
-| [openclaw-lobster.md](examples/openclaw-lobster.md) | `openclaw` | `lobster.aid.pub` | OpenClaw AI 助手（无签名） |
-| [signed-openclaw-lobster.md](examples/signed-openclaw-lobster.md) | `openclaw` | `lobster.aid.pub` | OpenClaw AI 助手（带签名） |
-| [codeagent-claudecode.md](examples/codeagent-claudecode.md) | `codeagent` | `claudecode.aid.pub` | Claude Code 编程助手 |
+| 文件 | Type | AID | 说明 |
+|------|------|-----|------|
+| [human-developer.md](examples/human-developer.md) | `human` | `zhangsan.aid.pub` | 全栈开发者 |
+| [openclaw-lobster.md](examples/openclaw-lobster.md) | `agent` | `lobster.aid.pub` | OpenClaw AI 助手（无签名） |
+| [signed-openclaw-lobster.md](examples/signed-openclaw-lobster.md) | `agent` | `lobster.aid.pub` | OpenClaw AI 助手（带签名） |
+| [codeagent-claudecode.md](examples/codeagent-claudecode.md) | `agent` | `claudecode.aid.pub` | Claude Code 编程助手 |
+| [群组-开发团队.md](examples/群组-开发团队.md) | `group` | `dev-team.aid.pub` | 开发团队协作群组 |
+
+表中无签名文件仅用于展示 payload 格式，不符合 `PUT /agent.md` 接收契约；静态签名示例也不代表可由线上 CA 验证的有效身份材料。
+
+## `PUT /agent.md` 接收顺序
+
+1. SDK 在联网前校验 UTF-8、payload 大小、frontmatter Schema；失败时不得签名或发起 HTTP 请求。
+2. SDK 使用当前 AID 的签名私钥追加签名块，再执行一次完整 Schema 校验和本地验签；失败时不得上传。
+3. Name Service 完成 Bearer Token 与 Host 绑定校验、完整 Schema 校验、CA 证书查询和验签。
+4. 只有全部校验成功后，Name Service 才能写入数据库并失效缓存。
+
+接收失败使用稳定的机器可读错误：格式或签名无效返回 `400 invalid_agent_md`，payload 超限返回 `413 agent_md_too_large`，CA 不可用返回 `503 certificate_verification_unavailable`，数据库不可用返回 `503 database_unavailable`。
 
 ## Markdown 部分建议内容
 

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

@@ -1,7 +1,7 @@
 ---
 aid: "claudecode.aid.pub"
 name: "Claude Code"
-type: "codeagent"
+type: "agent"
 version: "1.0.0"
 description: "Anthropic 官方代码助手，终端内的 AI 编程伙伴"
 

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

@@ -1,7 +1,7 @@
 ---
 aid: "lobster.aid.pub"
 name: "Lobster"
-type: "openclaw"
+type: "agent"
 version: "1.0.0"
 description: "OpenClaw 个人 AI 助手，支持 ACP 协议通信"
 

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

@@ -1,7 +1,7 @@
 ---
 aid: "lobster.aid.pub"
 name: "Lobster"
-type: "openclaw"
+type: "agent"
 version: "1.0.0"
 description: "OpenClaw 个人 AI 助手，支持 ACP 协议通信"
 

package/_packed_docs/audit/AUN/346/234/215/345/212/241Go/345/214/226/351/207/215/346/236/204/347/262/276/347/273/206/345/214/226/346/272/220/347/240/201/345/256/241/346/237/245-20260718.md

@@ -0,0 +1,366 @@
+# AUN 服务 Go 化重构精细化源码审查与修复结论
+
+> 初始审查日期：2026-07-18
+> 修复复审日期：2026-07-19
+> 审查对象：当前工作树中的 10 个 Go 化 AUN 服务及对应 Python 实现
+> 服务范围：`auth`、`ca`、`gateway`、`group`、`leaderboard`、`message`、`nameservice`、`service_proxy`、`storage`、`stream`
+> 基线：`ce56814a110e07497c7ee393b4673c1068badcc5` 加本轮工作树修复
+> 测试约束：Go 只在 Docker/Linux 中编译和测试，未使用宿主机 Go 或 Windows 可执行文件
+
+## 1. 最终结论
+
+本报告初审和对 Claude Code 报告的复审中，能够由当前源码确认的安全、并发、性能、功能和字段级差异均已完成源码修复或被证实为误报。对本报告列出的已知问题，当前开放状态为：
+
+| 严重度 | 修复前代表问题 | 当前开放数 |
+| --- | --- | ---: |
+| P0 | 短 SHA panic、签名 canonicalization 阻断、audit wrap 绕过 | 0 |
+| P1 | 鉴权绕过、数据一致性、死锁/竞态、关键功能和破坏性字段 gap | 0 |
+| P2 | 默认值、错误码、附加/缺失字段、资源边界和极端输入差异 | 0 |
+
+最终判定：
+
+1. 在已审查的调用链、功能和 RPC/request/response/event 字段范围内，未发现仍可由当前源码确认的 Go/Python 破坏性 gap。
+2. 已发现的双版本共同缺陷也同时修复，未通过“与 Python 一致”保留 Python 侧已知错误。
+3. 十个 Go 服务均在 `golang:1.24-bookworm` 中通过全包 `go test -race`、`go vet` 和 `gofmt` 检查。
+4. 对应 Python 服务的 `codex-unit` 与服务根目录测试在 Linux 容器中合计通过 `2345` 条，没有跳过项。
+5. 本结论是源码审查和容器单元/组件测试结论，不等价于真实 MySQL、Redis、对象存储、单域和双域 federation 的运行证明。按照工程规则，本轮没有启动 Kite；动态 E2E 边界见第 8 节。
+
+## 2. 审查方法与调用链
+
+审查不以历史报告为事实来源。Claude Code 报告仅作为检查清单，每条结论重新回到当前 Go/Python 源码、生产 wiring 和测试验证。
+
+每个服务均按下列层次检查：
+
+1. 启动、配置、控制中心发现和 Gateway service-plane attach。
+2. HTTP/WS/JSON-RPC 入口、请求解析、身份注入、方法授权和 dispatcher。
+3. service、repository、DB/Redis、WAL、文件系统和外部 RPC。
+4. response、event、异步队列、重试、重连和关闭路径。
+5. request/response/event 的字段名、类型、null/空值、默认值、错误码和处理时点。
+6. goroutine/task、channel/queue、mutex、文件句柄、事务和网络超时边界。
+
+| 服务 | 核心调用链 |
+| --- | --- |
+| Auth | `service.attach -> auth RPC -> CA/证书校验 -> token repository/fallback -> response` |
+| CA | `service.attach -> issue/renew/rekey/revoke/CT -> issuer/repository -> response/event` |
+| Gateway | `client/service WS -> auth/ACL/dispatcher -> local service/federation -> response/event fanout` |
+| Group | `group RPC -> membership/E2EE/duty/Group FS -> store/WAL -> push/event` |
+| Leaderboard | `ingest event -> pending journal -> batch aggregate -> metric repository -> query/status` |
+| Message | `send/v2.send -> auth/rate/audit -> WAL/transaction -> inbox/push -> pull/ack/recall` |
+| NameService | `HTTP/RPC -> name/Agent.md validation/repository/cache -> snapshot/proxy -> response` |
+| Service Proxy | `public HTTP/WS -> route/wakeup -> provider tunnel/frame queue -> client response` |
+| Storage | `RPC/data HTTP -> auth/ACL/mount/symlink -> repository/blob/collab -> event` |
+| Stream | `create -> WS push -> history/puller queue -> SSE pull -> created/closed event` |
+
+## 3. Service By Service 修复结论
+
+### 3.1 Auth
+
+- attach 握手失败时立即关闭局部 WebSocket，重试不再泄漏连接和文件描述符。
+- Gateway business 连接关闭时先让最后一帧 handler 获得一次调度；Go attach 的 drain 先释放写锁再等待在途请求，消除同连接回调造成的互锁；draining 检查和 inflight admission 由同一把锁线性化，关闭后不会再放入新请求。
+- `create_aid` 的 already-exists 恢复链可达；CA chain 失败采用与 Python 相同的降级语义。
+- DB 健康时以 DB 为权威，不再让 JSONL fallback 遮蔽撤销状态；refresh consume 增加并发 fence。
+- DB pool 增加连接数、空闲数和寿命边界。
+- `auth.verify(method=aid)` 明确调用 `verifyAID`，不会额外签发 refresh token或触发续证。
+- 登录证书比较、token prefix、identity 状态、renew/rekey 错误码和 response aliases 已与 Python 基准对齐；停止态统一返回 `-32020`。
+
+结论：Auth 已审查链路没有开放 gap。
+
+### 3.2 CA
+
+- Dispatch 只在锁内获取不可变状态快照，不再持 `RLock` 跨 DB/Gateway I/O。
+- Gateway business 连接关闭时先让最后一帧 handler 获得一次调度；Go attach 的 drain 锁顺序与 Auth 对齐，不再持锁等待在途回调，draining 与 inflight admission 同样线性化。
+- P-384 CT 使用 SHA-384；CT canonical JSON、Unicode、浮点和微秒时间格式与 Python 对齐。
+- renew/rekey 的 `key_purpose`、`aid_type`、chain 和证书字段语义统一。
+- `get_cert` 的 lifecycle、curve、purpose、排序、CA 自身证书和历史十进制 serial fallback 对齐。
+- verify-chain、generate-service-cert、revoke 幂等和 CRL 时间字段的错误/response 契约对齐。
+- service signature 证书强制校验 NotBefore/NotAfter；CT signer 失败向上传播，不再生成空签名记录。
+- service signature nonce 保持单次消费；Python/Go 重放表均使用锁保护、默认 100000 的硬容量和按过期时间有序的 FIFO，满时 fail-closed 且不驱逐未过期 nonce，正常消费摊还 O(1)；测试签名器也改为每次生成唯一 nonce。
+
+结论：CA 已审查链路没有开放 gap。
+
+### 3.3 Gateway
+
+- 客户端签名采用排序、紧凑、非 HTML 转义 canonical JSON，并兼容 Python legacy hash 规则。
+- Python relay `Session` 补齐 `module_id`，StatsTap 不再因 `AttributeError` 静默丢弃 leaderboard ingest。
+- service-plane 同时执行模块能力矩阵和 attach 声明方法 ACL；方法名大小写敏感，`collab` 只接受完整 `collab.*` 声明。
+- stale attach、同 instance 接管和连接 ownership 使用实例身份校验，旧连接不能删除新连接。
+- Kernel/event 队列改为有界、可唤醒、可配置的异步扇出；成功发送后才登记 dedup。
+- Python StatsTap 修复错误 session 属性；Go StatsTap 测试不再并发替换全局 stdout，消除测试竞态。
+- federation insecure 仅允许显式测试环境，生产 fail-closed；出站连接、connecting 状态和目标数均有上限及清理。
+- discovery TTL/stale、canary、least-pending、attach weight 校验、nonce TTL和状态字段已统一。
+- 在线 client signature 只接受当前 `active_signing` 生命周期证书；跨域按 AID 拉取对端当前证书，再对声明和实际指纹做常量时间比较，不能用 fingerprint 直接选中历史证书。
+
+结论：Gateway 已审查链路没有开放 gap。
+
+### 3.4 Group
+
+- async dispatch、WAL batch appender 和 shutdown 的关闭顺序改为幂等、可取消，不再 send-on-closed、nil channel 阻塞或无限等待。
+- `.group` baseline、protected 标记、owner/admin role ACL和 `baseline_role_acls_synced` 已对齐。
+- ban/admin、邀请码消费回滚、aid_cert、transfer history和 rekey state-chain 已对齐；过期 owner transfer 同时校验 pending.old_owner 和当前 owner 仍为 actor，陈旧 pending 不能覆盖后来所有权。
+- recall 默认窗口、重复 ID 事务语义、recent cache 清理和 fallback event 已对齐；Go production wiring 读取 `recall_window_seconds`，环境变量显式 `0` 可关闭窗口。
+- `v2.pull` 可见性 floor、设备游标、`has_more`、ack 上界和 Redis highwater 采用 fail-closed/单调策略。
+- `v2.pull` 的 legacy/plain 分支也执行与 Python `_member_can_receive_message` 等价的 join sequence、`min_read_epoch` 和成员可见性过滤。
+- duty 副作用移到成员、ban、active 和限流校验之后；在线管理员按群实时解析。
+- pull、pull_events、ack、state、invite、device、ban 等 response 补齐 `group_id`、`group_aid`、`cursor`、`e2ee_epoch_floor`；事件补齐 `group_aid`。
+- `fs.namespace_ready` 等 Group FS 确认写入校验当前 `group_identity` 证书指纹，不能用历史或非当前群身份证书签名确认 namespace。
+- `add_member` 及 open join、审批、邀请码等实际入群路径对本域 AID 执行 verified certificate 注册校验；缺失、过期或身份不匹配均 fail-closed，跨域保持 Python 的容错语义。
+- checkpoint replace、RESP bulk read和 slot/device 隔离键处理已修复跨平台及短读边界。
+
+结论：Group 已审查链路没有开放 gap。
+
+### 3.5 Leaderboard
+
+- ingest 使用真实内存聚合和批量提交，不再每个事件独立 insert/locking transaction。
+- 增加周期 pending recovery loop，临时 DB 故障不必等进程重启。
+- 实时 flush 和 recovery 均在事务内锁定并确认 event 状态；混合 processed/pending 快照不写入不可拆分的内存聚合，而从 durable `raw_json` 精确恢复，避免跨实例双计或永久卡住。
+- event ID、agent、group 和 edge 均按稳定主键顺序加锁/写入；Go recovery 与实时批次共用排序，Python 失败标记也按 event ID 排序，消除多实例交叉锁死顺序。
+- 已由其他实例处理的快照返回实际 applied 数，不再虚增 processed/flush 指标。
+- agent/group/edge 水位按事件时间和 ID 单调推进，乱序旧事件不能回退最新水位。
+- attach dispatch worker 可取消，避免连接级队头阻塞和关闭泄漏。
+- status/health 不再对全部 pending payload 做 O(N) JSON decode；DB 探测和恢复边界收口。
+
+结论：Leaderboard 已审查链路没有开放 gap。
+
+### 3.6 Message
+
+- Gateway pending response、断线清理和 fatal wakeup 改为锁外非阻塞通知，消除满 channel 持锁死锁。
+- WAL fsync/rotate 串行化；soft/hard latency backpressure、fatal 唤醒和 checkpoint 行为对齐。
+- 有事务执行器时，多设备 legacy 写入的查询、序号分配和写入位于同一事务；非事务 executor 明确为受控降级。
+- `v2.send` 强制 audit wrap，设备 wrap 只要求当前活跃目标，不错误拒绝历史 wrap。
+- pull/ack 的 device/slot 严格绑定认证上下文；recent cache 使用真实 KnownMaxSeq。
+- 普通 send 的 protected headers、headers、context和 client signature 进入 envelope；跨域 metadata 同样保留。
+- recall TTL 由服务端策略计算，成功和无 tombstone 路径都发布对齐事件。
+- pending rate limit 已接真实 Gateway attach `PendingCount`；legacy/V2 send 均在背压时原子预占，无背压成功后也记录窗口，不再由 WAL 状态误判或让 V2 绕过；push worker 增加 wakeup，并对齐 EMA、重试优先级和队列 floor。
+- Redis sequence allocator 只在 pair 首次使用或 Redis key 被驱逐时回查 durable floor，后续号段分配不再每个 block 往返 MySQL。
+- WAL 开关读取 `message_config.json` 的 `wal_enabled`；仅非空 `AUN_MESSAGE_WAL_ENABLED` 覆盖配置，显式 `0` 可关闭，空值回退配置，与 Python 优先级一致。
+
+结论：Message 已审查链路没有开放 gap。
+
+### 3.7 NameService
+
+- host-root reverse proxy 增加完整 header/body/upstream timeout。
+- Agent.md 仅经 `PUT /agent.md` 完成严格校验后写入 DB 并更新缓存；DB 故障 GET/PUT 分别返回对齐的服务错误，不使用文件镜像降级。
+- snapshot 和 Agent.md 覆盖替换使用平台实现；Linux 使用原子 rename，Windows 使用 replace 语义。
+- snapshot 全量按 `aid`、增量按 `(updated_at, aid)` 做 keyset 分页，避免 OFFSET 漂移和大表退化。
+- cache、证书缓存和 runtime reconnect 竞态已收口；proxy diagnostics 使用可注入时钟，补齐 `connection_id` trace/filter、稳定排序和汇总，host-root 事件也进入诊断，URL 敏感参数统一脱敏。
+- Python `/health` 补齐 `database_ready`，Go/Python 状态字段和 redirect 语义对齐。
+- Python `_init_db()` 增加幂等保护，ASGI startup 不会用未连接实例覆盖测试或生产 wiring 已注入、已连接的 DB。
+
+结论：NameService 已审查链路没有开放 gap。
+
+### 3.8 Service Proxy
+
+- provider frame queue 同时限制条数和字节；超限在单 queue 锁内原子注入 request-scoped terminal frame，只终止对应请求，不再断开 provider 并连带失败其他 HTTP/WS 请求。
+- HTTP request body、response header/body和 WS frame 都有 deadline/size 边界；provider HTTP status 与 WS close code 在两种实现中均先校验，Python 接受合法私有区间 `4000..4999`。
+- `lastWakeup` 增加 TTL和容量清理；provider services 读写统一加锁。
+- host-root routing 字符集、private client allowlist和 loopback 规则对齐。
+- wakeup event 补齐 `request_id`、`trace_id`、`_trace`；诊断字段执行白名单。
+- 生命周期、Gateway RPC timeout和 provider 断开清理均可取消。
+
+结论：Service Proxy 已审查链路没有开放 gap。
+
+### 3.9 Storage
+
+- `complete_upload(skip_blob=true)` 在构造 CAS key 前验证 64 位十六进制 SHA-256，短值不能 panic。
+- share Bearer 必须经 verifier 解析为 AID；空 `allowed_aids` 被拒绝，owner 访问不误消费无关 token。
+- 群 public/private 读取都验证实时 membership；群自有区写入已接当前 `group_identity` 指纹验证。
+- 系统路径、memberdata、ACL/token、legacy move/delete、symlink repoint和 collab target 统一执行 owner/root 守卫。
+- mount lease 保存 requester；锁前执行 `epoch -> fresh membership -> epoch`，锁内复核本地 mount/volume epoch，且不持 DB 锁跨 Gateway RPC。
+- LocalFS 下载流式处理 Range；stable URL resolver 已接生产 wiring；resolver 热切换使用同步保护。
+- cleanup 接入磁盘阈值，补删除事件/副作用；legacy 缺 SHA 对象也清理物理 blob。
+- collab diff 输出合法 unified diff，show/merge/restore 统一守卫并记录 error audit。
+- 群 collab root 的 authority/group identity 可按 Python 语义绕过不存在的 self-membership 行；普通请求者仍要求实时 membership。
+- `collab.set_acl/remove_acl` 仅由解析后的 storage owner 管理，不再额外要求该 owner 当前仍是群成员。
+- console owner limit 与 Python 对齐为 500，default bucket 按最近更新时间选择。
+
+结论：Storage 已审查链路没有开放 gap。跨服务撤权语义为：通过 preflight 的在途请求允许完成，撤权后的新请求被拒绝；不宣称跨服务事务可取消已提交写入。
+
+### 3.10 Stream
+
+- history 和每个 puller queue 都有总字节预算，超限行为可预测。
+- Gateway business 断连清理先让已接收的最后一帧获得一次调度，再取消未完成 task，避免合法 `get_info` 等请求被静默丢弃。
+- SSE history/live 交界按 seq 去重，同一 chunk 不重复交付。
+- 自动 seq 在 MaxInt64 前拒绝溢出。
+- metadata 使用紧凑 JSON 字节数计限并做嵌套深拷贝，调用方后续修改不会并发污染 stream 状态；空 `content_type` 和 nullable `target_aid` 与 Python 对齐。
+- completed retention 默认值和配置语义对齐；活跃 puller/每次输出都会 touch，idle cleanup 不会误关慢消费者。
+
+结论：Stream 已审查链路没有开放 gap。
+
+## 4. RPC 字段级对齐结果
+
+下表列出本轮发生过破坏性差异的主要字段。字段“已对齐”表示请求接受范围、response/event 字段及默认/null 语义已按 Python 基准修复；诊断性附加字段仅在不破坏调用方时保留。
+
+| 服务/接口 | Request 对齐 | Response 对齐 | Event 对齐 |
+| --- | --- | --- | --- |
+| Auth create/renew/rekey/verify | method、purpose、证书和 fallback 语义 | `created`、`cert`、`cert_sn/serial`、chain、token prefix、错误码 | token/证书状态不再因 fallback 产生陈旧结果 |
+| CA cert/CT/revoke | curve、purpose、lifecycle、serial、canonical hash | `aid_type`、`key_purpose`、chain、时间和 found/null | CT/SCT 输入、撤销事件时间一致 |
+| Gateway attach/client RPC | namespace/method、weight、nonce、签名 hash | stale instance、状态/统计字段一致 | dispatch trace、dedup、超时和重试一致 |
+| Group pull/admin/state | device metadata、recall、invite、ack floor | `group_id`、`group_aid`、`cursor`、`has_more`、`e2ee_epoch_floor` | message/state/recall/membership 事件补齐群标识 |
+| Leaderboard ingest/status | 批量 ingest 和事件时间 | processed/queued、水位和 backlog 语义一致 | 乱序事件不回退水位 |
+| Message send/pull/ack/recall | auth device/slot、audit wrap、metadata、TTL | ack/count/floor 和错误码一致 | envelope metadata、recall 和跨域字段一致 |
+| NameService Agent.md/health | DB 故障、keyset cursor、redirect | HTTP 状态、`database_ready`、缓存状态一致 | snapshot/诊断不暴露敏感值 |
+| Service Proxy route/wakeup | service 名、allowlist、body/frame 限制 | timeout、断开和错误语义一致 | `request_id`、`trace_id`、`_trace` 补齐 |
+| Storage upload/share/fs/collab | SHA、Bearer、membership、lease、target | stable URL、Range、console limit/default、delete 字段 | object delete、collab error和 volume 通知一致 |
+| Stream create/push/pull | metadata 字节、content type、seq | retention、queue overflow和 pull cursor 一致 | nullable target、created/closed 字段一致 |
+
+## 5. 安全、并发与性能闭合
+
+| 风险簇 | 修复结果 |
+| --- | --- |
+| 远程 panic | Storage SHA 在切片前完成长度和 hex 校验，并有回归测试 |
+| 鉴权/授权 | Gateway service-plane ACL、Storage share/group/collab、Message audit、Group 本域入群证书、CA service signature 均 fail-closed |
+| 重放/签名 | canonical JSON 跨语言一致；nonce 单次消费、有 TTL、硬容量和摊还 O(1) FIFO 清理，容量洪泛不能驱逐未过期记录 |
+| 死锁/永久阻塞 | Gateway/Message pending、Group dispatch/WAL、可取消 attach worker 均使用锁外通知和幂等关闭；Leaderboard 跨实例事务按稳定主键顺序加锁 |
+| 数据竞态 | resolver、provider map、StatsTap、缓存和 ownership 热切换均已同步；十服务 `-race` 通过 |
+| 事务/一致性 | Message 多设备事务、Storage lease epoch、Group cursor/highwater、Leaderboard event 状态/水位均保证单调或 fail-closed，跨实例 recovery 不双计 |
+| 内存/队列 | Gateway event、Proxy frame、Stream history/puller、CA nonce 和 federation 连接均有条数/字节/并发上限 |
+| 慢连接 | HTTP body/header、WS frame、Gateway fanout和 service RPC 均有 deadline/cancel |
+| 大表性能 | NameService keyset pagination、Leaderboard batch、Storage streaming Range和 status O(1) 路径已落地 |
+| 文件可靠性 | WAL fsync/rotate、snapshot replace、cleanup 和 legacy blob 删除边界已修复；Agent.md 不使用文件副本 |
+
+当前源码未见新的锁顺序环、持锁网络 I/O、send-on-closed-channel 或无界外部输入队列。
+
+## 6. 历史结论与 Claude Code 报告复审
+
+### 6.1 本报告原问题编号
+
+| 服务 | 原编号 | 当前状态 |
+| --- | --- | --- |
+| Auth | AUTH-1..5 | 全部修复 |
+| CA | CA-1..4 | 全部修复 |
+| Gateway | GATEWAY-1、REVIEW-P0-1 | 全部修复 |
+| Group | GROUP-1..11 | 全部修复或由更严格生产 wiring 消除条件 |
+| Leaderboard | LEADERBOARD-1..6 | 源码缺陷全部修复；真实 DB failover 仍属动态验证 |
+| Message | MESSAGE-1..6、REVIEW-P0-2 | 全部修复 |
+| NameService | NAMESERVICE-1..4 | 全部修复 |
+| Service Proxy | SERVICE-PROXY-1..6 | 全部修复 |
+| Storage | STORAGE-1..8、REVIEW-P1-01 | 全部修复 |
+| Stream | STREAM-1..4 | Go/Python 共同缺陷同步修复 |
+
+### 6.2 Claude 60 条已确认项
+
+Claude 原统计为 P0×3、P1×31、P2×26。重新读源码后的修复前判断是：
+
+- 59 条事实有效：原 P0 #3 因有“已持群身份”前提降为 P1，但仍需修复。
+- 1 条已经过时：原 P1 #4 `auth.verify(method=aid)` 在复审前已改走 `verifyAID`。
+- 59 条有效问题现在均已关闭；过时项继续不计缺陷。
+- Claude 自行驳回的 4 条经复审仍为误报，不因本轮修复重新计数。
+
+其中 P2 F01-F24、F26 的破坏性接受范围、字段或资源差异均已修复；F25 是 Go 可配置 retention 的附加能力，默认行为已经对齐，不构成兼容 bug。
+
+### 6.3 Claude 76 条候选
+
+修复前逐条复审统计经本轮源码再核修正为：4 条上调 P1、58 条确认/条件性 P2、6 条并入已存在根因、7 条驳回或不构成 bug、1 条待动态验证。此前草稿将 C71、C72 列为驳回，属于分类错误。
+
+当前处理结果：
+
+| 类别 | 编号/数量 | 当前状态 |
+| --- | --- | --- |
+| 上调 P1 | C26、C27、C48、C74 | federation、highwater、collab guard 已修复 |
+| 确认/条件性 P2 | 58 条（含 C71、C72） | 可操作源码差异已修复；C64 Redis 号段仅首次/驱逐时回查 durable floor，C71 群 collab-root authority 和 C72 ACL mutation 额外成员门槛均已按 Python 语义修复 |
+| 合并根因 | C10、C14、C31、C42、C50、C53 | 对应 CT、签名、Group 字段、Leaderboard batch、Message rate limit 根因已修复 |
+| 驳回/非 bug | C01、C02、C20、C41、C49、C61、C76 | 维持驳回，不计修复数 |
+| 原待动态 C70 | Windows replace | 已实现平台专用 replace；服务端目标为 Linux，本轮未运行 Windows 服务 |
+
+因此，Claude 的“60 条确认 + 76 条候选”没有作为数量直接叠加；合并项、误报、过时项和同根因只处理一次。当前没有从该清单遗留的已知源码缺陷。
+
+### 6.4 修复过程中新增发现
+
+修复时额外发现并关闭：
+
+- Gateway StatsTap 测试并发替换 `os.Stdout` 的 race。
+- Gateway attach 方法声明大小写和 `collab.*` 完整方法名边界。
+- NameService OFFSET 分页在并发更新下跳行/重复及大表退化。
+- NameService ASGI startup 重复初始化覆盖已注入 DB 的生命周期缺陷。
+- Storage mount membership 检查持 DB 锁跨 Gateway RPC 的潜在锁放大。
+- Storage console default bucket 与 Python“最近更新”语义不一致。
+- CA 测试签名器固定 nonce 与生产重放保护冲突。
+- Python Gateway 旧测试未声明新增的 service-plane 能力。
+- Message WAL 开关忽略 `message_config.json`，只读取环境变量。
+- Group 实际入群路径缺少 Python 已有的本域 AID CA 注册校验。
+- Gateway federation batch/event fanout 先为每个输入创建 task/goroutine、再进入 semaphore，16 MiB 帧内突发小请求仍可耗尽调度器；两端改为固定 worker 分片并保持结果顺序。
+- Gateway Python rate/diagnostic/federation 动态 map 只有时间清理没有硬 key 上限；补充容量上限、TTL 淘汰和 `_other` 聚合，Go/Python 统计字段保持兼容。
+- Message Kernel 入站 `system.require_init` 与 observed event 原先脱离连接级任务预算；补充去重、任务集合、预算丢弃和断开/关闭等待回收。
+- Service Proxy Python 对未知 provider `request_id` 会新建 pending stream queue；改为仅接受已登记且未完成的请求，并限频记录丢弃。
+- Storage S3/OSS/COS 在安全读取上限之后才构造 Range，可能仍向后端请求超大范围；改为先 clamp、校验整数溢出和 nil body，再读取有界内容。
+- Auth、Storage 及其他服务的随机 ID/nonce 生成路径曾忽略熵源失败的安全边界；统一采用可检查的 `io.ReadFull` 和 fail-closed/唯一性回退，并补故障测试。
+- Auth/CA/Gateway/Message/Service Proxy/Stream 的 WebSocket 入站帧缺少统一上限；按 Python 语义补充 16 MiB（Stream 数据面保留 64 MiB）限制。
+- Auth/CA/Stream/Gateway Python business/service-plane 关闭路径存在最后一帧 task 竞态；统一增加一次事件循环让渡并补回归测试。
+- Auth/CA Go gatewayattach 的 drain 曾持写锁等待在途请求，而在途 handler 可能反向调用同连接 `Call`；改为锁外等待并加入同连接回调死锁测试。
+- Gateway Python `Session.module_id` 缺失会使 StatsTap 记录异常被吞；补齐字段、边界测试和事件计数回归。
+- Gateway Python `entry.py` 消息循环存在一处不可编译的缩进；已按事件/RPC 分支恢复正确层级，并通过十服务 `compileall`。
+- 上述 Python 关闭让渡在外层取消时会先回收已创建 task 再传播 `CancelledError`，避免修复断连竞态后留下后台 task。
+- Auth/CA Go attach 的 draining 检查与 inflight 增量之间仍有 admission 窗口；改为同锁线性化，drain 开始后不再接纳新请求。
+- CA service signature 证书曾缺 NotBefore/NotAfter 校验，nonce 表只有 TTL 且每次全表扫描；两种实现同步补证书有效期、并发保护、硬容量和有序过期队列。
+- Gateway Go 跨域在线签名 resolver 曾按调用方 fingerprint 拉取历史证书；改为拉取对端当前证书后再比较实际指纹。
+- Group 过期 owner transfer 只检查 actor、未确认 pending.old_owner 与当前 owner；Go recall window 也未接 production 配置，均已修复。
+- Leaderboard 多实例实时 flush/recovery 曾可能双计、卡住混合状态批次或以不同 metric row 顺序形成数据库死锁；两种实现统一状态锁、durable recovery 和稳定锁顺序。
+- Message pending rate limit 曾错误依赖 WAL 且 V2 路径可绕过；改为读取 Gateway attach pending，并统一 legacy/V2 预占和成功记账。
+- Service Proxy frame queue 溢出曾断开整个 provider；改为 request-scoped 终止，并补 provider HTTP status/WS close code 输入校验。
+- Stream metadata 只复制顶层 map，调用方修改嵌套值可与服务读并发；改为深拷贝隔离，并由 `codex-unit/stream/test_stream_entry.py::test_stream_session_metadata_isolated_from_callers_and_info_consumers` 覆盖构造入参和 `to_info()` 返回值的嵌套 mutation。
+
+这些问题均已修复并纳入容器回归。
+
+## 7. Docker/Linux 验证证据
+
+### 7.1 Go
+
+环境：
+
+- 镜像：`golang:1.24-bookworm`
+- 源码：只挂载工作树
+- module cache：`C:\go\pkg\mod -> /go/pkg/mod:ro`
+- `GOPROXY=off`、`GOTOOLCHAIN=local`
+- 未调用宿主机 `go`，未生成或运行 Windows exe
+
+对以下十个服务逐一执行：
+
+```text
+go test -race ./... -count=1 -timeout=300s  # 大包使用 600s 上限
+go vet ./...
+gofmt -l .
+```
+
+结果：Auth、CA、Gateway、Group、Leaderboard、Message、NameService、Service Proxy、Storage、Stream 全部退出码 0；`gofmt -l` 无输出。
+
+### 7.2 Python
+
+环境：`aun-sdk-tester:latest` Linux Python 测试容器；临时测试容器内安装 `asyncmy`、`aiomysql` 和 `fakeredis`。`codex-unit` 与存在测试的服务根目录分别使用独立 pytest 进程；服务根目录套件通过容器 `--network host` 连接测试 MySQL。此隔离避免不同服务的同名 `tests.conftest` 和进程级 nonce/cache 相互污染。
+
+| 服务 | `codex-unit` passed | 服务根目录 passed | 合计 passed | skipped |
+| --- | ---: | ---: | ---: | ---: |
+| Auth | 64 | - | 64 | 0 |
+| CA | 66 | 29 | 95 | 0 |
+| Gateway | 270 | 61 | 331 | 0 |
+| Group | 275 | 434 | 709 | 0 |
+| Leaderboard | 19 | 2 | 21 | 0 |
+| Message | 133 | 270 | 403 | 0 |
+| NameService | 89 | - | 89 | 0 |
+| Service Proxy | 123 | - | 123 | 0 |
+| Storage | 150 | 225 | 375 | 0 |
+| Stream | 50 | 85 | 135 | 0 |
+| 合计 | **1239** | **1106** | **2345** | **0** |
+
+十服务 `compileall` 同样在该 Linux 容器中通过，本轮没有 skip。FastAPI/Starlette/aiohttp 和 `datetime.utcnow()` deprecation warning 不影响本轮断言，但应在依赖升级任务中单独处理。Message 根目录套件首次启动时 Python 3.13 在 `pytest_asyncio` collection 内发生一次原生段错误，业务测试尚未执行；随后两个全新 pytest 进程均为 `270 passed`，表中只计一轮，保留为测试运行器/依赖稳定性风险而非服务断言失败。
+
+## 8. 动态验证边界
+
+以下不是当前已确认 bug，而是源码和隔离测试无法证明的运行边界：
+
+1. 真实 MySQL/Redis 故障、重连、主从切换和长事务下的时序。
+2. 单域/双域 federation 的真实证书、DNS、连接池和断网恢复。
+3. S3/OSS、大文件 Range、磁盘水位和长时间 cleanup。
+4. Python/Go 混合服务逐 RPC 的在线 golden capture。
+5. 高并发撤权与跨服务在途请求的实际线性化窗口。
+
+工程规则禁止本轮直接启动 Kite，因此没有运行需要重建并启动完整服务编排的集成/E2E。发布前应由用户按 Docker 测试指南重建服务镜像并执行单域、双域和故障注入；失败应作为新的运行证据回到对应调用链，而不回退本报告已经由源码和 race 测试闭合的结论。
+
+## 9. 最终判定
+
+截至 2026-07-19 当前工作树：
+
+- 本报告和 Claude Code 清单中成立的已知源码 gap/bug 已全部修复。
+- 当前开放 P0/P1/P2 为 `0/0/0`。
+- Go 与 Python 在已审查接口和默认行为上达到源码级等价。
+- Go 十服务已满足 Docker/Linux 单元、竞态、vet 和格式化门槛；Python 对应测试全部通过。
+- 是否允许生产全量切换，最后仍取决于第 8 节的真实 Docker Compose 单域/双域 E2E，而不是继续保留已经修复的静态缺陷。