fango19961106-dotcom/dsh-knowledge-graph

dsh-knowledge-graph

用于 DeepSeek Harness（DSH）的持久化知识图谱插件。

为每个 agent 会话提供三个面向模型的工具，背后由同一个嵌入式 FTS5 数据库支撑——因此经验教训、模式和决策能够跨越会话结束、预设切换和进程重启而存续：

| 工具 | 用途 |
|---|---|
| kg_remember | 持久化一条经验教训 / 模式 / 决策 / 现场笔记 / 误报 |
| kg_search | 对曾经记住的所有内容进行 BM25 全文召回 |
| kg_recent | 最新条目——在会话开始时低成本刷新上下文 |

提取自 agent-knowledge-graph 架构（L1 条目 → L3 BM25 召回 → L4 记忆），压缩为一个零依赖插件。

特性

- 零 npm 依赖——存储使用 Node 内置的 node:sqlite（FTS5、WAL 模式、porter 分词器）
- 一个文件，一个存储——~/.local/share/dsh-knowledge-graph/knowledge.db（遵循 $XDG_DATA_HOME），由该 profile 中的每个会话和预设共享
- 触发器保持 FTS 同步——插入/删除触发器，无需手动重建索引
- 净化后的 MATCH 输入——模型提供的查询会被剥离 FTS 操作符；格式错误的输入会回退到最近列表，而不是报错
- 干净卸载——插件卸载时数据库句柄会关闭（Cordis effect 回卷）

安装

需要 Node >= 22.5（用于 node:sqlite）。

从代码检出开始
git clone https://github.com/fango19961106-dotcom/dsh-knowledge-graph
cd dsh-knowledge-graph

然后添加到 DSH profile（运行中的 dsh 是由 bundle 组成的插件树——将此作为树外插件添加）：

mkdir -p ~/.dsh/plugins
cp -r . ~/.dsh/plugins/dsh-knowledge-graph

并在你的 profile 的 cordis.patch.yml 中列出它：

- insert:
- id: knowledge-graph
name: '~/.dsh/plugins/dsh-knowledge-graph/src/index.ts'

（或是在发布后从 npm 安装：npm i dsh-knowledge-graph，然后在 patch 文件中按名称引用 dsh-knowledge-graph）。

工具契约

kg_remember：

{
"kind": "lesson | pattern | decision | field_note | false_positive",
"title": "One-line imperative summary",
"body": "Self-contained note: what happened, the rule, the evidence",
"tags": ["optional", "keywords"],
"project": "optional-scope"
}

kg_search / kg_recent 返回带 «highlighted» 片段（FTS5 snippet()）的排序命中结果。

无需模型即可验证

node --experimental-strip-types -e "
import('./src/store.ts').then(async m => {
const s = new m.KnowledgeStore('/tmp/kg-test.db');
s.remember('lesson', 'Pin third-party action SHAs', 'Tag-pinned actions can be mutated; @vX tags are moveable refs.', ['supply-chain'], 'dsh-plugin');
console.log(JSON.stringify(s.search('supply chain'), null, 1));
s.close();
})"

许可证

MIT