2.10.0 Memory SDK 使用文档修订
| 项目 | 说明 |
|---|---|
| 服务版本 | 2.10.0 |
| 范围 | 仅 Memory;不声明本仓其他功能已同步整版。 |
| SDK 安装版本 | Memory 专项验证与示例固定使用 agentbase-node-sdk@2.9.0;通用接入的 2.10.0 发布事实另见产品维护记录。 |
| 日期 | 2026-10-16 |
| 服务事实来源分支 | release-2.10.0(固定快照,后续分支移动不改变本记录) |
| 本迭代源 commit | 611a92b4853f3eea6c3ae83d2a0ec3b0480bd582(最终正文契约核对、定向单元测试及测试机部署共同使用) |
| 上一迭代源 commit | ebae954094883b847bf582cfbe9fbe58ae0a7499(上一版已登记的 v2.9.0,未用后查分支尖端替代) |
| 文档基线 commit | bbc80703db6f868846a3121c0938bbc4b4cd3bb7(开始任务时冻结的 origin/master;本任务目标按用户要求为 v2.10.0) |
| SDK 事实快照 | v2.9.0@58840fd6446526e832a050717419dc60522defc1(SDK 管线,不是服务快照) |
文档变化
新增从项目准备、模型配置、启用 Memory、手工保存记忆到创建 API Key、安装 SDK 的接入顺序,移除旧资源与绑定初始化流程。
增加完整 Node.js 示例,按用户行为覆盖创建、读回、列表、搜索、召回、版本更新和遗忘;补充异步轮询及逐项失败处理。
修正各语言操作卡的 CAS 版本、批量删除返回类型、exportId、画像消息输入、蒸馏证据与幂等键、上下文治理参数。
保留既有 6 类语言页签。2.9.0 SDK 尚未声明 media/pipelineId 的方法参数,使用 HTTP;项目生命周期和人工确认由 Console 管理。
完整复核纠正处理方式、主动删除和防止重新写入已遗忘内容的说明。演示正文包含每次操作标记,异步示例打印 jobId 和逐项结果,说明独立脚本的准备与续查方式;不再把控制台列表描述为可编辑。
跨页同步 Java、JavaScript 示例:Java 使用实际的类型化参数签名,JavaScript 先完成直写再检索,统一召回显式传 scope/userId。画像操作卡先提交提取,已有画像的读取、来源查询及重建独立执行,避免新项目先读画像即失败。
产品操作见 Memory 手册,示例见 SDK 接入与记忆操作。完整 HTTP 契约变化见 API 文档记录。
证据与语言状态
仅修订 zh-CN Memory 文档,其他功能与 en-US/ja-JP 未在本任务更新。实际安装 2.9.0 SDK 的模拟传输验证覆盖完整流程、连续两轮新演示、6 张操作卡的 22 次调用、批量删除失败中止,以及异步成功/超时/部分失败/失败分支;Java/Python/Go 操作卡核对签名、参数与枚举。文档工具 77 项测试通过,HTML 构建与本地链接检查通过。
本节记录的是原 Memory 专项的 SDK 2.9.0 验证;后续 SDK 2.10.0 发布与通用安装坐标已由本迭代基线登记,见产品维护记录。模拟测试不代表在线接口或真实模型质量验证。
固定来源与发布证据
服务与文档基线同 产品维护记录,截图及 Console 实操也使用该页登记的同一部署 commit;SDK 模拟传输验证不代表在线模型回归。SDK 2.9.0 的既有发布核验见 上一版交付记录。本轮重新查询 SDK v2.9.0 Release(id 1300,九附件),以及已存在的 build.json、delivery.json、SHA256SUMS 元数据;没有重新审计六个归档的完整内容。
本轮 registry 查询返回 agentbase-node-sdk@2.9.0,tarball 为 https://registry.npmmirror.com/agentbase-node-sdk/-/agentbase-node-sdk-2.9.0.tgz,dist.integrity 为 sha512-B4ZdbxRhPP7AL1xWc18Vlz+FcAULA14N7Yr8mQSk7jVunlPZfGLs/ChaXi8oYvNMa9VbGGxvSvNoID3u1rD3BA==。本任务使用该精确安装版本,未把服务 2.10.0 的更新写成 SDK 2.10.0 发布。
审查勘误:errorCode 在写入结果、任务、actions 与 fallback 中均为可省略字符串;失败、部分失败示例与固定 DTO 核对。Skill 的完整接入材料随 ZIP 自包含交付,新增打包链接边界与响应类型回归检查。
2026-10-19 通用发布与兼容补充
非 Memory 通用文档对应服务发布源 0a5d23f9349028496286572fd43117aa6f8fce0a,SDK 发布 v2.10.0 / revision 394f2a53dacfc2494f1f3e71082d9f09b9734ff1,制品六个 npm 坐标与六个 ZIP 的实际证据见 automation/release-evidence/2.10.0.json 发布索引。本页前文保留 Memory 专项 2.9 SDK 的历史验证边界,不把发布证明当在线全量兼容验收。当前适用范围见 Skill 的 references/compatibility.md 兼容说明。