QWQcool/dsh-trivium

dsh-trivium — DSH 进程内图记忆

DeepSeek Harness 的进程内图记忆插件：按节点和边记，默认少注入，设置页可改可归档。内核贴近 DSH：不另起进程、默认不加导航。要钉住某些记忆片段，再在设置里打开 芯片 注入；情节画布是可选的自嗨层，嵌在芯片开关下。每个工作区一个 .dsh/trivium.tdb，不另起服务。

快速安装：dsh plugin --profile web add dsh-trivium → 重启 dsh web → 打开工作区（设置里出现「Trivium 记忆」；标题栏 芯片 默认关）。完整步骤见 安装。

安装

前提：已安装 DeepSeek Harness 并至少启动过一次 dsh web。当前测试宿主：@deepseek-ai/dsh@0.1.5-rc.1（dsh-llm / dsh-tools peer 兼容 0.1.1-rc.2 与 0.1.0-rc.8）。

dsh plugin --profile web add dsh-trivium

重启 dsh web 后生效。记忆文件在当前工作区：

/.dsh/trivium.tdb      # 本地索引（二进制，建议 gitignore）
/.dsh/trivium.jsonl    # git 源（业务事实）

把 trivium.jsonl 交给 git。二进制库不要进版本库：

.dsh/trivium.tdb
.dsh/trivium.tdb*
.dsh/trivium-pending.json

clone / git pull 后若 jsonl 变了会自动导回。设置里 Git 旁路 默认关（和芯片一样）。在「检查更新」下面的 配置设置 里打开。开关只控制是否自动写出。开着时 生成 用当前 .tdb 覆盖写出同一路径的 jsonl；关掉后 删除 jsonl 会清掉已知工作区的 jsonl（.tdb 不动）。情节、向量、芯片钉选仍只留在本机。

用 Dsh_BatStart 的，双击启动就会装上，不必再执行上面这条。

本地跟源码联调：

npm install
node scripts/link-dsh.mjs
npm test              # 可选：跑全部离线 smoke

npm test 不需要 DSH 宿主，也不会碰你真实的 ~/.dsh/trivium.json（每个脚本用独立的临时设置文件）。想只跑一部分就传子串：npm test -- p8。

然后重启 dsh web。

更新

dsh plugin --profile web add dsh-trivium

装完重启 dsh web。源码联调则在仓库里 git pull 后再跑一次 node scripts/link-dsh.mjs。

卸载

先停掉 dsh web，避免 .tdb 被占用，然后：

dsh plugin --profile web remove dsh-trivium

remove 会删掉本插件的文件：~/.dsh/trivium.json，以及它打开过的每个工作区里的 .dsh/trivium.tdb、trivium.jsonl 和 trivium-pending.json。.dsh/ 下其它文件不动。用 dsh plugin add dsh-trivium 升级不会清记忆。若 trivium.jsonl 已提交，git checkout 可以找回。

然后再重启 dsh web：设置里不再有「Trivium 记忆」，标题栏不再有「芯片」，四个工具不再注册。

从未用本版打开过的工作区，可能还留着旧 .tdb；看到就手动删那个文件。只想停用、不卸载（数据还在）：在该 profile 的 cordis.patch.yml 里加：

- id: dsh-trivium
disabled: true

再重启 dsh web。

权限与数据

插件随 dsh web 进程加载，不另起端口、不另起服务。

| 访问 | 默认 | 说明 |
|---|---|---|
| 工作区 .dsh/trivium.tdb | 读写 | 记忆库。同一文件不要两个 Node 进程同时打开 |
| 工作区 .dsh/trivium.jsonl | 读写 | Git 旁路（默认关）。只含业务节点和边，不含向量 |
| ~/.dsh/trivium.json | 读写 | 设置和芯片钉选；可含你手填的 embedding API key |
| .dsh/trivium-pending.json | 读写 | 抽取失败时的本地队列 |
| 网络 | 关 | 对话不外发。打开 embedding 并填了 URL 才会把被检索文本发到你填的地址。设置页点「检查更新」会请求 npm registry（只拿版本号，不含对话） |
| 对话原文 | 不外发 | 抽取和检索都在本机；embedding 开启后，被检索的文本会发到你填的地址 |

官方 DeepSeek 对话接口没有 embeddings。不开 embedding 也能用：关键词 + 图遍历。改完设置或 embedding 后需重启 dsh web。

AI 时代安装

把下面这句话复制给助手即可：

请在 DeepSeek Harness 上执行：dsh plugin --profile web add dsh-trivium
然后重启 dsh web。设置里会出现「Trivium 记忆」。标题栏标签叫「芯片」，默认关；在设置「Trivium 记忆」里打开「芯片（记忆白名单）」即可，拨一下就保存，不必再重启。

默认安静的图记忆

Trivium 是记忆内核，不是日记、日历或聊天伴侣。它按节点和边记，默认少注入，记错了人能改。

- 跨会话 — 会话 A 记下「鉴权走 header X」，会话 B 调用 ctx_find("鉴权") 命中，并带上它连着谁（about / decided / broke / fixed）。
- 默认安静 — 新会话只注入一张短地图（≤400 token）。模型要用再调工具，不会每一步灌满。标题栏默认也不加第三标签。
- 芯片 / 记忆白名单（默认关） — 设置里打开后，标题栏「对话 / 轨迹」旁出现 芯片。拨一下即写入 ~/.dsh/trivium.json，重启后仍保持。勾选的条目从下一轮注入（L0，≤300 token）。其下还有 会话层（也默认关）：把 compaction / 分叉画成方框。
- 人能改错 — 芯片条可新增、归档、删除；设置页管搜、改名 / 正文、合并、导入导出、全局开关。
- 抽取偏严 — 闲聊、一次性改文件、密钥不会从对话自动入库。芯片「新增」按你写的存（点一次整段一条），同样过写入卫生闸门。
- 写入卫生 — ctx_remember、芯片新增、抽取、外部导入会拒绝乱码、复读、JSON envelope、base64 残骸和密钥。已经进 .tdb 的脏节点仍可在设置里看见以便归档；find / 短地图 / 芯片不再带它们。
- 可选 embedding — 默认关。官方 DeepSeek 对话接口没有 embeddings；可填 OpenAI 兼容地址。不开也能用：关键词 + 图遍历。

底层工程

- 进程内、一个文件 — TriviumDB（向量 + JSON payload + 有向带权图）随 DSH 进程打开。不另起 HTTP / Python 服务。
- 只有四个工具 — ctx_find / ctx_read / ctx_remember / ctx_link。芯片 / 会话层不加第五个。
- 注入走 agent.inject() — 不写 system prompt，避免 persona.complete: true 把地图静默丢掉。
- 召回带路径 — 每条命中都说明从哪个节点、沿哪条边过来。
- 失败不挡主循环 — 存储 / embedding / 抽取出错只记日志，Agent 继续。
- 界面跟随宿主语言 — 设置页和「芯片」标签随 DSH locale/change 切换（zh / en），也可在配置设置里锁定。
- 首轮短地图 — 每个会话只注入一次。若 session-start 和第一步赛跑输了，pre-step 会补上；不会每步重写（前缀缓存友好）。

功能

跨会话图

节点类型是 entity / preference / decision / experience。业务边是 about、decided、broke、fixed。

ctx_find 返回 L0 摘要和图路径（入边写成

会话开头注入 dsh-trivium 短地图；模型调用 ctx_find，命中「本仓库鉴权走 header X」。

轨迹 — 上下文注入可见

设置 — 检查更新、语言、注入策略

「检查更新」下面是可折叠的 配置设置（本插件语言、注入策略）。

设置 — 抽取、芯片、Git 旁路

芯片开关下嵌 会话层（情节画布）。同一页还有 Git 旁路、Markdown 导出、外部记忆一次性导入、远程 embedding。

设置 — 记忆条目

芯片 — 可选，在对话 / 轨迹旁

默认关。设置里打开 芯片（记忆白名单） 后，标题栏立刻出现 芯片。若同时打开 会话层，没压过的会话只有一个「后续」方框；顶部是记忆芯片（默认不勾）。可点「生成检查点」把后续收成左边一格。compaction 或 /compact 之后左边也会出现历史方框，分叉从方框连到子会话。

限制

- 模型不调 ctx_find、也不勾芯片时，窗口里主要是开场短地图。
- 抽取会漏；脏数据可在芯片条归档 / 删除，或到设置里改、合并。
- 同一个 .tdb 不要两个 Node 进程同时打开（正常只开一个 dsh web 即可）。
- Markdown 导出是给人看的，不能再解析回去。能回写进 git 的是 trivium.jsonl，不是 Markdown。外部导入（WorkBuddy / Claude Code / Codex）是一次性，不是双向同步，也不会吃会话 jsonl。
- .tdb 不要在 git 里合并（二进制）。跟踪 trivium.jsonl，忽略 .tdb。jsonl 冲突按普通文本解决，再打开工作区即可。
- 会话层打开时只投影 compaction 与 fork，不会按消息条数自己切方框。窗口没到 DSH 压缩线时，「更新检查点」也补不出历史方框；要分段请点「生成检查点」。
- 芯片 / 会话层 / Git 旁路 / 注入 / 抽取开关拨一下即保存。Embedding URL 仍要点「保存设置」。只有设置页本身没出现时才需要重启 dsh web。
- 宿主升到 rc.8 后，DSH 自己的旧会话库可能打不开（官方 SQLite 格式不兼容）。工作区里的 .tdb 图记忆还在；对不上号的旧情节方框可以当残留，不影响 ctx_find。

更新说明

0.4.18 — ~/.dsh/trivium.json 改为原子写（此前写到一半被杀会让所有开关和芯片钉选静默回默认），POSIX 下权限收紧为仅属主可读。新增 npm test 聚合入口（每个脚本用独立临时设置文件），smoke-p0 新增「重开后 hybrid 文本索引仍可用」的断言。四工具 / 短地图 / find 路径行为不变。

0.4.17 — 存储升到 triviumdb@0.8.8（引擎行为相对 0.4.16 不变）。适配宿主 @deepseek-ai/dsh@0.1.5-rc.1：session.header.seedLength 被移除，会话层 fork 切点改读 session.inheritedEventCount。四工具 / 短地图 / find 路径不变。

0.4.16 — 存储升到 triviumdb@0.8.4：引擎构造函数改为 options 对象（{ dim }），不再收数字位置参数；TQL 行 id 变字符串，插件内部归一为数字。四工具 / 短地图 / find 路径不变。

0.4.15 — 存储升到 triviumdb@0.8.2。设置 API 拒绝非回环请求与未登记 cwd；抽取后清空缓冲，savePending 不再阻塞当轮。

0.4.14 — 存储升到 triviumdb@0.8.1（WAL/锁更硬、可选只读共享、ARM64 修复）。四工具 / 短地图 / find 路径不变。

0.4.13 — 标题栏只显示 芯片；设置里的开关仍叫 芯片（记忆白名单）。会话层开关立刻刷新芯片页。设置 / 芯片截图更新。

0.4.12 — Git 旁路：工作区 .dsh/trivium.jsonl 作为文本源（业务节点和边）。.tdb 仍是本地索引。写入延迟约 1.5 秒，不额外调模型。clone / git pull 后文件变了会导回。开关默认关。生成 用当前 .tdb 覆盖写出 jsonl；关掉后 删除 jsonl 会清掉已知文件。设置页把可选项收到「检查更新」下的配置折叠里。界面语言可跟随宿主或锁定中/英。

0.4.11 — 标题栏标签改为 芯片(记忆白名单)（不再叫「会话图」）。开关拨一下即写入 ~/.dsh/trivium.json；标签立刻出现或消失，不必重启。

0.4.10 — dsh plugin remove 会删掉已知工作区的 .tdb 和 ~/.dsh/trivium.json。升级安装不清记忆。配置里 disabled 仍保留数据。

0.4.9 — 芯片标签和会话层画布都默认关。设置里打开芯片后标题栏才出现「芯片」；情节方框嵌在其下。内核（四工具、短地图、进程内 .tdb）不变。

0.4.8 — 写入 + 注入卫生闸门（密钥、乱码、复读、JSON envelope、base64 残骸）。设置页 / 芯片标签跟随 DSH 语言。设置页可检查 npm 更新。一次性严导入同时发现 Claude Code CLAUDE.md 与 Codex AGENTS.md。若 session-start 和第一步赛跑，首轮短地图仍会补上。

0.4.7 — 存储升到 triviumdb@0.7.6（引擎侧 searchExact / searchBatch）。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。

排障

| 现象 | 处理 |
|---|---|
| 设置里没有「Trivium 记忆」 | 确认装的是 web profile，然后重启 dsh web，再打开一个工作区。只刷新浏览器不够。 |
| 标题栏没有「芯片」 | 在设置里打开「芯片（记忆白名单）」（拨一下就会保存）。切回对话页，标签应立刻出现，不用重启。 |
| 改了注入 / 抽取 / embedding / 芯片开关没生效 | 芯片 / 抽取 / 注入拨一下即保存。Embedding URL 仍要点「保存设置」。只有设置页本身没出现时才重启 dsh web。 |
| 会话层只有一个「后续」方框 | 正常（在会话层已打开时）。方框跟 DSH 压缩走，会话长不等于已经压过（默认约窗口 80% 才自动压）。要分段：对话里 /compact，或点「生成检查点」（只切图，不压窗口）。旧会话可点「更新检查点」补已经发生过的压缩 / 分叉。 |
| ctx_find 什么都没有 | 新会话默认只注入短地图，模型要自己调工具。也可以在芯片条「新增」或对模型说「记住：…」。闲聊和一次性改文件不会自动入库。 |
| 报 .tdb 被占用 / 打不开 | 只开一个 dsh web。不要同时跑两份链接了本插件的 Node 进程。 |
| embedding 填了但检索没变准 | 失败会退回关键词 + 图。看 ~/.dsh/trivium.json 里 URL 是否 OpenAI 兼容（含 /v1 那种）。改完重启。 |
| 卸载后记忆还在 | 先停 dsh web 再 dsh plugin remove。剩下的 .tdb 是从未用 0.4.10 打开过的工作区，到该文件夹删 .dsh/trivium.tdb。已提交的 trivium.jsonl 用 git checkout 找回。只在配置里 disabled 不会清文件。 |
| 检查更新失败 | 只请求 npm registry 拿最新版本号，不影响记忆；过一会儿再点即可。 |
| rc.8 之后旧对话打不开 | 那是 DSH 自己的会话库格式变了，不是 .tdb 坏了。图记忆仍可 ctx_find；对不上号的旧方框可当情节残留。 |

本地联调：仓库里 npm install 后 node scripts/link-dsh.mjs，再重启 dsh web。triviumdb 是原生模块，装不上时先看 Node 是否满足 package.json 的 engines（^22.19.0 || >=24）。

发布信息

- GitHub: https://github.com/QWQcool/dsh-trivium
- npm: dsh-trivium@0.4.18
- 测试宿主：@deepseek-ai/dsh@0.1.5-rc.1（兼 0.1.1-rc.2 / 0.1.0-rc.8）
- License: MIT（依赖 TriviumDB 为 Apache-2.0）

致谢

写入卫生闸门、npm 检查更新、跟随宿主语言的界面，以及 Claude Code / Codex 文件发现，部分借鉴自 dsh-auto-memory（Aik358）。产品仍是图内核（节点、边、四个工具、默认安静），不是日记 / 日历伴侣。