本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

graph-memory

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:adoresever/graph-memory

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• DeepSeek Harness：通过 Cordis 生命周期接入 Session、Tool、Agent Loop、Prompt Assembly、LLM 与 Credentials；不修改 DSH 核心源码。
• OpenClaw：保留原有 Context Engine 插件入口、配置方式和数据能力。
• 共享内核：抽取、SQLite 存储、FTS5、向量检索、社区发现、PageRank 和上下文组装不绑定单一宿主。
• 跨 Session 召回，宿主重启后仍然保留。
• TASK、SKILL、EVENT 三类节点表达目标、方法、结果、错误与决策。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

数据存在哪里？会上传到云端吗？

默认存在本机 $DSH_HOME/graph-memory/graph-memory.db（未设 DSH_HOME 时通常为 ~/.dsh/graph-memory/graph-memory.db）。整个插件不发起任何数据上传，所有召回和抽取都在本地 SQLite 里完成。

没有配 Embedding（向量）能正常使用吗？

可以。当 embedding 配置为空时，插件自动切到 FTS5 全文检索模式，召回能力不会消失；后续接上向量服务会自动升级为语义检索并对历史节点做回填。

API key 怎么配才安全？

不要把 key 直接写到 Cordis 配置或聊天框里。推荐方式：在启动 DSH 的环境里设置 GRAPH_MEMORY_EMBEDDING_API_KEY / BASE_URL / MODEL / DIMENSIONS；插件只保存变量名引用，由 DSH 的 Credentials 服务在真正调用时再解析真实值。

DSH 入口里能找到 gm_update 和 gm_maintain 这两个工具吗？

找不到。当前 DSH/Cordis 适配器只注册了 gm_status、gm_search、gm_record、gm_stats 这四个工具，gm_update 和 gm_maintain 仅保留在 OpenClaw 入口，DSH 端尚未暴露。

这个插件和官方自带的会话压缩、上下文检索是什么关系？

不冲突也不互相替代。压缩解决"当前窗口还能装多少历史"，而 Graph Memory 解决"过往哪些知识值得现在叫醒"。两者方向互补，可以同时启用。

关键内容想稳定记下来怎么办？自动抽取偶尔会漏？

自动抽取依赖辅助模型输出，建议在 beta 阶段用 gm_record 工具主动写入——它通过类型化字段强制落库，不依赖 LLM 抽取逻辑，不会被遗忘。

真的不需要 Neo4j？这套方案能扛多大图谱？

Community 默认 SQLite，几千节点内本地图排序就能跑顺；README 与 DSH_NATIVE_PLAN 都明确写了 Neo4j 只在"更大图谱 + GDS + 复杂分析"才作为可选适配器出现，尚未实现。

npm 上能直接 add 安装吗？

当前 beta 1.6.0-beta.1 还没发布到 npm registry，需要先 git clone、npm install、npm run build、npm pack 生成 tarball，再用 dsh plugin --profile web add /path/to/.tgz 本地安装。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（官方适配基于 DSH 0.1.0-rc.5 验证，DSH 仍为 Developer Preview）
• Node: >=20（DSH 环境建议 Node 22.19+ 或 24+，见 README.md:200）
• Platforms: macOS, Windows, Linux
• Native modules: @photostructure/sqlite, @sinclair/typebox

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则