@agentunion/fastaun-browser 0.5.19 → 0.5.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +129 -78
- package/_packed_docs/CHANGELOG.md +129 -78
- package/_packed_docs/INDEX.md +201 -195
- package/_packed_docs/KITE_DOCS_GUIDE.md +93 -90
- package/_packed_docs/agent.md/SCHEMA.md +7 -7
- package/_packed_docs/agent.md//350/277/234/347/250/213agent.md/347/274/223/345/255/230/344/270/216etag/351/200/217/344/274/240/346/226/271/346/241/210.md +11 -11
- package/_packed_docs/protocol/06-/346/234/215/345/212/241/345/215/217/350/256/256.md +1072 -1072
- package/_packed_docs/protocol/10-Group-/345/255/220/345/215/217/350/256/256.md +676 -676
- package/_packed_docs/protocol/11-Storage-/345/255/220/345/215/217/350/256/256.md +8 -12
- package/_packed_docs/protocol/Ownership/345/215/217/350/256/256/345/256/232/344/271/211.md +443 -0
- package/_packed_docs/protocol/Ownership/345/215/217/350/256/256/345/256/232/344/271/2112.0.md +161 -0
- package/_packed_docs/protocol/Ownership/345/215/217/350/256/256/345/256/232/344/271/2112.1.md +658 -0
- package/_packed_docs/protocol/Ownership/345/215/217/350/256/256/345/256/232/344/271/2113.0.md +233 -0
- package/_packed_docs/protocol/agent.md/SCHEMA.md +1 -1
- package/_packed_docs/sdk/03-/346/240/270/345/277/203/346/246/202/345/277/265.md +1 -1
- package/_packed_docs/sdk/04-/350/277/236/346/216/245/344/270/216/350/256/244/350/257/201.md +67 -63
- package/_packed_docs/sdk/05-E2EE/345/212/240/345/257/206/351/200/232/344/277/241.md +1 -1
- package/_packed_docs/sdk/06-API/346/211/213/345/206/214.md +35 -8
- package/_packed_docs/sdk/08-/346/234/200/344/275/263/345/256/236/350/267/265.md +3 -3
- package/_packed_docs/sdk/09-group-rpc-manual.md +258 -254
- package/_packed_docs/sdk/09-message-rpc-manual.md +7 -4
- package/_packed_docs/sdk/09-storage-rpc-manual.md +18 -26
- package/_packed_docs/sdk/AUN_DOCS_GUIDE.md +61 -52
- package/_packed_docs/sdk/INDEX.md +92 -80
- package/_packed_docs/sdk/Ownership-SDK/345/256/236/347/216/260/346/214/207/345/215/227.md +169 -0
- package/_packed_docs/sdk/Ownership-SDK/347/274/226/346/216/222/346/214/207/345/215/227.md +349 -0
- package/_packed_docs/sdk/Ownership-SDK/347/274/226/346/216/222/346/214/207/345/215/2272.1.md +922 -0
- package/_packed_docs/sdk/Ownership-SDK/351/233/206/346/210/220/346/214/207/345/215/227.md +270 -0
- package/_packed_docs/sdk/Ownership2.1-SDK/345/272/224/347/224/250/351/233/206/346/210/220/346/214/207/345/215/227.md +300 -0
- package/_packed_docs/sdk/Ownership2.1-SDK/345/274/200/345/217/221/344/270/216/347/247/273/346/244/215/346/214/207/345/215/227.md +382 -0
- package/_packed_docs/sdk/Ownership2.1-TDD/345/210/206/351/230/266/346/256/265/345/256/236/346/226/275/350/256/241/345/210/222.md +708 -0
- package/_packed_docs/sdk/Ownership2.1/350/257/246/347/273/206/350/256/276/350/256/241.md +476 -0
- package/_packed_docs/sdk/Ownership/347/256/241/347/220/206/344/270/223/351/242/230.md +559 -0
- package/_packed_docs/sdk/ProtectedHeaders/347/224/250/346/263/225/344/270/223/351/242/230.md +299 -0
- package/_packed_docs/sdk//345/207/255/350/257/201/344/270/216/347/273/204/347/273/207/346/234/215/345/212/241SDK/345/272/224/347/224/250/351/233/206/346/210/220/346/214/207/345/215/227.md +173 -0
- package/_packed_docs/sdk//345/207/255/350/257/201/344/270/216/347/273/204/347/273/207/346/234/215/345/212/241SDK/345/274/200/345/217/221/344/270/216/347/247/273/346/244/215/346/214/207/345/215/227.md +211 -0
- package/_packed_docs//350/267/250/350/256/276/345/244/207/345/267/262/350/257/273/346/234/252/350/257/273SDK/345/256/236/347/216/260/347/247/273/346/244/215/346/214/207/345/215/227.md +331 -0
- package/_packed_docs//350/267/250/350/256/276/345/244/207/345/267/262/350/257/273/346/234/252/350/257/273SDK/351/233/206/346/210/220/346/214/207/345/215/227.md +207 -0
- package/_packed_docs//350/267/250/350/256/276/345/244/207/345/267/262/350/257/273/346/234/252/350/257/273/344/273/243/347/240/201/345/256/241/346/237/245/346/212/245/345/221/212.md +252 -0
- package/_packed_docs//350/267/250/350/256/276/345/244/207/345/267/262/350/257/273/346/234/252/350/257/273/345/256/236/346/226/275/350/256/241/345/210/222.md +156 -0
- package/_packed_docs//350/267/250/350/256/276/345/244/207/345/267/262/350/257/273/346/234/252/350/257/273/346/226/271/346/241/210.md +273 -0
- package/_packed_docs//350/267/250/350/256/276/345/244/207/345/267/262/350/257/273/346/234/252/350/257/273/350/257/246/347/273/206/350/256/276/350/256/241.md +211 -0
- package/dist/agent-md-schema.d.ts +15 -4
- package/dist/agent-md-schema.d.ts.map +1 -1
- package/dist/agent-md-schema.js +64 -30
- package/dist/agent-md-schema.js.map +1 -1
- package/dist/agent-md.d.ts +10 -2
- package/dist/agent-md.d.ts.map +1 -1
- package/dist/agent-md.js +278 -121
- package/dist/agent-md.js.map +1 -1
- package/dist/aid-store.d.ts +46 -0
- package/dist/aid-store.d.ts.map +1 -1
- package/dist/aid-store.js +149 -10
- package/dist/aid-store.js.map +1 -1
- package/dist/aid.d.ts +4 -1
- package/dist/aid.d.ts.map +1 -1
- package/dist/aid.js +23 -42
- package/dist/aid.js.map +1 -1
- package/dist/auth.d.ts +1 -1
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +85 -18
- package/dist/auth.js.map +1 -1
- package/dist/bundle.js +1581 -781
- package/dist/cert-utils.d.ts +49 -1
- package/dist/cert-utils.d.ts.map +1 -1
- package/dist/cert-utils.js +102 -56
- package/dist/cert-utils.js.map +1 -1
- package/dist/client/delivery.d.ts +7 -0
- package/dist/client/delivery.d.ts.map +1 -1
- package/dist/client/delivery.js +243 -28
- package/dist/client/delivery.js.map +1 -1
- package/dist/client/rpc-pipeline.d.ts.map +1 -1
- package/dist/client/rpc-pipeline.js +89 -77
- package/dist/client/rpc-pipeline.js.map +1 -1
- package/dist/client/v2-e2ee.d.ts.map +1 -1
- package/dist/client/v2-e2ee.js +99 -80
- package/dist/client/v2-e2ee.js.map +1 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +31 -17
- package/dist/client.js.map +1 -1
- package/dist/crypto.d.ts.map +1 -1
- package/dist/crypto.js +8 -6
- package/dist/crypto.js.map +1 -1
- package/dist/events.d.ts +5 -2
- package/dist/events.d.ts.map +1 -1
- package/dist/events.js +33 -14
- package/dist/events.js.map +1 -1
- package/dist/facades.js +5 -5
- package/dist/facades.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/org-protocol.d.ts.map +1 -1
- package/dist/org-protocol.js +72 -12
- package/dist/org-protocol.js.map +1 -1
- package/dist/ownership-v21.d.ts +25 -8
- package/dist/ownership-v21.d.ts.map +1 -1
- package/dist/ownership-v21.js +142 -73
- package/dist/ownership-v21.js.map +1 -1
- package/dist/ownership-workflow.d.ts +6 -1
- package/dist/ownership-workflow.d.ts.map +1 -1
- package/dist/ownership-workflow.js +221 -58
- package/dist/ownership-workflow.js.map +1 -1
- package/dist/tools/cross-sdk-agent.d.ts +2 -1
- package/dist/tools/cross-sdk-agent.d.ts.map +1 -1
- package/dist/tools/cross-sdk-agent.js +91 -8
- package/dist/tools/cross-sdk-agent.js.map +1 -1
- package/dist/transport.d.ts +1 -0
- package/dist/transport.d.ts.map +1 -1
- package/dist/transport.js +2 -0
- package/dist/transport.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/_packed_docs/INDEX.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# AUN SDK Core 文档索引
|
|
2
2
|
|
|
3
|
-
> 根级文档索引采用三层结构。Layer 1 用于快速定位,Layer 2 按主题交叉查找,Layer 3 给出重点文档摘要。SDK API 细节继续查看 `docs/sdk/INDEX.md
|
|
3
|
+
> 根级文档索引采用三层结构。Layer 1 用于快速定位,Layer 2 按主题交叉查找,Layer 3 给出重点文档摘要。SDK API 细节继续查看 `docs/sdk/INDEX.md`;当前 Pull Gate 按 namespace 单飞、每客户端最多 4 个并行,末页独立 ACK。
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -8,60 +8,62 @@
|
|
|
8
8
|
|
|
9
9
|
| 文档 | 定位 |
|
|
10
10
|
| --- | --- |
|
|
11
|
-
| [aun测试运行指南](aun测试运行指南.md) | `agentid.pub/agentid.cn` 双域本地单实例、独立固定材料与 Tester、Go 1.24、断网 cross-SDK、三文件线上镜像替换包、开箱默认配置、一次性初始化辅助包及单节点部署 |
|
|
11
|
+
| [aun测试运行指南](aun测试运行指南.md) | `agentid.pub/agentid.cn` 双域本地单实例、独立固定材料与 Tester、Go 1.24、断网 cross-SDK、三文件线上镜像替换包、开箱默认配置、一次性初始化辅助包及单节点部署 |
|
|
12
12
|
| [aun公网测试运行指南](aun公网测试运行指南.md) | 可配置 issuer domain 的 Python SDK 公网 integration/E2E runner、独立身份/运行目录、TLS 与服务端公网验收衔接 |
|
|
13
|
-
| [aun分布式测试运行指南](aun分布式测试运行指南.md) | 当前 `kite` worktree 内的三节点、本地与公网 `agentid.pub/agentid.cn` 双域、隔离 federation、固定材料/双身份 runner、Storage OSS 验收、镜像/Compose/mount 来源预检及分布式 Tester/cross-SDK |
|
|
13
|
+
| [aun分布式测试运行指南](aun分布式测试运行指南.md) | 当前 `kite` worktree 内的三节点、本地与公网 `agentid.pub/agentid.cn` 双域、隔离 federation、固定材料/双身份 runner、Storage OSS 验收、镜像/Compose/mount 来源预检及分布式 Tester/cross-SDK |
|
|
14
14
|
| [分布式 AUN 节点与服务启动流程](../../extensions/services/docs/分布式AUN节点与服务启动流程.md) | control master / worker node、控制/注册/配置中心一体化、节点启动、服务启停、注册发现和配置恢复流程 |
|
|
15
15
|
| [AUN 服务 Go 化重构精细化源码审查](audit/AUN服务Go化重构精细化源码审查-20260718.md) | 10 个 AUN 服务的 Go/Python 调用链、字段、并发、安全与性能修复终审;开放 P0/P1/P2 已归零,并附 Claude 60+76 条复审映射、跨实例/资源边界修复和 Docker/Linux 2344 条 Python 回归证据 |
|
|
16
|
-
| [AUNClient 拆分重构执行方案](design/AUNClient拆分重构执行方案.md) | Python / Go / TS / JS SDK AUNClient 内部拆分边界、执行步骤和验收矩阵 |
|
|
17
|
-
| [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md) | AUNClient 完全门面化、ClientRuntime 单一状态源和四端分批迁移步骤 |
|
|
18
|
-
| [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md) | Forward A/T/H 窗口、Group 成员可见性下界、Tail/History RPC、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和跨 SDK 验收门禁 |
|
|
19
|
-
| [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md) | `message.send` 秒级 TTL 钳制、持久/volatile 双游标、按 device 收件箱、隐藏 slot lease/ACK、文件 epoch、消息调试计数器与 payload type 分类、多实例/跨域和四 SDK 测试矩阵 |
|
|
20
|
-
| [跨设备已读未读方案](跨设备已读未读方案.md) | 同一 AID 多设备按话题同步已读位置;服务端按 message ID 公共顺序汇总,返回汇总 message ID 及当前设备 seq 映射,支持 P2P/Group、批量和部分会话上报 |
|
|
21
|
-
| [跨设备已读未读详细设计](跨设备已读未读详细设计.md) | RPC、单条/显式空值边界、紧凑状态表、晚到位置持久回填、Group canonical 与权限版本、owner 事件路由及四端补偿 |
|
|
22
|
-
| [跨设备已读未读实施计划](跨设备已读未读实施计划.md) | 按 TDD 分阶段落地服务端、状态缓存与异步批写、Gateway、四端 SDK、单域/E2E/cross-SDK/跨域测试及完成定义 |
|
|
23
|
-
| [跨设备已读未读 SDK 集成指南](跨设备已读未读SDK集成指南.md) | TypeScript 身份加载、P2P/Group 上报查询、单调事件、本地 `read_state_sync
|
|
24
|
-
| [跨设备已读未读 SDK 实现/移植指南](跨设备已读未读SDK实现移植指南.md) | 其它语言 SDK 的 wire 契约、状态表迁移、顺序与映射、CACHE
|
|
25
|
-
| [跨设备已读未读代码审查报告](跨设备已读未读代码审查报告.md) | 服务端及四端 SDK 补充修复、本轮实际验证与历史隔离/Docker 证据;部署层验收未执行 |
|
|
26
|
-
| [消息同步与历史拉取代码审查问题清单](消息同步与历史拉取代码审查问题清单.md) | Python/Go 服务端、Gateway 与四 SDK 当前实现的 P0/P1/P2 问题、retention/Group Forward 可见性边界、跨语言差异、修复顺序和已排除误报 |
|
|
27
|
-
| [跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md) | 多语言 SDK 同网同服、test-runner 控制面的跨语言 E2E 方案 |
|
|
28
|
-
| [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md) | SDK bootstrap 能力声明 + 服务端 policy 控制 1DH/per-AID wrap 的兼容方案 |
|
|
29
|
-
| [E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md) | 当前 V2-only P2P / Group 明文与加密主链路、设备密钥注册和 pull/ack 时序 |
|
|
30
|
-
| [ProtectedHeaders 用法专题](sdk/ProtectedHeaders用法专题.md) | 四 SDK `protected_headers` API、E2EE V2 元数据 HMAC、自动字段和接收信任边界 |
|
|
31
|
-
| [Ownership 协议定义 2.1](protocol/Ownership协议定义2.1.md) |
|
|
16
|
+
| [AUNClient 拆分重构执行方案](design/AUNClient拆分重构执行方案.md) | Python / Go / TS / JS SDK AUNClient 内部拆分边界、执行步骤和验收矩阵 |
|
|
17
|
+
| [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md) | AUNClient 完全门面化、ClientRuntime 单一状态源和四端分批迁移步骤 |
|
|
18
|
+
| [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md) | Forward A/T/H 窗口、Group 成员可见性下界、Tail/History RPC、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和跨 SDK 验收门禁 |
|
|
19
|
+
| [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md) | `message.send` 秒级 TTL 钳制、持久/volatile 双游标、按 device 收件箱、隐藏 slot lease/ACK、文件 epoch、消息调试计数器与 payload type 分类、多实例/跨域和四 SDK 测试矩阵 |
|
|
20
|
+
| [跨设备已读未读方案](跨设备已读未读方案.md) | 同一 AID 多设备按话题同步已读位置;服务端按 message ID 公共顺序汇总,返回汇总 message ID 及当前设备 seq 映射,支持 P2P/Group、批量和部分会话上报 |
|
|
21
|
+
| [跨设备已读未读详细设计](跨设备已读未读详细设计.md) | RPC、单条/显式空值边界、紧凑状态表、晚到位置持久回填、Group canonical 与权限版本、owner 事件路由及四端补偿 |
|
|
22
|
+
| [跨设备已读未读实施计划](跨设备已读未读实施计划.md) | 按 TDD 分阶段落地服务端、状态缓存与异步批写、Gateway、四端 SDK、单域/E2E/cross-SDK/跨域测试及完成定义 |
|
|
23
|
+
| [跨设备已读未读 SDK 集成指南](跨设备已读未读SDK集成指南.md) | TypeScript 身份加载、P2P/Group 上报查询、单调事件、本地 `read_state_sync`、队列身份代际隔离、精确整数和映射状态 |
|
|
24
|
+
| [跨设备已读未读 SDK 实现/移植指南](跨设备已读未读SDK实现移植指南.md) | 其它语言 SDK 的 wire 契约、状态表迁移、顺序与映射、CACHE/异步批写、事件联邦、逐处理器身份代际复核、四端对齐和测试矩阵 |
|
|
25
|
+
| [跨设备已读未读代码审查报告](跨设备已读未读代码审查报告.md) | 服务端及四端 SDK 补充修复、本轮实际验证与历史隔离/Docker 证据;部署层验收未执行 |
|
|
26
|
+
| [消息同步与历史拉取代码审查问题清单](消息同步与历史拉取代码审查问题清单.md) | Python/Go 服务端、Gateway 与四 SDK 当前实现的 P0/P1/P2 问题、retention/Group Forward 可见性边界、跨语言差异、修复顺序和已排除误报 |
|
|
27
|
+
| [跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md) | 多语言 SDK 同网同服、test-runner 控制面的跨语言 E2E 方案 |
|
|
28
|
+
| [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md) | SDK bootstrap 能力声明 + 服务端 policy 控制 1DH/per-AID wrap 的兼容方案 |
|
|
29
|
+
| [E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md) | 当前 V2-only P2P / Group 明文与加密主链路、设备密钥注册和 pull/ack 时序 |
|
|
30
|
+
| [ProtectedHeaders 用法专题](sdk/ProtectedHeaders用法专题.md) | 四 SDK `protected_headers` API、E2EE V2 元数据 HMAC、自动字段和接收信任边界 |
|
|
31
|
+
| [Ownership 协议定义 2.1](protocol/Ownership协议定义2.1.md) | 当前双文件关系、release/清理/重绑版本、响应 Header 投影、agent.md 非回归及隔离的旧 SDK owner RPC;非权威 P2P 编排与 Group/Org 专属生命周期、实体主签、owner token 上传与可选附签和实体证书代际 |
|
|
32
32
|
| [Ownership SDK 编排指南 2.1](sdk/Ownership-SDK编排指南2.1.md) | 七 Facade、审批、普通加密 P2P、本地事件、按角色完成证据与恢复契约 |
|
|
33
|
-
| [Ownership 2.1 SDK 应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md) |
|
|
34
|
-
| [Ownership 2.1 SDK 开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md) |
|
|
35
|
-
| [凭证与组织服务 SDK 应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md) | 0.5.19 应用接入、CAP
|
|
36
|
-
| [凭证与组织服务 SDK 开发与移植指南](sdk/凭证与组织服务SDK开发与移植指南.md) | 0.5.19 四端协议实现、canonical JSON、强状态 proof、facade/RPC
|
|
37
|
-
| [
|
|
38
|
-
| [
|
|
33
|
+
| [Ownership 2.1 SDK 应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md) | 普通 agent 可选 owner 注册与应用接入、sign/verify 公共门面、显式文件多签、Group/Org 实体上传、审批任务与新鲜共识 |
|
|
34
|
+
| [Ownership 2.1 SDK 开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md) | 统一签验核心、多签 HTTP 表示、实体指纹绑定、Storage 完整文件、owner.md 同会话上传及发布 CAS、原件恢复与持久任务 |
|
|
35
|
+
| [凭证与组织服务 SDK 应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md) | 0.5.19 应用接入、CAP 完整验证、登记回执、成员闭环、实体主签与 owner 上传、转让恢复 |
|
|
36
|
+
| [凭证与组织服务 SDK 开发与移植指南](sdk/凭证与组织服务SDK开发与移植指南.md) | 0.5.19 四端协议实现、canonical JSON、强状态 proof、facade/RPC、实体多签与原件恢复、共同向量 |
|
|
37
|
+
| [凭证服务 RPC 手册](sdk/09-凭证服务RPC手册.md) | Credential Service 实际注册 RPC、状态 proof、登记、吊销和吊销列表 |
|
|
38
|
+
| [组织服务 RPC 手册](sdk/09-组织服务RPC手册.md) | Org Service 生命周期、成员、受保护查询、审计/授权及内部/未实现方法 |
|
|
39
|
+
| [Ownership 2.1 详细设计](sdk/Ownership2.1详细设计.md) | agent.md 兼容非回归原则与审查矩阵、旧 SDK owner RPC/JSONL 隔离、SDK/NS/Storage 职责;关系事实依赖持久化的 `sub_aid/agent.md` 与 owner_aid 规范路径的 `owner.md` |
|
|
40
|
+
| [Ownership 2.1 TDD 分阶段实施计划](sdk/Ownership2.1-TDD分阶段实施计划.md) | 当前实施计划、历史冻结契约、HTTP 428 与错误分类、共同向量及四 SDK 实际验收范围 |
|
|
39
41
|
| [Ownership 管理专题(legacy)](sdk/Ownership管理专题.md) | 历史 `aun.ownership.v1`、proof、托管、代签、代上传与 rekey 记录,不作为 2.1 接入依据 |
|
|
40
42
|
| [Ownership SDK 集成指南(legacy)](sdk/Ownership-SDK集成指南.md) | 2026-10-09 历史 TypeScript 应用接入、旧审批 API 与自动编排记录 |
|
|
41
43
|
| [Ownership SDK 实现指南(legacy)](sdk/Ownership-SDK实现指南.md) | 历史 proof/escrow、metadata、恢复和 rekey 移植记录 |
|
|
42
44
|
| [Ownership 协议定义(legacy)](protocol/Ownership协议定义.md) | 历史 `aun.ownership.v1`、proof、托管和 owner 上传授权格式 |
|
|
43
|
-
| [Ownership 2.1 代码审查报告](audit/Ownership2.1代码审查报告.md) |
|
|
44
|
-
| [Group 专属生命周期与名片](sdk/09-group-rpc-manual.md) | 自动 owner 绑定/解绑、强制 rekey
|
|
45
|
+
| [Ownership 2.1 代码审查报告](audit/Ownership2.1代码审查报告.md) | 历史审查与修复;2026-10-15 旧 SDK 隔离兼容、owner 可选、四端会话/CAS、Storage 持久化与当前验收边界 |
|
|
46
|
+
| [Group 专属生命周期与名片](sdk/09-group-rpc-manual.md) | 自动 owner 绑定/解绑、强制 rekey 的两阶段转移、实体主签、owner token 名片上传与可选附签 |
|
|
45
47
|
| [Org 0.8 专属生命周期](../../extensions/services/docs/org/0.8/02-组织模型.md) | 创建与解散 owner 自动建立/解除、先 rekey 后 owner CAS、材料归属与组织名片 |
|
|
46
|
-
| [AUN RPC Trace 增强设计](design/2026-05-22-aun-rpc-trace-enhancement.md) | RPC trace 诊断字段与 enter/exit span 设计 |
|
|
48
|
+
| [AUN RPC Trace 增强设计](design/2026-05-22-aun-rpc-trace-enhancement.md) | RPC trace 诊断字段与 enter/exit span 设计 |
|
|
47
49
|
| [AUN 服务端消息通信诊断面板方案](design/AUN服务端消息通信诊断面板方案.md) | aun-console 消息通信页的服务端可观察诊断面板总体方案 |
|
|
48
50
|
| [服务端消息通信诊断面板 P0 方案](design/服务端消息通信诊断面板P0方案.md) | aun-console 消息通信页的服务端可观察 P0 诊断面板 |
|
|
49
51
|
| [消息收件箱统一迁移方案](design/消息收件箱统一迁移方案.md) | P2P `message_inbox` 与群消息 `group_inbox` 的统一读模型、后台回填和旧表清理方案 |
|
|
50
|
-
| [AUN 反向代理服务方案与 TDD 实施计划](design/AUN反向代理服务方案与TDD实施计划.md) | AUN Service Proxy、service_proxy 服务模块、SDK service-proxy-client、URL 路由、隧道协议、Web 边界和分阶段 TDD 落地计划 |
|
|
52
|
+
| [AUN 反向代理服务方案与 TDD 实施计划](design/AUN反向代理服务方案与TDD实施计划.md) | AUN Service Proxy、service_proxy 服务模块、SDK service-proxy-client、URL 路由、隧道协议、Web 边界和分阶段 TDD 落地计划 |
|
|
51
53
|
| [agent.md Schema(legacy 2.0)](agent.md/SCHEMA.md) | 历史 Ownership 2.0 双文件声明与撤销格式;当前 2.1 文件、关系版本和 owner 锁见协议定义 2.1 |
|
|
52
|
-
| [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md) | 远程 agent.md per-AID 本地文件/IndexedDB 缓存、Gateway `_meta.agent_md_etags` 角色、消息信封 ETag 和注入节流方案 |
|
|
53
|
-
| [agent.md Schema 与签发/验签流程澄清记录](agent.md/working/agent.md-schema与签发验签流程澄清.md) | working 讨论记录:当前 Schema、内嵌签名实现、三字段关系声明与 self-owner 单签、公开 proof 独立验签、owner 关系写入经 Auth 验证及冲突仲裁、事实摘要与 nonce/编排上下文分层、Auth 登记见证与回执、证书/关系状态分离,以及 `unbound`/`unusable`、状态 pull/push、TTL、type-change 和 Storage 权限的最新决策 |
|
|
54
|
-
| [AID 类型、owner 关系与换 owner 编排方案](agent.md/working/AID类型-owner关系与换owner编排方案.md) | working 方案:Schema 的 owner/proof 可选但出现即必须完整合法,human 禁止 owner;共同签署声明字段为 proof_id/subject_aid/owner_aid,self-owner 仅 subject 单签,事实摘要排除 nonce、完整声明摘要绑定 proof,使用可见分号域分隔符;Auth 作为登记机构托管证据并签发回执,公开 owner 声明多数场景可独立验证,旧 AID 通过 `aid_bind` 建立 type/owner 绑定且基本登录通信不受限,关系写入经 Auth 仲裁,Storage 内部对象可删除/移动/重命名,失效关系进入 `unbound`/`unusable` |
|
|
55
|
-
| [AID 类型、owner 关系与 agent.md 签发/换 owner 完整设计与实施计划](agent.md/working/AID类型-owner关系完整设计与实施计划.md) | 汇总设计及 Phase 0 已确认的 P0-A01 至 P0-A12:Schema owner/proof 可选性与 human 禁止 owner、三字段共同声明与 self-owner 单签、事实 hash 与完整声明 hash 分层、canonical JSON/可见分号域分隔符/签名封套、proof-only 与 registered 验证等级、Auth 登记见证/回执、证书状态与关系 operation 分离、legacy/绑定中基本登录通信及按应用场景降级、旧 AID `aid_bind` 与新建 `aid_register` 的 Facade/RPC 边界、active/pending 唯一性检查、离线审批、`unbound`/`unusable`、Storage 保留目录和内部对象操作、服务端/四端 SDK 调整及逐阶段验收标准;剩余仅为正式 wire/RPC 文档和跨端向量落稿 |
|
|
56
|
-
| [本地 Docker 测试 Bug 清单](agent.md/working/本地Docker测试Bug清单.md) | 本轮 owner 关系实施及单域、cross-SDK、双域 federation 回归中发现的非任务失败、根因、修复与验证记录 |
|
|
57
|
-
| [群索引版本提示与附件引用方案](design/群索引版本提示与附件引用方案.md) | `group.index` 签名索引、`_meta.group_indexes` 版本提示、CAS 更新、服务端缓存注入和附件稳定引用 |
|
|
58
|
-
| [SDK 文档索引](sdk/INDEX.md) | SDK 使用手册、四 SDK 当前 access token getter、Python Push 自动登记/Facade、RPC 手册、E2EE、Storage VFS、Group FS 和 Collab 的子索引 |
|
|
59
|
-
| [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md) | SDK 文档按行区间渐进式查阅方法 |
|
|
60
|
-
| [AUN SDK 0.5.6 更新日志](sdk/CHANGELOG-0.5.6.md) | 以 0.5.5 为基线的四 SDK 发布汇总;覆盖首次签名者回源、下载提交前验签、消息窗口、显式 change-seed 和语言能力边界 |
|
|
61
|
-
| [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md) | 以 Python 实现为主线的 v0.3.3 至 v0.5.
|
|
62
|
-
| [AUN CLI 手册](cli/CLI手册.md) | Python CLI 源码位置、安装运行入口、全局选项、profile 配置和主要命令集 |
|
|
54
|
+
| [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md) | 远程 agent.md per-AID 本地文件/IndexedDB 缓存、Gateway `_meta.agent_md_etags` 角色、消息信封 ETag 和注入节流方案 |
|
|
55
|
+
| [agent.md Schema 与签发/验签流程澄清记录](agent.md/working/agent.md-schema与签发验签流程澄清.md) | working 讨论记录:当前 Schema、内嵌签名实现、三字段关系声明与 self-owner 单签、公开 proof 独立验签、owner 关系写入经 Auth 验证及冲突仲裁、事实摘要与 nonce/编排上下文分层、Auth 登记见证与回执、证书/关系状态分离,以及 `unbound`/`unusable`、状态 pull/push、TTL、type-change 和 Storage 权限的最新决策 |
|
|
56
|
+
| [AID 类型、owner 关系与换 owner 编排方案](agent.md/working/AID类型-owner关系与换owner编排方案.md) | working 方案:Schema 的 owner/proof 可选但出现即必须完整合法,human 禁止 owner;共同签署声明字段为 proof_id/subject_aid/owner_aid,self-owner 仅 subject 单签,事实摘要排除 nonce、完整声明摘要绑定 proof,使用可见分号域分隔符;Auth 作为登记机构托管证据并签发回执,公开 owner 声明多数场景可独立验证,旧 AID 通过 `aid_bind` 建立 type/owner 绑定且基本登录通信不受限,关系写入经 Auth 仲裁,Storage 内部对象可删除/移动/重命名,失效关系进入 `unbound`/`unusable` |
|
|
57
|
+
| [AID 类型、owner 关系与 agent.md 签发/换 owner 完整设计与实施计划](agent.md/working/AID类型-owner关系完整设计与实施计划.md) | 汇总设计及 Phase 0 已确认的 P0-A01 至 P0-A12:Schema owner/proof 可选性与 human 禁止 owner、三字段共同声明与 self-owner 单签、事实 hash 与完整声明 hash 分层、canonical JSON/可见分号域分隔符/签名封套、proof-only 与 registered 验证等级、Auth 登记见证/回执、证书状态与关系 operation 分离、legacy/绑定中基本登录通信及按应用场景降级、旧 AID `aid_bind` 与新建 `aid_register` 的 Facade/RPC 边界、active/pending 唯一性检查、离线审批、`unbound`/`unusable`、Storage 保留目录和内部对象操作、服务端/四端 SDK 调整及逐阶段验收标准;剩余仅为正式 wire/RPC 文档和跨端向量落稿 |
|
|
58
|
+
| [本地 Docker 测试 Bug 清单](agent.md/working/本地Docker测试Bug清单.md) | 本轮 owner 关系实施及单域、cross-SDK、双域 federation 回归中发现的非任务失败、根因、修复与验证记录 |
|
|
59
|
+
| [群索引版本提示与附件引用方案](design/群索引版本提示与附件引用方案.md) | `group.index` 签名索引、`_meta.group_indexes` 版本提示、CAS 更新、服务端缓存注入和附件稳定引用 |
|
|
60
|
+
| [SDK 文档索引](sdk/INDEX.md) | SDK 使用手册、四 SDK 当前 access token getter、Python Push 自动登记/Facade、RPC 手册、E2EE、Storage VFS、Group FS 和 Collab 的子索引 |
|
|
61
|
+
| [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md) | SDK 文档按行区间渐进式查阅方法 |
|
|
62
|
+
| [AUN SDK 0.5.6 更新日志](sdk/CHANGELOG-0.5.6.md) | 以 0.5.5 为基线的四 SDK 发布汇总;覆盖首次签名者回源、下载提交前验签、消息窗口、显式 change-seed 和语言能力边界 |
|
|
63
|
+
| [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md) | 以 Python 实现为主线的 v0.3.3 至 v0.5.20 跨语言对齐清单;0.5.20 以已发布 0.5.19 对应快照为基线,覆盖通用多签、离线草稿、Ownership 原件与恢复、消息同步、组织凭证、语言边界和测试入口 |
|
|
64
|
+
| [AUN CLI 手册](cli/CLI手册.md) | Python CLI 源码位置、安装运行入口、全局选项、profile 配置和主要命令集 |
|
|
63
65
|
| [AUN CLI 设计文档](cli/AUN-CLI设计文档.md) | `python/src/aun_cli` 当前实现架构、命令注册面、配置解析、SDK 桥接和实现边界 |
|
|
64
|
-
| [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、下载 ticket / AID Bearer 边界、当前 access token getter、类 Linux 权限、mount/symlink、服务端分层和 direct backend 上传下载 |
|
|
66
|
+
| [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、下载 ticket / AID Bearer 边界、当前 access token getter、类 Linux 权限、mount/symlink、服务端分层和 direct backend 上传下载 |
|
|
65
67
|
| [AUN Storage SDK 存储分层设计](<aun-fs/SDK存储分层设计.md>) | Python SDK StorageVFS / StorageLowLevel 接口契约、返回类型、错误映射和跨语言对齐要求 |
|
|
66
68
|
| [AUN Storage CLI-fs 命令设计](<aun-fs/CLI-fs命令设计.md>) | `aun fs` 命令语义、寻址规则、输出格式、CLI 工程改造和端到端场景 |
|
|
67
69
|
| [AUN Storage 分阶段实施计划](<aun-fs/分阶段实施计划.md>) | AUN Storage VFS + CLI 的 6 阶段 TDD 实施计划、P1-P6 实际执行记录和验收口径 |
|
|
@@ -73,15 +75,15 @@
|
|
|
73
75
|
| [collab 协作层服务端编排设计](<aun-fs/collab/2026-06-10-collab层服务端编排详细设计.md>) | collab 服务端编排、台账、diff3、snapshot、export/adopt、群协作注册表和四语言薄 SDK 设计 |
|
|
74
76
|
| [collab 协作层 Plan 1 服务端基础](<aun-fs/collab/2026-06-10-collab服务端编排-plan1.md>) | storage 进程内 collab 编排的 TDD 任务拆分、repository 事务原语、RPC 注册和群协作发现计划 |
|
|
75
77
|
| [collab 协作层 Plan 2 Python SDK/CLI](<aun-fs/collab/2026-06-12-collab协作层-plan2.md>) | Python SDK collab 薄封装、CLI 命令、单域 Docker E2E 和文档同步计划 |
|
|
76
|
-
| [collab 协作层 Plan 3 四语言互操作](<aun-fs/collab/2026-06-12-collab协作层-plan3.md>) | Go / TypeScript / JavaScript SDK collab 薄封装、跨语言 E2E 和双域边界验证计划 |
|
|
77
|
-
| [Notify 通知方案](sdk/Notify通知方案.md) | `client.notify()` 在线轻量通知、跨域 federation 和可靠消息分工 |
|
|
78
|
-
| [AUN 离线推送 Push Service 设计](superpowers/specs/2026-07-24-push-service-design-v3.md) | 独立 Go Push Service 的职责边界、SDK connect 登记语义、主链路、持久状态机、可靠性、安全、生命周期与三中心纳管 |
|
|
79
|
-
| [AUN 离线推送核心契约冻结](superpowers/契约冻结-v3-to-v4.md) | `query_sessions`、Push RPC/ACK、持久状态机、dispatch 恢复和关闭生命周期六项冻结契约 |
|
|
80
|
-
| [AUN 离线推送实施计划 v4](superpowers/plans/2026-07-24-push-service-implementation-v4.md) | 9 个 Phase、40 个 Task;只定义范围、交付、依赖和验收,Phase/Task TDD 在实施时按真实状态展开 |
|
|
81
|
-
| [AUN 离线推送服务运维与发布指南](AUN离线推送服务运维与发布指南.md) | 发布门、业务诊断、身份安全、Mock Python SDK 恢复边界、隔离 PoC 灰度、回滚和生产硬阻断 |
|
|
82
|
-
| [AUN 离线推送接入与演示指南](AUN离线推送接入与演示指南.md) | 终端客户端登记、Push Server token/长连接/幂等/ACK 实现,以及 Python Mock 隔离演示和验收排障 |
|
|
83
|
-
| [离线推送通知协议](protocol/15-离线推送通知协议.md) | `push.register/unregister/ack`、Python connect 自动登记、installation delivery、事件与持久恢复边界 |
|
|
84
|
-
| [Service Proxy RPC 手册](sdk/09-proxy-rpc-manual.md) | `proxy.*` 控制面、proxy-server 数据面注册、服务列表一致性和 wakeup 路由语义 |
|
|
78
|
+
| [collab 协作层 Plan 3 四语言互操作](<aun-fs/collab/2026-06-12-collab协作层-plan3.md>) | Go / TypeScript / JavaScript SDK collab 薄封装、跨语言 E2E 和双域边界验证计划 |
|
|
79
|
+
| [Notify 通知方案](sdk/Notify通知方案.md) | `client.notify()` 在线轻量通知、跨域 federation 和可靠消息分工 |
|
|
80
|
+
| [AUN 离线推送 Push Service 设计](superpowers/specs/2026-07-24-push-service-design-v3.md) | 独立 Go Push Service 的职责边界、SDK connect 登记语义、主链路、持久状态机、可靠性、安全、生命周期与三中心纳管 |
|
|
81
|
+
| [AUN 离线推送核心契约冻结](superpowers/契约冻结-v3-to-v4.md) | `query_sessions`、Push RPC/ACK、持久状态机、dispatch 恢复和关闭生命周期六项冻结契约 |
|
|
82
|
+
| [AUN 离线推送实施计划 v4](superpowers/plans/2026-07-24-push-service-implementation-v4.md) | 9 个 Phase、40 个 Task;只定义范围、交付、依赖和验收,Phase/Task TDD 在实施时按真实状态展开 |
|
|
83
|
+
| [AUN 离线推送服务运维与发布指南](AUN离线推送服务运维与发布指南.md) | 发布门、业务诊断、身份安全、Mock Python SDK 恢复边界、隔离 PoC 灰度、回滚和生产硬阻断 |
|
|
84
|
+
| [AUN 离线推送接入与演示指南](AUN离线推送接入与演示指南.md) | 终端客户端登记、Push Server token/长连接/幂等/ACK 实现,以及 Python Mock 隔离演示和验收排障 |
|
|
85
|
+
| [离线推送通知协议](protocol/15-离线推送通知协议.md) | `push.register/unregister/ack`、Python connect 自动登记、installation delivery、事件与持久恢复边界 |
|
|
86
|
+
| [Service Proxy RPC 手册](sdk/09-proxy-rpc-manual.md) | `proxy.*` 控制面、proxy-server 数据面注册、服务列表一致性和 wakeup 路由语义 |
|
|
85
87
|
| [协议文档目录](protocol/) | AUN 协议相关文档 |
|
|
86
88
|
| [审查与路线图目录](audit/) | 历史审查、修复路线图、测试补充清单 |
|
|
87
89
|
| [superpowers 目录](superpowers/) | AUN SDK 规范类补充文档 |
|
|
@@ -92,23 +94,23 @@
|
|
|
92
94
|
|
|
93
95
|
### 测试与 E2E
|
|
94
96
|
|
|
95
|
-
- 本机各套环境边界、默认单实例服务端、独立 SDK Tester、容器/网络/数据目录和测试命令 → [aun测试运行指南](aun测试运行指南.md)
|
|
97
|
+
- 本机各套环境边界、默认单实例服务端、独立 SDK Tester、容器/网络/数据目录和测试命令 → [aun测试运行指南](aun测试运行指南.md)
|
|
96
98
|
- `evolagent.cn` / `agentid.pub` 等公网域的 Python SDK integration/E2E、隔离目录、TLS 和报告 → [aun公网测试运行指南](aun公网测试运行指南.md)
|
|
97
|
-
- 双域 Issuer/AID/MySQL 材料校验、三文件线上镜像替换包、开箱默认值与可选生产覆盖、一次性初始化辅助包及线上单节点部署 → [aun测试运行指南](aun测试运行指南.md)
|
|
98
|
-
- 当前 worktree 三节点、本地与公网 `agentid.pub/agentid.cn` 双域、固定身份双域 runner、Storage OSS、dist 域名、data-dist、镜像/Compose/mount 来源核验、控制中心和跳过 TLS verify → [aun分布式测试运行指南](aun分布式测试运行指南.md)
|
|
99
|
+
- 双域 Issuer/AID/MySQL 材料校验、三文件线上镜像替换包、开箱默认值与可选生产覆盖、一次性初始化辅助包及线上单节点部署 → [aun测试运行指南](aun测试运行指南.md)
|
|
100
|
+
- 当前 worktree 三节点、本地与公网 `agentid.pub/agentid.cn` 双域、固定身份双域 runner、Storage OSS、dist 域名、data-dist、镜像/Compose/mount 来源核验、控制中心和跳过 TLS verify → [aun分布式测试运行指南](aun分布式测试运行指南.md)
|
|
99
101
|
- 分布式节点角色、节点启动、服务启动/停止、注册发现、配置恢复和重启后状态恢复 → [分布式 AUN 节点与服务启动流程](../../extensions/services/docs/分布式AUN节点与服务启动流程.md)
|
|
100
|
-
- AUNClient 巨类拆分、内部组件边界、逐步迁移和验收矩阵 → [AUNClient 拆分重构执行方案](design/AUNClient拆分重构执行方案.md)
|
|
101
|
-
- AUNClient 完全门面化、Runtime 状态归属、状态写入收口和四端分批实施 → [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md)
|
|
102
|
-
- P2P/Group Message 的 A/T/H、Tail/History、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和分布式验收门禁 → [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md)
|
|
103
|
-
- P2P `message.send` TTL 内存缓存、持久/volatile 游标、device 收件箱、隐藏 slot lease/ACK、服务 epoch、消息调试计数器与 payload type 分类、跨 SDK/双域验收 → [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md)
|
|
104
|
-
- 同一 AID 多设备按会话话题同步已读位置、message ID 公共顺序汇总、当前设备 seq 映射、P2P/Group 批量上报与查询 → [跨设备已读未读方案](跨设备已读未读方案.md)
|
|
105
|
-
- 跨设备已读未读 RPC、状态表、请求级提交、混合域部分提交、SDK 缓存及本地完成事件契约 → [跨设备已读未读详细设计](跨设备已读未读详细设计.md)
|
|
106
|
-
- 跨设备已读未读 TDD 阶段、状态缓存与批写、测试矩阵、断点续跑、兼容审查和完成定义 → [跨设备已读未读实施计划](跨设备已读未读实施计划.md)
|
|
107
|
-
- TypeScript 应用快速接入跨设备已读未读、上报/查询、单调事件、`read_state_sync`、精确整数和映射状态 → [跨设备已读未读 SDK 集成指南](跨设备已读未读SDK集成指南.md)
|
|
108
|
-
- Python/TypeScript/JavaScript/Go 及其它语言 SDK 的已读状态实现、数据库迁移、CACHE 批写、事件联邦和验收 → [跨设备已读未读 SDK 实现/移植指南](跨设备已读未读SDK实现移植指南.md)
|
|
109
|
-
- 跨设备已读未读实现完整度、文档一致性、四端 SDK 对齐、问题修复闭环及本轮/历史验证边界 → [跨设备已读未读代码审查报告](跨设备已读未读代码审查报告.md)
|
|
110
|
-
- 当前实现的完整度、P0/P1/P2 缺陷、Python/Go 服务端差异、四 SDK 差异与 Go Group inbox-only 对齐项 → [消息同步与历史拉取代码审查问题清单](消息同步与历史拉取代码审查问题清单.md)
|
|
111
|
-
- Python / TypeScript / Go / JavaScript 跨语言容器 E2E、internal 网络、每轮唯一 AID、test-runner、test-control API、用例矩阵 → [aun测试运行指南](aun测试运行指南.md)、[跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
|
|
102
|
+
- AUNClient 巨类拆分、内部组件边界、逐步迁移和验收矩阵 → [AUNClient 拆分重构执行方案](design/AUNClient拆分重构执行方案.md)
|
|
103
|
+
- AUNClient 完全门面化、Runtime 状态归属、状态写入收口和四端分批实施 → [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md)
|
|
104
|
+
- P2P/Group Message 的 A/T/H、Tail/History、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和分布式验收门禁 → [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md)
|
|
105
|
+
- P2P `message.send` TTL 内存缓存、持久/volatile 游标、device 收件箱、隐藏 slot lease/ACK、服务 epoch、消息调试计数器与 payload type 分类、跨 SDK/双域验收 → [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md)
|
|
106
|
+
- 同一 AID 多设备按会话话题同步已读位置、message ID 公共顺序汇总、当前设备 seq 映射、P2P/Group 批量上报与查询 → [跨设备已读未读方案](跨设备已读未读方案.md)
|
|
107
|
+
- 跨设备已读未读 RPC、状态表、请求级提交、混合域部分提交、SDK 缓存及本地完成事件契约 → [跨设备已读未读详细设计](跨设备已读未读详细设计.md)
|
|
108
|
+
- 跨设备已读未读 TDD 阶段、状态缓存与批写、测试矩阵、断点续跑、兼容审查和完成定义 → [跨设备已读未读实施计划](跨设备已读未读实施计划.md)
|
|
109
|
+
- TypeScript 应用快速接入跨设备已读未读、上报/查询、单调事件、`read_state_sync`、精确整数和映射状态 → [跨设备已读未读 SDK 集成指南](跨设备已读未读SDK集成指南.md)
|
|
110
|
+
- Python/TypeScript/JavaScript/Go 及其它语言 SDK 的已读状态实现、数据库迁移、CACHE 批写、事件联邦和验收 → [跨设备已读未读 SDK 实现/移植指南](跨设备已读未读SDK实现移植指南.md)
|
|
111
|
+
- 跨设备已读未读实现完整度、文档一致性、四端 SDK 对齐、问题修复闭环及本轮/历史验证边界 → [跨设备已读未读代码审查报告](跨设备已读未读代码审查报告.md)
|
|
112
|
+
- 当前实现的完整度、P0/P1/P2 缺陷、Python/Go 服务端差异、四 SDK 差异与 Go Group inbox-only 对齐项 → [消息同步与历史拉取代码审查问题清单](消息同步与历史拉取代码审查问题清单.md)
|
|
113
|
+
- Python / TypeScript / Go / JavaScript 跨语言容器 E2E、internal 网络、每轮唯一 AID、test-runner、test-control API、用例矩阵 → [aun测试运行指南](aun测试运行指南.md)、[跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
|
|
112
114
|
- 多语言 SDK 测试缺口与补测清单 → [审查与路线图目录](audit/)
|
|
113
115
|
|
|
114
116
|
### 服务端 Go 化重构审查
|
|
@@ -117,24 +119,26 @@
|
|
|
117
119
|
|
|
118
120
|
### SDK 使用与协议
|
|
119
121
|
|
|
120
|
-
- Python / TS / Go / JS SDK 使用手册,以及 Python `push_notify_aid` connect 自动登记和 PushFacade → [SDK 文档索引](sdk/INDEX.md)
|
|
121
|
-
- Ownership 2.1
|
|
122
|
-
- Ownership 2.1 七 Facade
|
|
123
|
-
- Ownership 2.1
|
|
122
|
+
- Python / TS / Go / JS SDK 使用手册,以及 Python `push_notify_aid` connect 自动登记和 PushFacade → [SDK 文档索引](sdk/INDEX.md)
|
|
123
|
+
- Ownership 2.1 双文件关系、release 保持当前版本、清理后版本投影为 0/重绑默认 1、响应 Header 只投影校验结果、普通 agent owner 可选及旧 SDK 隔离兼容 → [协议定义 2.1](protocol/Ownership协议定义2.1.md)、[详细设计](sdk/Ownership2.1详细设计.md)
|
|
124
|
+
- Ownership 2.1 七 Facade、公开签验与文件多签、Group/Org 实体上传、审批、本地事件、任务与新鲜共识 → [SDK 编排指南 2.1](sdk/Ownership-SDK编排指南2.1.md)、[应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md)
|
|
125
|
+
- Ownership 2.1 统一签验核心、多签 HTTP 表示、Storage 完整原文/存在性再读、owner.md 同会话上传与 expected_version 发布 CAS、原件恢复与持久任务验收 → [开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md)、[TDD 实施账本](sdk/Ownership2.1-TDD分阶段实施计划.md)
|
|
124
126
|
- Credential/Org 应用接入、CAP 完整 Verify、登记回执、成员入组/续期、代表请求和转让恢复 → [凭证与组织服务 SDK 应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md)
|
|
125
127
|
- Credential/Org 四端协议实现、canonical JSON、父链强状态 proof、请求绑定、facade/RPC 和共同向量 → [凭证与组织服务 SDK 开发与移植指南](sdk/凭证与组织服务SDK开发与移植指南.md)
|
|
126
|
-
-
|
|
128
|
+
- Credential Service 服务端 RPC、签名状态 proof 和吊销列表 → [凭证服务 RPC 手册](sdk/09-凭证服务RPC手册.md)
|
|
129
|
+
- Org Service 生命周期、成员、受保护查询、内部接口和未实现占位 → [组织服务 RPC 手册](sdk/09-组织服务RPC手册.md)
|
|
130
|
+
- 旧 SDK owner 注册、绑定、转移、查询和解绑的隔离 RPC/Auth JSONL 兼容 → [当前协议兼容边界](protocol/Ownership协议定义2.1.md);legacy proof、托管、代签和代上传记录 → [Ownership 管理专题](sdk/Ownership管理专题.md)
|
|
127
131
|
- legacy 应用接入与旧 SDK 自动编排 → [Ownership SDK 集成指南](sdk/Ownership-SDK集成指南.md)
|
|
128
132
|
- legacy proof/escrow、metadata 和 rekey 移植记录 → [Ownership SDK 实现指南](sdk/Ownership-SDK实现指南.md)
|
|
129
133
|
- legacy `aun.ownership.v1` wire 格式和 owner 上传授权 → [Ownership 协议定义](protocol/Ownership协议定义.md)
|
|
130
|
-
- Ownership 2.1
|
|
131
|
-
- 四 SDK 当前 access token getter、缓存快照语义和外部 HTTP 数据面下载凭据生命周期 → [连接与认证](sdk/04-连接与认证.md)、[API 手册](sdk/06-API手册.md)、[Storage RPC 手册](sdk/09-storage-rpc-manual.md)、[AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>)
|
|
132
|
-
- 按主题和行区间查 SDK 文档 → [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md)
|
|
133
|
-
- 四 SDK 0.5.6 发布摘要、首次签名者回源、可信缓存提交、消息窗口、语言能力边界 → [AUN SDK 0.5.6 更新日志](sdk/CHANGELOG-0.5.6.md)
|
|
134
|
-
- 四 SDK 0.5.
|
|
134
|
+
- Ownership 2.1 代码审查、四端逐项裁决、旧 SDK 隔离兼容、普通名片保护、2026-10-15 修复和验证限制 → [Ownership 2.1 代码审查报告](audit/Ownership2.1代码审查报告.md)
|
|
135
|
+
- 四 SDK 当前 access token getter、缓存快照语义和外部 HTTP 数据面下载凭据生命周期 → [连接与认证](sdk/04-连接与认证.md)、[API 手册](sdk/06-API手册.md)、[Storage RPC 手册](sdk/09-storage-rpc-manual.md)、[AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>)
|
|
136
|
+
- 按主题和行区间查 SDK 文档 → [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md)
|
|
137
|
+
- 四 SDK 0.5.6 发布摘要、首次签名者回源、可信缓存提交、消息窗口、语言能力边界 → [AUN SDK 0.5.6 更新日志](sdk/CHANGELOG-0.5.6.md)
|
|
138
|
+
- 四 SDK 0.5.20 相对已发布 0.5.19 的通用多签、草稿恢复、Ownership 原件 CAS、Pull/ACK、撤回及已读事件、组织凭证、代码/测试落点与语言边界 → [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md)
|
|
135
139
|
- Python CLI 源码位置、安装运行入口、全局选项、profile 配置、身份/消息/群组/Storage/Group FS/Collab/诊断等命令用法 → [AUN CLI 手册](cli/CLI手册.md)
|
|
136
140
|
- Python CLI 当前实现架构、`main.py` 命令注册、`CLISession` SDK 桥接、配置解析和实现边界 → [AUN CLI 设计文档](cli/AUN-CLI设计文档.md)
|
|
137
|
-
- Storage SDK VFS、控制面/数据面分离、下载 ticket / AID Bearer 边界、当前 access token getter、类 Linux 权限、mount/symlink、direct backend 上传下载和服务端分层 → [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>)
|
|
141
|
+
- Storage SDK VFS、控制面/数据面分离、下载 ticket / AID Bearer 边界、当前 access token getter、类 Linux 权限、mount/symlink、direct backend 上传下载和服务端分层 → [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>)
|
|
138
142
|
- StorageVFS / StorageLowLevel 接口契约、NodeView/ObjectView、错误映射和跨语言对齐 → [AUN Storage SDK 存储分层设计](<aun-fs/SDK存储分层设计.md>)
|
|
139
143
|
- `aun fs` 命令语义、AID 路径解析、输出格式和 CLI 到 SDK 的调用边界 → [AUN Storage CLI-fs 命令设计](<aun-fs/CLI-fs命令设计.md>)
|
|
140
144
|
- AUN Storage 6 阶段 TDD 计划、P1/P2/P3/P4/P5/P6 实际执行记录、阶段实施前详细计划和 Docker 验证纪律 → [AUN Storage 分阶段实施计划](<aun-fs/分阶段实施计划.md>)
|
|
@@ -143,18 +147,18 @@
|
|
|
143
147
|
- 群自有区 owner 默认写、admin 需 owner 显式 `role:admin` ACL 授权与撤销/查询、group 与 storage 鉴权分工、Storage 写审计 → [群自有区角色 ACL 写权限实施方案](<aun-fs/group-fs/群自有区角色ACL写权限实施方案.md>)
|
|
144
148
|
- `memberdata` 和 `group_data` 系统目录保护、`group_data` 目录树隐藏但读/下载不刻意隐藏、普通写入口保护、group.fs 授权写入路径、真实 owner AID 配额计入 → [系统目录保护方案](protocol/16-系统目录保护方案.md)
|
|
145
149
|
- group.fs 8 阶段重构步骤、每阶段 IPO、Step-by-step、用例集、Checklist、验收、回滚和 Phase 8 Docker 完成记录 → [群文件系统 group.fs POSIX 化分阶段实施计划](<aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md>)
|
|
146
|
-
- 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>)
|
|
147
|
-
- `client.notify()` 在线轻量通知、AID/群路由、跨域 federation 和不离线存储边界 → [Notify 通知方案](sdk/Notify通知方案.md)
|
|
148
|
-
- 终端如何登记、Push Server 如何签发 token、接收批次、平台推送、幂等 ACK,以及如何运行 Mock smoke → [AUN 离线推送接入与演示指南](AUN离线推送接入与演示指南.md)
|
|
149
|
-
- P2P/Group 离线唤醒、Python connect/Facade 登记、六项冻结契约、9 Phase/40 Task、发布门和回滚 → [离线推送协议](protocol/15-离线推送通知协议.md)、[Push Service 设计](superpowers/specs/2026-07-24-push-service-design-v3.md)、[契约冻结](superpowers/契约冻结-v3-to-v4.md)、[v4 实施计划](superpowers/plans/2026-07-24-push-service-implementation-v4.md)、[运维与发布指南](AUN离线推送服务运维与发布指南.md);[旧 Codex 版本](AUN离线推送服务架构与详细实现计划-codex.md)仅作历史背景
|
|
150
|
-
- 协议细节、Agent 自主行为、群 `mention_mode` 提及过滤和消息格式 → [协议文档目录](protocol/)、[Group 子协议](protocol/10-Group-子协议.md)、[Agent 行为规范](protocol/13-Agent行为规范.md)
|
|
150
|
+
- 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>)
|
|
151
|
+
- `client.notify()` 在线轻量通知、AID/群路由、跨域 federation 和不离线存储边界 → [Notify 通知方案](sdk/Notify通知方案.md)
|
|
152
|
+
- 终端如何登记、Push Server 如何签发 token、接收批次、平台推送、幂等 ACK,以及如何运行 Mock smoke → [AUN 离线推送接入与演示指南](AUN离线推送接入与演示指南.md)
|
|
153
|
+
- P2P/Group 离线唤醒、Python connect/Facade 登记、六项冻结契约、9 Phase/40 Task、发布门和回滚 → [离线推送协议](protocol/15-离线推送通知协议.md)、[Push Service 设计](superpowers/specs/2026-07-24-push-service-design-v3.md)、[契约冻结](superpowers/契约冻结-v3-to-v4.md)、[v4 实施计划](superpowers/plans/2026-07-24-push-service-implementation-v4.md)、[运维与发布指南](AUN离线推送服务运维与发布指南.md);[旧 Codex 版本](AUN离线推送服务架构与详细实现计划-codex.md)仅作历史背景
|
|
154
|
+
- 协议细节、Agent 自主行为、群 `mention_mode` 提及过滤和消息格式 → [协议文档目录](protocol/)、[Group 子协议](protocol/10-Group-子协议.md)、[Agent 行为规范](protocol/13-Agent行为规范.md)
|
|
151
155
|
- legacy Ownership 2.0 的 agent.md/owner.md 声明与撤销 → [agent.md Schema](agent.md/SCHEMA.md);当前 2.1 文件与锁规则 → [协议定义 2.1](protocol/Ownership协议定义2.1.md)
|
|
152
|
-
- agent.md 远程缓存、`remote_etag` / `local_etag`、`requester` / `peer` / `group` 角色、消息信封与 Gateway `_meta` ETag 透传 → [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md)
|
|
153
|
-
- agent.md Schema、内嵌签名、三字段关系声明与 self-owner 单签、公开 proof 独立验签、关系写入经 Auth 验证与冲突仲裁、既有签名协议开放项及本轮状态/TTL/Storage 决策 → [agent.md Schema 与签发/验签流程澄清记录](agent.md/working/agent.md-schema与签发验签流程澄清.md)
|
|
154
|
-
- AID 类型、owner/ownership_proof 可选但出现即合法、human 禁止 owner、共同签署字段集合、可见分号 canonical bytes、公开关系声明、Auth 关系写入与冲突裁定、owner-side 备份 ACL、`unbound`/`unusable` 与无专门 recovery → [AID 类型、owner 关系与换 owner 编排方案](agent.md/working/AID类型-owner关系与换owner编排方案.md)
|
|
155
|
-
- Auth 权威写入状态、Schema 可选性与 human 禁止 owner、三字段共同声明与 self-owner 单签、canonical bytes、公开 owner proof 独立验证、active/pending 唯一性检查、owner 流程、状态传播、`unbound`/`unusable`、Storage 内部对象权限、服务端/四端 SDK 调整和分阶段验收 Checklist;剩余为正式 wire/RPC 文档和跨端向量落稿 → [AID 类型、owner 关系与 agent.md 签发/换 owner 完整设计与实施计划](agent.md/working/AID类型-owner关系完整设计与实施计划.md)
|
|
156
|
-
- 本轮本地 Docker、单域、cross-SDK 与双域 federation 回归中的非任务失败及修复证据 → [本地 Docker 测试 Bug 清单](agent.md/working/本地Docker测试Bug清单.md)
|
|
157
|
-
- `group.index` owner/admin SDK 生成签名索引、`_meta.group_indexes` 观察、`expected_index_etag` CAS、服务端正/负缓存与注入频率控制 → [群索引版本提示与附件引用方案](design/群索引版本提示与附件引用方案.md)、[SDK 文档索引](sdk/INDEX.md)
|
|
156
|
+
- agent.md 远程缓存、`remote_etag` / `local_etag`、`requester` / `peer` / `group` 角色、消息信封与 Gateway `_meta` ETag 透传 → [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md)
|
|
157
|
+
- agent.md Schema、内嵌签名、三字段关系声明与 self-owner 单签、公开 proof 独立验签、关系写入经 Auth 验证与冲突仲裁、既有签名协议开放项及本轮状态/TTL/Storage 决策 → [agent.md Schema 与签发/验签流程澄清记录](agent.md/working/agent.md-schema与签发验签流程澄清.md)
|
|
158
|
+
- AID 类型、owner/ownership_proof 可选但出现即合法、human 禁止 owner、共同签署字段集合、可见分号 canonical bytes、公开关系声明、Auth 关系写入与冲突裁定、owner-side 备份 ACL、`unbound`/`unusable` 与无专门 recovery → [AID 类型、owner 关系与换 owner 编排方案](agent.md/working/AID类型-owner关系与换owner编排方案.md)
|
|
159
|
+
- Auth 权威写入状态、Schema 可选性与 human 禁止 owner、三字段共同声明与 self-owner 单签、canonical bytes、公开 owner proof 独立验证、active/pending 唯一性检查、owner 流程、状态传播、`unbound`/`unusable`、Storage 内部对象权限、服务端/四端 SDK 调整和分阶段验收 Checklist;剩余为正式 wire/RPC 文档和跨端向量落稿 → [AID 类型、owner 关系与 agent.md 签发/换 owner 完整设计与实施计划](agent.md/working/AID类型-owner关系完整设计与实施计划.md)
|
|
160
|
+
- 本轮本地 Docker、单域、cross-SDK 与双域 federation 回归中的非任务失败及修复证据 → [本地 Docker 测试 Bug 清单](agent.md/working/本地Docker测试Bug清单.md)
|
|
161
|
+
- `group.index` owner/admin SDK 生成签名索引、`_meta.group_indexes` 观察、`expected_index_etag` CAS、服务端正/负缓存与注入频率控制 → [群索引版本提示与附件引用方案](design/群索引版本提示与附件引用方案.md)、[SDK 文档索引](sdk/INDEX.md)
|
|
158
162
|
|
|
159
163
|
### Service Proxy 与服务暴露
|
|
160
164
|
|
|
@@ -172,11 +176,11 @@
|
|
|
172
176
|
- 测试日志路径、测试输出、容器日志查看 → [aun测试运行指南](aun测试运行指南.md)
|
|
173
177
|
- 跨语言 E2E trace 字段、日志产物、失败分类 → [跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
|
|
174
178
|
|
|
175
|
-
### E2EE 与跨语言一致性
|
|
176
|
-
|
|
177
|
-
- SDK E2EE V2 API、会话管理、ProtectedHeaders、P2P/Group 当前主链路 → [SDK 文档索引](sdk/INDEX.md)、[E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md)
|
|
178
|
-
- `protected_headers` 四端 API、合并优先级、元数据 HMAC 和解密信任边界 → [ProtectedHeaders 用法专题](sdk/ProtectedHeaders用法专题.md)
|
|
179
|
-
- E2EE V2 1DH/per-AID wrap、bootstrap 能力声明、服务端 fanout → [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md)
|
|
179
|
+
### E2EE 与跨语言一致性
|
|
180
|
+
|
|
181
|
+
- SDK E2EE V2 API、会话管理、ProtectedHeaders、P2P/Group 当前主链路 → [SDK 文档索引](sdk/INDEX.md)、[E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md)
|
|
182
|
+
- `protected_headers` 四端 API、合并优先级、元数据 HMAC 和解密信任边界 → [ProtectedHeaders 用法专题](sdk/ProtectedHeaders用法专题.md)
|
|
183
|
+
- E2EE V2 1DH/per-AID wrap、bootstrap 能力声明、服务端 fanout → [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md)
|
|
180
184
|
- 共享测试向量、transcript 回放、Python / TS / Go / JS 互通 → [aun测试运行指南](aun测试运行指南.md)、[跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
|
|
181
185
|
|
|
182
186
|
---
|
|
@@ -185,7 +189,7 @@
|
|
|
185
189
|
|
|
186
190
|
### aun测试运行指南
|
|
187
191
|
|
|
188
|
-
记录本机 `agentid.pub/agentid.cn` 两套单节点环境以及三节点、federation 的 Compose、数据、project、网络与容器边界。真实双域各自固定 Issuer CA、服务 AID、MySQL UUID、workspace 和 Tester 目录,通过材料清单与运行态 mount 双重预检防止混用。指南统一 Go 1.24 与断网测试纪律,并定义停止写入后的 MySQL 单事务逻辑快照、三文件线上包的开箱默认值与可选生产覆盖、首部署导入和后续镜像升级流程;公网复测另有固定身份注册、TLS 和镜像发布门禁。
|
|
192
|
+
记录本机 `agentid.pub/agentid.cn` 两套单节点环境以及三节点、federation 的 Compose、数据、project、网络与容器边界。真实双域各自固定 Issuer CA、服务 AID、MySQL UUID、workspace 和 Tester 目录,通过材料清单与运行态 mount 双重预检防止混用。指南统一 Go 1.24 与断网测试纪律,并定义停止写入后的 MySQL 单事务逻辑快照、三文件线上包的开箱默认值与可选生产覆盖、首部署导入和后续镜像升级流程;公网复测另有固定身份注册、TLS 和镜像发布门禁。
|
|
189
193
|
|
|
190
194
|
### aun公网测试运行指南
|
|
191
195
|
|
|
@@ -193,49 +197,49 @@
|
|
|
193
197
|
|
|
194
198
|
### aun分布式测试运行指南
|
|
195
199
|
|
|
196
|
-
规定当前 `D:\modelunion\kite` worktree 独立维护默认单实例、本地与公网真实域名双域 `agentid.pub/agentid.cn`、三节点 `dist-agentid.pub`、隔离 federation、服务端镜像、Tester 和部署产物,不得引用相邻 worktree。包含本地双域的 env 合并规则、固定身份双挂载 runner、Storage OSS 跨域授权/下载验收、公网固定身份注册与 TLS 复测、线上镜像门禁、跨域日志判定、跨 worktree 的停写整套冷克隆边界、分布式 Tester/cross-SDK、镜像哈希、Compose label 与 bind mount 强制预检、精确 Git 忽略边界;日常流程禁止在线或局部复制、擅自重签、`setup_aids.py` 或清库,Go Tester 统一 1.24。
|
|
200
|
+
规定当前 `D:\modelunion\kite` worktree 独立维护默认单实例、本地与公网真实域名双域 `agentid.pub/agentid.cn`、三节点 `dist-agentid.pub`、隔离 federation、服务端镜像、Tester 和部署产物,不得引用相邻 worktree。包含本地双域的 env 合并规则、固定身份双挂载 runner、Storage OSS 跨域授权/下载验收、公网固定身份注册与 TLS 复测、线上镜像门禁、跨域日志判定、跨 worktree 的停写整套冷克隆边界、分布式 Tester/cross-SDK、镜像哈希、Compose label 与 bind mount 强制预检、精确 Git 忽略边界;日常流程禁止在线或局部复制、擅自重签、`setup_aids.py` 或清库,Go Tester 统一 1.24。
|
|
197
201
|
|
|
198
202
|
### 分布式 AUN 节点与服务启动流程
|
|
199
203
|
|
|
200
204
|
整理当前分布式节点架构和启动时序。文档明确 `control master` 本身也是 worker 节点,aun-console 同时承载控制中心、注册中心和配置中心,worker 通过 launcher/control supervisor 注册节点、拉取 desired-state、建立 WebSocket watch、按 `managed` 目标状态启停服务;服务启动后通过本机 kernel 注册 RPC 能力,并优先从注册中心发现 Gateway business endpoint,随后由 launcher 上报 service instance 和 endpoints。文档还定义服务停用时 `running -> stopping -> stopped` 的 AUN 层优雅关停顺序、nameservice 使用注册中心 `public_http` 改写 302、配置中心 revision/binding 合并顺序,以及默认单实例兼容边界。
|
|
201
205
|
|
|
202
|
-
### 消息同步与历史拉取改造方案
|
|
203
|
-
|
|
204
|
-
定义在原 Forward Cursor 上增加 A/T/H 实时扫描窗口:新 Head 一律先 Tail,仍有未扫描 Gap 时再执行一页后台 Forward;History 是独立只读 RPC。方案明确 A/T/H 只是扫描水位,SDK 仅保证响应页内唯一有序发布,跨页由应用按 message_id 幂等并按 seq 排序;同时区分物理 GC retention floor 与 Group Forward 成员可见性下界,规定缺 sender IK 时最多 3 秒 single-flight 同步 bootstrap、Forward 按服务端原始页最大 seq 推进、页内缺号视为永久空号、坏密文不阻塞水位、三个 Pull Gate 的前后台 FIFO 与 3 秒旁路,以及四语言 SDK、服务端、Gateway、兼容矩阵和分布式 E2E 门禁。
|
|
205
|
-
|
|
206
|
-
### P2P 消息 TTL 内存缓存方案
|
|
207
|
-
|
|
208
|
-
定义 P2P `message.send` 的秒级 `ttl` 语义:`ttl <= 0` 走原持久化路径,正数钳制到 1-3600 秒并进入不写数据库/WAL 的 volatile 通道。方案规定持久/volatile 独立游标、按 device 的内存收件箱、slot 隐藏的 lease/ACK、服务模块数据目录中的递增 epoch 文件、消息调试页的 volatile 计数器与 payload type 分类、重启丢失和多实例/跨域约束,并给出 Python/Go 服务端、四 SDK、单域、cross-SDK、E2E 与双域验收矩阵。
|
|
209
|
-
|
|
210
|
-
### 跨设备已读未读方案
|
|
211
|
-
|
|
212
|
-
定义同一 AID 多设备的业务已读状态模型。P2P `seq` 按设备隔离,设备按应用传入的 `topic_key` 保存最后已读 `message_id`;服务端依据消息公共顺序汇总各设备状态,查询只返回汇总 message ID 及其在当前设备上的 seq 映射。方案覆盖 P2P/Group、AID/话题/Group 过滤查询、单条/批量/部分会话上报、在线变更事件、定向消息边界、四端 SDK 和前端未读数计算。
|
|
213
|
-
|
|
214
|
-
### 跨设备已读未读详细设计
|
|
215
|
-
|
|
216
|
-
定义四个已读 RPC 的 wire 契约、顶层单条与显式空值边界、128 字符字段上限、紧凑状态表与幂等迁移、公共顺序和晚到位置持久回填、Group canonical ID 与跨实例权限版本、请求级提交及混合域部分提交;明确原事件 scope、必需 owner、Gateway 来源与路由,以及四端 SDK 的原查询登记、身份隔离、精确整数和本地补偿完成事件。
|
|
217
|
-
|
|
218
|
-
### 跨设备已读未读实施计划
|
|
219
|
-
|
|
220
|
-
按契约测试、Message/Group 紧凑状态表与兼容迁移、repository、RPC/Gateway、事件、四端 SDK、单域/E2E/cross-SDK/跨域验收的顺序实施;定义断点续跑、兼容性审查、测试文件规划和完成定义。
|
|
221
|
-
|
|
222
|
-
### 跨设备已读未读 SDK 集成指南
|
|
223
|
-
|
|
224
|
-
以 `@agentunion/fastaun` TypeScript SDK 为例,说明 AID 加载、Gateway 连接、P2P/Group 已读上报与查询、单调 `read_changed`、本地 `read_state_sync` 的 states/errors、number/精确字符串整数表示、`mapping_status` 解释和混合域重试边界。
|
|
225
|
-
|
|
226
|
-
### 跨设备已读未读 SDK 实现/移植指南
|
|
227
|
-
|
|
228
|
-
面向四端和其它语言 SDK 实现者,定义 wire 字段、128 字符约束、紧凑状态表与迁移重试、公共顺序和当前设备映射、请求级异步提交、事件/federation、原查询登记与身份隔离、本地完成事件、精确整数及验收矩阵。
|
|
229
|
-
|
|
230
|
-
### 跨设备已读未读代码审查报告
|
|
231
|
-
|
|
232
|
-
记录 2026-10-11 本轮顶层单条/空值、事件 scope/owner、Gateway 来源与路由、晚到位置持久回填、Group 别名和跨实例权限、事件 ID 与日志边界的补充修复,另覆盖 A→B→A 身份代际和 Gateway 已读结果无损整数,实际隔离验证、工具缺失及既有 runner 失败已汇总于报告第 7.3 节。R-01~R-17、2026-10-10 隔离回归和 2026-10-09 Docker 结果单列为历史证据;真实 MySQL、多实例、集成/E2E、共享 AID cross-SDK 和双域部署验收本轮未执行。
|
|
233
|
-
|
|
234
|
-
### 消息同步与历史拉取代码审查问题清单
|
|
235
|
-
|
|
236
|
-
以当前代码为唯一事实来源,汇总 Python/Go Message 与 Group 服务端、Python/Go Gateway、Python/TypeScript/Go/JavaScript SDK 的实现完整度和横向一致性。问题按 P0/P1/P2 排序,覆盖跨 Gap ACK、retention 与 Group Forward 可见性边界、崩溃窗口、异步任务代际、反向快照、History 分页、GC/WAL/cache、响应上限、敏感日志与诊断缺口;明确迁移完成后 Python Group inbox-only 为基准,Go Group 仍合并旧表必须对齐,并记录已排除的误报。
|
|
237
|
-
|
|
238
|
-
### AUN 服务 Go 化重构精细化源码审查
|
|
206
|
+
### 消息同步与历史拉取改造方案
|
|
207
|
+
|
|
208
|
+
定义在原 Forward Cursor 上增加 A/T/H 实时扫描窗口:新 Head 一律先 Tail,仍有未扫描 Gap 时再执行一页后台 Forward;History 是独立只读 RPC。方案明确 A/T/H 只是扫描水位,SDK 仅保证响应页内唯一有序发布,跨页由应用按 message_id 幂等并按 seq 排序;同时区分物理 GC retention floor 与 Group Forward 成员可见性下界,规定缺 sender IK 时最多 3 秒 single-flight 同步 bootstrap、Forward 按服务端原始页最大 seq 推进、页内缺号视为永久空号、坏密文不阻塞水位、三个 Pull Gate 的前后台 FIFO 与 3 秒旁路,以及四语言 SDK、服务端、Gateway、兼容矩阵和分布式 E2E 门禁。
|
|
209
|
+
|
|
210
|
+
### P2P 消息 TTL 内存缓存方案
|
|
211
|
+
|
|
212
|
+
定义 P2P `message.send` 的秒级 `ttl` 语义:`ttl <= 0` 走原持久化路径,正数钳制到 1-3600 秒并进入不写数据库/WAL 的 volatile 通道。方案规定持久/volatile 独立游标、按 device 的内存收件箱、slot 隐藏的 lease/ACK、服务模块数据目录中的递增 epoch 文件、消息调试页的 volatile 计数器与 payload type 分类、重启丢失和多实例/跨域约束,并给出 Python/Go 服务端、四 SDK、单域、cross-SDK、E2E 与双域验收矩阵。
|
|
213
|
+
|
|
214
|
+
### 跨设备已读未读方案
|
|
215
|
+
|
|
216
|
+
定义同一 AID 多设备的业务已读状态模型。P2P `seq` 按设备隔离,设备按应用传入的 `topic_key` 保存最后已读 `message_id`;服务端依据消息公共顺序汇总各设备状态,查询只返回汇总 message ID 及其在当前设备上的 seq 映射。方案覆盖 P2P/Group、AID/话题/Group 过滤查询、单条/批量/部分会话上报、在线变更事件、定向消息边界、四端 SDK 和前端未读数计算。
|
|
217
|
+
|
|
218
|
+
### 跨设备已读未读详细设计
|
|
219
|
+
|
|
220
|
+
定义四个已读 RPC 的 wire 契约、顶层单条与显式空值边界、128 字符字段上限、紧凑状态表与幂等迁移、公共顺序和晚到位置持久回填、Group canonical ID 与跨实例权限版本、请求级提交及混合域部分提交;明确原事件 scope、必需 owner、Gateway 来源与路由,以及四端 SDK 的原查询登记、身份隔离、精确整数和本地补偿完成事件。
|
|
221
|
+
|
|
222
|
+
### 跨设备已读未读实施计划
|
|
223
|
+
|
|
224
|
+
按契约测试、Message/Group 紧凑状态表与兼容迁移、repository、RPC/Gateway、事件、四端 SDK、单域/E2E/cross-SDK/跨域验收的顺序实施;定义断点续跑、兼容性审查、测试文件规划和完成定义。
|
|
225
|
+
|
|
226
|
+
### 跨设备已读未读 SDK 集成指南
|
|
227
|
+
|
|
228
|
+
以 `@agentunion/fastaun` TypeScript SDK 为例,说明 AID 加载、Gateway 连接、P2P/Group 已读上报与查询、单调 `read_changed`、本地 `read_state_sync` 的 states/errors、number/精确字符串整数表示、`mapping_status` 解释和混合域重试边界。
|
|
229
|
+
|
|
230
|
+
### 跨设备已读未读 SDK 实现/移植指南
|
|
231
|
+
|
|
232
|
+
面向四端和其它语言 SDK 实现者,定义 wire 字段、128 字符约束、紧凑状态表与迁移重试、公共顺序和当前设备映射、请求级异步提交、事件/federation、原查询登记与身份隔离、本地完成事件、精确整数及验收矩阵。
|
|
233
|
+
|
|
234
|
+
### 跨设备已读未读代码审查报告
|
|
235
|
+
|
|
236
|
+
记录 2026-10-11 本轮顶层单条/空值、事件 scope/owner、Gateway 来源与路由、晚到位置持久回填、Group 别名和跨实例权限、事件 ID 与日志边界的补充修复,另覆盖 A→B→A 身份代际和 Gateway 已读结果无损整数,实际隔离验证、工具缺失及既有 runner 失败已汇总于报告第 7.3 节。R-01~R-17、2026-10-10 隔离回归和 2026-10-09 Docker 结果单列为历史证据;真实 MySQL、多实例、集成/E2E、共享 AID cross-SDK 和双域部署验收本轮未执行。
|
|
237
|
+
|
|
238
|
+
### 消息同步与历史拉取代码审查问题清单
|
|
239
|
+
|
|
240
|
+
以当前代码为唯一事实来源,汇总 Python/Go Message 与 Group 服务端、Python/Go Gateway、Python/TypeScript/Go/JavaScript SDK 的实现完整度和横向一致性。问题按 P0/P1/P2 排序,覆盖跨 Gap ACK、retention 与 Group Forward 可见性边界、崩溃窗口、异步任务代际、反向快照、History 分页、GC/WAL/cache、响应上限、敏感日志与诊断缺口;明确迁移完成后 Python Group inbox-only 为基准,Go Group 仍合并旧表必须对齐,并记录已排除的误报。
|
|
241
|
+
|
|
242
|
+
### AUN 服务 Go 化重构精细化源码审查
|
|
239
243
|
|
|
240
244
|
以当前工作树为代码基线,逐项核对 auth、ca、gateway、group、leaderboard、message、nameservice、service_proxy、storage、stream 的 Go/Python 调用链和 RPC 字段,并记录修复后的最终状态。Storage 短 SHA panic、Gateway 签名与 service-plane ACL、Message audit/WAL、Group 关闭与游标、CA CT/nonce、Leaderboard 跨实例 recovery、Storage mount/collab、Proxy/Stream 资源预算等已知问题均已闭合;Claude 报告的 60 条已确认项、76 条候选与原 4 条误报已完成源码复审映射,其中候选 C71/C72 经源码再核确认为已修复的兼容性缺陷。当前开放 P0/P1/P2 为 0/0/0,十服务通过 Docker/Linux Go race/vet/gofmt,Python 两层对应套件合计为 2344 passed、0 skipped;真实单域/双域 E2E 仍作为发布前动态门槛。
|
|
241
245
|
|
|
@@ -275,75 +279,75 @@
|
|
|
275
279
|
|
|
276
280
|
定义 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 前置条件。
|
|
277
281
|
|
|
278
|
-
### 远程 agent.md 缓存与 ETag 透传方案
|
|
279
|
-
|
|
280
|
-
定义每个远程 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 一致性规则。
|
|
281
|
-
|
|
282
|
-
### agent.md Schema
|
|
283
|
-
|
|
282
|
+
### 远程 agent.md 缓存与 ETag 透传方案
|
|
283
|
+
|
|
284
|
+
定义每个远程 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 一致性规则。
|
|
285
|
+
|
|
286
|
+
### agent.md Schema
|
|
287
|
+
|
|
284
288
|
保留 legacy Ownership 2.0 的 agent.md/owner.md 独立声明、共识与撤销格式,不定义当前 2.1 的关系版本、owner 锁和释放终局。当前完整文件与身份校验见 [Ownership 协议定义 2.1](protocol/Ownership协议定义2.1.md);`docs/protocol/agent.md/SCHEMA.md` 则是更早的 legacy 1.0 副本。
|
|
285
|
-
|
|
286
|
-
### agent.md Schema 与签发/验签流程澄清记录
|
|
287
|
-
|
|
288
|
-
记录当前四端 SDK 的 agent.md Schema、尾部内嵌签名格式、签发与验签责任边界,并列出历史外挂 `.sig` 草案与当前实现的冲突。owner proof 可公开独立验证;只有 owner 关系创建、替换或撤销需要 Auth 验证写入,普通内容变化不触发关系审批;证书状态不因关系 pending 改变,legacy/绑定中保留基本登录通信;并记录 `unbound`/`unusable`、状态 pull/push、TTL、type-change 和 Storage 权限决策。该文档处于 working 状态,不是冻结协议。
|
|
289
|
-
|
|
290
|
-
### AID 类型、owner 关系与换 owner 编排方案
|
|
291
|
-
|
|
292
|
-
定义八种 AID 类型下的 owner 必填矩阵、human/agent owner 约束、agent 自主 self-owner、`owner` 与 `ownership_proof` 两字段、subject 与 owner 对三字段关系声明独立签名及 self-owner 单签。大多数场景可信任公开验签通过的 agent.md owner;旧/绑定中 AID 保留基本登录通信,具体 owner 依赖场景由应用层决定;只有关系创建、替换和撤销经 Auth 验证写入,协议冲突由 Auth 按台账与 CAS 裁定,并在绑定和 `agent.md` 激活时检查未解除关系;普通名片内容变化不触发关系审批。文档还涵盖当前 owner 发起并签署目标/版本绑定转移授权、`unbound`/`unusable`、无专门 recovery 及 owner-side 备份 ACL 生命周期。该文档处于 working 状态,不是冻结协议。
|
|
293
|
-
|
|
294
|
-
### AID 类型、owner 关系与 agent.md 签发/换 owner 完整设计与实施计划
|
|
295
|
-
|
|
296
|
-
汇总公开 proof 独立验签、Auth 关系写入与冲突仲裁边界、创建/换 owner/解绑流程、Storage 保留目录与内部对象操作、Auth/Name Service/Storage 和四端 SDK 调整,以及带阶段验收标准的实施 Checklist;其中 12A 节记录了已确认的 Phase 0 P0-A01 至 P0-A12 字段、可见分号 canonical bytes、hash/签名、receipt、TTL、证书状态与关系 operation 分离、legacy/绑定中基本登录通信、`unbound`/`unusable` 和 RPC 方向,剩余为正式 wire/RPC 文档及跨端向量落稿。普通关系读取不要求每次实时查询 Auth;需要确认最新状态的场景按新鲜度契约处理。该文档处于 working 状态,不是冻结协议。
|
|
297
|
-
|
|
298
|
-
### 本地 Docker 测试 Bug 清单
|
|
299
|
-
|
|
300
|
-
记录本轮 owner 关系实施及单域、cross-SDK、双域 federation 回归中发现的非任务失败,包括 Go SQL mock 期望缺失、损坏 Python 字节码、Tester 原生 ABI、身份游标污染、双域端口冲突和 Group 成员状态异步持久化断言竞态;每项均列出根因、修复动作和验证结果。
|
|
301
|
-
|
|
302
|
-
### 群索引版本提示与附件引用方案
|
|
289
|
+
|
|
290
|
+
### agent.md Schema 与签发/验签流程澄清记录
|
|
291
|
+
|
|
292
|
+
记录当前四端 SDK 的 agent.md Schema、尾部内嵌签名格式、签发与验签责任边界,并列出历史外挂 `.sig` 草案与当前实现的冲突。owner proof 可公开独立验证;只有 owner 关系创建、替换或撤销需要 Auth 验证写入,普通内容变化不触发关系审批;证书状态不因关系 pending 改变,legacy/绑定中保留基本登录通信;并记录 `unbound`/`unusable`、状态 pull/push、TTL、type-change 和 Storage 权限决策。该文档处于 working 状态,不是冻结协议。
|
|
293
|
+
|
|
294
|
+
### AID 类型、owner 关系与换 owner 编排方案
|
|
295
|
+
|
|
296
|
+
定义八种 AID 类型下的 owner 必填矩阵、human/agent owner 约束、agent 自主 self-owner、`owner` 与 `ownership_proof` 两字段、subject 与 owner 对三字段关系声明独立签名及 self-owner 单签。大多数场景可信任公开验签通过的 agent.md owner;旧/绑定中 AID 保留基本登录通信,具体 owner 依赖场景由应用层决定;只有关系创建、替换和撤销经 Auth 验证写入,协议冲突由 Auth 按台账与 CAS 裁定,并在绑定和 `agent.md` 激活时检查未解除关系;普通名片内容变化不触发关系审批。文档还涵盖当前 owner 发起并签署目标/版本绑定转移授权、`unbound`/`unusable`、无专门 recovery 及 owner-side 备份 ACL 生命周期。该文档处于 working 状态,不是冻结协议。
|
|
297
|
+
|
|
298
|
+
### AID 类型、owner 关系与 agent.md 签发/换 owner 完整设计与实施计划
|
|
299
|
+
|
|
300
|
+
汇总公开 proof 独立验签、Auth 关系写入与冲突仲裁边界、创建/换 owner/解绑流程、Storage 保留目录与内部对象操作、Auth/Name Service/Storage 和四端 SDK 调整,以及带阶段验收标准的实施 Checklist;其中 12A 节记录了已确认的 Phase 0 P0-A01 至 P0-A12 字段、可见分号 canonical bytes、hash/签名、receipt、TTL、证书状态与关系 operation 分离、legacy/绑定中基本登录通信、`unbound`/`unusable` 和 RPC 方向,剩余为正式 wire/RPC 文档及跨端向量落稿。普通关系读取不要求每次实时查询 Auth;需要确认最新状态的场景按新鲜度契约处理。该文档处于 working 状态,不是冻结协议。
|
|
301
|
+
|
|
302
|
+
### 本地 Docker 测试 Bug 清单
|
|
303
|
+
|
|
304
|
+
记录本轮 owner 关系实施及单域、cross-SDK、双域 federation 回归中发现的非任务失败,包括 Go SQL mock 期望缺失、损坏 Python 字节码、Tester 原生 ABI、身份游标污染、双域端口冲突和 Group 成员状态异步持久化断言竞态;每项均列出根因、修复动作和验证结果。
|
|
305
|
+
|
|
306
|
+
### 群索引版本提示与附件引用方案
|
|
303
307
|
|
|
304
308
|
定义 `group.index` 的 owner/admin SDK 生成、canonical JSONL、签名、`etag` / `body_hash`、`expected_index_etag` CAS、`_meta.group_indexes` 版本提示、Gateway/Message 转发边界、服务端正/负缓存、singleflight、写后失效/刷新、注入频率控制,以及 DB 保存核心设置、group.fs 保存大附件、附件稳定引用和 SDK `check/get/updateGroupIndex` 语义。
|
|
305
309
|
|
|
306
|
-
### SDK 文档索引
|
|
307
|
-
|
|
308
|
-
`docs/sdk/INDEX.md` 是 SDK 手册的三层子索引,覆盖快速开始、连接认证、E2EE V2、P2P device/TTL volatile 消息、Group 成员控制与两阶段群主转让、Storage MIME/Content-Type/OSS 403、Python `ErrorInfo.cause`、Group FS、Collab 和各类 RPC 手册。
|
|
309
|
-
|
|
310
|
-
### ProtectedHeaders 用法专题
|
|
311
|
-
|
|
312
|
-
按当前四端 SDK 实现整理 `protected_headers` 的实例级与单次调用方式、兼容别名、key/value 规范化、E2EE V2 元数据 HMAC、自动字段、解密失败信任边界,以及明文和裸 RPC 的适用边界。
|
|
313
|
-
|
|
314
|
-
### Ownership 管理专题
|
|
315
|
-
|
|
310
|
+
### SDK 文档索引
|
|
311
|
+
|
|
312
|
+
`docs/sdk/INDEX.md` 是 SDK 手册的三层子索引,覆盖快速开始、连接认证、E2EE V2、P2P device/TTL volatile 消息、Group 成员控制与两阶段群主转让、Storage MIME/Content-Type/OSS 403、Python `ErrorInfo.cause`、Group FS、Collab 和各类 RPC 手册。
|
|
313
|
+
|
|
314
|
+
### ProtectedHeaders 用法专题
|
|
315
|
+
|
|
316
|
+
按当前四端 SDK 实现整理 `protected_headers` 的实例级与单次调用方式、兼容别名、key/value 规范化、E2EE V2 元数据 HMAC、自动字段、解密失败信任边界,以及明文和裸 RPC 的适用边界。
|
|
317
|
+
|
|
318
|
+
### Ownership 管理专题
|
|
319
|
+
|
|
316
320
|
保留 legacy `aun.ownership.v1` 四端 proof、托管、代签、代上传和 rekey 历史记录;文中“当前”指该历史基线,不作为 Ownership 2.1 契约或接入依据。
|
|
317
321
|
|
|
318
322
|
### Ownership 协议定义 2.1
|
|
319
323
|
|
|
320
|
-
|
|
324
|
+
定义 NS 当前 `agent.md` 与 owner Storage 当前 `owner.md` 的原始字节多签、逐块 prefix 验证、multi-v1 表示协商、自身份上传、owner.md 权限和当前关系校验;owner 锁与响应 Header 只投影本次材料的校验结果。release 保持被释放的版本 v,sub 清理关系字段后的版本投影为 0、再次绑定默认 1;转移仍核对 v 与 v+1。Group/Org 创建自动绑定、解散自动解绑、专属转移强制 rekey,实体名片以实体主签、owner token 上传与可选 owner 附签单独分流;三个时间字段统一安全整数范围,invalid 与 unavailable 分别表示无效与不可用。实体 pending 固定完整多签原文、owner/实体代际及原 CAS,取消额外 V2 上传授权与过期窗口,应用显式重试仍须新鲜核对当前代际;同全文/ETag 已提交仅观察确认。SDK 普通 P2P 编排仅作非权威协作,不构成协议层授权。新服务端保留旧 SDK 注册、绑定、转移、查询和解绑 RPC 及隔离的 Auth JSONL,仅激活旧 NS ownership_proof;不写 2.1 双文件,不授 2.1 lock/version/consensus,也不覆盖已存现代声明。
|
|
321
325
|
|
|
322
326
|
### Ownership SDK 编排指南 2.1
|
|
323
327
|
|
|
324
328
|
定义七 Facade、明确审批、普通加密 P2P 载荷、公共 local_roles 与请求身份、本地事件、按角色核对完成证据和新鲜权威恢复;冻结重复发起复用、错误与任务状态分别记录、时间整数边界,文件保存、关系完成与清理分别跟踪;整体 30 秒从首次 GET 前计时,接收方固定授权摘要/期限,无控制消息也按精确本人历史同意恢复清理。
|
|
325
329
|
|
|
326
|
-
Group/Org 作为 sub
|
|
330
|
+
Group/Org 作为 sub 时不进入这些通用任务或审批;以其为 sub 误调用直接 not_applicable,符合普通 owner 规则时仍可作为 owner_aid。实体 owner 创建自动建立、解散自动解除,专属转移强制 rekey,名片由实体主签、owner token 上传,可选 owner 附签不改变当前授权。
|
|
327
331
|
|
|
328
332
|
### Ownership 2.1 SDK 应用集成指南
|
|
329
333
|
|
|
330
|
-
|
|
334
|
+
说明普通 agent 注册 owner 可选、应用身份准备、sign/verify 公共门面、显式文件输入与多签结果、Group/Org 实体主签和 owner 上传、审批 UI/策略、任务事件、新鲜 checkOwnershipConsensus 和恢复接入;普通下载 ownership_status 保留 legacy proof 展示语义,不能作为 2.1 授权结果;实体 pending 保留完整原件和原 CAS,由应用显式重试。
|
|
331
335
|
|
|
332
336
|
### Ownership 2.1 SDK 开发与移植指南
|
|
333
337
|
|
|
334
|
-
以当前 Node TS
|
|
338
|
+
以当前 Node TS 接线为参考,说明公开签验门面与唯一内部核心、多签 prefix、离线证书与显式 resolver、HTTP 表示协商和现代实体指纹绑定;Storage authoritative 保留当前完整原文/摘要/存在性,object_id/version 不作为读取一致性或共识条件;owner.md 使用 create_upload_session→HTTP PUT→complete_upload 的同一会话,沿用 expected_version 作发布 CAS,agent 保留原 ETag,持久 CAS/outbox 恢复不刷新原提交条件;HTTP 428 统一映射 unsupported_protocol;通知恢复发送前逐条核对新鲜 NS,不以参考实现代替各语言验收;严格 OCSP issuer 绑定、本人原件/任务上下文和实体 pending 完整原件恢复以协议与逐项裁决为准,不默认全部行为以 TS 为准。
|
|
335
339
|
|
|
336
340
|
### Ownership 2.1 详细设计
|
|
337
341
|
|
|
338
|
-
定义四 SDK、NS、Storage
|
|
342
|
+
定义四 SDK、NS、Storage 的组件职责、NS原ETag、owner.md 同会话完整发布与 expected_version CAS、名片同步、legacy RPC/Auth JSONL 隔离与 agent.md 非回归;NS 可信内部 Storage 副本仅限本域 default/agent.md,不经客户端会话,不写删 owner.md,也不替代 NS 权威;Ownership 关系事实只由持久化的 `sub_aid/agent.md` 与 owner_aid 规范路径的 `owner.md` 提供,Header 只投影本次校验结果;补 release 保持 v、清理后版本投影为 0/重绑默认 1,以及当前时间 OCSP 复核、原文件及 CAS 固定、无消息释放清理和实体多签恢复边界。
|
|
339
343
|
|
|
340
344
|
### Ownership 2.1 TDD 分阶段实施计划
|
|
341
345
|
|
|
342
|
-
|
|
346
|
+
保存当前实施顺序、共同向量、原实施阶段冻结契约与历史测试账本,统一 Group/Org 的 sub 边界、HTTP 428/错误分类及非权威 P2P;第 13 节记录当时各端源码、运行版本、恢复进程边界及未验证环境,第 13.3 节的历史冻结契约不覆盖当前协议;旧群自签/token 上传结果保留为旧契约事实,不能作为新 owner 本人名片契约验收;第 13.7 节单列 2026-10-11 的 13 项复审后本地验证,第 13.8 节关联 2026-10-13 更正与修复边界,不改写历史网络账本。
|
|
343
347
|
|
|
344
348
|
### Ownership 2.1 代码审查报告
|
|
345
349
|
|
|
346
|
-
保留首次审查的实现完整性、协议一致性、四端差异及服务端问题;第九节记录用户授权后的 6 个 P1、12 个 P2、追加恢复窗口修复、受影响测试证据和验证边界;第十节记录三项契约冻结与本地验证,第十一节记录 Group/Org 既有转移/解散上的约束与恢复修复、owner 本人名片和 V2
|
|
350
|
+
保留首次审查的实现完整性、协议一致性、四端差异及服务端问题;第九节记录用户授权后的 6 个 P1、12 个 P2、追加恢复窗口修复、受影响测试证据和验证边界;第十节记录三项契约冻结与本地验证,第十一节记录 Group/Org 既有转移/解散上的约束与恢复修复、owner 本人名片和 V2 授权、四端与服务按断点取得的本地测试证据、已知基线首败及未执行环境验收。第十二节记录 6 个 P1、7 个 P2、V2 过期停止自动重传的用户决定和断点回归。第十三节记录 2026-10-13 的误报撤回与最小修复;第十四节保留本轮中间状态,第十五节记录 2026-10-15 的当前裁决、15 项追加问题和修复:agent owner 可选、四端会话/CAS及读取错误、旧 SDK Auth/NS/Gateway 隔离入口、Group 历史副本、Storage 精确 ACL/持久化/撤权墓碑,以及独立测试批次和未执行部署边界。不能从历史状态或本地单测外推真实旧 SDK 全流程兼容验收。
|
|
347
351
|
|
|
348
352
|
### Ownership SDK 集成指南
|
|
349
353
|
|
|
@@ -356,28 +360,30 @@ Group/Org 作为 sub 时不进入这些通用任务、审批或 NS Ownership 账
|
|
|
356
360
|
### Ownership 协议定义
|
|
357
361
|
|
|
358
362
|
保留 legacy `aun.ownership.v1`、proof、托管和 owner 代上传授权格式;当前文件、锁、版本及审计以 [协议定义 2.1](protocol/Ownership协议定义2.1.md) 为准。
|
|
359
|
-
|
|
360
|
-
### Service Proxy RPC 手册
|
|
363
|
+
|
|
364
|
+
### Service Proxy RPC 手册
|
|
361
365
|
|
|
362
366
|
定义 `proxy.register_services` / `proxy.unregister_services` / `proxy.list_services` 的 Gateway 控制面语义,以及 proxy-server `register_services` 数据面隧道消息、服务列表与连接绑定、一致性约束和 wakeup 路由策略。
|
|
363
367
|
|
|
364
|
-
### SDK 查阅指南
|
|
365
|
-
|
|
366
|
-
`docs/sdk/AUN_DOCS_GUIDE.md` 说明如何按行区间渐进式读取 SDK 文档,避免一次性加载过多文档内容。
|
|
368
|
+
### SDK 查阅指南
|
|
369
|
+
|
|
370
|
+
`docs/sdk/AUN_DOCS_GUIDE.md` 说明如何按行区间渐进式读取 SDK 文档,避免一次性加载过多文档内容。
|
|
367
371
|
|
|
368
372
|
### 凭证与组织服务 SDK 指南
|
|
369
373
|
|
|
370
374
|
[应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md)覆盖 service-plane 边界、完整验证、Credential 请求绑定、受保护读取、首次 admission、创建/转让恢复及解散清理;[开发与移植指南](sdk/凭证与组织服务SDK开发与移植指南.md)定义四端共同密码学、CAP、binding、facade/RPC、checkpoint 和测试向量契约。
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
375
|
+
|
|
376
|
+
[凭证服务 RPC 手册](sdk/09-凭证服务RPC手册.md)与[组织服务 RPC 手册](sdk/09-组织服务RPC手册.md)按两个服务当前 dispatcher 描述实际方法、请求用途和受限/未实现边界。
|
|
377
|
+
|
|
378
|
+
### AUN SDK 0.5.6 更新日志
|
|
379
|
+
|
|
380
|
+
`docs/sdk/CHANGELOG-0.5.6.md` 以 `ce56814a` 的 0.5.5 发布提交为基线,汇总四语言共有的 peer 证书回源、`group.index` / indexed settings / `agent.md` 下载提交前校验、可信缓存读取、消息窗口和 inline realtime,并明确 Python Push、Go Push 合同测试以及文件型 change-seed 的语言边界。
|
|
381
|
+
|
|
382
|
+
### 四 SDK 版本对齐变更清单
|
|
383
|
+
|
|
384
|
+
`python/CHANGES_FOR_PARITY.md` 以 Python SDK 历史实现为主线记录 Go / TypeScript / JavaScript 的对齐要求。当前 v0.5.20 章节以已发布 v0.5.19 对应的 `ab05792f` 快照为基线,记录通用多签与实体主签、离线草稿、Ownership 原件 CAS 和 release/清理/重绑、namespace 并发补拉与末页 ACK、撤回及已读队列语言差异、凭证最终时效和注册/CLI 兼容;列出四端 API、Python 函数定位及测试入口,并保留 v0.5.19 和更早历史章节。
|
|
385
|
+
|
|
386
|
+
### AUN CLI 手册
|
|
381
387
|
|
|
382
388
|
面向 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,并给出常用示例和退出码。
|
|
383
389
|
|
|
@@ -387,7 +393,7 @@ Group/Org 作为 sub 时不进入这些通用任务、审批或 NS Ownership 账
|
|
|
387
393
|
|
|
388
394
|
### AUN Storage 架构设计
|
|
389
395
|
|
|
390
|
-
定义 AUN Storage 的 SDK VFS、low-level storage client、Storage Service、Storage Core、Metadata Engine 和 Blob Backend 分层。大文件主数据流量直连 localfs/OSS/S3/COS backend,控制面通过 `storage.*` RPC 管理权限、配额、session/ticket、元数据提交和事件;普通应用通过 SDK VFS 使用类 POSIX 文件操作。SDK 手册补充四语言实际字节 MIME 识别、session/PUT/complete Content-Type 一致性和 OSS 403 边界;底层 RPC 保留给能自行完成该编排的高级客户端。
|
|
396
|
+
定义 AUN Storage 的 SDK VFS、low-level storage client、Storage Service、Storage Core、Metadata Engine 和 Blob Backend 分层。大文件主数据流量直连 localfs/OSS/S3/COS backend,控制面通过 `storage.*` RPC 管理权限、配额、session/ticket、元数据提交和事件;普通应用通过 SDK VFS 使用类 POSIX 文件操作。SDK 手册补充四语言实际字节 MIME 识别、session/PUT/complete Content-Type 一致性和 OSS 403 边界;底层 RPC 保留给能自行完成该编排的高级客户端。
|
|
391
397
|
|
|
392
398
|
### AUN Storage SDK 存储分层设计
|
|
393
399
|
|
|
@@ -425,10 +431,10 @@ Group/Org 作为 sub 时不进入这些通用任务、审批或 NS Ownership 账
|
|
|
425
431
|
|
|
426
432
|
定义 collab 是锚定在 storage 上的自包含版本化目录,服务端负责 `collab.*` 编排、`collab_ledger` 台账、乐观锁、行级 diff3、snapshot、export/adopt、prune 和群协作注册表。Plan 1 拆解 storage 进程内服务端基础实现和测试;Plan 2 扩展 Python SDK/CLI 与单域 Docker E2E;Plan 3 扩展 Go / TypeScript / JavaScript SDK、跨语言互操作和双域边界验证。
|
|
427
433
|
|
|
428
|
-
### Notify 通知方案
|
|
429
|
-
|
|
430
|
-
定义 `client.notify()` 的 JSON-RPC Notification 发送语义。方案规定 notify 只投递在线长连接设备,不做离线存储、不分配 seq、不进入 pull/ack;同时说明服务端通知、AID 在线转发、群在线转发、跨域 federation 转发的路由模型,以及和 `message.send` / `group.send` 可靠应用事件的分工。
|
|
431
|
-
|
|
432
|
-
### AUN 离线推送 Push Service
|
|
433
|
-
|
|
434
|
-
设计文档定义独立 Go Push Service 的职责、通信平面、持久状态机、在线复核、批次投递、故障恢复、安全和三中心纳管;Python `connect()` 把 `push_notify_aid/push_token` 映射为显式 `push.register`,运行期通过 PushFacade 登记或注销,认证协议本身不扩展字段。[接入与演示指南](AUN离线推送接入与演示指南.md)从终端、Push Server 两侧给出 token、长连接、幂等 ACK、Mock smoke 和排障路径。[离线推送通知协议](protocol/15-离线推送通知协议.md)给出对外字段和可靠性边界。契约冻结文档固定确定 Session、批次级 ACK、不可变 membership、candidate 汇总、恢复、Gateway ACL 和关闭顺序。v4 计划只定义范围、依赖和验收,Task TDD 在实施时展开。[运维与发布指南](AUN离线推送服务运维与发布指南.md)补充发布门、身份材料、Mock Python SDK 应用层恢复、灰度和回滚,并明确生产仍受 token 加密硬阻断。旧 Codex 文档只作为历史背景。
|
|
434
|
+
### Notify 通知方案
|
|
435
|
+
|
|
436
|
+
定义 `client.notify()` 的 JSON-RPC Notification 发送语义。方案规定 notify 只投递在线长连接设备,不做离线存储、不分配 seq、不进入 pull/ack;同时说明服务端通知、AID 在线转发、群在线转发、跨域 federation 转发的路由模型,以及和 `message.send` / `group.send` 可靠应用事件的分工。
|
|
437
|
+
|
|
438
|
+
### AUN 离线推送 Push Service
|
|
439
|
+
|
|
440
|
+
设计文档定义独立 Go Push Service 的职责、通信平面、持久状态机、在线复核、批次投递、故障恢复、安全和三中心纳管;Python `connect()` 把 `push_notify_aid/push_token` 映射为显式 `push.register`,运行期通过 PushFacade 登记或注销,认证协议本身不扩展字段。[接入与演示指南](AUN离线推送接入与演示指南.md)从终端、Push Server 两侧给出 token、长连接、幂等 ACK、Mock smoke 和排障路径。[离线推送通知协议](protocol/15-离线推送通知协议.md)给出对外字段和可靠性边界。契约冻结文档固定确定 Session、批次级 ACK、不可变 membership、candidate 汇总、恢复、Gateway ACL 和关闭顺序。v4 计划只定义范围、依赖和验收,Task TDD 在实施时展开。[运维与发布指南](AUN离线推送服务运维与发布指南.md)补充发布门、身份材料、Mock Python SDK 应用层恢复、灰度和回滚,并明确生产仍受 token 加密硬阻断。旧 Codex 文档只作为历史背景。
|