dsh-trivium 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/README.md +122 -79
  2. package/lib/client.js +1443 -2
  3. package/lib/episode.js +278 -0
  4. package/lib/extract.js +39 -7
  5. package/lib/index.js +127 -39
  6. package/lib/markdown.js +359 -0
  7. package/lib/pins.js +155 -0
  8. package/lib/schema.js +5 -0
  9. package/lib/server.js +113 -0
  10. package/lib/settings.js +26 -0
  11. package/lib/store.js +36 -8
  12. package/package.json +8 -3
package/README.md CHANGED
@@ -1,112 +1,155 @@
1
- # dsh-trivium
1
+ # dsh-trivium — DSH 进程内图记忆
2
2
 
3
- In-process **graph memory kernel** for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), backed by [TriviumDB](https://github.com/YoKONCy/TriviumDB).
3
+ DeepSeek Harness 的跨会话图记忆插件：按节点和边记，默认少注入，设置页可改可归档。会话标题栏多一个 **会话图**：compaction 收成方框，可从检查点 fork，可选记忆芯片钉进下一轮。每个工作区一个 `.dsh/trivium.tdb`，不另起服务。
4
4
 
5
- One `.tdb` file per workspace. No extra server. MIT license.
5
+ > **快速安装**：`dsh plugin --profile web add dsh-trivium` → 重启 **dsh web** → 打开工作区（设置里出现「Trivium 记忆」，对话旁出现「会话图」）。
6
6
 
7
- > 进程内图记忆：按节点和边记，按需读。钉死 `@deepseek-ai/dsh@0.1.0-rc.6`。
7
+ ---
8
8
 
9
- ## Status
9
+ ## 安装
10
10
 
11
- **v0.2.0** — P4 kernel + Settings correction: find with edges/`until`; edit/rename, merge, JSON export/import; recall **off** unless `autoRecall` or entity-name inject (mutually exclusive). Optional remote embedding (manual URL, default off). See [PLAN.md](./PLAN.md).
11
+ > 前提：已安装 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 并至少启动过一次 `dsh web`。当前在 `@deepseek-ai/dsh@0.1.0-rc.6` 上测试。
12
12
 
13
- ## Tools
13
+ ```sh
14
+ dsh plugin --profile web add dsh-trivium
15
+ ```
16
+
17
+ 重启 **dsh web** 后生效。记忆文件在当前工作区：
18
+
19
+ ```
20
+ <workspace>/.dsh/trivium.tdb
21
+ ```
22
+
23
+ 用 [Dsh_BatStart](https://github.com/QWQcool/Dsh_BatStart) 的，双击启动就会装上，不必再执行上面这条。
24
+
25
+ 本地跟源码联调：
26
+
27
+ ```sh
28
+ npm install
29
+ node scripts/link-dsh.mjs
30
+ ```
31
+
32
+ 然后重启 `dsh web`。
33
+
34
+ ## 更新
35
+
36
+ ```sh
37
+ dsh plugin --profile web add dsh-trivium
38
+ ```
39
+
40
+ 装完重启 **dsh web**。源码联调则在仓库里 `git pull` 后再跑一次 `node scripts/link-dsh.mjs`。
41
+
42
+ ## AI 时代安装
43
+
44
+ 把下面这句话复制给助手即可：
45
+
46
+ ```text
47
+ 请在 DeepSeek Harness 上执行：dsh plugin --profile web add dsh-trivium
48
+ 然后重启 dsh web。设置里会出现「Trivium 记忆」，会话标题栏「对话 / 轨迹」旁会出现「会话图」。
49
+ ```
50
+
51
+ ---
14
52
 
15
- | Tool | Role |
53
+ ## 做什么
54
+
55
+ - **跨会话** — 会话 A 记下「鉴权走 header X」，会话 B 调用 `ctx_find("鉴权")` 命中，并带上它连着谁（`about` / `decided` / `broke` / `fixed`）。
56
+ - **默认安静** — 新会话只注入一张短地图（≤400 token）。模型要用再调工具，不会每一步灌满。
57
+ - **会话图** — compaction 切一段就收成一个方框；点方框用 DSH 原生 fork 开分支；勾选的记忆芯片从当前这段的下一轮注入。
58
+ - **人能改错** — 设置 → Trivium 记忆：搜、看邻居、改名 / 正文、合并、归档或删除。
59
+ - **抽取偏严** — 闲聊、一次性改文件、密钥不入库。
60
+ - **可选 embedding** — 默认关。官方 DeepSeek 对话接口没有 embeddings；可填 OpenAI 兼容地址。
61
+
62
+ ### 四个工具
63
+
64
+ | 工具 | 说明 |
16
65
  |---|---|
17
- | `ctx_find` | Hybrid / keyword search + edge paths (L0 only) |
18
- | `ctx_read` | Full payload by node id |
19
- | `ctx_remember` | Explicit write (`entity` / `preference` / `decision` / `experience`) |
20
- | `ctx_link` | Directed labelled edge |
66
+ | `ctx_find` | 检索，返回摘要和图路径 |
67
+ | `ctx_read` | 按 id 读全文和入边 |
68
+ | `ctx_remember` | 手动写入 |
69
+ | `ctx_link` | 两点之间建有向边 |
21
70
 
22
- Default: **no per-step auto-recall**. Session start injects a short map (budget ~400 tokens). Settings can switch recall to **entity-name inject** (1-hop neighbors when the user names a known entity) or full `autoRecall`; the two are mutually exclusive and both default **off**.
71
+ 内核仍是这四个。会话图不加第五个工具。
23
72
 
24
- Optional **remote embedding** (OpenAI-compatible URL + model + key) is off by default. Failures fall back to keyword + graph. There is no local embedding model.
73
+ ---
25
74
 
26
- ## Compared with what (mechanisms, not a bake-off)
75
+ ## 会话图
27
76
 
28
- This is a **kernel**, not a memory workbench. We did **not** run LoCoMo, OpenViking L0/L1/L2 product tests, or a live OV plugin shoot-out. The table is what we chose to win or skip. The only live contrast we ran is **vanilla DSH / empty `.tdb`**: the same `ctx_find("鉴权")` / `ctx_find("AuthGateway")` has no durable preference.
77
+ 入口：当前会话标题栏 **对话 / 轨迹 / 会话图**。这是情节图，不是记忆编辑器；改错的节点仍走设置页。
29
78
 
30
- | | dsh-trivium | Stock DSH | JSON / FTS memory plugins | Wiki dual-link | OpenViking / PowerContext | Mnemon |
31
- |---|---|---|---|---|---|---|
32
- | Extra process | No (napi `.tdb` in-process) | — | Usually no | Often Python / indexer | Often a service + richer stack | Heavier local stack |
33
- | What is stored | Nodes + labelled edges (entity / preference / decision / experience) | Session only | Documents or snippets | Markdown + `[[links]]` | Layered memory schema | Rich items + UI |
34
- | How it enters the window | Short map ≤400 tokens; tools to drill; recall **off** (optional auto / entity-name inject) | Prompt / tools | Often dump or search | Follow links | Pre-step / layered load | Sidebar + recall |
35
- | Graph | Engine edges (`about` / `decided` / `broke` / `fixed`); find returns **path** | None | Rare | Scan `[[slug]]` | Depends on product | UI-first |
36
- | Human correction | Settings: search, neighbors, edit/rename, merge, archive vs delete, JSON export/import | — | Varies | Edit files | Product UI | Full workbench |
37
- | First-period non-goals | Graph canvas, fifth tool, default auto-recall, local embedding | — | Feature-list race | 9-tool Python vectors | LoCoMo / parse farm / Skill hub | UI completeness |
79
+ ### 方框
38
80
 
39
- **Why not a live OV comparison.** OV’s DSH plugin is the right *hook* shape (`inject`, pin rc.6, pending replay). Copying its product thickness (layers, skills, eval farm) is explicitly out of scope. Measuring “who wins LoCoMo” would optimize the wrong thing for a four-tool kernel.
81
+ - 没压过上下文：只有一个「后续」方框。
82
+ - 一次成功的 compaction 之后：左边历史检查点（摘要来自 DSH），右边仍是「后续」。
83
+ - 方框自己不压缩。质量来自 DSH 已经做的摘要替换；fork 时不会再总结一遍。
84
+ - 「改名」只改方框标题，不动 DSH 摘要。点方框可跳回对话里对应的检查点，或打开轨迹。
40
85
 
41
- ## What we actually checked
86
+ ### 分叉
42
87
 
43
- On `@deepseek-ai/dsh@0.1.0-rc.6`, plugin linked into the web profile (not copied into Harness):
88
+ 点方框上的分叉图标，会弹出「分叉为新会话」。这个名字会出现在左侧会话列表里（默认是源标题加 `(1)`）。
44
89
 
45
- - Session A writes / extracts; session B `ctx_find` hits with `about` / `decided` / `fixed` paths; `ctx_read` returns `incoming`.
46
- - Empty workspace: same queries, no durable preference (plugin still loaded).
47
- - Extract whitelist: chitchat, one-shot “edit this file”, secrets, and the word `鉴权` as an entity stay out.
48
- - Stale `until` hidden unless the query is about the deadline (`周五` / `下周`).
49
- - Settings: filter by entity, stale toggle, archive then find misses; edit name/text, merge same-type nodes, export/import JSON.
50
- - Optional remote embedding stays off until a URL is saved; no local model.
51
- - Failure isolation: a broken `.tdb` path does not kill the agent loop.
90
+ 确认后走宿主的 `session.fork`：子会话出现在侧边栏，前缀（含当时已经压过的摘要）由 DSH 拷过去。有检查点时从那个检查点切开；只有「后续」时就从你点的那个方框连出去。
52
91
 
53
- Offline: `npm run smoke-p1` / `smoke-p2` / `smoke-p4` / `smoke-p5`.
92
+ 对话页里用 DSH 自带 fork，切回会话图也能看到对应分支。侧边栏归档一个子会话后，图上的分叉方框会跟着消失；取消归档会再出现。
54
93
 
55
- ## Strengths
94
+ 画布：空白处拖动平移，滚轮缩放。
56
95
 
57
- - **Durable facts with edges**, not a chat transcript dump. `find("AuthGateway")` can return a neighbor whose text never repeats the name.
58
- - **Cheap by default.** Short map budget 400; no per-step recall; Trajectory shows `dsh-trivium` as plugin inject.
59
- - **One file, one process.** Install is a profile junction / `dsh plugin add`; memory is `<workspace>/.dsh/trivium.tdb`.
60
- - **Visible and reversible.** Settings can edit, merge, archive vs delete, and export/import JSON; find ignores archived nodes.
61
- - **Honest degradation.** Keyword + graph walk by default. Optional remote embedding; extract / TDB / embed errors log and continue.
96
+ ### 记忆芯片
62
97
 
63
- ## Limits (v0.2.0)
98
+ 会话图顶部可展开勾选。列出未归档的 preference / decision / entity（experience 不进芯片，避免太吵）。
64
99
 
65
- - **Not a workbench.** No graph canvas, no Mnemon sidebar, no cross-agent share, no PDF/Zotero RAG. Settings can edit, merge, and export/import.
66
- - **Recall is off by default.** If the model never calls `ctx_find`, the short map is all it gets unless you enable entity-name inject or `autoRecall` (mutually exclusive).
67
- - **Extract is conservative.** It will miss facts that do not match the whitelist; a real tool-fail→success experience only links when the fail/fix text or a nearby user turn names an entity.
68
- - **Engine gaps we paper over.** No `expandLabels` / `getIncomingEdges` in the Node binding, so the plugin scans edges itself. Same `.tdb` must not be opened by two Node processes (normal `dsh web` use is one process).
69
- - **Vectors are optional.** Remote OpenAI-compatible embedding can fill the 1536-d slot; local models are not shipped. Old rows stay zero until you backfill.
70
- - **Old dirty rows stay.** Settings can edit or archive them; we do not auto-wipe a workspace library.
100
+ | 操作 | 生效时机 |
101
+ |---|---|
102
+ | 勾上某条 | 当前这段里你再发的**下一条**带上它（L0，≤300 token） |
103
+ | 取消勾选 | 再下一轮不再带 |
104
+ | 已经发出去的轮次 | 不回写 |
71
105
 
72
- ## Install (when testing against local DSH)
106
+ 芯片按会话隔离。新开会话、fork 出的子会话默认都不勾；需要的话在分叉对话框旁打开「分叉时继承钉选」，或到子会话里重新勾。短地图仍在 session-start 自动带，不占芯片位。建议标记只是提示，不会自动勾上。
73
107
 
74
- This repo is **not** copied into `DeepSeek_Harness`. Link it into the web profile:
108
+ ---
75
109
 
76
- ```sh
77
- cd dsh-trivium
78
- npm install
79
- node scripts/link-dsh.mjs
80
- ```
110
+ ## 界面截图
81
111
 
82
- Restart `dsh web`, pick a workspace, then ask the agent to `ctx_remember` and `ctx_find`.
112
+ 以下都是本机 DSH Web（rc.6）里的实测画面。
83
113
 
84
- Manual equivalent:
114
+ ### 会话 — `ctx_find("鉴权")`
85
115
 
86
- ```sh
87
- dsh plugin --profile web add /absolute/path/to/dsh-trivium
88
- ```
116
+ ![ctx_find 鉴权](docs/screenshots/02-ctx-find.png)
89
117
 
90
- Memory file: `<workspace>/.dsh/trivium.tdb`.
118
+ 会话开头注入 `dsh-trivium` 短地图；模型调用 `ctx_find`，命中「本仓库鉴权走 header X」。
91
119
 
92
- ## Layout
120
+ ### 轨迹 — 上下文注入可见
93
121
 
94
- ```
95
- lib/index.js Cordis apply: tools, session-start map, extract hooks
96
- lib/store.js TriviumDB open / insert / search / archive / merge / export
97
- lib/schema.js Node types and edge labels
98
- lib/embed.js Optional remote OpenAI-compatible embeddings
99
- lib/settings.js ~/.dsh/trivium.json (recall mode, embed URL)
100
- lib/tools.js ctx_* tools
101
- lib/extract.js Rule + small-prompt distill, pending replay
102
- lib/client.js Settings page 「Trivium 记忆」
103
- scripts/link-dsh.mjs
104
- scripts/p2-cases.mjs
105
- scripts/smoke-p4.mjs
106
- scripts/smoke-p5.mjs
107
- PLAN.md
108
- ```
122
+ ![轨迹](docs/screenshots/03-trajectory.png)
123
+
124
+ ### 设置 — 注入策略
125
+
126
+ ![设置](docs/screenshots/04-settings.png)
127
+
128
+ ### 设置 — 记忆条目
129
+
130
+ ![条目列表](docs/screenshots/05-settings-list.png)
131
+
132
+ ### 会话图 — 对话 / 轨迹旁的第三标签
133
+
134
+ ![会话图](docs/screenshots/06-session-map.png)
135
+
136
+ 标题栏出现「会话图」。没压过的会话只有一个「后续」方框；顶部是记忆芯片（默认不勾）。compaction 之后左边出现历史方框，分叉从方框连到子会话。
137
+
138
+ ---
139
+
140
+ ## 限制
141
+
142
+ - 模型不调 `ctx_find`、也不勾芯片时，窗口里主要是开场短地图。
143
+ - 抽取会漏；脏数据要在设置里改或归档。
144
+ - 同一个 `.tdb` 不要两个 Node 进程同时打开（正常只开一个 `dsh web` 即可）。
145
+ - Markdown 导出是给人看的，不能再解析回去。WorkBuddy 导入是一次性，不是双向同步。
146
+ - 会话图只投影 compaction 与 fork，不会按消息条数自己切方框。
147
+ - 改插件设置后需要重启 `dsh web`。
148
+
149
+ ---
109
150
 
110
- ## License
151
+ ## 发布信息
111
152
 
112
- MIT. TriviumDB itself is Apache-2.0 and remains a dependency.
153
+ - GitHub: https://github.com/QWQcool/dsh-trivium
154
+ - npm: [`dsh-trivium`](https://www.npmjs.com/package/dsh-trivium)
155
+ - License: MIT（依赖 [TriviumDB](https://github.com/TriviumDB/triviumdb) 为 Apache-2.0）