图谱记忆 adoresever/graph-memory

Graph Memory

Bound the context. Keep the memory.
DeepSeek Harness 原生记忆插件，保留最近的对话轮次，归档更早的历史，在需要时精确召回有来源支撑的知识。

中文 · dsh.so · 20-turn benchmark · Upgrade guide

它解决什么问题

Graph Memory 掌管模型可见的历史界面，但不会删除 DSH 的事件日志。默认情况下，它保留最新的五个已完成用户轮次，从后续请求中移除已完成的推理/工具轨迹，并自动召回相关的更早或跨会话来源问答。

1.6 轮次记忆导航升级

| 之前 | 现在 |
| 直接从消息中提取 TASK / SKILL / EVENT | 先生成一条自包含的轮次摘要，再从同一句话推导 SPO |
| 图节点可能变成事实载荷 | 摘要、SPO 和社区只负责导航；原始问题和最终答案仍是证据 |
| 活跃会话中的旧记忆可能被整体过滤 | 只排除新窗口中仍可见的来源；归档的同会话召回与跨会话召回共用一条路径 |
| 社区扩展可能拉入整个邻域 | 本地 LPA 缩小候选范围，查询时 PPR 排序，只恢复匹配的问答 |
| DSH 保留完整的工具和推理轨迹 | 已完成的轮次保留问题 + 最终答案；更早的前缀折叠为一个固定标记 |

写入一个已完成轮次只花费一次辅助 LLM 调用。社区检测和 PPR 都在本地完成。没有硬编码的节点/边数量、语义方向门控，也没有把无效输出变成可接受数据的 JSON 修复。阅读完整设计、来源映射和移植顺序 →

先看实测

| 真实 20 轮 GLM-5.2 运行 | 历史原生 DSH 基线 | 最新 Graph Memory | 变化 |
| T20 首次请求 | 56,998 tokens | 11,008 tokens | −80.69% |
| T20 模型可见消息 | 171 | 21 | −87.72% |
| T01–T20 首次请求上下文 | 532,451 tokens | 165,896 tokens | −68.84% |
| 全部实测 token¹ | 2,487,776 | 2,327,728 | −6.43% |

¹ 最新候选版本包含 166 次主智能体请求、20 次轮次抽取和 41 次嵌入请求；历史基线发起了 77 次主请求。DSH 提交与不确定的工具循环各不相同，因此这不是严格的同时 A/B 对比。首次请求上下文是直接的接管指标；完整账单依然可见。

20/20 场景轮次通过 · 20/20 结构化抽取成功 · 0 隔离 · 20 轮次摘要 · 92 条 SPO 三元组 · 30 个社区 · 20 个摘要向量。T11、T19 和 T20 自动召回了窗口外记忆，并带出精确的源问题和最终答案。

阅读 Markdown 基准测试、逐轮数据、方法与限制 →

记忆能跨过上下文窗口存活

图谱是导航层，不是证据的替代品。TASK、SKILL 和 EVENT 节点指回原始用户问题和最终可见答案；召回上下文包含这些精确的源消息。

在 DeepSeek Harness 上安装

1.6.0-beta.17 修复了 DSH 0.1.7+ / Session V4 上的生产者归属问题（#113）、无法使用 off 的模型上的抽取问题（#117），以及可配置的 SQLite 锁等待。上下文窗口与召回策略保持不变。修复详情与恢复说明（中文）→

Node.js 22.13+ · 无需 DSH 分支 · 在 npm 1.6 发布之前，安装固定版本的 GitHub release：

npx @deepseek-ai/dsh plugin --profile web add github:adoresever/graph-memory#v1.6.0-beta.17
npx @deepseek-ai/dsh --profile web --dump-config
npx @deepseek-ai/dsh web

npm registry 仍在提供旧的 1.5.8；不要用它验证 DSH。只有当 npm view graph-memory version 报告 1.6.0-beta.17 或更新版本后，才改用 npx @deepseek-ai/dsh plugin --profile web add graph-memory。

确认 Settings → Plugins 下 graph-memory/dsh 处于启用状态。默认数据库是 $DSH_HOME/graph-memory/graph-memory.db，通常为 ~/.dsh/graph-memory/graph-memory.db。

交付内容

| 能力 | 实现 |
| 上下文接管 | 可配置的最新 N 个已完成轮次；一个归档标记替换较旧的模型表面 |
| 轻量抽取 | 只处理用户问题和最终答案；严格的结构化工具契约；不摄入推理/工具记录 |
| 查询优先召回 | 向量 Top-K，FTS5 兜底；精确的源问答随图谱命中一起传递 |
| 持久记忆 | 本地 SQLite，来源稳定，支持跨会话、跨项目召回 |
| 失败行为 | 无效提取会被隔离；前台对话继续；坏数据不修复、不落库 |
| 宿主支持 | 原生 DSH/Cordis 适配器；维护中的 OpenClaw Context Engine 适配器 |

可选向量嵌入

Graph Memory 支持 OpenAI 兼容的向量嵌入端点。没有向量嵌入时，回退到 FTS5，不阻塞对话。

export GRAPH_MEMORY_EMBEDDING_API_KEY='replace-with-your-key'
export GRAPH_MEMORY_EMBEDDING_BASE_URL='https://dashscope.aliyuncs.com/compatible-mode/v1'
export GRAPH_MEMORY_EMBEDDING_MODEL='text-embedding-v4'
export GRAPH_MEMORY_EMBEDDING_DIMENSIONS='1024'
dsh web

DSH 工具与提取路由

| 工具 | 用途 |
| gm_status | 存储、提取、召回、向量与保留状态 |
| gm_search | 显式搜索图记忆 |
| gm_record | 确定性地持久化 TASK、SKILL 或 EVENT |
| gm_stats | 图与保留回执 |
| gm_maintain | 一次有界维护 tick |
| gm_retry_extraction | 显式重试待处理或已隔离的提取 |

自动召回无需调用工具。提取可以通过 GRAPH_MEMORY_LLM_PROVIDER 和 GRAPH_MEMORY_LLM_MODEL 使用专用模型；可选的推理与输出控制项是 GRAPH_MEMORY_LLM_REASONING_EFFORT 和 GRAPH_MEMORY_LLM_MAX_TOKENS。

没有显式指定 effort 时，提取会读取模型的确切能力：优先 off，否则用宿主公布的首个 effort，非推理模型则省略该字段。路由或服务商故障会让源 Q/A 保持待处理，并在日志和 gm_status 中报告原因。要恢复旧的已隔离记录，启用 assistantTools: all 并调用 gm_retry_extraction。用 GRAPH_MEMORY_DB_BUSY_TIMEOUT_MS 配置 SQLite 锁等待（默认：5000 毫秒）。

OpenClaw 兼容性

openclaw plugins install graph-memory
openclaw plugins enable graph-memory
openclaw gateway restart

在 ~/.openclaw/openclaw.json 中激活 Context Engine 槽位：

{
"plugins": {
"slots": { "contextEngine": "graph-memory" },
"entries": { "graph-memory": { "enabled": true } }
}
}

Graph Memory Pro

仓库里还有一个实验性的只读 DSH Pro Lite Host + Client 插件，后端是 Community SQLite。2D/3D 图工作台、分屏视图和受控拖拽到上下文仍在计划中。见 dsh-pro/README_CN.md。

验证与限制

当前 beta 1.6.0-beta.17 通过了 149/149 项自动化测试，其中包括 DSH 0.2.0-rc.2 的官方 V4 校验器，以及真实 SQLite 写入争用。上面 GLM-5.2 的 20 轮数据来自 2026-09-09 的导航升级运行；本次兼容性补丁没有重跑那项付费实验。

- 结构化抽取仍然依赖模型遵守契约：历史运行 20/20 次成功。契约失败会被隔离；路由/服务商失败则保持待处理，等配置修正后显式重试。
- 召回受可配置的 Top-K 限制。定向探测都成功了；一个宽泛的多主题查询可能需要更大的 Top-K，或者拆成多个问题。
- 公布的运行结果属于工程负载，不是通用的 LoCoMo/LongMemEval 分数。
- 摘要 + SPO 导航 + 精确问答升级的设计、源码地图和移植顺序，都记录在中文升级指南里。

从 benchmarks/dsh-context-takeover/ 复现。原始对话、服务商响应、本地路径和凭据均已排除。

Development

npm install
npm test
npm run build
npm run verify:package

MIT © 2026 adoresever · Asset and trademark notes