Docs
文档目录

2.12.0 产品手册迭代记录

项目状态
版本2.12.0
文档目标分支v2.12.0
文档基线v2.11.0@24340922a9c28861bdb26f9971946e0c7039b2c9
服务来源obai/appbase
服务版本标签v2.12.0@1b75b0e57db3b46dce1a04d48f75aa695c4eb6a6
服务分支核对点release-2.12.0@1b75b0e57db3b46dce1a04d48f75aa695c4eb6a6
已发布 SDK 的服务源码构建快照2546f7ed91dc5b93380d3dca02f5f0a938301823
上一服务基线release-2.11.0@ce9ad991de95ef5440304bfd0d79f1d21b72a0a6
核对日期2026-11-16
截图环境仓库规范的截图环境是 SIT(https://appbuild-sit.oceanbase.com/);本期实拍截图经维护者授权采集于 Stress,SIT 未采集,不得据此认定 SIT 已验证
状态更新进行中;未核对的正文与功能路径仍待验证

与已发布 SDK 的服务源码快照相比,当前服务核对点包含沙箱诊断及 Memory 数据库兼容性修复。实际部署的源码提交应以运行镜像及发布记录为准。

产品与手册变化

待核验

权限、功能开关及依赖模型服务的完整操作路径、其余截图与服务发布差异仍在核对;本记录不代表本版文档已发布。

master 已合入的历史增量与验证记录

以下为 PR #32 合并时的历史记录,反映当时的源码、测试与截图证据;不代表本次整合后的候选已经完成验证。

坐标事实
版本2.12.0
source_repositorygit@code.alipay.com:obai/appbase.git
source_tagv2.12.0
source_commit1b75b0e57db3b46dce1a04d48f75aa695c4eb6a6
previous_source_tagv2.10.0
previous_source_commit0a5d23f9349028496286572fd43117aa6f8fce0a
docs_base_commit / 文档基线 commitcaddb6c90d76246e760238f4150701315a359b14(本次未封板重刷的 origin/master 基线;首次生成基线见下文)
生成日期2026-11-18(Asia/Shanghai)
文档分支 / 合并目标v2.12.0 → master;人工评审合并
服务版本 / Migration2.12.0 / V61;迁移基线与 SDK 包版本分别核对

增量基准

开工时 origin/master@cba2350e39a90573cce901a385499c96ac225d7c 的三个索引最新登记行均为 2.10.0;产品页同时含 Memory 专项固定快照,本次通用基准采用页首正式 tag 的 peeled commit。既有 v2.12.0 分支包含 2.11.0 发布准备记录,该记录明确未冻结服务源码,且远端不存在 v2.11.0 tag,因此不能把它作为已冻结的上一源迭代。本次精确增量是 v2.10.0..v2.12.0,覆盖中间迭代;历史记录保持原样。

新增能力

行为变化

配置与部署

Migration V57 → V61,包含 V58 手机挑战与场景目录、V59 项目业务线映射、V60 快照片段/场景补齐及 V61 调度与摄取/增强字段。具体迁移与 Worker 升级由部署流程执行,本任务只生成文档。

废弃与迁移

旧 Functions 单 Cron 接口只投影 compact 任务,不代表全部任务;新调度响应 schedule 为 JSON 规则字符串。旧 SDK 的方法覆盖不得直接套用于新服务;安装坐标以本次 SDK Release 证据为准。

手册侧与逐语言状态

zh-CN/en-US:各 62 篇产品正文,更新函数、场景索引、图谱/Wiki、数据集、评估、账户/组织 Key、Data API 与 Memory Pipeline 10 个同名主题;其余继承原验证范围。ja-JP:未产出。SDK/API 分别为各 52 / 26 篇,见各自记录。

截图台账

2026-11-18 读取 SIT /v1/health/version 返回 2.12.0。新增截图 0 张;沿用截图每语言 48 张、流程示意每语言 63 张,图片字节与原脱敏台账保持。Functions Settings 页面有真实 Legacy Cron 记录且调度请求 HTTP 200,但页面缺少 h1,采集按就绪规则超时,未截图入库。场景库当前空态,数据集现有样本但无运行,均不冒充新能力主截图。

待拍:带多条新类型任务的函数调度、已导入场景及图谱构建结果、Memory/RAG 数据集运行与集合分析、JSONPath 保存/预览、Data API 登录授权与执行。新类型任务/集合分析未对共享项目造数或执行;本轮只读核对既有演示数据,未触发模型费用。历史图片保留原始版本与脱敏来源,不作为本版新能力运行证明。

证据与已知缺口

SDK Release v2.12.0(id 2692,revision 8f4e7cea6be643da2728cb47c64bc53638320d0a,2026-11-17T06:38:41Z)已发布。build.json 的 source_commit 为 2546f7ed91dc5b93380d3dca02f5f0a938301823(首次生成快照),与当前服务 tag 分别登记;delivery.json 登记 npm 六坐标与六个 ZIP。SDK/API 细节分别见 SDK 记录与 API 记录。在线模型质量与全族 SDK 回归不由文档静态核对推断。

本轮验证补充

公共 registry 三个 npm 包实际安装,integrity 与 delivery.json 一致;4 段原文 Node 示例以真实发布包发送 9 次 loopback HTTP 请求,调度/增强/temporal/数据集请求字段断言通过。Java Server ZIP 外层摘要与发布记录一致,包内 Memory/Knowledge 示例经发布 JAR 编译通过。此项为本地契约验证,非真实模型端到端或全族在线回归。

历史保护与分支续做

既有分支 v2.12.0@24340922a9c28861bdb26f9971946e0c7039b2c9 包含此前在版本分支追加的 2.10.0 维护记录。为遵守 master 已合并历史只读边界,本 PR 保持 master 的三个 2.10.0 changelog 和 Skill release-2.10.0.md 原字节,正文中的适用维护改动保留,由本期记录承接;不把版本分支中的追加段落回写到已合并历史。

继承的维护基线

此前版本分支正文已吸收 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 创建或删除业务数据。

master 冲突整合

PR #32 报 conflict_and_cannot_be_merged 后,在 v2.12.0 合入 origin/master@cba2350e39a90573cce901a385499c96ac225d7c,就地解决 11 个框架/Skill/鉴权冲突。保留项目级 Runtime 使用面及 master 新增的控制面 Key 白名单、凭据复用与安全失败行为;合并前后 docs 开工基线仍为 7a27c833,未改写已合并历史。合并后的 api-key-auth 原文示例使用实际 Console SDK 2.12.0,通过 42 项 loopback 鉴权/平台注册测试。

首次交付核验(旧源码快照,PR #32)

评审 PR #32,v2.12.0 → master,禁用自动合并。master 冲突整合后 326 项 unittest 全部通过;313 对中英文检查通过;渲染引用检查无悬空文件、图片或片段。13 段新增 Node 原文示例 / 21 次本地 HTTP、42 项 Console 鉴权原文测试、Java 编译及制品摘要校验通过。截图缺口与在线回归边界维持上述记录,未创建文档 tag 或 Release。

未封板同版本重刷(2026-11-18)

文档仓远端尚无 refs/tags/v2.12.0。本次 webhook 为 tag_push,项目 obai/appbase,ref refs/tags/v2.12.0;after=cd59f4f26988a52bb8f59ce27aa50e27d51fad22 是 tag 对象,peeled commit 与 checkout_sha 均为 1b75b0e57db3b46dce1a04d48f75aa695c4eb6a6。当前页首坐标更新为此快照;previous_source 仍保留首次迭代的 v2.10.0 基准,本次补充差分单独固定为 2546f7ed91dc5b93380d3dca02f5f0a938301823..1b75b0e57db3b46dce1a04d48f75aa695c4eb6a6。

首次生成 docs 基线 7a27c8332dae064128a92a71fd62b65c74f1f279 与 PR #32 的验证记录保留。本次从最新 origin/master@caddb6c90d76246e760238f4150701315a359b14 冻结重刷基线,复用 v2.12.0;旧远端分支与 master 的树不同,按任务约定创建以两者为父、内容精确取 master 的对齐提交,未 force-push。

产品与手册补充

本次截图台账与证据边界

新增截图 0 张,历史 PNG 字节与原来源台账不动。此次差分未改 Console 页面;诊断存储/低空间与含连字符物理库需要配套部署和特定测试条件,未在共享 SIT 造数或制造磁盘压力,也未重新采集 SIT 运行证据。前述首次采样的健康版本和截图缺口不作当前 commit 部署证明。仍待拍多类型函数任务、场景/图谱、Memory/RAG 数据集与集合分析、JSONPath、Data API 授权/执行;本次未声称闭环线上 SDK 回归、生产部署或文档发布。

本次交付验证

python3 -m unittest discover -s tests -p 'test_*.py':326 项通过,包含渲染后文件、图片及片段可达性检查;python3 automation/check_translations.py:313 对通过。静态站点渲染 306 页、复制 222 项视觉资源;git diff --check、本次改动的占位串/环境凭据扫描通过。SDK 原始 build/delivery/validation 内容逐项与 master 比较保持不变,四个公开调用面/迁移目录的 Git tree 在两个源 commit 间逐项相同,已封板历史及全部 PNG 原字节保持。版本一致性测试同步区分当前服务快照与 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 已关闭。

双语全仓 git archive 已超过旧 15 MiB 阈值;本次将 automation/package_release.py、边界回归与 RELEASE.md 对齐 Admin 实际的 32 MiB(32 * 1024 * 1024)上限。等于上限允许,超出 1 byte 拒绝,超过旧阈值但低于新上限允许。正式文档 tag 按已推送工作分支的最终提交冻结,复用打包/发布脚本上传 Skill tar.gz 与完整仓库 Markdown 源码 ZIP,并下载回读比对字节与 SHA256;构建元数据留在仓外,不作为第三个附件。这不扩大截图或线上运行验证范围,原有待拍及线上 SDK 回归缺口保持。

本次发布前门禁:全量 326 项 unittest、12 项打包回归、313 对双语校验通过;静态渲染 306 页、222 项视觉资源,渲染后引用检查无悬空文件/图片/锚点;ACI 发布 YAML 校验通过。发布结果与最终冻结 commit、制品大小及 SHA256 由 AntCode Release 和任务回报登记,不将构建缓存或二进制加入 Git。

本次交付评审:PR #34。已回读确认 source=docs/v2.12.0-sync、target=v2.12.0、reviewer=pm02597234,合并后删源分支、Squash merge、自动合并均为 true。

2.11 分支历史记录汇合

合并 2.11 分支时,保留其关于2.10.2 手册候选、图片来源及后续勘误的历史记录。为保持已冻结的 2.10 变更记录字节不变,原文留在所链接的固定提交;其中的历史候选、截图和验证结论不代表本次重新验收。