dsh-trivium 0.2.0 → 0.3.0

package/README.md

@@ -1,112 +1,144 @@
 # dsh-trivium
 
-In-process **graph memory kernel** for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), backed by [TriviumDB](https://github.com/YoKONCy/TriviumDB).
+DeepSeek Harness 的**进程内图记忆内核**。按节点和边记，按需读。每个工作区一个 `.tdb` 文件，不另起服务。MIT。
 
-One `.tdb` file per workspace. No extra server. MIT license.
+不是 Mnemon / OpenViking 那种记忆工作台。四个工具，默认几乎不往窗口里灌。
 
-> 进程内图记忆：按节点和边记，按需读。钉死 `@deepseek-ai/dsh@0.1.0-rc.6`。
+> **快速安装**（已有 `dsh web`）：`dsh plugin --profile web add dsh-trivium` → 重启 **dsh web** → 打开工作区。设置页会出现「Trivium 记忆」。
 
-## Status
+钉死 **`@deepseek-ai/dsh@0.1.0-rc.6`**。不要把本仓库拷进 `DeepSeek_Harness`。
 
-**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).
+npm：[`dsh-trivium@0.3.0`](https://www.npmjs.com/package/dsh-trivium) · GitHub：[QWQcool/dsh-trivium](https://github.com/QWQcool/dsh-trivium) · topic `dsh-plugin`
 
-## Tools
+---
 
-| Tool | Role |
-|---|---|
-| `ctx_find` | Hybrid / keyword search + edge paths (L0 only) |
-| `ctx_read` | Full payload by node id |
-| `ctx_remember` | Explicit write (`entity` / `preference` / `decision` / `experience`) |
-| `ctx_link` | Directed labelled edge |
+## 安装
 
-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**.
+前提：本机已经能跑 `dsh web`，版本是 `0.1.0-rc.6`。
 
-Optional **remote embedding** (OpenAI-compatible URL + model + key) is off by default. Failures fall back to keyword + graph. There is no local embedding model.
+```sh
+dsh plugin --profile web add dsh-trivium
+```
 
-## Compared with what (mechanisms, not a bake-off)
+或从 GitHub：
 
-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.
+```sh
+dsh plugin --profile web add github:QWQcool/dsh-trivium
+```
 
-| | dsh-trivium | Stock DSH | JSON / FTS memory plugins | Wiki dual-link | OpenViking / PowerContext | Mnemon |
-|---|---|---|---|---|---|---|
-| Extra process | No (napi `.tdb` in-process) | — | Usually no | Often Python / indexer | Often a service + richer stack | Heavier local stack |
-| What is stored | Nodes + labelled edges (entity / preference / decision / experience) | Session only | Documents or snippets | Markdown + `[[links]]` | Layered memory schema | Rich items + UI |
-| 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 |
-| Graph | Engine edges (`about` / `decided` / `broke` / `fixed`); find returns **path** | None | Rare | Scan `[[slug]]` | Depends on product | UI-first |
-| Human correction | Settings: search, neighbors, edit/rename, merge, archive vs delete, JSON export/import | — | Varies | Edit files | Product UI | Full workbench |
-| 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 |
+然后**重启 dsh web**，选一个工作区。记忆文件在：
 
-**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.
+```
+<workspace>/.dsh/trivium.tdb
+```
 
-## What we actually checked
+本地开发（本仓库）：
 
-On `@deepseek-ai/dsh@0.1.0-rc.6`, plugin linked into the web profile (not copied into Harness):
+```sh
+cd dsh-trivium
+npm install
+node scripts/link-dsh.mjs
+```
 
-- Session A writes / extracts; session B `ctx_find` hits with `about` / `decided` / `fixed` paths; `ctx_read` returns `incoming`.
-- Empty workspace: same queries, no durable preference (plugin still loaded).
-- Extract whitelist: chitchat, one-shot “edit this file”, secrets, and the word `鉴权` as an entity stay out.
-- Stale `until` hidden unless the query is about the deadline (`周五` / `下周`).
-- Settings: filter by entity, stale toggle, archive then find misses; edit name/text, merge same-type nodes, export/import JSON.
-- Optional remote embedding stays off until a URL is saved; no local model.
-- Failure isolation: a broken `.tdb` path does not kill the agent loop.
+再重启 `dsh web`。
 
-Offline: `npm run smoke-p1` / `smoke-p2` / `smoke-p4` / `smoke-p5`.
+### 丢给 AI 安装
 
-## Strengths
+把下面整段交给你的助手即可：
 
-- **Durable facts with edges**, not a chat transcript dump. `find("AuthGateway")` can return a neighbor whose text never repeats the name.
-- **Cheap by default.** Short map budget 400; no per-step recall; Trajectory shows `dsh-trivium` as plugin inject.
-- **One file, one process.** Install is a profile junction / `dsh plugin add`; memory is `<workspace>/.dsh/trivium.tdb`.
-- **Visible and reversible.** Settings can edit, merge, archive vs delete, and export/import JSON; find ignores archived nodes.
-- **Honest degradation.** Keyword + graph walk by default. Optional remote embedding; extract / TDB / embed errors log and continue.
+```text
+请在 DeepSeek Harness 上安装 dsh-trivium（进程内图记忆插件）。
+要求宿主是 @deepseek-ai/dsh@0.1.0-rc.6，不要把源码拷进 DeepSeek_Harness。
+执行：dsh plugin --profile web add dsh-trivium
+然后重启 dsh web。记忆落在 <workspace>/.dsh/trivium.tdb。
+```
 
-## Limits (v0.2.0)
+---
 
-- **Not a workbench.** No graph canvas, no Mnemon sidebar, no cross-agent share, no PDF/Zotero RAG. Settings can edit, merge, and export/import.
-- **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).
-- **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.
-- **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).
-- **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.
-- **Old dirty rows stay.** Settings can edit or archive them; we do not auto-wipe a workspace library.
+## 它实际记住什么
 
-## Install (when testing against local DSH)
+原装 DSH 没有跨会话图记忆。装上之后：
 
-This repo is **not** copied into `DeepSeek_Harness`. Link it into the web profile:
+**会话 A** 说「记住，鉴权走 header X」→ 写入 preference，并尽量挂到实体（例如 AuthGateway）上。  
+**会话 B** 调用 `ctx_find("鉴权")` → 命中，返回 L0 摘要，并带实体 path（`about` / `decided` / `broke` / `fixed`）。
 
-```sh
-cd dsh-trivium
-npm install
-node scripts/link-dsh.mjs
-```
+`find("AuthGateway")` 也可以打到邻居，即使邻居正文里根本没出现这个名字。
 
-Restart `dsh web`, pick a workspace, then ask the agent to `ctx_remember` and `ctx_find`.
+默认**不**每一步自动召回（`autoRecall` 关）：启动只注入一张短地图（≤400 token），模型要用 `ctx_find` / `ctx_read` 自己下钻。设置里可改成「实体名折中」（话里出现已有实体名才灌 1 跳邻居）或打开 `autoRecall`；三选一，互斥，默认关。
 
-Manual equivalent:
+抽取偏严：闲聊、一次性「改这个文件」、密钥不入库。每轮写入正文合计 ≤3000 字、最多 24 条。
 
-```sh
-dsh plugin --profile web add /absolute/path/to/dsh-trivium
-```
+---
+
+## 设置里能做什么
 
-Memory file: `<workspace>/.dsh/trivium.tdb`.
+设置 → **Trivium 记忆**：
 
-## Layout
+- 搜、看邻居、改名 / 正文、合并、归档 vs 删除
+- 导出 / 导入 **JSON**（可回写图）
+- 导出 **Markdown**（只读投影，给人、给 git；带边，例如 `- 鉴权走 header X —about→ AuthGateway`）。改完不要把这篇散文再解析回来，回写走 JSON 或本页编辑
+- **一次性**导入已有的 `~/.workbuddy/MEMORY.md` 或工作区 `.workbuddy/memory/MEMORY.md`（偏严宁漏，不持续同步）
+- 注入策略、抽取开关、可选远程 embedding（OpenAI 兼容 URL，默认关）
+
+`until` 是决策上的截止日期。过期决策默认不进 find，除非查询本身在问这个期限（如「周五」「下周」）。
+
+---
+
+## 四个工具
+
+| 工具 | 干什么 |
+|---|---|
+| `ctx_find` | 检索。返回 L0 摘要 + 边路径。不要把结果原文贴进后续思考。 |
+| `ctx_read` | 按 find 给的 id 读全文和入边。 |
+| `ctx_remember` | 显式写入（entity / preference / decision / experience）。 |
+| `ctx_link` | 两节点之间建有向带标签的边。 |
+
+没有第五个工具。没有图谱画布。没有默认每步自动召回。
+
+---
+
+## 可选 embedding
+
+默认关。没有本地 embedding 模型。官方 DeepSeek chat API **没有** embeddings。
+
+若要语义检索：在设置里打开开关，手填 OpenAI 兼容的 embedding URL / 模型 / key。失败则退回关键词 + 图遍历，Agent 继续跑。
+
+---
+
+## 限制（v0.3.0）
+
+- 这是内核，不是工作台：无 Mnemon 侧栏、无跨 Agent 共享、无 PDF/Zotero RAG。
+- 默认 `autoRecall` 关。模型若不调 `ctx_find`，窗口里就只有短地图。
+- 抽取会漏：白名单没命中的事实不会进库；tool 失败→成功的经验，只在失败/修复文本或邻近用户话里点名了实体时才连边。
+- 同一 `.tdb` 不要被两个 Node 进程同时打开（普通 `dsh web` 是单进程）。
+- 旧的脏行不会自动清；人在 Settings 里改或归档。
+- Markdown 导出不能当回写格式。WorkBuddy 导入不是双向同步。
+
+第一期明确不做：对标 OpenViking 的 LoCoMo / L0–L2 评测、默认每步自动召回、本地 embedding、第五工具、图谱画布。
+
+---
+
+## 机制对照（不是 bake-off）
+
+没跑过 live OV 对打，也没跑 LoCoMo。唯一做过的 live 对照是：**同一插件装上、空 `.tdb` 上同样的 `ctx_find("鉴权")` 没有跨会话 preference。**
+
+相对原装 DSH：我们有跨会话节点和边。相对「再起一个记忆服务」：我们没有。相对把 MEMORY.md 整篇灌进 system prompt：我们默认只灌短地图，动态记忆走 `agent.inject()` / 工具，不写 system prompt（也避免 `persona.complete: true` 把注入丢掉）。
+
+---
+
+## 结构
 
 ```
-lib/index.js     Cordis apply: tools, session-start map, extract hooks
-lib/store.js     TriviumDB open / insert / search / archive / merge / export
-lib/schema.js    Node types and edge labels
-lib/embed.js     Optional remote OpenAI-compatible embeddings
-lib/settings.js  ~/.dsh/trivium.json (recall mode, embed URL)
-lib/tools.js     ctx_* tools
-lib/extract.js   Rule + small-prompt distill, pending replay
-lib/client.js    Settings page 「Trivium 记忆」
-scripts/link-dsh.mjs
-scripts/p2-cases.mjs
-scripts/smoke-p4.mjs
-scripts/smoke-p5.mjs
-PLAN.md
+lib/index.js      工具、短地图、抽取钩子
+lib/store.js      TriviumDB
+lib/markdown.js   MEMORY.md 只读导出、WorkBuddy 一次性导入
+lib/extract.js    规则 + 小 prompt；每批限写
+lib/client.js     Settings「Trivium 记忆」
+lib/server.js     本机 API
 ```
 
+离线：`npm run smoke-p1` … `smoke-p6`。
+
 ## License
 
-MIT. TriviumDB itself is Apache-2.0 and remains a dependency.
+MIT。TriviumDB 是 Apache-2.0，仍是依赖。

package/lib/client.js

@@ -26,7 +26,15 @@ window.__ModuleLoader__.load({
       recallAnchor: "实体名折中",
       recallAnchorHint: "用户文本命中已有 entity 的 name/aliases 时，注入该实体 1 跳 about/decided/broke/fixed 邻居（≤300 token）。",
       extract: "compaction/end 抽取",
-      extractHint: "规则 + 一次小 prompt；失败只记日志。turn 结束后约 12 秒空闲会再抽一次，下次 session-start 也会重放 pending。",
+      extractHint: "规则 + 一次小 prompt；失败只记日志。turn 结束后约 12 秒空闲会再抽一次，下次 session-start 也会重放 pending。每轮写入正文合计 ≤3000 字、最多 24 条。",
+      markdown: "Markdown 投影",
+      markdownHint: "只读导出，带边（- 鉴权走 header X —about→ AuthGateway）。给编辑器和 git 看。改完回写用 JSON 导入或本页编辑，不解析自由散文。",
+      exportMd: "导出 Markdown",
+      workbuddy: "WorkBuddy 一次性导入",
+      workbuddyHint: "只读 ~/.workbuddy/MEMORY.md 与工作区 .workbuddy/memory/MEMORY.md。偏严宁漏：闲聊、一次性改文件、密钥、无规则线索的段落跳过。不持续同步。每批同样 ≤3000 字 / 24 条。",
+      workbuddyImport: "导入找到的 MEMORY.md",
+      workbuddyNone: "当前没有找到这些文件。",
+      workbuddyFound: "找到",
       embed: "远程 embedding（OpenAI 兼容，默认关）",
       embedHint: "失败退回关键词 + 图检索。需单独的 embeddings endpoint；官方 DeepSeek chat API 不含 embedding。",
       embedReady: "已就绪",
@@ -143,6 +151,8 @@ window.__ModuleLoader__.load({
       const [edits, setEdits] = react.useState({});
       const [mergeFrom, setMergeFrom] = react.useState({});
       const fileRef = react.useRef(null);
+      const [buddyFiles, setBuddyFiles] = react.useState([]);
+      const [buddyNote, setBuddyNote] = react.useState("");
 
       const load = react.useCallback(async () => {
         setError("");
@@ -163,6 +173,8 @@ window.__ModuleLoader__.load({
           const qs = params.toString();
           const list = await api("/api/dsh-trivium/nodes" + (qs ? "?" + qs : ""));
           setNodes(list.nodes || []);
+          const wb = await api("/api/dsh-trivium/workbuddy");
+          setBuddyFiles(wb.files || []);
         } catch (err) {
           setError(String(err.message || err));
         }
@@ -277,6 +289,56 @@ window.__ModuleLoader__.load({
         }
       };
 
+      const exportMd = async () => {
+        try {
+          const resp = await fetch("/api/dsh-trivium/export.md");
+          const text = await resp.text();
+          if (!resp.ok) {
+            let message = "HTTP " + resp.status;
+            try {
+              message = JSON.parse(text).message || message;
+            } catch {
+              // keep
+            }
+            throw new Error(message);
+          }
+          const blob = new Blob([text], { type: "text/markdown;charset=utf-8" });
+          const a = document.createElement("a");
+          a.href = URL.createObjectURL(blob);
+          a.download = "MEMORY.md";
+          a.click();
+          URL.revokeObjectURL(a.href);
+        } catch (err) {
+          setError(String(err.message || err));
+        }
+      };
+
+      const importBuddy = async () => {
+        setBusy(true);
+        setBuddyNote("");
+        try {
+          const r = await api("/api/dsh-trivium/import-workbuddy", {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: "{}",
+          });
+          setSaved(true);
+          setBuddyNote(
+            "导入 " +
+              (r.created || 0) +
+              " 新建 / " +
+              (r.merged || 0) +
+              " 合并，跳过 " +
+              (r.skipped || 0),
+          );
+          await load();
+        } catch (err) {
+          setError(String(err.message || err));
+        } finally {
+          setBusy(false);
+        }
+      };
+
       const importJson = async (file) => {
         if (!file) return;
         setBusy(true);
@@ -358,6 +420,7 @@ window.__ModuleLoader__.load({
                   }),
                   jsx(Button, { variant: "outline", size: "sm", onClick: load, children: L.refresh }),
                   jsx(Button, { variant: "outline", size: "sm", onClick: exportJson, children: L.exportJson }),
+                  jsx(Button, { variant: "outline", size: "sm", onClick: exportMd, children: L.exportMd }),
                   jsx(Button, {
                     variant: "outline",
                     size: "sm",
@@ -425,6 +488,37 @@ window.__ModuleLoader__.load({
               jsx("div", { style: ui.hint, children: L.extractHint }),
             ],
           }),
+          jsxs("div", {
+            style: ui.card,
+            children: [
+              jsx("div", { style: ui.cardTitle, children: L.markdown }),
+              jsx("div", { style: ui.hint, children: L.markdownHint }),
+              jsx("div", { style: ui.cardTitle, children: L.workbuddy }),
+              jsx("div", { style: ui.hint, children: L.workbuddyHint }),
+              jsx("div", {
+                style: { ...ui.hint, wordBreak: "break-all" },
+                children: (buddyFiles || []).some((f) => f.exists)
+                  ? L.workbuddyFound +
+                    "  " +
+                    buddyFiles
+                      .filter((f) => f.exists)
+                      .map((f) => f.path)
+                      .join(" · ")
+                  : L.workbuddyNone,
+              }),
+              buddyNote ? jsx("div", { style: ui.saved, children: buddyNote }) : null,
+              jsx("div", {
+                style: { display: "flex", flexWrap: "wrap", gap: 8 },
+                children: jsx(Button, {
+                  variant: "outline",
+                  size: "sm",
+                  disabled: busy || !(buddyFiles || []).some((f) => f.exists),
+                  onClick: importBuddy,
+                  children: L.workbuddyImport,
+                }),
+              }),
+            ],
+          }),
           jsxs("div", {
             style: ui.card,
             children: [

package/lib/extract.js

@@ -18,6 +18,11 @@ export const ONESHOT_CUES =
 export const CHITCHAT_CUES =
   /^(哈哈+|呵呵+|嗯+|哦+|好的|谢谢|天气|吃了吗|在吗)[\s!！.。?？]*$/;
 
+/** WorkBuddy-style per-batch write cap. Not a file-size limit. */
+export const MAX_WRITE_CHARS = 3000;
+export const MAX_LINE_CHARS = 240;
+export const MAX_WRITE_ITEMS = 24;
+
 const NAME_RE =
   /`([^`]{2,64})`|\b([A-Z][a-z]+[A-Z][A-Za-z0-9]*)\b|\b([A-Z][A-Za-z0-9]*(?:[_-][A-Z][A-Za-z0-9]*)+)\b|\b([a-z][a-z0-9]*(?:-[a-z][a-z0-9]*)+)\b|\b([A-Z]{3,}[A-Z0-9_-]{0,})\b/g;
 
@@ -170,6 +175,10 @@ function linkNameOf(span, turnText, uniqueTurn, { inSpanOnly = false } = {}) {
   );
 }
 
+export function firstEntityName(text) {
+  return collectNames(text, 1)[0]?.name;
+}
+
 function collectNames(text, min = 2) {
   const counts = new Map();
   const s = String(text || "");
@@ -298,10 +307,12 @@ export function ruleCandidates(turns) {
   return out;
 }
 
-export function filterCandidates(candidates) {
+export function filterCandidates(candidates, { importFile = false } = {}) {
   const seen = new Set();
   const out = [];
-  const caps = { entity: 8, preference: 8, decision: 6, experience: 4 };
+  const caps = importFile
+    ? { entity: 24, preference: 24, decision: 12, experience: 8 }
+    : { entity: 8, preference: 8, decision: 6, experience: 4 };
   const used = { entity: 0, preference: 0, decision: 0, experience: 0 };
   for (const raw of candidates || []) {
     if (!raw || !WRITE_TYPES.has(raw.type)) continue;
@@ -315,7 +326,7 @@ export function filterCandidates(candidates) {
       const blob = `${raw.text || ""} ${raw.quote || ""}`;
       if (CHITCHAT_CUES.test(String(raw.text || "").trim())) continue;
       if (ONESHOT_CUES.test(blob) && !PREFERENCE_CUES.test(blob)) continue;
-      if (!PREFERENCE_CUES.test(blob)) continue;
+      if (!importFile && !PREFERENCE_CUES.test(blob)) continue;
     }
     if ((used[raw.type] || 0) >= (caps[raw.type] || 4)) continue;
     const key = `${raw.type}|${(raw.name || "").toLowerCase()}|${text.toLowerCase()}`;
@@ -325,7 +336,7 @@ export function filterCandidates(candidates) {
     out.push({
       type: raw.type,
       name: raw.name ? String(raw.name).slice(0, 80) : undefined,
-      text: clip(text, 400),
+      text: clip(text, MAX_LINE_CHARS),
       linkName: raw.linkName ? String(raw.linkName).slice(0, 80) : undefined,
       linkLabel: raw.linkLabel || undefined,
       fail: raw.fail ? clip(raw.fail, 200) : undefined,
@@ -377,8 +388,29 @@ function resolveEntityId(db, name) {
   return findMergeTarget(db, { type: "entity", name, text: name });
 }
 
-export function applyCandidates(db, candidates, { sessionId } = {}) {
-  const list = filterCandidates(candidates);
+/** Drop the tail once the WorkBuddy-style char/item budget is spent. */
+export function capWriteBatch(candidates, { maxChars = MAX_WRITE_CHARS, maxItems = MAX_WRITE_ITEMS } = {}) {
+  const kept = [];
+  let used = 0;
+  for (const cand of candidates || []) {
+    if (kept.length >= maxItems) break;
+    const n = String(cand.text || cand.name || "").length;
+    if (used + n > maxChars && kept.length) break;
+    if (n > maxChars && !kept.length) {
+      kept.push({ ...cand, text: clip(cand.text || cand.name || "", MAX_LINE_CHARS) });
+      used += Math.min(n, MAX_LINE_CHARS);
+      break;
+    }
+    kept.push(cand);
+    used += n;
+  }
+  return { kept, used, dropped: Math.max(0, (candidates || []).length - kept.length) };
+}
+
+export function applyCandidates(db, candidates, { sessionId, via } = {}) {
+  const { kept: list } = capWriteBatch(
+    filterCandidates(candidates, { importFile: via === "workbuddy-import" }),
+  );
   const ordered = [
     ...list.filter((c) => c.type === "entity"),
     ...list.filter((c) => c.type !== "entity"),
@@ -398,7 +430,7 @@ export function applyCandidates(db, candidates, { sessionId } = {}) {
       source: {
         sessionId: sessionId ? String(sessionId) : "",
         quote: cand.quote,
-        via: "extract",
+        via: via || cand.via || "extract",
       },
     };
     const untilAt = cand.until ? resolveUntilAt(cand.until) : undefined;

package/lib/markdown.js

@@ -0,0 +1,359 @@
+/**
+ * Read-only Markdown projection + one-shot WorkBuddy MEMORY.md import.
+ * The Markdown file is not a write-back format.
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { BUSINESS_EDGES, clip, looksSecret, nowIso } from "./schema.js";
+import {
+  CHITCHAT_CUES,
+  DECISION_CUES,
+  MAX_LINE_CHARS,
+  MAX_WRITE_CHARS,
+  MAX_WRITE_ITEMS,
+  ONESHOT_CUES,
+  PREFERENCE_CUES,
+  applyCandidates,
+  firstEntityName,
+} from "./extract.js";
+import { parseUntilFromText } from "./until.js";
+import { listOutgoingBusiness } from "./store.js";
+
+export const EXPORT_MARKER = "dsh-trivium-export";
+
+const WRITE_TYPES = ["preference", "decision", "entity", "experience"];
+
+const HEADING_STOP = new Set([
+  "memory",
+  "memories",
+  "notes",
+  "note",
+  "user",
+  "soul",
+  "identity",
+  "about",
+  "overview",
+  "todo",
+  "log",
+  "logs",
+  "rules",
+  "记忆",
+  "笔记",
+  "用户",
+  "关于",
+  "日志",
+]);
+
+/** Imperative / contract language — used only for curated-file import, not live extract. */
+const RULE_CUES =
+  /必须|务必|禁止|永远不要|始终|prefer|\balways\b|\bnever\b|\bmust\b|\bdo not\b|\bdon't\b|mandatory|用.{1,24}不用|\buse\b.{1,24}\bnot\b/i;
+
+const DATE_HEADING = /^\d{4}-\d{2}-\d{2}\b/;
+const KV_LINE =
+  /^(`[^`]{2,64}`|[A-Z][A-Za-z0-9._-]{1,63}|[a-z][a-z0-9]+(?:-[a-z0-9]+)+)\s*[:：]\s+(\S[\s\S]*)$/;
+
+export function isOurMarkdownExport(text) {
+  return String(text || "").slice(0, 800).includes(EXPORT_MARKER);
+}
+
+function targetName(db, edge) {
+  const payload = db.get(edge.to)?.payload || {};
+  if (payload.type === "entity") return String(payload.name || payload.text || "").trim();
+  return String(payload.name || payload.text || edge.l0 || "").replace(/\s+/g, " ").trim();
+}
+
+function lineOf(db, payload, edges) {
+  const type = payload.type;
+  let body = String(payload.text || payload.name || "").replace(/\s+/g, " ").trim();
+  if (type === "entity") body = String(payload.name || payload.text || "").trim();
+  if (type === "decision" && payload.until && !/\buntil\b|周五|下周/i.test(body)) {
+    body = `${body} until ${payload.until}`;
+  }
+  body = clip(body, MAX_LINE_CHARS);
+  const bits = [];
+  for (const e of edges || []) {
+    if (!BUSINESS_EDGES.includes(e.label)) continue;
+    const short = clip(targetName(db, e), 48);
+    if (!short) continue;
+    bits.push(`—${e.label}→ ${short}`);
+  }
+  const suffix = bits.length ? ` ${bits.join(" ")}` : "";
+  return `- ${body}${suffix}`;
+}
+
+export function exportMarkdown(db, { cwd = "" } = {}) {
+  const buckets = {
+    preference: [],
+    decision: [],
+    entity: [],
+    experience: [],
+  };
+  for (const id of db.allNodeIds?.() || []) {
+    const node = db.get(id);
+    if (!node) continue;
+    const payload = node.payload || {};
+    if (!WRITE_TYPES.includes(payload.type)) continue;
+    if (payload.status === "archived") continue;
+    const edges = listOutgoingBusiness(db, id);
+    const line = lineOf(db, payload, edges);
+    const extra = [];
+    if (payload.type === "entity" && Array.isArray(payload.aliases) && payload.aliases.length) {
+      extra.push(`  aliases: ${payload.aliases.slice(0, 8).join(", ")}`);
+    }
+    if (payload.type === "experience") {
+      if (payload.fail) extra.push(`  fail: ${clip(payload.fail, 160)}`);
+      if (payload.fix) extra.push(`  fix: ${clip(payload.fix, 160)}`);
+    }
+    if (payload.type === "decision" && payload.untilAt) {
+      extra.push(`  untilAt: ${payload.untilAt}`);
+    }
+    buckets[payload.type].push({ updatedAt: payload.updatedAt || "", line, extra });
+  }
+  for (const type of WRITE_TYPES) {
+    buckets[type].sort((a, b) => String(b.updatedAt).localeCompare(String(a.updatedAt)));
+  }
+
+  const lines = [
+    `<!-- ${EXPORT_MARKER} v1 -->`,
+    "# dsh-trivium MEMORY.md",
+    "",
+    "Read-only projection of the graph. Do not edit this file to write back — use Settings or JSON import.",
+    `Generated ${nowIso()}${cwd ? ` from \`${cwd}\`` : ""}.`,
+    `Each line clipped to ${MAX_LINE_CHARS} chars (WorkBuddy-style write discipline).`,
+    "",
+  ];
+  for (const type of WRITE_TYPES) {
+    const rows = buckets[type];
+    if (!rows.length) continue;
+    lines.push(`## ${type}`, "");
+    for (const row of rows) {
+      lines.push(row.line);
+      lines.push(...row.extra);
+    }
+    lines.push("");
+  }
+  if (lines[lines.length - 1] === "") lines.pop();
+  return `${lines.join("\n")}\n`;
+}
+
+function headingEntity(title) {
+  const t = String(title || "")
+    .replace(/^#+\s*/, "")
+    .trim();
+  if (!t || DATE_HEADING.test(t)) return { skipSection: DATE_HEADING.test(t), name: undefined };
+  const key = t.toLowerCase().replace(/[:：].*$/, "").trim();
+  if (HEADING_STOP.has(key)) return { skipSection: false, name: undefined };
+  const name = firstEntityName(t);
+  if (!name) return { skipSection: false, name: undefined };
+  if (t.length > 64) return { skipSection: false, name: undefined };
+  return { skipSection: false, name };
+}
+
+function kvParts(text) {
+  const m = String(text || "").match(KV_LINE);
+  if (!m) return null;
+  const name = String(m[1]).replace(/`/g, "").trim();
+  const rest = String(m[2] || "").trim();
+  if (!name || !rest) return null;
+  if (HEADING_STOP.has(name.toLowerCase())) return null;
+  const ident =
+    firstEntityName(name) === name ||
+    /^[A-Z][A-Za-z0-9]*[A-Z][A-Za-z0-9._-]*$/.test(name) ||
+    /^[A-Z]{2,12}$/.test(name) ||
+    /^[a-z][a-z0-9]+(?:-[a-z0-9]+)+$/.test(name);
+  if (!ident) return null;
+  return { name, rest };
+}
+
+function classifyBullet(text, sectionEntity) {
+  const body = String(text || "").replace(/\s+/g, " ").trim();
+  if (!body) return { skip: "empty" };
+  if (body.length < 8) return { skip: "too-short" };
+  if (body.length > 800) return { skip: "too-long" };
+  if (looksSecret(body)) return { skip: "secret" };
+  if (CHITCHAT_CUES.test(body)) return { skip: "chitchat" };
+  if (ONESHOT_CUES.test(body)) return { skip: "oneshot" };
+  if (/^\d{1,2}:\d{2}\b/.test(body) || /^#{1,6}\s/.test(body)) return { skip: "log-line" };
+
+  const kv = kvParts(body);
+  const name = kv?.name || firstEntityName(body) || sectionEntity;
+  const fact = kv ? `${kv.name}: ${clip(kv.rest, MAX_LINE_CHARS - kv.name.length - 2)}` : clip(body, MAX_LINE_CHARS);
+
+  if (DECISION_CUES.test(body)) {
+    return {
+      skip: null,
+      candidates: [
+        kv ? { type: "entity", name: kv.name, text: kv.name, via: "workbuddy-import" } : null,
+        {
+          type: "decision",
+          name,
+          text: fact,
+          until: parseUntilFromText(body),
+          linkName: name,
+          linkLabel: "decided",
+          quote: clip(body, 120),
+          via: "workbuddy-import",
+        },
+      ].filter(Boolean),
+    };
+  }
+
+  const ruleLike = PREFERENCE_CUES.test(body) || RULE_CUES.test(body) || Boolean(kv);
+  if (ruleLike) {
+    const out = [];
+    if (kv) out.push({ type: "entity", name: kv.name, text: kv.name, via: "workbuddy-import" });
+    else if (sectionEntity && name === sectionEntity) {
+      out.push({ type: "entity", name: sectionEntity, text: sectionEntity, via: "workbuddy-import" });
+    }
+    out.push({
+      type: "preference",
+      name,
+      text: fact,
+      linkName: name,
+      linkLabel: "about",
+      quote: clip(body, 120),
+      via: "workbuddy-import",
+    });
+    return { skip: null, candidates: out };
+  }
+
+  return { skip: "no-cue" };
+}
+
+export function parseWorkbuddyMarkdown(text, { sourcePath = "" } = {}) {
+  const raw = String(text || "");
+  if (!raw.trim()) {
+    return { ok: false, message: "空文件", candidates: [], skipped: 0, sourcePath };
+  }
+  if (isOurMarkdownExport(raw)) {
+    return {
+      ok: false,
+      message: "这是本插件导出的 MEMORY.md，不能当 WorkBuddy 文件回写。请用 JSON 导入或 Settings。",
+      candidates: [],
+      skipped: 0,
+      sourcePath,
+    };
+  }
+
+  const candidates = [];
+  let skipped = 0;
+  let sectionEntity;
+  let skipSection = false;
+  let inFence = false;
+
+  for (const rawLine of raw.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (/^```/.test(line)) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence) continue;
+    if (!line) continue;
+    if (/^#{1,6}\s+/.test(line)) {
+      const heading = headingEntity(line);
+      skipSection = heading.skipSection;
+      sectionEntity = heading.skipSection ? undefined : heading.name;
+      continue;
+    }
+    if (skipSection) {
+      skipped += 1;
+      continue;
+    }
+    const bullet = line.match(/^[-*+]\s+(?:\[[ xX]\]\s+)?(.+)$/);
+    if (!bullet) {
+      skipped += 1;
+      continue;
+    }
+    const result = classifyBullet(bullet[1], sectionEntity);
+    if (result.skip) {
+      skipped += 1;
+      continue;
+    }
+    candidates.push(...result.candidates);
+  }
+
+  return { ok: true, candidates, skipped, sourcePath };
+}
+
+export function discoverWorkbuddyFiles(cwd = "") {
+  const home = homedir();
+  const rows = [
+    { id: "user", path: join(home, ".workbuddy", "MEMORY.md") },
+    { id: "workspace", path: cwd ? join(cwd, ".workbuddy", "memory", "MEMORY.md") : "" },
+    { id: "workspaceRoot", path: cwd ? join(cwd, ".workbuddy", "MEMORY.md") : "" },
+  ];
+  return rows
+    .filter((row) => row.path)
+    .map((row) => {
+      const exists = existsSync(row.path);
+      let bytes = 0;
+      if (exists) {
+        try {
+          bytes = statSync(row.path).size;
+        } catch {
+          bytes = 0;
+        }
+      }
+      return { ...row, exists, bytes };
+    });
+}
+
+function readIfExists(path) {
+  try {
+    return readFileSync(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * One-shot import of discovered WorkBuddy MEMORY.md files. No watch, no reverse sync.
+ */
+export function importWorkbuddy(db, { cwd = "", ids } = {}) {
+  const found = discoverWorkbuddyFiles(cwd);
+  const want = Array.isArray(ids) && ids.length ? new Set(ids) : null;
+  const files = found.filter((f) => f.exists && (!want || want.has(f.id)));
+  if (!files.length) {
+    return {
+      ok: false,
+      message: "没有找到 ~/.workbuddy/MEMORY.md 或工作区 .workbuddy/memory/MEMORY.md",
+      created: 0,
+      merged: 0,
+      skipped: 0,
+      files: found,
+    };
+  }
+
+  const candidates = [];
+  let skipped = 0;
+  const used = [];
+  for (const file of files) {
+    const text = readIfExists(file.path);
+    if (text == null) continue;
+    const parsed = parseWorkbuddyMarkdown(text, { sourcePath: file.path });
+    if (!parsed.ok) {
+      return { ...parsed, created: 0, merged: 0, files: found };
+    }
+    skipped += parsed.skipped;
+    candidates.push(...parsed.candidates);
+    used.push({ id: file.id, path: file.path, bytes: file.bytes, parsed: parsed.candidates.length });
+  }
+
+  const applied = applyCandidates(db, candidates, { via: "workbuddy-import" });
+  const created = applied.filter((a) => a.action === "insert").length;
+  const merged = applied.filter((a) => a.action === "merge").length;
+  const dropped = Math.max(0, candidates.length - applied.length);
+  return {
+    ok: true,
+    created,
+    merged,
+    linked: applied.filter((a) => a.type !== "entity").length,
+    skipped: skipped + dropped,
+    applied: applied.length,
+    maxWriteChars: MAX_WRITE_CHARS,
+    maxWriteItems: MAX_WRITE_ITEMS,
+    files: found,
+    used,
+  };
+}

package/lib/server.js

@@ -16,6 +16,7 @@ import {
 } from "./store.js";
 import { embeddingPublicStatus } from "./embed.js";
 import { recallModeOf, writeUiSettings } from "./settings.js";
+import { discoverWorkbuddyFiles, exportMarkdown, importWorkbuddy } from "./markdown.js";
 
 export { readUiSettings, writeUiSettings } from "./settings.js";
 
@@ -24,6 +25,16 @@ function isLoopback(req) {
   return ra === "127.0.0.1" || ra === "::1" || ra === "::ffff:127.0.0.1";
 }
 
+function sendText(res, status, body, contentType) {
+  const data = Buffer.from(String(body || ""), "utf8");
+  res.writeHead(status, {
+    "content-type": contentType || "text/plain; charset=utf-8",
+    "cache-control": "no-store",
+    "content-length": String(data.length),
+  });
+  res.end(data);
+}
+
 function sendJson(res, status, body) {
   const data = Buffer.from(JSON.stringify(body), "utf8");
   res.writeHead(status, {
@@ -130,6 +141,35 @@ async function handle(req, res, { liveOptions, status }) {
     return;
   }
 
+  if (path === "/api/dsh-trivium/export.md" && method === "GET") {
+    const { cwd, db } = await dbForRequest(url);
+    if (!db) {
+      sendJson(res, 400, { ok: false, message: "no workspace" });
+      return;
+    }
+    sendText(res, 200, exportMarkdown(db, { cwd }), "text/markdown; charset=utf-8");
+    return;
+  }
+
+  if (path === "/api/dsh-trivium/workbuddy" && method === "GET") {
+    const cwd = url.searchParams.get("cwd") || getActiveCwd() || "";
+    sendJson(res, 200, { ok: true, cwd, files: discoverWorkbuddyFiles(cwd) });
+    return;
+  }
+
+  if (path === "/api/dsh-trivium/import-workbuddy" && method === "POST") {
+    const { cwd, db } = await dbForRequest(url);
+    if (!db) {
+      sendJson(res, 400, { ok: false, message: "还没有打开工作区" });
+      return;
+    }
+    const body = JSON.parse((await readBody(req)) || "{}");
+    const ids = Array.isArray(body.ids) ? body.ids.filter((id) => typeof id === "string") : undefined;
+    const result = importWorkbuddy(db, { cwd, ids });
+    sendJson(res, result.ok ? 200 : 400, result);
+    return;
+  }
+
   if (path === "/api/dsh-trivium/import" && method === "POST") {
     const { db } = await dbForRequest(url);
     if (!db) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-trivium",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "In-process graph memory kernel for DeepSeek Harness, backed by TriviumDB.",
   "license": "MIT",
   "type": "module",
@@ -36,6 +36,7 @@
     "smoke-p3": "node scripts/smoke-p3.mjs",
     "smoke-p4": "node scripts/smoke-p4.mjs",
     "smoke-p5": "node scripts/smoke-p5.mjs",
+    "smoke-p6": "node scripts/smoke-p6.mjs",
     "verify-live-p2": "node scripts/verify-live-p2.mjs"
   },
   "engines": {