dsh-trivium — DSH 进程内图记忆
DeepSeek Harness 的跨会话图记忆插件：按节点和边记，默认少注入，设置页可改可归档。会话标题栏多一个 会话图：compaction 收成方框，可从检查点 fork，可选记忆芯片钉进下一轮。每个工作区一个 .dsh/trivium.tdb，不另起服务。
> 快速安装：dsh plugin --profile web add dsh-trivium → 重启 dsh web → 打开工作区（设置里出现「Trivium 记忆」，对话旁出现「会话图」）。
---
安装
> 前提：已安装 DeepSeek Harness 并至少启动过一次 dsh web。当前测试宿主：@deepseek-ai/dsh@0.1.1-rc.2（dsh-llm / dsh-tools peer 兼容 0.1.0-rc.8 与 0.1.1-rc.2）。设置里的「Trivium 记忆」、新会话短地图、跨会话 ctx_find、会话图标签均可用。
dsh plugin --profile web add dsh-trivium重启 dsh web 后生效。记忆文件在当前工作区：
<workspace>/.dsh/trivium.tdb用 Dsh_BatStart 的，双击启动就会装上，不必再执行上面这条。
本地跟源码联调：
npm install
node scripts/link-dsh.mjs然后重启 dsh web。
更新
dsh plugin --profile web add dsh-trivium装完重启 dsh web。源码联调则在仓库里 git pull 后再跑一次 node scripts/link-dsh.mjs。
AI 时代安装
把下面这句话复制给助手即可：
请在 DeepSeek Harness 上执行：dsh plugin --profile web add dsh-trivium
然后重启 dsh web。设置里会出现「Trivium 记忆」，会话标题栏「对话 / 轨迹」旁会出现「会话图」。---
做什么
- 跨会话 — 会话 A 记下「鉴权走 header X」，会话 B 调用
ctx_find("鉴权")命中，并带上它连着谁（about/decided/broke/fixed）。 - 默认安静 — 新会话只注入一张短地图（≤400 token）。模型要用再调工具，不会每一步灌满。
- 会话图 — compaction 切一段就收成一个方框；旧会话可点「更新检查点」补上已经发生过的压缩 / 分叉；勾选的记忆芯片从当前这段的下一轮注入。
- 人能改错 — 会话图芯片条可新增、归档、删除；设置页管搜、改名 / 正文、合并、全局开关。
- 抽取偏严 — 闲聊、一次性改文件、密钥不会从对话自动入库。芯片「新增」按你写的存（点一次整段一条）。
- 可选 embedding — 默认关。官方 DeepSeek 对话接口没有 embeddings；可填 OpenAI 兼容地址。
四个工具
| 工具 | 说明 |
|---|---|
ctx_find | 检索，返回摘要和图路径 |
ctx_read | 按 id 读全文和入边 |
ctx_remember | 手动写入 |
ctx_link | 两点之间建有向边 |
内核仍是这四个。会话图不加第五个工具。
---
会话图
入口：当前会话标题栏 对话 / 轨迹 / 会话图。这是情节图，不是记忆编辑器；改名、合并、全局开关仍走设置页。芯片条上可以直接新增、归档、删除。
方框
- 没压过上下文：只有一个「后续」方框。
- 一次成功的 compaction 之后：左边历史检查点（摘要来自 DSH），右边仍是「后续」。
- 点「生成检查点」：把当前「后续」收成左边一格，右边继续当后续。只切情节图，不压缩模型窗口。同一轮次再点不会双写。
- 装插件之前已经压过 / 分过叉的旧会话：点「更新检查点」，从当前对话里的压缩标记和侧边栏分叉补方框（可重复点，不会双写）。没压过就仍只有「后续」——会话长、工具多不等于 DSH 已经压缩（默认约窗口 80% 才自动压）。要压上下文请在对话里输入
/compact。 - 方框自己不压缩。质量来自 DSH 已经做的摘要替换；fork 时不会再总结一遍。
- 「改名」只改方框标题，不动 DSH 摘要。点方框可跳回对话里对应的检查点，或打开轨迹。
分叉
点方框上的分叉图标，会弹出「分叉为新会话」。这个名字会出现在左侧会话列表里（默认是源标题加 (1)）。
确认后走宿主的 session.fork：子会话出现在侧边栏，前缀（含当时已经压过的摘要）由 DSH 拷过去。有检查点时从那个检查点切开；只有「后续」时就从你点的那个方框连出去。
对话页里用 DSH 自带 fork，切回会话图也能看到对应分支。侧边栏归档一个子会话后，图上的分叉方框会跟着消失；取消归档会再出现。
画布：空白处拖动平移，滚轮缩放。
记忆芯片
会话图顶部可展开勾选。列出未归档的 preference / decision / entity（experience 不进芯片，避免太吵）。
| 操作 | 生效时机 |
|---|---|
| 勾上某条 | 当前这段里你再发的下一条带上它（L0，≤300 token） |
| 取消勾选 | 再下一轮不再带 |
| 新增 | 点一次写入一条；整段粘贴也是一条 |
| 选择 → 归档 | 软删除：find / 短地图 / 芯片不再出现，节点还在 .tdb |
| 选择 → 删除 | 从 .tdb 去掉，不可恢复 |
| 已经发出去的轮次 | 不回写 |
芯片按会话隔离。新开会话、fork 出的子会话默认都不勾；需要的话在分叉对话框旁打开「分叉时继承钉选」，或到子会话里重新勾。短地图仍在 session-start 自动带，不占芯片位。建议标记只是提示，不会自动勾上。
---
界面截图
以下入口在本机 DSH Web（0.1.1-rc.2）上仍在。截图摄于较早的 rc.6 界面。
会话 — ctx_find("鉴权")
会话开头注入 dsh-trivium 短地图；模型调用 ctx_find，命中「本仓库鉴权走 header X」。
轨迹 — 上下文注入可见
设置 — 注入策略
设置 — 记忆条目
会话图 — 对话 / 轨迹旁的第三标签
标题栏出现「会话图」。没压过的会话只有一个「后续」方框；顶部是记忆芯片（默认不勾）。compaction 之后左边出现历史方框，分叉从方框连到子会话。
---
限制
- 模型不调
ctx_find、也不勾芯片时，窗口里主要是开场短地图。 - 抽取会漏；脏数据可在芯片条归档 / 删除，或到设置里改、合并。
- 同一个
.tdb不要两个 Node 进程同时打开（正常只开一个dsh web即可）。 - Markdown 导出是给人看的，不能再解析回去。WorkBuddy 导入是一次性，不是双向同步。
- 会话图默认只投影 compaction 与 fork，不会按消息条数自己切方框。窗口没到 DSH 压缩线时，「更新检查点」也补不出历史方框；要分段请点「生成检查点」。
- 改插件设置后需要重启
dsh web。 - 宿主升到 rc.8 后，DSH 自己的旧会话库可能打不开（官方 SQLite 格式不兼容）。工作区里的
.tdb图记忆还在；对不上号的旧会话图方框可以当情节残留，不影响ctx_find。
---
更新说明
0.4.6 — 会话图可「生成检查点」：把当前「后续」收成左边一格。不触发 DSH 压缩。
0.4.5 — 宿主 peer 放宽到 0.1.0-rc.8 与 0.1.1-rc.2，不再嵌一套旧 dsh-llm / dsh-tools。
0.4.4 — 依赖 triviumdb@0.7.5：入边、按 label 扩邻、按 label 删边走引擎 API，不再全表扫边。find / 会话图行为不变。
0.4.3 — 会话图「更新检查点」：把当前对话里 DSH 已有的压缩标记和侧边栏 fork 补进图，给装插件之前的旧会话用。没压过的会话仍然只有「后续」。
0.4.2 — 会话图芯片条可新增（整段粘贴一条）、批量归档 / 删除。自动抽取仍偏严；芯片新增按你写的入库。
0.4.1 — 宿主钉到 @deepseek-ai/dsh@0.1.0-rc.8。功能与 0.4.0 相同。已在 rc.8 上确认：设置「Trivium 记忆」、新会话短地图、跨会话 ctx_find、会话图标签。
0.4.0 — 会话图、记忆芯片、从检查点 fork。
---
发布信息
- GitHub: https://github.com/QWQcool/dsh-trivium
- npm:
dsh-trivium@0.4.6 - 测试宿主：
@deepseek-ai/dsh@0.1.1-rc.2（兼0.1.0-rc.8） - License: MIT（依赖 TriviumDB 为 Apache-2.0）