@agentunion/fastaun-browser 0.4.4 → 0.4.5

package/_packed_docs/0.4.0_/345/267/256/345/274/202/346/240/270/345/256/236/345/206/263/347/255/226/350/256/260/345/275/225.md

@@ -1,302 +0,0 @@
-# AUN SDK 0.4.0 差异核实决策记录
-
-**创建日期**：2026-05-30
-
----
-
-## #1 / #2 / #3 — `load()` / `list()` / `changeSeed()` 同步 vs 异步
-
-| 方法 | 设计文档 | TS | JS | Python | Go |
-|------|---------|----|----|--------|-----|
-| `load()` | Promise | 同步 | 异步 | 同步 | 同步 |
-| `list()` | Promise | 同步 | 异步 | 同步 | 同步 |
-| `changeSeed()` | Promise | 同步 | 异步 | 同步 | 同步 |
-
-**决策**：设计文档改为同步。JS SDK 允许保持异步作为平台例外。
-
-**原因**：
-1. 三个方法都是纯本地操作（读文件、扫目录、重加密私钥），不涉及网络IO
-2. 毫秒级完成，无需异步
-3. 同步API更简洁，调用方不需要 await
-4. TS/Python/Go 三个SDK已经是同步实现，JS 是唯一的异步版本
-5. JS 保持异步的原因：底层存储是 IndexedDB（浏览器原生 API），所有操作均为异步，无同步版本，**无法改为同步，属于平台硬约束**
-
-**行动项**：
-- [ ] 更新设计文档 `load()` / `list()` / `changeSeed()` 签名为同步
-- [ ] 设计文档中注明 JS SDK 因浏览器环境限制保持异步
-
----
-
-## #4 — `resolve()` 等方法返回类型精度
-
-| 方法 | 设计文档 | TS/JS | Python | Go |
-|------|---------|-------|--------|-----|
-| `resolve()` | 强类型 | ✅ `ResolveResult` | ✅ `ResolveResult` TypedDict | ✅ 强类型 |
-| `fetchAgentMd()` | 强类型 | ✅ `FetchAgentMdResult` | ✅ `FetchAgentMdResult` TypedDict | ✅ 强类型 |
-| `headAgentMd()` | 强类型 | ✅ `HeadAgentMdResult` | ✅ `HeadAgentMdResult` TypedDict | ✅ 强类型 |
-| `checkAgentMd()` | 强类型 | ✅ `CheckAgentMdResult` | ✅ `CheckAgentMdResult` TypedDict | ✅ 强类型 |
-| `diagnose()` | 强类型 | ✅ `DiagnoseResult` | ✅ `DiagnoseResult` TypedDict | ✅ 强类型 |
-| `renewCert()` | 强类型 | ✅ `RenewCertResult` | ✅ `RenewCertResult` TypedDict | ✅ 强类型 |
-| `rekey()` | 强类型 | ✅ `RekeyResult` | ✅ `RekeyResult` TypedDict | ✅ 强类型 |
-
-**决策**：所有 SDK 均改为强类型返回。**已全部完成（v0.4.2）。**
-
-**行动项**：
-- [x] TS/JS `aid-store.ts` 定义具名类型，替换 `Record<string, unknown>`
-- [x] Python `aid_store.py` 定义对应 TypedDict，替换 `dict[str, Any]`
-- [ ] 更新设计文档类型定义章节
-
----
-
-## #5 — AIDStore 额外构造参数
-
-| 参数 | 设计文档 | 各SDK现状 | 决策 |
-|------|---------|----------|------|
-| `aunPath` | ✅ 有 | 全部有 | 保留 |
-| `encryptionSeed` | ✅ 有 | 全部有 | 保留 |
-| `deviceId?` | ✅ 有 | 全部有 | 保留 |
-| `slotId?` | ✅ 有 | 全部有 | 保留 |
-| `verifySsl?` | ❌ 无 | 全部有 | **保留，补充进设计文档** |
-| `rootCaPath?` | ❌ 无 | 全部有 | **保留，补充进设计文档** |
-| `debug?` | ❌ 无 | 全部有 | **保留，补充进设计文档** |
-| `discoveryPort?` | ❌ 无 | 全部有 | **移除** ✅ |
-
-**决策**：
-- 保留 `verifySsl`、`rootCaPath`、`debug`，补充进设计文档
-- 移除 `discoveryPort`：服务发现不应指定端口，端口应由服务发现机制自动解析
-- **已全部完成（v0.4.2）：`discoveryPort` 已从四个 SDK 移除；`rootCaPath` 已加入。**
-
-**原因**：
-- `verifySsl`：测试环境需要关闭 SSL 校验，实用参数
-- `rootCaPath`：私有部署需要自定义根证书，必要参数
-- `debug`：控制日志级别，调试必备
-- `discoveryPort`：硬编码端口违背服务发现的设计意图，应由 gateway URL 或 DNS SRV 等机制自动确定
-
-**行动项**：
-- [x] 设计文档 AIDStore 构造参数补充 `verifySsl?`、`rootCaPath?`、`debug?`（待同步文档）
-- [x] 各 SDK 移除 `discoveryPort` 参数及相关逻辑
-- [x] 移除后 agent.md URL 拼接改为从 gateway URL 自动推导端口
-
----
-
-## #6 — `AIDStore.close()` 方法
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| `close()` | 未提及 | 存在 | 存在 | 存在 | 存在 |
-
-**决策**：保留，补充进设计文档。
-
-**原因**：AIDStore 内部持有 HTTP client、缓存等资源，需要显式释放。所有 SDK 已实现，属于合理的资源管理方法。
-
-**行动项**：
-- [ ] 设计文档 AIDStore 操作表补充 `close()` 方法
-
----
-
-## #7 — AID 额外属性 `deviceId` / `slotId`
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| `AID.deviceId` | 无 | `readonly deviceId: string` | 同TS | `device_id: str` | 有 |
-| `AID.slotId` | 无 | `readonly slotId: string` | 同TS | `slot_id: str` | 有 |
-
-**决策**：保留，补充进设计文档 AID 只读属性列表。
-
-**原因**：AID 携带创建它的 AIDStore 的 deviceId/slotId，AUNClient 连接时需要传给服务端标识消费通道。这是多设备/多实例支持的必要信息传递路径。
-
-**行动项**：
-- [ ] 设计文档 2.5 AID 只读属性表补充 `deviceId` 和 `slotId`
-
----
-
-## #8 — AIDInfo 额外字段 `certFingerprint`
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| `AIDInfo` | `{ aid, certNotAfter, certIssuer }` | 多了 `certFingerprint` | 同TS | 多了 `cert_fingerprint` | 多了 `CertFingerprint` |
-
-**决策**：保留，补充进设计文档 `AIDInfo` 类型定义。
-
-**原因**：证书 SHA-256 指纹是身份的唯一标识，列出身份时提供 fingerprint 便于比对、日志和 UI 展示，无额外开销（load 时已计算）。
-
-**行动项**：
-- [ ] 设计文档 2.2 `AIDInfo` 类型定义补充 `certFingerprint: string`
-
----
-
-## #9 — AUNClient 构造签名
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| 构造签名 | `constructor(aid?: AID)` | ✅ `constructor(aid?: AID)` | ✅ `constructor(aid?: AID)` | ✅ `__init__(aid=None)` | ✅ `NewAUNClient(aid *AID)` |
-
-**决策**：收紧为设计文档的纯粹设计——`constructor(aid?: AID)`，移除 options 重载。**已全部完成（v0.4.2）。**
-
-**机制**：
-- AIDStore 在 `load()` 时将必要配置（`aunPath`、`verifySsl`、`rootCaPath`、`debug`）作为只读属性附加到 AID 对象
-- AUNClient 从 AID 对象上读取所有配置，不再单独接受 options 参数
-- Go 额外：`LoadIdentity(aid)` 在 aunPath 变化时自动重建 keystore/auth/net（对齐 Python `_rebuild_runtime_for_identity`）
-
-**行动项**：
-- [x] 各 SDK 移除 AUNClient 的 options 重载，只保留 `constructor(aid?: AID)`
-- [x] AID 对象携带只读属性：`aunPath`、`verifySsl`、`rootCaPath`、`debug`（由 AIDStore.load() 注入）
-- [ ] 设计文档 AID 只读属性表补充上述字段
-- [ ] 设计文档明确 AUNClient 必须通过 AIDStore 创建的 AID 使用
-
----
-
-## #10 — `setLocalAgentMdPath` 方法
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| `setLocalAgentMdPath` | 已移除 | ✅ 已移除 | ✅ 已移除 | ✅ 已移除 | ✅ 已移除 |
-
-**决策**：从各 SDK 中移除。**已全部完成（v0.4.0）。**
-
-**行动项**：
-- [x] TS/JS/Python/Go 各 SDK 删除 `setLocalAgentMdPath` 方法及相关逻辑
-
----
-
-## #11 — `uploadAgentMd` 可见性
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| `uploadAgentMd` | 公开 | 私有 `_uploadAgentMd` | 同TS | 私有 | 私有 |
-
-**决策**：`uploadAgentMd` 保持私有，设计文档删除该公开方法。
-
-**原因**：`publishAgentMd` 已封装签名+上传全流程，无需再暴露裸上传接口，减少公开 API 面。
-
-**行动项**：
-- [ ] 设计文档 3.2.4 方法可用性矩阵及 4.3 操作表删除 `uploadAgentMd` 行
-
----
-
-## #12 — `authenticate()` 状态约束
-
-| | 设计文档 | TS/JS | Python | Go |
-|---|---------|-------|--------|-----|
-| 允许状态 | 仅 Standby | ✅ 仅 Standby | ✅ 仅 Standby | ✅ 仅 Standby |
-
-**决策**：所有 SDK 统一为仅 Standby 状态可调。**已全部完成（v0.4.2）。**
-
-**行动项**：
-- [x] TS/JS 收紧 `authenticate()` 状态检查：移除 Authenticated 状态的允许
-- [x] Go 补充显式状态检查：仅 Standby 可调
-
----
-
-## #13 — `connect()` 参数
-
-| | 设计文档 | TS/JS | Python | Go |
-|---|---------|-------|--------|-----|
-| 参数 | `{ gateway? }` | `connect(options?: RpcParams)` | `connect(options?: dict)` | `Connect(ctx, opts...)` |
-
-**决策**：`connect()` 无参数，签名改为 `connect(): Promise<void>`。
-
-**机制**：
-- `authenticate()` 执行后，将结果缓存到 AUNClient 私有字段：`_gatewayUrl`、`_accessToken`、`_refreshToken`
-- `connect()` 直接使用缓存的 gateway URL 和 token 建立连接
-- 若未 authenticate，`connect()` 内部自动先调用 `authenticate()`（使用 AID 中的配置发现 gateway）
-- cached token/URL 的复用也在 authenticate 流程内部完成
-
-**原因**：gateway URL 是认证结果的一部分，不应由调用方传入；connect 只管建连接，不管配置。
-
-**行动项**：
-- [ ] 各 SDK `connect()` 移除参数
-- [ ] 设计文档更新 `connect()` 签名为无参数，并说明 gateway URL 来源
-
----
-
-## #14 — ConnectionState 命名风格
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| 命名 | kebab-case | snake_case | snake_case | snake_case | snake_case |
-
-**决策**：以 SDK 的 snake_case 为准，设计文档更新。
-
-**原因**：kebab-case（含 `-`）在多数语言中不是合法标识符，snake_case 跨语言通用。
-
-**行动项**：
-- [ ] 设计文档全文将 `'no-identity'`、`'retry-backoff'`、`'connection-failed'` 等改为 snake_case
-
----
-
-## #15 — `ResolveOpts.timeout` 缺失
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| `timeout?` | 有，默认 10000ms | ✅ 已实现 | 待核实 | 待核实 | ✅ 已实现 |
-
-**决策**：各 SDK 补充 `timeout` 参数，默认值 10000ms，与设计文档一致。
-
-**行动项**：
-- [x] TS `ResolveOpts` 补充 `timeout?: number`，默认 10000
-- [ ] JS `ResolveOpts` 补充 `timeout?: number`，默认 10000
-- [ ] Python `resolve()` 补充 `timeout: int = 10000`
-- [x] Go `AIDStoreResolveOptions` 补充 `Timeout time.Duration`，默认 10s
-
----
-
-## #17 — `changeSeed()` 返回类型不一致
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| 返回 | `Result<{ changed: true, count: number }>` | ✅ `Result<ChangeSeedResult>` | ✅ `Result<ChangeSeedResult>`（async） | ✅ `Result[ChangeSeedResult]` | ✅ `Result[ChangeSeedResult]` |
-
-**决策**：统一为强类型，`{ changed: boolean; count: number }`。**已全部完成（v0.4.2）。**
-
-**行动项**：
-- [x] Python `change_seed()` 返回类型改为 `Result[ChangeSeedResult]`
-- [x] Go `ChangeSeed()` 返回改为 `Result[ChangeSeedResult]`，含 `Changed bool` + `Count int`
-
----
-
-## #18 — `list()` 返回包装不一致
-
-| | 设计文档 | TS | JS | Python | Go |
-|---|---------|----|----|--------|-----|
-| 返回 | `Result<{ identities: AIDInfo[] }>` | ✅ 一致 | ✅ 一致（async） | ✅ `Result[ListResult]` | ✅ `Result[ListResult]` |
-
-**决策**：统一为强类型 Result 包装。**已全部完成（v0.4.2）。**
-
-**行动项**：
-- [x] Python `list()` 返回类型改为 `Result[ListResult]`
-- [x] Go `List()` 返回改为 `Result[ListResult]`
-
----
-
-## #19/#20 — `resolve()` / `renewCert()` / `rekey()` 返回类型
-
-已在 **#4** 中统一决策，此处不重复。
-
----
-
-## #21 — `authenticate()` 状态约束跨SDK不一致
-
-已在 **#12** 中统一决策，此处不重复。
-
----
-
-## #22 — `load()` / `list()` / `changeSeed()` 同步性
-
-已在 **#1/#2/#3** 中统一决策，此处不重复。
-
----
-
-## #23 — Go 不使用 Result 包装
-
-| | 设计文档 | TS/JS/Python | Go |
-|---|---------|-------------|-----|
-| 错误处理 | `Result<T>` | `Result<T>` | ✅ `Result[T]`（泛型，`go/result.go`） |
-
-**决策**：Go 也统一使用 Result 包装。**已完成（v0.4.2）：`go/result.go` 实现泛型 `Result[T]`，AIDStore 所有公开方法已改为 `Result[T]` 返回。**
-
-**行动项**：
-- [x] Go 新增泛型 `Result[T]` 类型（`go/result.go`）
-- [x] Go AIDStore 所有公开方法返回值改为 `Result[T]`
-- [ ] Go AUNClient 公开方法返回值改为 `Result[T]`（待评估范围）
-

package/_packed_docs/AUN_SDK_0.4.0_/350/256/276/350/256/241/345/257/271/346/257/224/345/210/206/346/236/220.md

@@ -1,194 +0,0 @@
-# AUN SDK 0.4.0 — 设计文档 vs 实际实现对比分析
-
-**分析日期**：2026-05-30  
-**SDK 版本**：`@agentunion/fastaun@0.4.0`  
-**对比基准**：`docs/AUN_SDK_重构设计方案_v3.md`（实际标题 v4.0）
-
----
-
-## 一、一致的部分
-
-| 设计项 | SDK 实现 | 状态 |
-|--------|----------|:----:|
-| **三主体架构** AIDStore / AID / AUNClient | 全部导出，职责分离 | ✅ |
-| **AIDStore 构造** `{ aunPath, encryptionSeed, deviceId?, slotId? }` | 完全一致，额外有 `verifySsl`, `discoveryPort`, `rootCaPath`, `debug` | ✅ |
-| **AIDStore.load(aid)** 返回 `Result<{ aid: AID }>` | 一致（同步） | ✅ |
-| **AIDStore.register(aid)** 返回 `Promise<Result<{ registered: true }>>` | 一致 | ✅ |
-| **AIDStore.list()** 返回 `Result<{ identities: AIDInfo[] }>` | 一致（同步） | ✅ |
-| **AIDStore.exists(aid)** 返回 `Promise<Result<{ exists: boolean }>>` | 一致 | ✅ |
-| **AIDStore.resolve(aid, opts?)** | 一致，`ResolveOpts` 有 `forceRefresh` + `skipAgentMd` | ✅ |
-| **AIDStore.fetchAgentMd / headAgentMd / checkAgentMd / diagnose / renewCert / rekey** | 全部存在 | ✅ |
-| **AIDStore.changeSeed(old, new)** | 一致（同步） | ✅ |
-| **AID 只读属性** `aid`, `aunPath`, `certPem`, `publicKey`, `certSubject`, `certNotBefore`, `certNotAfter`, `certIssuer`, `certFingerprint` | 全部存在 | ✅ |
-| **AID.isCertValid() / isPrivateKeyValid()** | 一致 | ✅ |
-| **AID.sign / verify / signAgentMd / verifyAgentMd** 返回 `Result<T>` | 一致 | ✅ |
-| **VerifyResult** `{ status, payload, reason? }` | 一致，额外有 `aid?`, `cert_fingerprint?`, `timestamp?` | ✅ |
-| **Result\<T\>** 统一格式 `{ ok, data } \| { ok, error: { code, message, cause? } }` | 完全一致 | ✅ |
-| **AUNClient 构造** 可选传入 AID | 一致：`constructor(options?)` 或 `constructor(aid, options?)` | ✅ |
-| **AUNClient.loadIdentity(aid: AID)** | 一致 | ✅ |
-| **AUNClient.authenticate() / connect() / disconnect() / close()** | 全部存在 | ✅ |
-| **AUNClient.call(method, params)** | 一致 | ✅ |
-| **AUNClient.on / off** | 一致 | ✅ |
-| **AUNClient capability getters** `hasIdentity`, `canSign`, `canConnect`, `canSend`, `isReady`, `isOnline`, `isClosed` | 全部存在 | ✅ |
-| **AUNClient 重连 getters** `nextRetryAt`, `nextRetryInSeconds`, `retryAttempt`, `retryMaxAttempts`, `lastError`, `lastErrorCode` | 全部存在 | ✅ |
-| **AUNClient.setProtectedHeaders / getProtectedHeaders** | 一致 | ✅ |
-| **AUNClient.publishAgentMd()** | 存在 | ✅ |
-| **AUNClient 对端管理** `lookupPeer`, `getPeer`, `cachePeer`, `peers` | 全部存在 | ✅ |
-| **ConnectionState 枚举** 9 个状态 | 全部一致 | ✅ |
-| **AUNClient.gatewayHealth** getter | 存在 | ✅ |
-| **AUNClient.state / currentAid / aunPath** getters | 存在 | ✅ |
-
----
-
-## 二、不一致 / 差异
-
-### 2.1 同步 vs 异步
-
-| # | 方法 | 设计文档 | SDK 实际 | 影响 |
-|---|------|---------|---------|------|
-| 1 | `AIDStore.load()` | `Promise<Result<...>>` | **同步** `Result<{ aid: AID }>` | 调用方不需要 await |
-| 2 | `AIDStore.list()` | `Promise<Result<...>>` | **同步** `Result<{ identities: AIDInfo[] }>` | 同上 |
-| 3 | `AIDStore.changeSeed()` | `Promise<Result<...>>` | **同步** `Result<{ changed, count }>` | 同上 |
-
-**评估**：SDK 实现更优（纯本地操作无需异步），设计文档需更新。
-
----
-
-### 2.2 类型精度
-
-| # | 方法 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 4 | `AIDStore.resolve()` | `Promise<Result<ResolveData>>`（强类型） | `Promise<Result<Record<string, unknown>>>` |
-| 5 | `AIDStore.fetchAgentMd()` | `Promise<Result<AgentMdFetchData>>`（强类型） | `Promise<Result<Record<string, unknown>>>` |
-| 6 | `AIDStore.headAgentMd()` | `Promise<Result<AgentMdHeadData>>`（强类型） | `Promise<Result<Record<string, unknown>>>` |
-| 7 | `AIDStore.checkAgentMd()` | `Promise<Result<AgentMdCheckData>>`（强类型） | `Promise<Result<Record<string, unknown>>>` |
-| 8 | `AIDStore.diagnose()` | `Promise<Result<DiagnoseData>>`（强类型） | `Promise<Result<Record<string, unknown>>>` |
-| 9 | `AIDStore.renewCert()` | `Promise<Result<{ renewed, newCertNotAfter }>>`（强类型） | `Promise<Result<Record<string, unknown>>>` |
-| 10 | `AIDStore.rekey()` | `Promise<Result<{ rekeyed, newFingerprint }>>`（强类型） | `Promise<Result<Record<string, unknown>>>` |
-
-**评估**：运行时数据可能是完整的，但 `.d.ts` 类型定义未细化。可能是：
-- 有意为之（避免频繁改类型定义）
-- 或 .d.ts 生成时未展开内部类型
-
-**建议**：确认运行时返回的实际字段是否与设计一致，如果一致则补充 `.d.ts` 类型。
-
----
-
-### 2.3 AIDStore 额外内容
-
-| # | 差异 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 11 | 构造参数 | 只有 `aunPath`, `encryptionSeed`, `deviceId?`, `slotId?` | 多了 `verifySsl?`, `discoveryPort?`, `rootCaPath?`, `debug?` |
-| 12 | `close()` 方法 | 未提及 | 存在 `close(): void` |
-
-**评估**：SDK 比设计多了运维/调试参数和资源清理方法，合理扩展。设计文档可补充。
-
----
-
-### 2.4 AID 额外属性
-
-| # | 差异 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 13 | `deviceId` / `slotId` | AID 无此属性 | `readonly deviceId: string` / `readonly slotId: string` |
-
-**评估**：AID 携带创建它的 store 的 deviceId/slotId，便于 AUNClient 使用。合理。
-
----
-
-### 2.5 AIDInfo 额外字段
-
-| # | 差异 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 14 | `AIDInfo` 字段 | `{ aid, certNotAfter, certIssuer }` | 多了 `certFingerprint: string` |
-
-**评估**：有用的额外信息，设计文档可补充。
-
----
-
-### 2.6 AUNClient 构造与独立性
-
-| # | 差异 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 15 | 构造签名 | `constructor(aid?: AID)` | `constructor(options?: AUNClientOptions)` 或 `constructor(aid: AID, options?: AUNClientOptions)` |
-| 16 | 独立使用 | 设计说配置由 AIDStore 管理，AUNClient 不接受配置 | `AUNClientOptions` 保留了 `aun_path`, `encryption_seed` 等，AUNClient 可独立使用 |
-| 17 | `setLocalAgentMdPath` | 设计说已移除 | 实际仍存在 `setLocalAgentMdPath(path): string` |
-
-**评估**：SDK 保留了向后兼容路径——不强制必须通过 AIDStore 使用 AUNClient。这是务实选择，但与设计文档"AUNClient 只接收 AID"的纯粹设计有偏差。
-
----
-
-### 2.7 uploadAgentMd 可见性
-
-| # | 差异 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 18 | `uploadAgentMd` | 公开方法，在 AUNClient 上 | **私有** `_uploadAgentMd`，仅 `publishAgentMd()` 公开 |
-
-**评估**：SDK 简化了公开 API——`publishAgentMd` 内部自动签名+上传，不再暴露裸上传。设计文档需更新。
-
----
-
-### 2.8 authenticate 状态约束
-
-| # | 差异 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 19 | `authenticate()` 可调状态 | 仅 Standby | Standby **和** Authenticated 都可调 |
-
-**评估**：SDK 允许在 Authenticated 状态重新认证（刷新 token），比设计宽松。合理。
-
----
-
-### 2.9 connect() 参数
-
-| # | 差异 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 20 | `connect()` 参数 | `{ gateway? }` | `connect(options?: RpcParams)` 接受任意 RPC 参数 |
-
-**评估**：更灵活，`gateway` 只是其中一个可选字段。
-
----
-
-### 2.10 ConnectionState 命名风格
-
-| # | 差异 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 21 | 枚举值命名 | kebab-case: `'no-identity'`, `'retry-backoff'` | snake_case: `'no_identity'`, `'retry_backoff'` |
-
-**评估**：设计文档需更新为 snake_case。
-
----
-
-### 2.11 ResolveOpts 缺少 timeout
-
-| # | 差异 | 设计文档 | SDK 实际 |
-|---|------|---------|---------|
-| 22 | `ResolveOpts.timeout` | 有，默认 10000ms | 不存在，只有 `forceRefresh?` 和 `skipAgentMd?` |
-
-**评估**：SDK 未实现 timeout 参数。可能内部有默认超时，或后续版本补充。
-
----
-
-## 三、总结
-
-### 核心设计一致性：高
-
-三主体架构、Result 统一错误处理、AID 不可变值对象、AUNClient 状态机、capability getters——这些核心设计全部落地，且实现质量高。
-
-### 主要偏差分类
-
-| 类别 | 数量 | 严重程度 | 建议 |
-|------|:----:|:--------:|------|
-| 同步 vs 异步（设计写 Promise，实际同步） | 3 | 低 | 更新设计文档 |
-| 类型定义未细化（`Record<string, unknown>`） | 7 | 中 | 确认运行时字段，补充 .d.ts |
-| SDK 比设计多内容（额外参数/属性/方法） | 6 | 低 | 更新设计文档 |
-| AUNClient 独立性保留（未强制依赖 AIDStore） | 2 | 中 | 决策：是否在后续版本收紧 |
-| uploadAgentMd 变私有 | 1 | 低 | 更新设计文档 |
-| 命名风格（kebab vs snake） | 1 | 低 | 更新设计文档 |
-| ResolveOpts 缺 timeout | 1 | 低 | 后续版本补充或设计文档删除 |
-
-### 建议优先级
-
-1. **P0**：确认 `resolve` / `fetchAgentMd` 等方法运行时返回的实际字段，决定是否补充强类型
-2. **P1**：更新设计文档中 `load()` / `list()` / `changeSeed()` 为同步签名
-3. **P1**：更新 ConnectionState 枚举命名为 snake_case
-4. **P2**：决定 AUNClient 独立使用路径是否保留（当前保留是合理的兼容策略）
-5. **P2**：补充设计文档中缺失的 `AIDStore.close()`、额外构造参数、AID.deviceId/slotId