已发布的 Go 模块¶
英文版的参考译文,更新于 30/10/2026。如有差异,以英文版为准。
28/10/2026 已确认:Go SDK v2.11.1 已通过标签 sdks/go/v2.11.1发布,公共模块代理和 checksum 数据库均已提供该版本。上一个版本 v2.11.0(sdks/go/v2.11.0)于 26/10/2026 确认,其说明保留在下文。模块和导入路径保留 /v2。SDK 版本与 DCP 线格式/规范版本独立。Go 无需额外注册表令牌,使用方通过 Go 模块系统解析仓库标签。
安装¶
需要 Go 1.25 或更高版本。在应用模块中执行,并更新及提交应用的 go.mod 和 go.sum:
v2.11.1 的更新内容¶
在 VERIFICATION.md 的 V2-11 中的二级 SHA3-256 字段存在时验证它们:audit_merkle_root_secondary(按主树方式构建的 SHA3-256 树;空记录为 sha3-256: 后接 64 个零)、每个 prev_hash_secondary(第一个条目为 "GENESIS",之后为 bundle 中原样的前一条目的 SHA3-256)以及每个 intent_hash_secondary(意图载荷的 SHA3-256)。不存在的字段不作要求,因此已验证的 bundle 可能没有完整的二级链。存在的字段如果是 null、不是字符串或不一致,则被拒绝:对于带有这些字段的证据,这是相对于 v2.11.0 的接受范围变更(v2.11.0 曾接受它们)。API、结果字段、dcp-jcs-v1、实验性且需显式启用的 dcp-jcs-v2 API 以及 hash_alg 的处理均不变。验证仍然不等于对主体的信任、准入或授权。 SDK 遥测报告 2.11.1。
升级与兼容性¶
v2.11.0(2026 年 10 月 26 日)包含、v2.11.1 予以保留的内容:V1 无效密钥长度错误处理、修复后的 V2 责任主体/密钥/产物/检查点验证、责任主体显式信任与 strict-v1、委托链,以及具备重放保护的并发 A2A 会话。v2.11.0 的 SDK 遥测报告 2.11.0。见 SDK README、准入指南 和安全策略。
验证比 v2.10.0 更严格:之前接受的格式错误或不一致证据可能被拒绝。请保留历史证据,不要重写。dcp-jcs-v1 仍是规范性默认值;dcp-jcs-v2 API 仍为实验性、非规范性且须显式启用。验证不等于责任主体信任、准入或授权。在 v2.11.0 中,可选的次级 SHA3-256 字段不在验证器的检查范围内;v2.11.1 会在它们存在时检查。
验证¶
对于 v2.11.1,代理提供的模块 zip 中的 84 个文件与 main 一致(Go 会在 zip 中加入仓库根目录的 LICENSE),代理和 checksum 数据库确认了该版本。一个不使用本地 replace、从代理解析 v2.11.1 的外部使用方通过了 189 项测试。
对于 v2.11.0(2026 年 10 月 26 日),默认套件和 -race -tags otlp 套件各通过 1,154 项测试/子测试;一项测试有意留给独立的实时生产者/消费者矩阵。go mod tidy -diff、构建和 vet 均通过。外部使用方通过 137 项测试/子测试,其负对照按预期失败。已通过公开代理与 checksum 验证将发布模块下载到新缓存,源码与审核提交一致。随后外部使用方在没有本地 replace 指令的情况下通过测试。Rust 的独立发布见 Rust。
已准备、尚未发布:v2.12.0¶
v2.12.0 已于 30/10/2026 在仓库中准备好,但尚未发布:sdks/go/v2.12.0 标签不存在,因此模块代理不提供此版本,go get 也无法解析它。上面的安装命令仍为 v2.11.1。与 v2.11.1 相比,v2.12.0:
- 修正
v2.VerifyPayloadHash(接受范围变更)。 只有当payload_hash恰好是"sha256:"后接dcp-jcs-v1规范 payload 的小写十六进制 SHA-256 时才返回true。现在接受v2.SignPayload的输出,拒绝不带前缀的摘要;v2.11.1 正好相反。该函数只检查哈希一致性,不检查签名、密钥、策略、对主体的信任或准入。bundle 验证从未使用它,也不会改变。 - 新增
v2.RawAuditEventV2。 它原样保留收到的审计条目的字节,因此显式的null和未知成员在转发后仍然保留;Typed()是有损视图。AuditEventV2及其他类型化结构体仍是用于生成的类型,行为不变。
其他 API、bundle 验证、dcp-jcs-v1 以及实验性且需显式启用的 dcp-jcs-v2 API 均不变;实验性候选的新测试不改变任何默认值。SDK 遥测报告 2.12.0。模块不再包含翻译版 README,它们现在位于仓库的 i18n/ 目录树中。参见 SDK README 和变更日志。
相关发布¶
各注册表中的当前版本见已发布版本。其他发布说明:npm 软件包、Python 2.10.1、Rust 2.11.1。