dsh-ming-graph
IdentifiedA graph of your memory store for DSH: one node per real memory, and every edge must state why the two are connected — a quoted keyword, a shared term, a project, or temporal adjacency. Pure filesystem
dsh-ming-graph
一个 DSH 插件:把记忆库画成一张能读的图——每条真记忆一个点,每条边都答得出「它凭什么连」。
入口在「插件」页的 tab 栏,和插件市场并排,点开是「关系图」。
~/.dsh/memory/notes/*.md ┐
QQ-Agent 的 observations.jsonl ├──► 纯读盘建图(不过模型)──► 快照 JSON ──► 前端画图
people/_index.json(号码→昵称) ┘
为什么不是一张「好看的图」
把记忆做成星云、粒子、力导向球体的东西很多,问题是它们不回答任何问题:两个点为什么连着?因为距离近?因为颜色像?那些边是布局算出来的,不是事实。
这里的规矩只有一条:边必须有理由,理由必须能读。
所以边只有四种,每种都带一个 why 字符串,点开节点能逐条读:
| 边 | 凭什么连 | why 里写什么 |
|---|---|---|
| 引用 | A 的正文里出现了 B 的关键词 | 那个关键词 |
| 共词 | 两条记忆的关键词交集 ≥2 | 是哪几个词 |
| 归属 | 项目节点 ↔ 该项目下每一条记忆 | 项目名 |
| 补边 | 同项目、按时间排下来紧挨着的两条 | 时间差 |
不编数据、不画演示点。读不到就报错,不拿假货顶上。
配套
配 dsh-ming-memory 一起用:那边把 persona 文件与最近几篇日记摆进系统提示词(只读、不捕获对话),这边把这些记忆的归档画成图。
一个管「下一轮用得上」,一个管「回头看都有什么」。装不装对方都能跑,装在一起,图上的点才和提示词里的字是同一批。
三个视图
- 人:星图。中心是记录者,边宽 = 关于那个人的记忆条数,只画 count ≥ 3 的。
- 主题:词共现。只算同一条记忆里一起出现 ≥2 次的词;父子词不连边。
- 时间线:按天,两侧分开。
不给人和人连边。 按共享词连过一次,连出来全是「机器人 ↔ 直接」这种噪音。人和人之间的关系,只能靠一条条能核的计数,不能靠词。
数据源(只读)
- DSH 侧(默认开):
~/.dsh/memory/notes/*.md的 frontmatter。扫目录,不读 index.json——索引会有滞后,目录才是全的。老笔记没有created就从文件名20261020-123127-…里解析。 - QQ 侧(可选):任何一行的 JSONL 观察库,路径配
qqObservations。不读 evidence/原文档——那文件几十 MB,图上用不着。 - 人名(可选):
peopleIndex指的{ byId: { "<号码>": [{ name }] } }。昵称会改,认人只认号。
三个都不写死在仓库里:路径、号码、群名一律从 ~/.dsh/ming-graph.json 读(见下面「配置」)。
路由与刷新
GET /_dsh/dsh-ming-graph/snapshot—— 当前快照;/refresh强制重算。- 用
connection.requestRejection做认证边界。curl 不带 cookie 会拿到 401——那个 401 就是路由活着的证据。 - Host 端每
syncSeconds(默认 120)stat 一次三个源,mtime 变了才重算(读 20ms + 算 100ms)。 - Client 端每 60 秒拉一次,
generatedAt没变就不重绘。
人这一层:一个人一颗点
早期版本里,同一个人会在私聊房间、群成员、观察记录里各成一个点,看起来像好几个人。现在按号码合并:一个人一颗点,跨房间的记忆都挂在他身上;房间只作场所。
私聊房间不单独成点——一对一没有信息量。群保留场所节点。
neuron-check.mjs 会顺手报这件事:同号多点不为 0 就算坏。
自己验
node neuron-check.mjs # 报节点/边/孤立点/同号多点,并落一份 JSON 给前端调试
node neuron-check.mjs out.json # 指定落盘路径
输出的是数据源的条数、图的规模、孤立点比例,以及人这一层的健康度。它是自验,不是演示:数字不对就是不对。
配置
跟某台机器绑在一起的值不进仓库,放 ~/.dsh/ming-graph.json(或用 MING_GRAPH_CONFIG 指一个文件):
{
"qqObservations": "/path/to/QQ-Agent/data/memory/observations.jsonl",
"peopleIndex": "/path/to/workspace/people/_index.json",
"ownerId": "123456789",
"ownerName": "我",
"roomLabels": {
"group:123456": "群 · 某个群",
"private:123456789": "私聊 · 我"
}
}
没有这个文件也能跑:只读 DSH 侧记忆,人名显示号码,房间按号码命名,星图中心不特指谁。
配置项全写在 index.js 的 DEFAULTS 里,文件里的同名键就地覆盖。
装
# profile 的 cordis.patch.yml
- id: ming-graph
config:
syncSeconds: 120
装完要看两处:Host 起来了不等于界面在——client 半边要等一次 HMR 重载(touch client.js 等几秒)才会注册进 plugins.tab;Slots.listSubTree 的 occupants 里能看到 ming-graph 才算成。
目录
index.js Host 端:路由、快照、定时重算
neuron.js 建图(纯函数)+ 两个读盘函数
client.js 前端入口
src/neuron-view.js 画图
neuron-check.mjs 自验
people-merge.mjs 按号码合并人
build.mjs 打包
License
MIT
Comments
Loading…
Similar plugins
by ilaomianyang
Long-term associative memory for DeepSeek Harness: raw episodes, typed memory cards and entity pages in a plain-text vault you own. No auto-injection, no embeddings, no binary store.
★ 0
MIT
JavaScript
Nov 3, 2026
dsh plugin --profile web add @ilaomianyang/dsh-memory-graphDSH knowledge-graph memory with a better-sidebar tab and a standalone /graph-memory/app dashboard: extracts TASK/SKILL/EVENT nodes, recalls across sessions, and ships as the npm package dsh-graphmemor
★ 0
↓ 288/wk
dsh plugin --profile web add dsh-graphmemoryOn-demand memory for DeepSeek Harness: session logs are distilled into layered markdown (a summary, an index and per-topic files), and a mem_query tool returns only the matched entries rather than the
★ 0
dsh plugin --profile web add dsh-memory-liteby XHszDHM
Long-term notes and daily journals kept per workspace in a hot/cold archive, each tier with its own index and rebalanced once a day; read and written through seven memory_* tools, with a settings page
★ 0
MIT
JavaScript
Nov 4, 2026
dsh plugin --profile web add dsh-memory-tideby icearia0219
Human-governed cross-session memory spaces with independent source and consumer relationships, provenance, versioning, and pre-send injection review.
★ 3
MIT
TypeScript
Sep 26, 2026
dsh plugin --profile web add dsh-memory-spacesby Bryan-cmf
DSH-Plugin: durable agent memory core - mem_save/mem_search/mem_health backed by storageDomain (survives restarts), 記憶 view tab.
★ 0
MIT
TypeScript
Aug 17, 2026
dsh plugin --profile web add @bryan-cmf/dsh-vector-memory