[1.0.2] - 2026-09-08

🐛 修复

OpenClaw 宿主兼容

• 兼容 OpenClaw 8.2：适配新版宿主 API（runEmbeddedAgent 三级降级、标准 sessionKey、agentId 补传、runDetachedWebhookWork 独立 root work），并前向兼容旧版本（sessionKey / sessionFile 按版本二选一）。

核心稳定性

• L3 画像 agentId 硬编码问题：HostAdapter 新增 resolveAgentId 动态解析默认 agentId，替换两处写死的 main，覆盖单 agent 改名场景（多 agent / standalone / 异常兜底 main）。
• 召回策略在 embedding 不可用时自动降级 keyword：对齐 develop 分支，embedding 服务不可用时自动回退到关键字检索，避免召回失效。

[2.0.2-beta.1] - 2026-09-07

v2.0.2-beta.1 发布，相比 v2.0.1 新增可选的 MongoDB 存储后端、更丰富的面板登录方式、
全新的数据分析与可观测能力，并优化了技能展示、会话接入体验，修复了记忆召回、
多团队切换等若干问题。

产品定位：让 Agent 的经验、文档、代码沉淀成可复用资产，让下一位 Agent
直接读档。详见 README_CN.md。

🗄️ 存储后端可扩展 · 支持 MongoDB

团队记忆不再绑定单一存储，数据底座可按需选择：

• 新增 MongoDB 作为可选后端，大规模团队、高并发场景下更稳、更易横向扩展
• 本地 / 开源镜像新增一键 MongoDB 模式入口，部署时可按需切换存储方案
• 写入策略更稳健，数据一致性得到保障，减少高负载下的写入隐患

🔐 登录方式更丰富

• 面板新增企业登录能力，适配内部办公账号体系，登录更省心
• 账号鉴权更稳健，身份识别更准确

📊 数据分析与可观测性

• 全新数据分析页，团队使用情况一目了然，辅助你判断记忆资产的沉淀效果
• 关键环节补充埋点与可观测数据，运维排查更直观

🧰 技能（Skill）体验优化

• 技能检索与展示更结构化，信息更清晰、调用更稳定
• 历史遗留的异常技能数据自动修复，旧资产无缝兼容

🔄 会话与接入体验

• 更多客户端接入更顺畅，文字模式客户端也能开箱即用
• 团队 / Agent 选择列表完整展示，团队较多时不再漏选
• 会话重置完成提示更清晰

🐛 修复

• 修复部分场景下记忆召回为空、检索降级不生效的问题
• 修复个别情况下记忆解析失败、历史消息重复的问题
• 修复多团队切换时列表被截断、显示不全的问题
• 修复部署脚本在部分环境下的兼容性问题

[2.0.1] - 2026-08-25

产品定位：让 Agent 的经验、文档、代码沉淀成可复用资产，让下一位 Agent
直接读档。详见 README_CN.md。

🚀 支持更多 Agent 客户端

现在无论你用哪款 coding agent，都能直接挂上团队记忆：

• 新增 OpenCode 客户端接入
• 新增 DeepSeek Harness (dsh) 接入 —— DeepSeek 官方 agent harness 的
  Web UI 会话可直接接入 Proxy，自动获得团队记忆 / skill / 知识注入
• 新增 Codex CLI 接入
• 新增 WorkBuddy 客户端接入，开箱即用
• 多款客户端的首次引导与重置体验保持一致，切换更顺畅

🤖 会话内直接下指令

不用切到面板，在对话里就能完成常用操作：

• 会话中途一键重置绑定（换团队 / 换 Agent / 换任务）
• 对话内直接创建 / 更新任务
• 指令响应更快，减少等待

🧠 冷启动开箱即用

• 创建团队或用户即自动生成默认 Agent，无需手工配置
• 管理员可自定义默认 Agent 模板，新用户冷启动自动套用
• 支持从 IDE 里已有的 Agent 一键导入资产，快速起步
• 接入后默认绑定任务，即开即用

🔄 会话绑定更稳定

• 会话绑定持久化保存，重启不丢失
• 切换 Agent 后记忆与技能正确跟随切换，不再串场
• 修复部分客户端历史回放被误判的问题

🧰 技能（Skill）体验升级

• 会话里新建的技能立即可被检索到，不再有"搜索盲区"
• 恢复技能 ID 的展示与一键复制
• 技能支持在线编辑
• 新增接入向导技能：跟着引导一步步配置，或一条命令自动完成 Proxy 接入

🎛️ Memory Hub 面板

• 全新登录页，加入点阵波纹动效
• 团队编辑 / 删除入口整合到团队切换器，操作更顺手、修复切换异常
• 管理员创建账号时可自定义 User_Key
• 新增对话记忆搜索：跨会话的语义与关键字检索，按权限精确控制可见范围；
  支持对单层记忆直接覆盖修改
• 资产 ID 直接展示并可复制；列表完整加载，修复分页截断显示不全的问题

⚙️ 一键部署增强

• 启动脚本支持交互式配置，自动预检 LLM 通路与端口占用，避免部署踩坑
• 客户端接入地址一键复制，单机部署下自动解析为宿主机地址，外部客户端可直接连接

⚡ 性能优化

• 知识库列表加载提速，常用路径更快响应
• Wiki 页面并发构建，单页失败自动重试，大批量文档导入时间大幅缩短

📚 文档

• 按客户端拆分独立接入文档，各 agent 各有一份清晰的接入指南
• 新增面板与 API 使用文档
• 补充英文面板截图与 README 更新

🐛 修复

• 修复多 Agent 场景下记忆检索为空的问题
• 修复资产解绑不生效、资产较多时记忆 tab 丢失的问题
• 修复导入历史会话时间错乱，恢复原始时间线
• 修复编辑场景时部分内容被重复展开的问题
• 修复 macOS 下部署脚本的兼容性问题
• 修复依赖缺失导致的安装报错
• 修复部分客户端首次引导表单在老版本上的兼容性问题
• 新增清空对话记忆功能，支持批量删除

[2.0.1-beta.2] - 2026-08-15

v2.0.1-beta.2 发布，相比 v2.0.0 新增冷启动默认 Agent 与预置 Skill、Wiki 生成加速、
Skill 生态增强、Memory Proxy 新增 Codex / WorkBuddy / DeepSeek Harness 等客户端接入，
并修复了多 Agent 检索、资产解绑、记忆丢失等若干问题。

产品定位：让 Agent 的经验、文档、代码沉淀成可复用资产，让下一位 Agent
直接读档。详见 README_CN.md。

🧠 冷启动开箱即用 · 默认 Agent + 预置 Skill

• 创建团队/用户即自动生成默认 Agent，无需手工配置
• 客户端接入地址一键复制，支持指向 Memory Proxy
• 单机部署下接入地址自动解析为宿主机地址，外部客户端可直接连接

⚡ Wiki 生成加速

• 优化 Wiki 生成，页面并发构建，大幅缩短大批量文档导入时间
• 单页失败自动重试，不再拖停整个批次
• 生成进度与单页状态实时可见

🧰 Skill 生态

• 新增 Skill 导出功能
• 优化 Skill 检索，私有 Skill 可被检索到，结果更精准
• 优化 Skill 提取能力，捕获范围更广

🔀 Memory Proxy · 新增客户端接入

• 新增 Codex CLI 接入
• 新增 WorkBuddy 客户端接入
• 新增 DeepSeek Harness (dsh) 接入 —— DeepSeek 官方 agent harness 的 Web UI 会话
  可直接接入 Proxy，拿到团队记忆 / skill / knowledge 注入；支持 aux 请求短路
  (compaction / title-gen) 与 CLI headless bypass
• 优化 code-graph 资源与工作区的关联

🎛️ Memory Hub 面板

• 重构首次使用引导流程，新增 Agent 绑定步骤
• 优化面板交互、加载骨架屏与过渡动效
• 优化 Task 页用户展示名解析
• 优化资产页面布局与归属/共享规则说明
• 修复资产较多时记忆 tab 丢失的问题

🐛 修复

• 修复多 Agent 场景下记忆检索为空的问题
• 修复资产解绑不生效的问题
• 导入的历史会话保留原始时间，时间线不再错乱
• 修复某些场景下记忆丢失的问题
• 新增清空对话记忆功能，支持批量删除

[2.0.1-beta.1] - 2026-08-14

v2.0.1-beta.1 发布，相比 v2.0.0 新增冷启动默认 Agent 与预置 Skill、Wiki 生成加速、
Skill 生态增强、Memory Proxy 新增 Codex / WorkBuddy / DeepSeek Harness 等客户端接入，
并修复了多 Agent 检索、资产解绑、记忆丢失等若干问题。

产品定位：让 Agent 的经验、文档、代码沉淀成可复用资产，让下一位 Agent
直接读档。详见 README_CN.md。

🧠 冷启动开箱即用 · 默认 Agent + 预置 Skill

• 创建团队/用户即自动生成默认 Agent，无需手工配置
• 客户端接入地址一键复制，支持指向 Memory Proxy
• 单机部署下接入地址自动解析为宿主机地址，外部客户端可直接连接

⚡ Wiki 生成加速

• 优化 Wiki 生成，页面并发构建，大幅缩短大批量文档导入时间
• 单页失败自动重试，不再拖停整个批次
• 生成进度与单页状态实时可见

🧰 Skill 生态

• 新增 Skill 导出功能
• 优化 Skill 检索，私有 Skill 可被检索到，结果更精准
• 优化 Skill 提取能力，捕获范围更广

🔀 Memory Proxy · 新增客户端接入

• 新增 Codex CLI 接入
• 新增 WorkBuddy 客户端接入
• 新增 DeepSeek Harness (dsh) 接入 —— DeepSeek 官方 agent harness 的 Web UI 会话
  可直接接入 Proxy，拿到团队记忆 / skill / knowledge 注入；支持 aux 请求短路
  (compaction / title-gen) 与 CLI headless bypass
• 优化 code-graph 资源与工作区的关联

🎛️ Memory Hub 面板

• 重构首次使用引导流程，新增 Agent 绑定步骤
• 优化面板交互、加载骨架屏与过渡动效
• 优化 Task 页用户展示名解析
• 优化资产页面布局与归属/共享规则说明
• 修复资产较多时记忆 tab 丢失的问题

🐛 修复

• 修复多 Agent 场景下记忆检索为空的问题
• 修复资产解绑不生效的问题
• 导入的历史会话保留原始时间，时间线不再错乱
• 修复某些场景下记忆丢失的问题
• 新增清空对话记忆功能，支持批量删除

[2.0.0] - 2026-08-03

v2.0.0 正式版发布，相比 beta.1 新增 Skill 强制归档、CodeGraph 定时同步、
面板中英文切换 / 管理员资产管理等特性，并完善了部署流程与接入文档。

产品定位：让 Agent 的经验、文档、代码沉淀成可复用资产，让下一位 Agent
直接读档。详见 README_CN.md。

🧠 四种记忆资产 · 首次完整开源

四类资产从"对话/工作痕迹"里自动沉淀出来：

• Chat Memory — 从对话中逐层提取 L0 原始记录 → L1 事实 → L2 场景 → L3
  长期认知；跨会话保留偏好、决策、交互历史。
• Skill — 从跑通的任务里提炼可复用 SOP，附版本 / 资源文件 / 触发边界 /
  执行步骤 / 验证规则。新增强制归档功能，确保关键 Skill 不遗漏。
• Wiki — 把文档变成结构化页面 + 链接图谱（灵感来自 Karpathy 的 LLM 知识库
  实践）。
• CodeGraph — 索引仓库的符号 / 文件 / 调用关系 / 影响路径，Agent 改代码
  前先做 impact analysis。新增定时自动同步代码库功能，仓库变更后无需手动
  触发。

🎛️ Memory Hub · 面向团队的操作台

管控面板（agentmemory/memory-hub 镜像，含 Panel + Knowledge Service）：

• 建 Team / Agent，把资产按 Owner / 版本 / 状态 / 可见性统一管理
• 三级可见性：private / team / restricted（User / Role / Agent ACL），
  外加 agent 定向装配
• Agent Loadout：给不同 Agent 绑定不同资产、调整优先级和使用方式
• Wiki + CodeGraph 工坊内置在 Hub，导入代码库/文档就能自动构建
• 新增管理员（System Admin）也可使用资产管理功能
• 新增面板全面支持中英文切换；统一页面设计风格，优化列表交互和分页体验

🔀 Memory Proxy · Agent 挂上记忆的通道

agentmemory/memory-proxy 让 Claude Code 等 coding agent 直接用上团队记忆：

• Anthropic / OpenAI 双协议：/claude-code/<spaceId>/v1/messages 和
  /v1/chat/completions 都接
• 首轮引导：sessionInit 通过 AskUserQuestion 让用户选 team / agent /
  task，proxy 记住绑定
• 每轮注入：把该 agent 的 L2/L3 记忆、matched skill、wiki/code-graph
  拼进 system prompt，转发上游 LLM
• 鉴权：x-tdai-user-key → 内核 /v3/meta/auth/verify 换 user_id，
  按用户维度控制资产可见性

🚀 部署方式

stop-all.sh --purge 可彻底清理 volume + admin key，方便重置环境。

🧰 官方 SDK

📖 文档

• 新增 CodeBuddy / Hermes / OpenClaw 接入指南
• 更新安装指南中的角色权限说明

Full Changelog: v2.0.0-beta.1...v2.0.0

[2.0.0-beta.1] - 2026-07-21

产品定位：让 Agent 的经验、文档、代码沉淀成可复用资产，让下一位 Agent
直接读档。详见 README_CN.md。

🧠 四种记忆资产 · 首次完整开源

四类资产从"对话/工作痕迹"里自动沉淀出来：

• Chat Memory — 从对话中逐层提取 L0 原始记录 → L1 事实 → L2 场景 → L3
  长期认知；跨会话保留偏好、决策、交互历史。
• Skill — 从跑通的任务里提炼可复用 SOP，附版本 / 资源文件 / 触发边界 /
  执行步骤 / 验证规则。
• Wiki — 把文档变成结构化页面 + 链接图谱（灵感来自 Karpathy 的 LLM 知识库
  实践）。
• CodeGraph — 索引仓库的符号 / 文件 / 调用关系 / 影响路径，Agent 改代码
  前先做 impact analysis。

🎛️ Memory Hub · 面向团队的操作台

管控面板（agentmemory/memory-hub 镜像，含 Panel + Knowledge Service）：

• 建 Team / Agent，把资产按 Owner / 版本 / 状态 / 可见性统一管理
• 三级可见性：private / team / restricted（User / Role / Agent ACL），
  外加 agent 定向装配
• Agent Loadout：给不同 Agent 绑定不同资产、调整优先级和使用方式
• Wiki + CodeGraph 工坊内置在 Hub，导入代码库/文档就能自动构建

🔀 Memory Proxy · Agent 挂上记忆的通道

agentmemory/memory-proxy 让 Claude Code 等 coding agent 直接用上团队记忆：

• Anthropic / OpenAI 双协议：/claude-code/<spaceId>/v1/messages 和
  /v1/chat/completions 都接
• 首轮引导：sessionInit 通过 AskUserQuestion 让用户选 team / agent /
  task，proxy 记住绑定
• 每轮注入：把该 agent 的 L2/L3 记忆、matched skill、wiki/code-graph
  拼进 system prompt，转发上游 LLM
• 鉴权：x-tdai-user-key → 内核 /v3/meta/auth/verify 换 user_id，
  按用户维度控制资产可见性

🚀 部署方式

🧰 官方 SDK

[1.0.1] - 2026-07-13

Patch 修复版本：修复 Gateway local 模式下 L2 定时器路由错误导致场景提取失效的问题，以及升级 COS SDK 解决安全风险。

🐛 修复

• Gateway local L2 定时器未走场景提取 (#227)：本地 timer 扫描将 L2 schedule 错路由到非 scene extraction 任务类型，导致 L2 场景提取定时触发失效。抽出 timer-routing.ts，按 timer member 前缀正确映射 offload-l1 / offload-l15 / offload-l2 与 L1 / L2 / L3 任务。
• 升级 cos-nodejs-sdk-v5 至 3.0.0：旧版 COS SDK 存在安全风险，升级从而修复该问题。

Full Changelog: v1.0.0...v1.0.1

[1.0.0] - 2026-06-11

正式版发布：从 OpenClaw 专属插件演进为面向所有 Agent 的通用记忆服务。完整的 Gateway 独立服务 + v2 HTTP API + 官方 TypeScript / Python SDK，任何 Agent 框架均可接入完整的多层记忆与上下文压缩能力。

⚠️ Breaking Changes

• 客户端/服务端架构拆分：记忆引擎从 OpenClaw 嵌入式插件拆分为独立 Gateway 服务进程，部署方式与接入方式发生变化。
• 配置结构变更：插件配置结构扁平化重构，原 gateway 字段迁移为 server 嵌套。
• 插件入口模式变更：支持 local（进程内本地运行，默认）和 client（连接外部 Memory Gateway）两种接入模式。

🚀 独立 Gateway 服务（v2 API）

记忆能力不再绑定 OpenClaw 宿主，以独立服务形式运行，通过 v2 HTTP API 为任意 Agent 提供记忆读写与管线管理：

• 完整 v2 API：14 条标准路由覆盖记忆 CRUD、原子更新、场景索引、管线状态查询等全部操作。
• 管线状态查询（/v2/pipeline/status）：实时获取 L1/L2/L3 各阶段运行状态与进度。
• 实例生命周期管理（/v2/instance/destroy）：支持外部系统主动创建/销毁记忆实例。
• 可选 Bearer 鉴权 + CORS 白名单：保护对外暴露的 API 安全。
• 请求体校验：强制 1 MiB 上限，防止异常请求。

🚀 官方 SDK

• TypeScript SDK 1.0.0（@tencentdb-agent-memory/memory-sdk-ts）：类型安全，覆盖全部 v2 API，npm 安装即用。
• Python SDK（tencentdb-agent-memory-sdk-python）：pip wheel 安装，同步/异步双模式，覆盖全部 v2 API。

🚀 通用 Agent 框架适配

• OpenClaw 插件适配：支持 local（进程内本地运行，默认）和 client（连接外部 Memory Gateway）两种接入模式。local 模式保持原有体验。
• Hermes Agent 适配：memory_tencentdb_v2 adapter，支持 Hermes 框架多租户场景。
• 通用接入：任何能发 HTTP 请求的 Agent（LangChain、AutoGPT、自研框架等）均可通过 SDK 或裸 API 接入。

🚀 可观测性

• OpenTelemetry 全链路 Trace：支持 OTLP 协议上报，可对接 Jaeger / Grafana Tempo 等后端。
• Langfuse 集成：仅转发 LLM 相关 span，适合评估记忆提取质量。
• 管线评测指标：L1 提取率、去重决策分布、各阶段 token 消耗、recall 延迟等。

🚀 Offload Server V2

• L1 / L1.5 / L2 异步执行器：独立的 Offload 处理管线，支持大规模会话并发。
• L3 压缩处理器：Mermaid 符号化 + 上下文预算控制，智能上下文压缩。
• MMD 注入：支持多模态数据注入 Offload 流程。
• Gateway 集成 /v2/offload/* 路由：统一 Offload API 入口。

📦 部署方式

⬆️ 从 0.x 升级说明

v1.0.0 与 0.x 是并行维护的两条版本线：

• 0.x（main 分支）：OpenClaw 嵌入式插件，适合轻量单机场景
• 1.x（feat/server 分支）：独立 Memory 服务，适合多 Agent / 多框架 / 服务化部署

两者核心记忆引擎相同（L0→L3 分层 + BM25/向量混合检索 + Mermaid 符号化短期记忆），数据格式兼容。

🐛 修复（v1.0.0-beta.2 → v1.0.0）

• Hermes 插件 install_hermes_tdai_gateway.sh 完善：支持 root 自动切换用户、旧路径自动迁移、幂等检测以跳过重复安装
• Gateway 配置优化：默认端口 8420，同步写入 /etc/profile.d/ 和 ~/.hermes/.env 两份环境变量
• SDK 文档补全：TypeScript / Python SDK README 与接入示例
• OpenClaw plugin.json 配置调整：移除 deprecated 字段，适配 OpenClaw 最新版本

📖 文档

• SDK 接入指南（TypeScript / Python 示例）。
• Gateway 独立部署文档。
• OpenClaw / Hermes 插件安装说明。
• Docker 部署与配置参考。

Full Changelog: https://github.com/Tencent/TencentDB-Agent-Memory/commits/feat/server

[1.0.0-beta.1] - 2026-05-29

🚀 全新架构：独立 Memory 服务

v1.0.0-beta.1 是 TencentDB Agent Memory 的全新里程碑版本，从 OpenClaw 嵌入式插件演进为独立可部署的 Memory 服务。

核心变化：

• 独立部署：不再依赖 OpenClaw 宿主，支持 Docker / Node.js 直接部署
• HTTP v2 API：完整的 RESTful 接口，任何语言/框架的 Agent 都可通过 HTTP 接入
• 多框架适配：同时支持 OpenClaw 插件模式 + Hermes 插件模式 + 独立服务模式
• 官方 SDK：提供 TypeScript SDK 与 Python SDK

✨ 新功能

v2 REST API（Gateway）

• L0 Conversation：add / query / search / delete
• L1 Atomic：update / query / search / delete
• L2 Scenario：ls / read / write / rm
• L3 Core（Persona）：read / write
• 所有路由前缀 /v2/，认证方式 Authorization: Bearer + x-tdai-service-id

Standalone 本地模式

• 零外部依赖：仅需 LLM API Key 即可运行
• 默认 SQLite + BM25 存储，开箱即用
• 支持 Docker 一键部署（agentmemory/hermes-memory:1.0.0-beta / agentmemory/openclaw-memory:1.0.0-beta）

SDK

• TypeScript SDK（@tencentdb-agent-memory/memory-sdk-ts）：完整覆盖 L0–L3 全部接口
• Python SDK（tencentdb-agent-memory-sdk-python）：同步 + 异步双客户端

Pipeline 服务化

• PipelineWorker：异步消费 L1 提取 / L2 场景生成 / L3 画像更新
• TimerScanner：定时扫描 idle session 触发 pipeline
• StorePool：多实例存储池管理
• Redis HA 配置支持（service 模式）

可观测性

• OpenTelemetry trace/metric/log 集成
• Langfuse span processor
• ClickHouse + Kafka 可选上报

📦 部署方式

⬆️ 从 0.x 升级说明

v1.0.0-beta.1 与 0.x 是并行维护的两条版本线：

• 0.x（main 分支）：OpenClaw 嵌入式插件，适合轻量单机场景
• 1.x（feat/server 分支）：独立 Memory 服务，适合多 Agent / 多框架 / 服务化部署

两者核心记忆引擎相同（L0→L3 分层 + BM25/向量混合检索 + Mermaid 符号化短期记忆），数据格式兼容。