2.12.0 SDK 文档迭代记录
文档基线:
v2.11.0@24340922a9c28861bdb26f9971946e0c7039b2c9;目标分支v2.12.0。全量 52 篇 SDK 指南继承现有内容;本版接口与制品差异按发布证据核对。
按 2.12.0 服务源码修正
documentTag筛选语义;不代表新版 SDK 制品已发布。2.12.0 SDK Release 已发布;服务兼容性仍以目标环境和具体能力为准。中英文均有正文,日文尚未提供。
Agent Runtime 多语言可执行示例因凭据重定向和运行操作时序风险暂时移除;功能说明和产品手册入口保留,具体语言示例待重新验证。
master 已合入的历史增量与验证记录
以下为 PR #32 合并时的历史记录,反映当时的源码、测试与截图证据;不代表本次整合后的候选已经完成验证。
| 版本 | 2.12.0 |
|---|---|
| source_repository | git@code.alipay.com:obai/appbase.git |
| source_tag | v2.12.0 |
| source_commit | 1b75b0e57db3b46dce1a04d48f75aa695c4eb6a6 |
| previous_source_tag / previous_source_commit | v2.10.0 / 0a5d23f9349028496286572fd43117aa6f8fce0a |
| docs_base_commit | caddb6c90d76246e760238f4150701315a359b14 |
| 生成日期 | 2026-11-18 |
| 分支 / 目标 | v2.12.0 → master,人工评审合并 |
首次生成时三个 master 索引最新登记的是 2.10.0。本分支的 2.11.0 属未冻结服务的发布准备记录,本次不改写该历史;精确差分基准见产品记录。
交付坐标与校验
agentbase-sdks Release v2.12.0,id 2692,revision 8f4e7cea6be643da2728cb47c64bc53638320d0a,published_at 2026-11-17T06:38:41Z。build.json source_commit 为 2546f7ed91dc5b93380d3dca02f5f0a938301823,保留已发布 SDK 的真实构建来源;当前服务 tag 已重指向新快照,SDK 构建提交另为 ef5a16d469bd95a771d571237b63dbcc16e52aa9,不得把 SDK tag commit 当服务 commit。
npm 六坐标统一 2.12.0:public agentbase-web-sdk / agentbase-node-sdk / agentbase-console-sdk,以及内部 @alipay 同名三包;delivery.json 的 npm_provenance_policy=bound。Java/Python/Go 的 Server/Console 六个 ZIP 与 SHA256SUMS、build.json、delivery.json 已随同版本 Release 发布。只保存文本证据,不把 ZIP/JAR 入库。
发布证据保存于 automation/release-evidence/2.12.0.json。build.json SHA-256 bc2484c7a9d0352c073ead11ef644112c087fd13445f515cbc14dd3e16fc189d;delivery.json SHA-256 463b9cedc7cfcd49be6f2748a05fd3b98e0d1a3d53cc30f26eb5f251e2529452。仅下载校验 Java Server ZIP,未独立下载其余五个 ZIP 或重新查询全部 registry 终态;发布证据不替代线上回归。
契约变化与文档增量
安装与语言示例上刷精确安装坐标;当前服务 2.12.0/V61、SDK 2.12.0 与迁移基线 1.9.0 分别说明。
Functions:Projects 调度 CRUD、规则类型、JSON data、分页与 compact/保活边界。
KnowledgeBases:目录过滤、原文/解析产物、增强操作,202 后使用任务 ID 查询;一次性 config 不持久化。
Memory:sourceContext、temporal;Pipeline 试运行使用冻结版本/样本且不写业务记忆。
Observability:集合分析请求来源、requestId、权限与重试;两类 Gateway 增补原生 rerank instruct、审批与工具向量。
新增 Scenarios 使用指南,包含分类、场景、revision、导入预览/提交与删除影响确认;SDK/API 功能基线登记同步。
Skill 当前安装钉与差异页同步;保留已验证 Demo lockfile 和 Memory 专项 2.9.0 例外,不机械宣称旧验证已覆盖 2.12.0。
逐语言状态
全量 52 篇 SDK 指南:zh-CN/en-US 各 52 篇,同名主题与安装坐标同步;ja-JP 未产出。新增 Scenarios 的 Node/REST 事实按发布源码核对,未猜测 Java/Python/Go 方法签名。
证据缺口
未执行七族全量在线回归,也未重新跑全部历史 Demo、模型调用与生产部署。HTTP 202、SDK 发布和文档提交各自不能证明业务任务成功。源区间为 master 最后冻结的 2.10.0..2.12.0,不借用未冻结的 2.11.0 记录作为 commit。
Registry 核验:默认 registry.npmmirror.com 查询 Console 2.12.0 返回 ETARGET;改用 registry.npmjs.org 后 Web/Node/Console 2.12.0 实际安装成功。镜像同步延迟不等于上游未发布。内部 @alipay 三坐标仅由 delivery.json 证明,未另行 registry 查询。
本轮验证补充
公共 registry 三个 npm 包实际安装,integrity 与 delivery.json 一致;4 段原文 Node 示例以真实发布包发送 9 次 loopback HTTP 请求,调度/增强/temporal/数据集请求字段断言通过。Java Server ZIP 外层摘要与发布记录一致,包内 Memory/Knowledge 示例经发布 JAR 编译通过。此项为本地契约验证,非真实模型端到端或全族在线回归。
继承的维护基线
此前版本分支正文已吸收 appbase release-2.10.2@0983b818445bcf261f54c41984ff0d66832ec201 的词库、项目级 Agent Runtime、Memory 与数据保留等维护修订。本次保留这些正文,不回写 master 已合并 2.10.0 历史页;当前新增变化仍按本页 source_commit 核对。该历史快照不替代 2.12.0 验收。
Scenarios 9 段原文示例以真实 Node SDK 执行 12 次本地 HTTP 请求,文件 multipart、entries 对象数组、revision、冲突策略及删除确认 token 通过。与前述 4 段示例合计 13 段 / 21 次请求,均为合成 fixture,不在 SIT 创建或删除业务数据。
首次交付核验(旧源码快照,PR #32)
评审 PR #32,v2.12.0 → master,禁用自动合并。master 冲突整合后 326 项 unittest 全部通过;313 对中英文检查通过;渲染引用检查无悬空文件、图片或片段。13 段新增 Node 原文示例 / 21 次本地 HTTP、42 项 Console 鉴权原文测试、Java 编译及制品摘要校验通过。截图缺口与在线回归边界维持上述记录,未创建文档 tag 或 Release。
未封板同版本重刷(2026-11-18)
服务来源从 2546f7ed91dc5b93380d3dca02f5f0a938301823 校准至当前 v2.12.0@1b75b0e57db3b46dce1a04d48f75aa695c4eb6a6;本次 docs 基线为 caddb6c90d76246e760238f4150701315a359b14,首次生成基线 7a27c8332dae064128a92a71fd62b65c74f1f279 保留供追溯。差分与产品行为见产品记录。
已发布 SDK 的 sdk_build.source_commit 仍为 2546f7ed91dc5b93380d3dca02f5f0a938301823,Release id/revision、制品摘要、安装版本和 Skill 版本钉保持真实发布值。automation/release-evidence/2.12.0.json 顶层 source_commit 表示本次服务快照,source_refresh 登记差分文件与公开调用面目录的相同 Git tree;不得把顶层坐标刷新当作 SDK 重建或再次发布。
本区间 SDK 源码与 API controller 无变更,未新增/删除方法或请求/响应字段。Memory 对含连字符库名的兼容修复位于服务端池目录与签名路由校验,客户端继续使用项目 ID、已有凭据和既有方法;不传内部库名或路由签名。中文/英文 Memory 指南补充这一边界,保留已有经验证的示例安装钉。
本次未重新下载或重建 SDK,也未重跑七族线上回归;首次交付的包摘要/示例验证仍只代表当时构建。截图台账归产品记录,API 面核对归API 记录。
本次文档门禁:326 项 unittest 与 313 对双语校验通过,包含服务/SDK 分别登记来源的坐标一致性检查;本次未新增可执行 SDK 示例。完整验证摘要见产品记录。
上轮重刷评审(已关闭,由迭代分支 PR 接替):PR #33,v2.12.0 → master,reviewer chengyao.cp,排除提交者本人;禁用自动合并,等待人工评审。
保护迭代分支与发布交付(2026-11-18)
按最新交付约定,v2.12.0 从 master@caddb6c90d76246e760238f4150701315a359b14 重新创建并保护:push/merge access level 均为 40,master_can_edit=true,禁止分支强推。现有文档改动保留在 docs/v2.12.0-sync,目标改为 v2.12.0;评审人为派蒙(pm02597234),启用合并后删除来源分支、Squash merge、评审与检查通过后自动合并。原始文档基线与旧 PR 验证记录保留,旧 PR #33 已关闭。
SDK Release 2692 / revision 8f4e7cea6be643da2728cb47c64bc53638320d0a 本次回读仍为正式发布;Skill 标题/指引/版本差异页/CHANGELOG/evals 已具备 2.12.0 版本钉,本次保持 SDK 包与原构建来源,不把文档 Skill 制品发布表述为 SDK 重建。ZIP 上限、文档双制品与截图台账见产品记录。
本次交付评审:PR #34。已回读确认 source=docs/v2.12.0-sync、target=v2.12.0、reviewer=pm02597234,合并后删源分支、Squash merge、自动合并均为 true。
2.11 分支历史记录汇合
合并 2.11 分支时,保留其关于多语言 SDK 示例、KnowledgeBases、TablesDB、Functions 和认证与配额相关勘误的历史记录。为保持已冻结的 2.10 变更记录字节不变,原文留在所链接的固定提交;其中的历史候选、截图和验证结论不代表本次重新验收。