@agentunion/fastaun 0.5.26 → 0.5.28

package/_packed_docs/sdk/INDEX.md

@@ -14,7 +14,7 @@
 | [0.5.22 SDK 开发与移植指南](0.5.22-SDK开发与移植指南.md) | 后台退避 · 群状态 · 两种绑定与 Stage/CAS · 消息内部消费 · 撤销同步 · 组织恢复及配套服务修复 · 默认读缓存 · Rust 清单 |
 | [0.5.24 SDK 应用集成指南](0.5.24-SDK应用集成指南.md) | 当前身份与消息接入 · 无任务 Ownership · local 双／三身份编排 · resolve 与文件缓存 · 凭证组织 · 升级 |
 | [0.5.24 SDK 开发与移植指南](0.5.24-SDK开发与移植指南.md) | peer／batch 提交 · NS 事实与远端 CAS · local 短连接 · 观察与 PKI 缓存 · 持久化边界 · 语言差异和验收 |
-| 0.5.25 CHANGELOG：[Python](../../python/CHANGELOG.md)、[Go](../../go/CHANGELOG.md)、[TS](../../ts/CHANGELOG.md)、[JS](../../js/CHANGELOG.md) | Pull／volatile／群恢复 · Ownership 缓存 · 名片下载退避 · 分域发现；实现差异与验证边界见 [parity](../../python/CHANGES_FOR_PARITY.md#v0525--已提交-v0524-基线变更未发布) |
+| [0.5.28 应用指南](0.5.28-SDK应用集成指南.md)、[开发与移植指南](0.5.28-SDK开发与移植指南.md)；[0.5.27 应用指南](0.5.27-SDK应用集成指南.md)、[开发与移植指南](0.5.27-SDK开发与移植指南.md) | agent.md 上传／下载校验、非一致共识 fresh、分类控制消息、Owner 通知与风控；四端差异及验证边界见 [parity 0.5.28](../../python/CHANGES_FOR_PARITY.md#v0528--校验控制消息与风控未发布) |
 | [CHANGELOG-0.5.6](CHANGELOG-0.5.6.md) | **0.5.6 版本更新日志**：首次签名者回源 · 下载提交前验签 · 消息窗口 · 显式 change-seed · 语言能力边界 |
 | [01-快速开始](01-快速开始.md) | 安装 · 三主体模型 · 最小示例 · 多语言构造 |
 | [02-WebSocket协议](02-WebSocket协议.md) | 握手流程 · 严格布尔 peer 能力声明 · JSON-RPC 消息格式 · 裸 WebSocket 示例 |
@@ -28,9 +28,11 @@
 | [Ownership SDK 编排指南 2.1](Ownership-SDK编排指南2.1.md) | 历史编排方案；任务恢复、reset 与一次性决定已由当前两份指南的无状态流程替代 |
 | [Ownership 2.1 应用集成指南](Ownership2.1-SDK应用集成指南.md) | TS 接线与审批；双向绑定、释放、转移、两个 local 编排和显式重试的图与示例，以 NS 当前归属为准 |
 | [Ownership 2.1 开发与移植指南](Ownership2.1-SDK开发与移植指南.md) | 严格签验、NS 验收、Storage 条件发布、通用消息交付、本地编排和文件 CAS；不维护 Ownership 任务或 WAL |
-| [凭证与组织服务 SDK 应用集成指南](凭证与组织服务SDK应用集成指南.md) | TS 示例与凭证登记／验证、成员申请／邀请、续期、撤销同步和组织 rekey／finalize 转让流程图 |
-| [凭证与组织服务 SDK 开发与移植指南](凭证与组织服务SDK开发与移植指南.md) | TS 内部示例与 Verify、双层请求摘要、登记最终化、撤销快照和实体 checkpoint 流程图；跨语言契约与验收 |
-| [凭证服务 RPC 手册](09-凭证服务RPC手册.md) | Credential Service 实际注册的 health/status/register/revoke/revocationList RPC |
+| [凭证与组织服务 SDK 应用集成指南](凭证与组织服务SDK应用集成指南.md) | §3结构化完整链路；§4语义流程图、TS 示例及 E01—E36 场景对照 |
+| [凭证与组织服务 SDK 开发与移植指南](凭证与组织服务SDK开发与移植指南.md) | §3结构化委托／完整Verify；§4语义契约；§6.5—§6.6普通proof／CRL恢复 |
+| [凭证与组织服务 CLI 开发与使用指南](../cli/凭证与组织服务CLI开发与使用指南.md) | 真实CLI流程图＋TS示例；23个凭证命令、组织材料衔接和SDK调用对照 |
+| [凭证服务 RPC 手册](09-凭证服务RPC手册.md) | 旧版RPC及六个credential.semantic.*的params/result、CAS／协调、CRL分页与十错误码 |
+| [语义凭证示例与验收](../../examples/semantic-credential/示例使用指南.md) | E01—E36、286组配置证据、CN／本地aid.com、浏览器／普通凭证冷恢复与验证边界 |
 | [组织服务 RPC 手册](09-组织服务RPC手册.md) | Org Service 生命周期、成员、凭证查询、审计/授权及内部/未实现方法 |
 | [Ownership 2.1 详细设计](Ownership2.1详细设计.md) | agent.md/owner.md 关系、agent.md 兼容非回归矩阵、旧 SDK owner RPC/JSONL 隔离、本地失败稿／显式重试、本地任务与原 CAS |
 | [Ownership 2.1 TDD 实施计划](Ownership2.1-TDD分阶段实施计划.md) | 历史分阶段计划、冻结契约与网络账本、2026-10-13 复查修复边界 |
@@ -74,15 +76,17 @@
 
 - 当前身份与消息接入、无任务 Ownership、两个 local 场景、名片及文件缓存、凭证组织与升级 → [应用集成指南](0.5.24-SDK应用集成指南.md)
 - 三主体分层、提交／ACK、NS 事实和远端 CAS、local 身份隔离、缓存新鲜度、语言差异与验收 → [开发与移植指南](0.5.24-SDK开发与移植指南.md)
-- 0.5.25 对照已提交 0.5.24 的增量、四端实现落点与验证边界 → [parity 当前章节](../../python/CHANGES_FOR_PARITY.md#v0525--已提交-v0524-基线变更未发布)
+- 0.5.28 agent.md 校验、共识 fresh、分类控制消息、Owner 通知、风控和四端验证边界 → [应用指南](0.5.28-SDK应用集成指南.md)、[开发与移植指南](0.5.28-SDK开发与移植指南.md)；实现差异见 [parity 当前章节](../../python/CHANGES_FOR_PARITY.md#v0528--校验控制消息与风控未发布)。0.5.27 历史版本见对应旧指南与 parity。
 
 ### 身份与认证
 
 - 当前普通 Ownership 2.1 双文件关系、双向绑定、release／转移、两个 local 编排、文件 CAS 与显式重试 → [应用集成指南](Ownership2.1-SDK应用集成指南.md)、[开发与移植指南](Ownership2.1-SDK开发与移植指南.md)；wire 格式见[协议 2.1](../protocol/Ownership协议定义2.1.md)
 - 通用 Store raw/document 多签、Group/Org 实体主签、owner token 上传及可选附签、代际与原 CAS pending → [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传)、[Group RPC](09-group-rpc-manual.md#群组生命周期)
-- TS 示例与凭证登记／验证、成员申请／邀请、续期、撤销同步和组织 rekey／finalize 转让流程图 → [应用集成指南](凭证与组织服务SDK应用集成指南.md)
-- TS 内部示例与 Verify、双层请求摘要、登记最终化、撤销快照和实体 checkpoint 流程图；跨语言契约与验收 → [开发与移植指南](凭证与组织服务SDK开发与移植指南.md)
-- Credential Service 实际 RPC 与签名状态 proof/吊销列表 → [凭证服务 RPC 手册](09-凭证服务RPC手册.md)
+- 结构化约束→委托→登记→完整Verify→状态／CRL，以及语义签发→确认→登记→请求验真→业务验收 → [应用集成指南](凭证与组织服务SDK应用集成指南.md)
+- 结构化链／完整Verify、可信proof／CRL适配及语义四SDK契约与独立持久状态 → [开发与移植指南](凭证与组织服务SDK开发与移植指南.md)
+- 旧版与六语义RPC的参数／结果、修订、协调、CRL及错误 → [凭证服务 RPC 手册](09-凭证服务RPC手册.md)
+- 语义凭证E01—E36、CN续跑、实际证据和应用适配 → [示例指南](../../examples/semantic-credential/示例使用指南.md)；23个凭证CLI命令 → [CLI手册](../cli/CLI手册.md#凭证与语义凭证)
+- 凭证／组织CLI流程图、TS调用与SDK胶水开发 → [CLI专题](../cli/凭证与组织服务CLI开发与使用指南.md)
 - Org Service 生命周期、成员关系、受保护查询、内部接口和未实现占位 → [组织服务 RPC 手册](09-组织服务RPC手册.md)
 
 - AID 格式、证书、不可变值对象 → [03-核心概念](03-核心概念.md)
@@ -172,9 +176,11 @@ TypeScript 身份与消息接线、Ownership 审批恢复、resolve、默认缓
 
 定义消息 peer／batch／Gate、Ownership NS 事实和远端 CAS、Stage、local 专属 slot 与身份代际、展示及文件缓存、PKI 和 Credential 查询新鲜度、组织 checkpoint。列出四端兼容差异、Rust 核查与分层验收，不将已有专项证据等同完整发布验证。
 
-### 0.5.25 更新日志与跨端对齐
+### 0.5.28 更新日志与跨端对齐
 
-[变更与对齐清单](../../python/CHANGES_FOR_PARITY.md#v0525--已提交-v0524-基线变更未发布) 对照已提交 0.5.24，说明 Pull 无进展暂停、volatile 直接交付、群恢复、Ownership 正文与证书证据复用、agent.md 下载退避和分域发现；四端 CHANGELOG 提供接口级摘要，parity 列出实现落点、语言差异与验证边界。
+0.5.28 [应用指南](0.5.28-SDK应用集成指南.md)：身份／消息接入 §2—§3 L18-95、凭证／组织 §4—§5 L96-137、Storage／Ownership §6—§7 L138-186、Owner 通知 §8 L187-201、风控／升级 §9—§10 L202-228；[开发与移植指南](0.5.28-SDK开发与移植指南.md)：上传／下载 schema §1 L7-36、非一致共识 fresh §2 L37-62、分类控制消息 §3 L63-108、Owner outbox §4 L109-121、风控 §5 L122-134、移植矩阵 §6 L135-146。 [变更与对齐清单](../../python/CHANGES_FOR_PARITY.md#v0528--校验控制消息与风控未发布) L15-99 记录四端落点、已有测试入口及服务依赖／验收边界；本指南不把已有专项结果扩写为完整版本发布结论。
+
+0.5.27 [应用指南](0.5.27-SDK应用集成指南.md)：身份／连接／消息迁移 §2—§3 L30-133，结构化 §4 L134-192／语义 §5 L193-349，组织与缓存 §6—§7 L350-388，升级 §8 L389-408；[开发与移植指南](0.5.27-SDK开发与移植指南.md)：字节／签名 §2 L38-84，结构化 §3 L85-123／语义 §4 L124-297，组织 §5 L298-334，迁移交付 §6 L335-383，平台与回归 §7—§8 L384-410。 [变更与对齐清单](../../python/CHANGES_FOR_PARITY.md#v0527--相对于-v0525-基线的变更未发布) L15-132 对照 0.5.25 源码，说明语义凭证、消息证据、状态／Usage 恢复、Gateway 迁移、时间容错、组织及 CLI；四端 CHANGELOG 提供接口级摘要，parity 列出实现落点、语言差异和已有验证范围。0.5.26 仅为 TypeScript 根证书打包修正，旧版本章节保留历史记录。
 
 ### CHANGELOG-0.5.6
 
@@ -204,15 +210,19 @@ TypeScript 身份与消息接线、Ownership 审批恢复、resolve、默认缓
 
 ### 凭证与组织服务 SDK 应用集成指南
 
-以短 TS 示例和流程图说明凭证登记／验证、成员申请／邀请、续期、代表调用、撤销同步和组织转让；保留 service-plane、当前状态与显式恢复边界。
+模式表区分结构化、纯语义和混合；§3 L21-304以图与TS示例覆盖非空约束、委托收窄、登记回执、实际请求完整Verify、强状态proof及普通CRL恢复；§4 L305-763说明语义原件／确认、包／请求、online／bounded、额度和消息证据；§5—§7 L764-954说明组织流程。
 
 ### 凭证与组织服务 SDK 开发与移植指南
 
-以 TS 内部片段和流程图说明共同签验、完整 Verify、两层请求摘要、登记最终化、撤销持久快照及实体 checkpoint；列出四端差异、服务契约和有序验收。
+§3 L51-209以图与TS示例说明结构化链、约束收窄和完整Verify；§4 L210-525列语义四SDK契约、严格分流、原字节／签名域与独立持久状态；§5.4 L581-608说明普通请求绑定，§6.5—§6.6 L651-894实现可信证书／状态proof适配及CRL分页原子持久。
 
 ### 凭证服务 RPC 手册
 
-按 Credential Service dispatcher 记录 health/status、register、revoke、revocationList 的参数、响应和授权边界，并区分本地 SDK helper 与服务端 RPC。
+普通接口L1-80；语义公共约定L81-97，六RPC的params/result、受众CAS、usage协调及CRL分页L98-169，十个SEMANTIC错误与retryable L170-187。场景证据见[示例指南](../../examples/semantic-credential/示例使用指南.md)§5，CLI 23命令见[CLI手册](../cli/CLI手册.md#凭证与语义凭证)。
+
+### 凭证与组织服务 CLI 开发与使用指南
+
+[CLI专题](../cli/凭证与组织服务CLI开发与使用指南.md)以流程图与TS示例说明真实CLI调用：入口／23命令L5-121、凭证L122-591、组织L592-798、SDK胶水／错误恢复／E2E对照L799-869。
 
 ### 组织服务 RPC 手册