Docs
文档目录

2.10.0 迭代增量与版本记录

版本2.10.0
源 tag / 仓库v2.10.0(peeled commit 0a5d23f9349028496286572fd43117aa6f8fce0a)@ git@code.alipay.com:obai/appbase.git
本迭代源 commit0a5d23f9349028496286572fd43117aa6f8fce0a(tag 即 release-2.10.0 尖端)
上一迭代源 commitebae954094883b847bf582cfbe9fbe58ae0a7499(v2.9.0 tag)
文档基线 commit19f1f3a9c6418d97890038fbe5e55218d090b697(迭代分支 v2.10.0 自 origin/master 冻结;分支此前已含维护提交 eba5aa0…72f24de,续做按 merge-base 语义沿用本 SHA)
生成日期2026-10-19
服务版本 / MigrationAPP_VERSION_STABLE 单次 bump 2.9.0 → 2.10.0(app/init/constants.php:55 实读);Migration V57(边界迁移:不新增 schema/data 动作,platform projects collection 增两个只读状态字段与内部 readOnlyRevision,经 platform-migrate Expand 对账补齐;升级迁移基线 1.9.0 不变)
SDK 发布面agentbase-sdks v2.10.0 release 已发布(2026-10-19T03:03:11Z,revision 394f2a53dacfc2494f1f3e71082d9f09b9734ff1):npm 六坐标 2.10.0(public agentbase-web-sdk / agentbase-node-sdk / agentbase-console-sdk + 内部 @alipay/*,delivery.json npm_provenance_policy: bound)+ Java / Python / Go 与 Console 共 6 个 ZIP 制品 + SHA256SUMS / build.json(source_commit: 0a5d23f9… 与本迭代源 tag 一致)/ delivery.json

范围说明:本页合并登记本迭代的非 Memory 更新与 PR14 的 Memory 专项修订。两部分分别保留其固定服务快照、文档开工基线、SDK 验证版本及截图环境;非 Memory 记录见下文,Memory 专项记录见本页后半部分。文档合并目标为 v2.10.0@a4bcbf2ec099b5e60c9d497ccff4f3230cddf3ac。

新增能力

行为变化

配置与部署

废弃与迁移

已知问题

手册侧(本迭代 products/ 变化)

与相邻 changelog 的分工

Memory 专项文档增量与版本记录

项目事实
版本2.10.0
范围本节仅登记 Memory 及直接相关接入文档。
生成日期2026-10-16
服务事实来源分支release-2.10.0(固定快照,后续分支移动不改变本记录)
本迭代源 commit611a92b4853f3eea6c3ae83d2a0ec3b0480bd582(最终正文契约核对、定向单元测试及测试机部署共同使用)
上一迭代源 commitebae954094883b847bf582cfbe9fbe58ae0a7499(上一版已登记的 v2.9.0,未用后查分支尖端替代)
文档基线 commitbbc80703db6f868846a3121c0938bbc4b4cd3bb7(开始任务时冻结的 origin/master;本任务目标按用户要求为 v2.10.0)

本页是维护版本记录,不随产品语言树或客户 PDF 交付。初稿曾参考辅助快照 bcd0c8739c102cc1cd1448648eff2d96d4a15b26;交付前完整复核、定向单元测试及截图部署固定为上述本迭代源 commit。PR 最初目标冻结为 v2.10.0@19f1f3a9c6418d97890038fbe5e55218d090b697;2026-10-19 同步 PR15 合入后的目标 v2.10.0@72f24de57a0c44c5fbe408f1e1b5002cdff6119d,保留其规范、观测接入及材料索引修订。随后同步非 Memory 2.10.0 更新后的目标 a4bcbf2ec099b5e60c9d497ccff4f3230cddf3ac;整本手册版本随该基线上刷为 2.10.0,Memory 仍保留本节固定来源。开工文档基线、服务事实源与截图来源不因此改变。

新增能力

本次只核对 Memory,未声明其他组件的整版手册已更新。

行为变化

配置与部署

Memory 仍要求 Shared V2 项目。图片/PDF 需要文件读取权限、视觉模型与部署侧媒体解析支持;本文不执行部署或数据库迁移。

废弃与迁移

旧 Memory Resource、claim 和项目绑定初始化流程已从接入说明中移除;SDK 旧资源方法不作为当前服务接入示例。已发布 SDK 的版本与新服务能力分开记录,未更改全仓 SDK 版本钉。

已知问题与核验边界

无本任务证实的产品缺陷。接口契约核对不代表在线模型质量与实际部署结果。

手册侧

截图台账

本任务的截图来源依据是任务发起人在本会话的明确指令:“用release分支申请测试机,部署一个服务,文档内需要有系统操作截图”,并指定正式入库图片目录为 products/zh-CN/assets/。该指令是本次 Memory 更新使用专属测试机截图的来源例外,优先于目录默认的 SIT 取图步骤;只适用于本任务,不修改通用截图规则,也不将测试机记为 SIT。

部署与取图固定为 release-2.10.0@611a92b4853f3eea6c3ae83d2a0ec3b0480bd582,源码无跟踪修改。独立测试机申请编号 25020024;真实 Core、Memory、Worker 与 Console,Memory 按该版本的 required 009 / supported 006,009 配置,使用演示账号和数据。截图收集提交为文档分支 docs/memory-operation-screenshots-20261016@33e3e2dce8f581c2e149082a1a686031d6b7ce2e。本分支复制下列 PNG 后逐张校验 SHA-256,未用其他版本截图替代。

本次补入 15 张操作截图,来自独立申请的测试机,运行 Agentbase 2.10.0 和真实后端,使用演示账号与数据;不将该环境记为 SIT。覆盖项目创建、启用入口、模型配置、配置确认、就绪状态、直接写入、执行回执、检索、画像、四类 Pipeline、已保存草稿、模型路由、经验与技能、上下文及请求审计。图片位于各页面所属的 assets 目录,逐张检查,均不超过 300 KiB。

实际完成的操作为项目创建、Memory 启用、直接写入、语义检索、画像提取与查询、Pipeline 草稿创建与保存。经验与技能和上下文截图展示真实初始状态,不声明已完成蒸馏、版本批准或上下文生成。独立环境未部署可观测服务,未拍摄 Trace,也不声明移动端回归。移除旧版 Memory 概览图;其他功能点截图沿用基线。

图片(相对 products/zh-CN/assets/)拍摄时间(UTC,2026-10-16)SHA-256
memory/overview/fig-1-create-project.png08:52:17.040Zf4fec8b5ed87f82d23e3353de59935cd5bed5b077cc38efb238e555069a96a61
memory/overview/fig-2-memory-disabled.png08:49:37.441Z0e748a12f213b717e3e8938f6d7fb7c9617078f07798a4991f8bdf5c48312f28
memory/overview/fig-3-memory-configuration.png08:56:07.618Zba98f07f0168192d9dfde6ce0b43c26298e12a0b2a256429332965baa272d8ed
memory/overview/fig-4-memory-review.png08:56:08.369Za62d5228629d5ed0c3b56485b2af3782ceb1305bb374d91ad84c977c677c3c89
memory/overview/fig-5-memory-ready.png08:56:21.515Z5ebecdc8e814c9ba79e1e15f86beb772547c0a5a093fe2b50d8b578465878a4a
memory/memories/fig-1-create-memory.png08:56:44.908Z2016df8898f098f2b3c91812354496ae1ecc50fc6ea3fbab60fe89fd884bac16
memory/memories/fig-2-write-result.png08:56:49.794Z84f20a7839d408394ed9b5d0cfdc66ba35d54cd62484764266006c4ddd5cd373
memory/memories/fig-3-search-memory.png08:56:53.325Z98051ba33f40d7341b7bda2ee1762f5b96d32992338c2b5db3b6c37c510f85fa
misc/profiles/fig-1-profiles.png08:58:39.200Ze53865dede33dbe82a70310482381f5de49702b4b0d5e88d4732df8e626e8397
misc/evolution/fig-1-evolution.png08:57:03.529Z5961fae6ba1b21287c053f782e86a83878f98709412fd6f4b5a84032c4bb3f48
misc/models/fig-1-models.png08:57:06.143Za3ab9db50e7bdd91233cacff936b85f1b884388d25fd40cc2a95df15ff1b08f3
misc/governance/fig-1-contexts.png08:57:08.721Zabd51c91a853216121937efbcecc117dd860f449c729e923bce30713ea03b365
misc/configuration/fig-1-configuration.png08:57:11.299Z30a901eac5f52cd1a5cc52c3f8f7d84019c90e00af9bc7757ef73f43985d9000
misc/configuration/fig-2-pipeline-draft.png08:58:41.746Z4f8888a44a9a396e55982e82a18c265c6058ddc2c3fe1d157deb9a300bdfa998
misc/audit/fig-1-audit.png08:57:13.867Zd72eec65e99ecb01054595c647139d4a1c4db4d90f56352dad91e09dfc98ab99

交付核验

复核纠正了处理方式下拉框、控制台无编辑入口、主动删除语义与已遗忘内容保护;补齐权限、演示用户 ID、最小模型配置和异步任务续查步骤。SDK 演示加入本次操作的正文标记,区分新的演示与已删除内容。基础 Embedding 提供方、模型及维度的锁定说明与界面保持一致。

文档工具 77 项测试通过,145 个正文页面构建成功,本地链接与图片引用无死链;15 张新截图通过 PNG 完整性、大小及所属页面检查。Memory 的 54 项 API 操作、请求示例、代码围栏及多语言页签同时检查。删除、遗忘保护与重新学习相关的 5 个定向单元测试及协议单元测试通过。实际安装 2.9.0 SDK 验证完整脚本、连续两轮演示、6 张操作卡和异步成功/等待/部分失败/失败处理。SDK 验证采用模拟传输,不把测试机上的 Console 操作扩大为所有 SDK 或真实模型路线已回归。

本轮审查修正:Skill 下载包的项目准备、完整脚本与 HTTP 接入说明改为包内材料;API 与 SDK 说明明确可省略的字符串 errorCode,补充失败和部分失败响应,并纠正审计操作名 createMemory。新增实际 ZIP 引用边界与错误响应契约回归检查;本轮 81 项测试全部通过,146 个 HTML 页面完成本地引用检查,无死链。

根 DOCS-SYNC.md、API-DESIGN.md、SECURITY.md 已随 PR15 进入上述新目标,本次候选同步并补齐 Memory 文档与新增回归的映射。PR14 内容与新目标的合并结果需独立双轮审查;PR15 的通过记录不代替本次审查。

Memory 专项模拟验证及示例固定使用 SDK 2.9.0;这不覆盖后续 SDK 2.10.0 发布,当前通用接入版本见上表与 SDK 接入页。详情见 SDK 文档记录与 API 文档记录。

2026-10-19 构建就绪补充与截图路径勘误

PR14、PR15 已合入 v2.10.0@8f7b44336cd91e0d172295c6dabfc089fc62a92d;master 尚未同步。后续本轮构建固定此文档基线,修订内容经新的本地候选提交复现。默认 SIT 入口为 https://appbuild-sit.oceanbase.com/ ,此 URL 记录环境坐标,不声称本轮重新取图;Memory 图片仍是前文专属测试机例外。

截图仅按正文所属路径迁移到 assets/<页面路径>/,PNG 字节保持一致;观测概览与指标页原共用的 metrics 图各保留一份相同字节副本,分别归属各页面。原表路径是历史记录,当前以正文链接及所属 assets 子目录为准。迁移涉及 account、auth、databases、knowledge-base、models-ai-gateway、observability、organization、overview;根目录和页面路径不变。调色板 PNG 保留原文件,新增校验覆盖 CRC、解压上限、调色板和像素索引。

SDK/API 记录追加通用 2.10 发布来源,Skill 增加限定 Memory 兼容说明;发布索引仅引用已有制品,未触发新发布。