dsh-trivium 0.4.1 → 0.4.3

package/README.md

@@ -54,9 +54,9 @@ dsh plugin --profile web add dsh-trivium
 
 - **跨会话** — 会话 A 记下「鉴权走 header X」，会话 B 调用 `ctx_find("鉴权")` 命中，并带上它连着谁（`about` / `decided` / `broke` / `fixed`）。
 - **默认安静** — 新会话只注入一张短地图（≤400 token）。模型要用再调工具，不会每一步灌满。
-- **会话图** — compaction 切一段就收成一个方框；点方框用 DSH 原生 fork 开分支；勾选的记忆芯片从当前这段的下一轮注入。
-- **人能改错** — 设置 → Trivium 记忆：搜、看邻居、改名 / 正文、合并、归档或删除。
-- **抽取偏严** — 闲聊、一次性改文件、密钥不入库。
+- **会话图** — compaction 切一段就收成一个方框；旧会话可点「更新检查点」补上已经发生过的压缩 / 分叉；勾选的记忆芯片从当前这段的下一轮注入。
+- **人能改错** — 会话图芯片条可新增、归档、删除；设置页管搜、改名 / 正文、合并、全局开关。
+- **抽取偏严** — 闲聊、一次性改文件、密钥**不会从对话自动入库**。芯片「新增」按你写的存（点一次整段一条）。
 - **可选 embedding** — 默认关。官方 DeepSeek 对话接口没有 embeddings；可填 OpenAI 兼容地址。
 
 ### 四个工具
@@ -74,12 +74,13 @@ dsh plugin --profile web add dsh-trivium
 
 ## 会话图
 
-入口：当前会话标题栏 **对话 / 轨迹 / 会话图**。这是情节图，不是记忆编辑器；改错的节点仍走设置页。
+入口：当前会话标题栏 **对话 / 轨迹 / 会话图**。这是情节图，不是记忆编辑器；改名、合并、全局开关仍走设置页。芯片条上可以直接新增、归档、删除。
 
 ### 方框
 
 - 没压过上下文：只有一个「后续」方框。
 - 一次成功的 compaction 之后：左边历史检查点（摘要来自 DSH），右边仍是「后续」。
+- 装插件之前已经压过 / 分过叉的旧会话：点「更新检查点」，从当前对话里的压缩标记和侧边栏分叉补方框（可重复点，不会双写）。没压过就仍只有「后续」——会话长、工具多不等于 DSH 已经压缩（默认约窗口 80% 才自动压）。
 - 方框自己不压缩。质量来自 DSH 已经做的摘要替换；fork 时不会再总结一遍。
 - 「改名」只改方框标题，不动 DSH 摘要。点方框可跳回对话里对应的检查点，或打开轨迹。
 
@@ -101,6 +102,9 @@ dsh plugin --profile web add dsh-trivium
 |---|---|
 | 勾上某条 | 当前这段里你再发的**下一条**带上它（L0，≤300 token） |
 | 取消勾选 | 再下一轮不再带 |
+| 新增 | 点一次写入一条；整段粘贴也是一条 |
+| 选择 → 归档 | 软删除：find / 短地图 / 芯片不再出现，节点还在 `.tdb` |
+| 选择 → 删除 | 从 `.tdb` 去掉，不可恢复 |
 | 已经发出去的轮次 | 不回写 |
 
 芯片按会话隔离。新开会话、fork 出的子会话默认都不勾；需要的话在分叉对话框旁打开「分叉时继承钉选」，或到子会话里重新勾。短地图仍在 session-start 自动带，不占芯片位。建议标记只是提示，不会自动勾上。
@@ -140,10 +144,10 @@ dsh plugin --profile web add dsh-trivium
 ## 限制
 
 - 模型不调 `ctx_find`、也不勾芯片时，窗口里主要是开场短地图。
-- 抽取会漏；脏数据要在设置里改或归档。
+- 抽取会漏；脏数据可在芯片条归档 / 删除，或到设置里改、合并。
 - 同一个 `.tdb` 不要两个 Node 进程同时打开（正常只开一个 `dsh web` 即可）。
 - Markdown 导出是给人看的，不能再解析回去。WorkBuddy 导入是一次性，不是双向同步。
-- 会话图只投影 compaction 与 fork，不会按消息条数自己切方框。
+- 会话图只投影 compaction 与 fork，不会按消息条数自己切方框。窗口没到 DSH 压缩线时，「更新检查点」也补不出历史方框。
 - 改插件设置后需要重启 `dsh web`。
 - 宿主升到 rc.8 后，DSH 自己的旧会话库可能打不开（官方 SQLite 格式不兼容）。工作区里的 `.tdb` 图记忆还在；对不上号的旧会话图方框可以当情节残留，不影响 `ctx_find`。
 
@@ -151,13 +155,9 @@ dsh plugin --profile web add dsh-trivium
 
 ## 更新说明
 
-**0.4.1** — 宿主钉到 `@deepseek-ai/dsh@0.1.0-rc.8`。功能与 0.4.0 相同。已在 rc.8 上确认：设置「Trivium 记忆」、新会话短地图、跨会话 `ctx_find`、会话图标签。
-
-**0.4.0** — 会话图、记忆芯片、从检查点 fork。
+**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`、会话图标签。
 
@@ -168,6 +168,6 @@ dsh plugin --profile web add dsh-trivium
 ## 发布信息
 
 - GitHub: https://github.com/QWQcool/dsh-trivium
-- npm: [`dsh-trivium@0.4.1`](https://www.npmjs.com/package/dsh-trivium)
+- npm: [`dsh-trivium@0.4.3`](https://www.npmjs.com/package/dsh-trivium)
 - 测试宿主：`@deepseek-ai/dsh@0.1.0-rc.8`
 - License: MIT（依赖 [TriviumDB](https://github.com/TriviumDB/triviumdb) 为 Apache-2.0）

package/lib/client.js

@@ -980,6 +980,67 @@ window.__ModuleLoader__.load({
       return best;
     }
 
+    function collectChatCompactions(chat) {
+      const nodes = chat?.nodes;
+      if (!nodes || typeof nodes.values !== "function") return [];
+      const rows = [];
+      const seen = new Set();
+      for (const n of nodes.values()) {
+        const kind = n.kind;
+        const data = n.data || {};
+        let seq;
+        let summary = "";
+        let compactionId = "";
+        if (kind === "compaction") {
+          seq = Number(n.anchorSeq ?? data.seq);
+          summary = String(data.summary || "");
+          compactionId = String(data.compactionId || data.id || "");
+        } else if (kind === "manual-compaction") {
+          const landed = data.compaction;
+          if (!landed) continue;
+          seq = Number(landed.seq ?? n.anchorSeq ?? data.command?.seq);
+          summary = String(landed.summary || "");
+          compactionId = String(landed.compactionId || data.command?.commandId || "");
+        } else continue;
+        if (!Number.isFinite(seq) || seen.has(seq)) continue;
+        seen.add(seq);
+        rows.push({ atSeq: seq, compactionId, summary });
+      }
+      return rows.sort((a, b) => a.atSeq - b.atSeq);
+    }
+
+    function parentIdOf(row) {
+      return String(row?.parentSessionId || row?.parentId || "");
+    }
+
+    function collectSessionForks(sessionId, byId, seedLengthOf) {
+      const forks = [];
+      const seen = new Set();
+      const add = (childId, parentId) => {
+        const child = String(childId || "");
+        const parent = String(parentId || "");
+        if (!child || !parent || seen.has(child + ":" + parent)) return;
+        const row = byId[child];
+        if (row?.origin === "subagent") return;
+        seen.add(child + ":" + parent);
+        const seed = typeof seedLengthOf === "function" ? seedLengthOf(child) : null;
+        const n = Number(seed);
+        forks.push({
+          childSessionId: child,
+          parentSessionId: parent,
+          atSeq: Number.isFinite(n) && n > 0 ? n - 1 : undefined,
+        });
+      };
+      const mine = String(sessionId || "");
+      const rows = byId || {};
+      add(mine, parentIdOf(rows[mine]));
+      for (const id of Object.keys(rows)) {
+        const parent = parentIdOf(rows[id]);
+        if (parent && (parent === mine || id === mine)) add(id, parent);
+      }
+      return forks;
+    }
+
     function scrollConversation({ key, bottom }) {
       let n = 0;
       const tick = () => {
@@ -1238,6 +1299,8 @@ window.__ModuleLoader__.load({
         position: "relative",
       },
       chipsHead: { display: "flex", alignItems: "center", justifyContent: "space-between", gap: 8, flexWrap: "wrap" },
+      chipsToolbar: { display: "flex", alignItems: "center", gap: 10, flexWrap: "wrap" },
+      chipsActions: { display: "flex", alignItems: "center", gap: 8, flexWrap: "wrap" },
       chipsTitle: { fontSize: 13, fontWeight: 650 },
       hint: { fontSize: 12, opacity: 0.62 },
       chips: { display: "flex", flexWrap: "wrap", gap: 8, alignItems: "center" },
@@ -1255,16 +1318,50 @@ window.__ModuleLoader__.load({
       chipSuggest: { borderColor: "currentColor", background: "rgba(127,127,127,0.08)" },
       suggest: { fontSize: 10, fontWeight: 650, opacity: 0.78, flexShrink: 0 },
       search: {
-        width: 180,
+        width: 200,
         boxSizing: "border-box",
-        fontSize: 12,
-        padding: "4px 8px",
+        fontSize: 13,
+        padding: "6px 10px",
         borderRadius: 8,
         border: "1px solid rgba(127,127,127,0.28)",
         background: "transparent",
         color: "inherit",
       },
       inherit: { display: "flex", alignItems: "center", gap: 6, fontSize: 12, cursor: "pointer", margin: 0 },
+      chipPicked: { borderColor: "currentColor", background: "rgba(127,127,127,0.18)" },
+      draftBox: {
+        width: "100%",
+        minHeight: 96,
+        boxSizing: "border-box",
+        fontSize: 13,
+        padding: "8px 10px",
+        borderRadius: 8,
+        border: "1px solid rgba(127,127,127,0.28)",
+        background: "transparent",
+        color: "inherit",
+        resize: "vertical",
+        fontFamily: "inherit",
+      },
+      actionBtn: {
+        fontSize: 13,
+        padding: "6px 14px",
+        borderRadius: 8,
+        border: "1px solid rgba(127,127,127,0.35)",
+        background: "rgba(127,127,127,0.10)",
+        color: "inherit",
+        cursor: "pointer",
+        flexShrink: 0,
+      },
+      dangerBtn: {
+        fontSize: 13,
+        padding: "6px 14px",
+        borderRadius: 8,
+        border: "1px solid rgba(180,60,60,0.45)",
+        background: "transparent",
+        color: "inherit",
+        cursor: "pointer",
+        flexShrink: 0,
+      },
       titleRow: { display: "flex", alignItems: "center", gap: 6, minWidth: 0 },
       title: {
         fontSize: 14,
@@ -1633,7 +1730,7 @@ window.__ModuleLoader__.load({
 
     let pendingSessionNav = null;
 
-    function SessionMapView({ sessionId, useSessions, useSession, fork, open, renameSession, actions }) {
+    function SessionMapView({ sessionId, useSessions, useSession, fork, open, renameSession, actions, seedLengthOf }) {
       const canSetView = typeof actions?.setView === "function";
       const chat = useSession((s) => s.chat);
       const cwd = useSessions((s) => (sessionId == null ? "" : s.byId[sessionId]?.cwd || ""));
@@ -1660,7 +1757,12 @@ window.__ModuleLoader__.load({
       const [chipQuery, setChipQuery] = react.useState("");
       const [inheritPins, setInheritPins] = react.useState(false);
       const [chipsOpen, setChipsOpen] = react.useState(false);
+      const [chipSelect, setChipSelect] = react.useState(false);
+      const [pickedIds, setPickedIds] = react.useState([]);
+      const [draftOpen, setDraftOpen] = react.useState(false);
+      const [draftText, setDraftText] = react.useState("");
       const [forkDraft, setForkDraft] = react.useState(null);
+      const [backfillNote, setBackfillNote] = react.useState("");
       const canvasRef = react.useRef(null);
       const dragRef = react.useRef(null);
       const userMovedRef = react.useRef(false);
@@ -1719,6 +1821,34 @@ window.__ModuleLoader__.load({
         }
       }, [qs, sessionId]);
 
+      const syncCheckpoints = async () => {
+        if (!sessionId || busy) return;
+        setBusy(true);
+        setError("");
+        try {
+          const compactations = collectChatCompactions(chat);
+          const forks = collectSessionForks(sessionId, sessionById, seedLengthOf);
+          const resp = await api("/api/dsh-trivium/map/backfill" + qs, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ sessionId, compactations, forks }),
+          });
+          setNodes(resp.nodes || []);
+          setEdges(resp.edges || []);
+          const checks = Number(resp.checkpoints) || 0;
+          const forkN = Number(resp.forks) || 0;
+          if (!checks && !forkN) {
+            setBackfillNote("没有发现压缩标记或分叉。没压过的会话本来就只有「后续」。");
+          } else {
+            setBackfillNote("已同步 " + checks + " 个检查点、" + forkN + " 条分叉。");
+          }
+        } catch (err) {
+          setError(String(err.message || err));
+        } finally {
+          setBusy(false);
+        }
+      };
+
       react.useEffect(() => {
         load();
       }, [load, lineageKey]);
@@ -1924,6 +2054,67 @@ window.__ModuleLoader__.load({
         }
       };
 
+      const qsPins = cwd ? "?cwd=" + encodeURIComponent(cwd) : "";
+
+      const applyChipPayload = (payload) => {
+        if (Array.isArray(payload.chips)) setChips(payload.chips);
+        if (Array.isArray(payload.pinIds)) setPinIds(payload.pinIds);
+        if (payload.clipped != null) setClipped(!!payload.clipped);
+      };
+
+      const togglePicked = (id) => {
+        setPickedIds((prev) => (prev.includes(id) ? prev.filter((x) => x !== id) : prev.concat(id)));
+      };
+
+      const runChipBatch = async (action) => {
+        if (!pickedIds.length || busy) return;
+        if (action === "delete") {
+          const ok = window.confirm(
+            "删除会从 .tdb 里拿掉这 " +
+              pickedIds.length +
+              " 条，不可恢复。归档只是藏起来，find / 短地图 / 芯片都不再出现。确定删除？",
+          );
+          if (!ok) return;
+        }
+        setBusy(true);
+        setError("");
+        try {
+          const resp = await api("/api/dsh-trivium/chips/batch" + qsPins, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ sessionId, action, ids: pickedIds }),
+          });
+          applyChipPayload(resp);
+          setPickedIds([]);
+          setChipSelect(false);
+        } catch (err) {
+          setError(String(err.message || err));
+        } finally {
+          setBusy(false);
+        }
+      };
+
+      const submitChipDraft = async () => {
+        const text = draftText.trim();
+        if (!text || busy) return;
+        setBusy(true);
+        setError("");
+        try {
+          const resp = await api("/api/dsh-trivium/chips" + qsPins, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ sessionId, text, pin: true }),
+          });
+          applyChipPayload(resp);
+          setDraftText("");
+          setDraftOpen(false);
+        } catch (err) {
+          setError(String(err.message || err));
+        } finally {
+          setBusy(false);
+        }
+      };
+
       const pinSet = new Set(pinIds);
       const visibleChips = react.useMemo(() => {
         const needle = chipQuery.trim().toLowerCase();
@@ -1954,17 +2145,31 @@ window.__ModuleLoader__.load({
               jsx("div", {
                 style: mapUi.hint,
                 children:
+                  backfillNote ||
                   "共 " +
-                  chips.length +
-                  " 条，已钉 " +
-                  pinIds.length +
-                  "。默认不勾选：不钉就不会按芯片白名单注入，但仍可能被开场短地图点名带上，模型也能 find 到。",
+                    chips.length +
+                    " 条，已钉 " +
+                    pinIds.length +
+                    "。默认不勾选：不钉就不会按芯片白名单注入，但仍可能被开场短地图点名带上，模型也能 find 到。",
               }),
-              jsx("button", {
-                type: "button",
-                style: mapUi.foldBtn,
-                onClick: () => setChipsOpen((v) => !v),
-                children: chipsOpen ? "收起" : "展开勾选",
+              jsxs("div", {
+                style: mapUi.chipsActions,
+                children: [
+                  jsx("button", {
+                    type: "button",
+                    style: mapUi.actionBtn,
+                    disabled: busy,
+                    title: "读取当前对话里 DSH 已有的压缩标记和侧边栏分叉，生成检查点方框。给插件装上之前的旧会话用。",
+                    onClick: syncCheckpoints,
+                    children: busy ? "更新中…" : "更新检查点",
+                  }),
+                  jsx("button", {
+                    type: "button",
+                    style: mapUi.actionBtn,
+                    onClick: () => setChipsOpen((v) => !v),
+                    children: chipsOpen ? "收起" : "展开勾选",
+                  }),
+                ],
               }),
             ],
           }),
@@ -1973,7 +2178,7 @@ window.__ModuleLoader__.load({
                 style: { display: "flex", flexDirection: "column", gap: 8 },
                 children: [
                   jsxs("div", {
-                    style: mapUi.chipsHead,
+                    style: mapUi.chipsToolbar,
                     children: [
                       jsx("input", {
                         type: "search",
@@ -1993,25 +2198,113 @@ window.__ModuleLoader__.load({
                           "分叉时继承钉选",
                         ],
                       }),
-                      clipped
-                        ? jsx("div", { style: mapUi.hint, children: "已截到预算（≤300 token）" })
-                        : jsx("div", { style: mapUi.hint, children: "勾选后从当前这段的下一轮注入。空白处拖动画布，滚轮缩放。" }),
+                      jsxs("div", {
+                        style: mapUi.chipsActions,
+                        children: [
+                          jsx("button", {
+                            type: "button",
+                            style: mapUi.actionBtn,
+                            onClick: () => {
+                              setDraftOpen((v) => !v);
+                              setChipSelect(false);
+                              setPickedIds([]);
+                            },
+                            children: draftOpen ? "取消新增" : "新增",
+                          }),
+                          jsx("button", {
+                            type: "button",
+                            style: mapUi.actionBtn,
+                            onClick: () => {
+                              setChipSelect((v) => !v);
+                              setPickedIds([]);
+                              setDraftOpen(false);
+                            },
+                            children: chipSelect ? "取消选择" : "选择",
+                          }),
+                          chipSelect
+                            ? jsx("button", {
+                                type: "button",
+                                style: mapUi.actionBtn,
+                                disabled: !pickedIds.length || busy,
+                                onClick: () => runChipBatch("archive"),
+                                children: "归档" + (pickedIds.length ? " " + pickedIds.length : ""),
+                              })
+                            : null,
+                          chipSelect
+                            ? jsx("button", {
+                                type: "button",
+                                style: mapUi.dangerBtn,
+                                disabled: !pickedIds.length || busy,
+                                onClick: () => runChipBatch("delete"),
+                                children: "删除" + (pickedIds.length ? " " + pickedIds.length : ""),
+                              })
+                            : null,
+                        ],
+                      }),
                     ],
                   }),
+                  jsx("div", {
+                    style: mapUi.hint,
+                    children: chipSelect
+                      ? "点芯片多选。归档：软删除，find / 短地图 / 芯片不再出现，节点还在库里。删除：从 .tdb 去掉，不可恢复。"
+                      : clipped
+                        ? "已截到预算（≤300 token）"
+                        : "勾选后从当前这段的下一轮注入。空白处拖动画布，滚轮缩放。",
+                  }),
+                  draftOpen
+                    ? jsxs("div", {
+                        style: { display: "flex", flexDirection: "column", gap: 6 },
+                        children: [
+                          jsx("textarea", {
+                            value: draftText,
+                            onChange: (e) => setDraftText(e.target.value),
+                            placeholder: "粘贴或输入要记住的内容。点一次写入，整段就是一条芯片。",
+                            style: mapUi.draftBox,
+                          }),
+                          jsx("button", {
+                            type: "button",
+                            style: { ...mapUi.actionBtn, alignSelf: "flex-start" },
+                            disabled: busy || !draftText.trim(),
+                            onClick: submitChipDraft,
+                            children: "写入并钉选",
+                          }),
+                        ],
+                      })
+                    : null,
                   visibleChips.length
                     ? jsx("div", {
                         style: mapUi.chips,
-                        children: visibleChips.map((c) =>
-                          jsxs(
-                            "label",
+                        children: visibleChips.map((c) => {
+                          const picked = pickedIds.includes(c.id);
+                          return jsxs(
+                            chipSelect ? "button" : "label",
                             {
-                              style: { ...mapUi.chip, ...(c.suggested ? mapUi.chipSuggest : {}) },
+                              type: chipSelect ? "button" : undefined,
+                              style: {
+                                ...mapUi.chip,
+                                ...(c.suggested ? mapUi.chipSuggest : {}),
+                                ...(chipSelect && picked ? mapUi.chipPicked : {}),
+                              },
+                              onClick: chipSelect
+                                ? (e) => {
+                                    e.preventDefault();
+                                    togglePicked(c.id);
+                                  }
+                                : undefined,
                               children: [
-                                jsx("input", {
-                                  type: "checkbox",
-                                  checked: pinSet.has(c.id),
-                                  onChange: (e) => togglePin(c.id, e.target.checked),
-                                }),
+                                chipSelect
+                                  ? jsx("input", {
+                                      type: "checkbox",
+                                      checked: picked,
+                                      readOnly: true,
+                                      tabIndex: -1,
+                                      style: { pointerEvents: "none" },
+                                    })
+                                  : jsx("input", {
+                                      type: "checkbox",
+                                      checked: pinSet.has(c.id),
+                                      onChange: (e) => togglePin(c.id, e.target.checked),
+                                    }),
                                 c.suggested ? jsx("span", { style: mapUi.suggest, children: "建议" }) : null,
                                 jsx("span", {
                                   style: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
@@ -2020,14 +2313,14 @@ window.__ModuleLoader__.load({
                               ],
                             },
                             String(c.id),
-                          ),
-                        ),
+                          );
+                        }),
                       })
                     : jsx("div", {
                         style: mapUi.hint,
                         children: chips.length
                           ? "没有匹配的芯片。"
-                          : "还没有可钉选的 preference / decision / entity。",
+                          : "还没有可钉选的 preference / decision / entity。用「新增」写一条。",
                       }),
                 ],
               })
@@ -2217,6 +2510,15 @@ window.__ModuleLoader__.load({
               inject: () => ({
                 fork: (opts) => sessions.fork(opts),
                 open: (id) => sessions.open(id),
+                seedLengthOf: (id) => {
+                  try {
+                    const seed = sessions.binding?.(id)?.session?.header?.seedLength;
+                    const n = Number(seed);
+                    return Number.isFinite(n) && n > 0 ? n : null;
+                  } catch {
+                    return null;
+                  }
+                },
                 renameSession: async (id, title) => {
                   const face = sessions.binding?.(id)?.session;
                   if (!face || typeof face.rename !== "function") {

package/lib/episode.js

@@ -203,6 +203,48 @@ export function syncForkLineage(db, { childSessionId, parentSessionId, atSeq } =
   return { cutId, childTail };
 }
 
+/**
+ * Project DSH's already-landed compactations and fork list onto episode boxes.
+ * Idempotent: same atSeq / child reuses the existing node.
+ */
+export function backfillSessionMap(db, { sessionId, compactations = [], forks = [] } = {}) {
+  const sid = String(sessionId || "");
+  let checkpoints = 0;
+  const seenSeq = new Set();
+  for (const raw of compactations || []) {
+    const atSeq = Number(raw.atSeq);
+    if (!sid || !Number.isFinite(atSeq) || seenSeq.has(atSeq)) continue;
+    seenSeq.add(atSeq);
+    const id = recordCheckpoint(db, {
+      sessionId: sid,
+      atSeq,
+      compactionId: raw.compactionId,
+      summary: raw.summary,
+    });
+    if (id != null) checkpoints += 1;
+  }
+  if (sid) ensureTail(db, sid);
+  let forkLinks = 0;
+  for (const raw of forks || []) {
+    const child = String(raw.childSessionId || "");
+    const parent = String(raw.parentSessionId || "");
+    if (!child || !parent) continue;
+    const atSeq = Number.isFinite(Number(raw.atSeq)) ? Number(raw.atSeq) : undefined;
+    const result = syncForkLineage(db, {
+      childSessionId: child,
+      parentSessionId: parent,
+      atSeq,
+    });
+    if (result?.childTail != null) forkLinks += 1;
+  }
+  return {
+    ok: true,
+    checkpoints,
+    forks: forkLinks,
+    ...sessionMapSnapshot(db, sid),
+  };
+}
+
 export function sessionMapSnapshot(db, sessionId) {
   const sid = String(sessionId || "");
   const all = listEpisodeRecords(db);

package/lib/extract.js

@@ -21,6 +21,7 @@ export const CHITCHAT_CUES =
 /** 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 EXPLICIT_LINE_CHARS = 2000;
 export const MAX_WRITE_ITEMS = 24;
 
 const NAME_RE =
@@ -307,10 +308,10 @@ export function ruleCandidates(turns) {
   return out;
 }
 
-export function filterCandidates(candidates, { importFile = false } = {}) {
+export function filterCandidates(candidates, { importFile = false, explicit = false } = {}) {
   const seen = new Set();
   const out = [];
-  const caps = importFile
+  const caps = importFile || explicit
     ? { 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 };
@@ -319,10 +320,10 @@ export function filterCandidates(candidates, { importFile = false } = {}) {
     const text = String(raw.text || raw.name || "").trim();
     if (!text) continue;
     if (raw.type === "entity" && isNoiseName(raw.name || text)) continue;
-    if (looksSecret(text) || looksSecret(raw.fail) || looksSecret(raw.fix) || looksSecret(raw.quote)) {
+    if (!explicit && (looksSecret(text) || looksSecret(raw.fail) || looksSecret(raw.fix) || looksSecret(raw.quote))) {
       continue;
     }
-    if (raw.type === "preference") {
+    if (raw.type === "preference" && !explicit) {
       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;
@@ -336,7 +337,7 @@ export function filterCandidates(candidates, { importFile = false } = {}) {
     out.push({
       type: raw.type,
       name: raw.name ? String(raw.name).slice(0, 80) : undefined,
-      text: clip(text, MAX_LINE_CHARS),
+      text: clip(text, explicit ? EXPLICIT_LINE_CHARS : 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,
@@ -409,7 +410,10 @@ export function capWriteBatch(candidates, { maxChars = MAX_WRITE_CHARS, maxItems
 
 export function applyCandidates(db, candidates, { sessionId, via } = {}) {
   const { kept: list } = capWriteBatch(
-    filterCandidates(candidates, { importFile: via === "workbuddy-import" }),
+    filterCandidates(candidates, {
+      importFile: via === "workbuddy-import",
+      explicit: via === "chip-add",
+    }),
   );
   const ordered = [
     ...list.filter((c) => c.type === "entity"),

package/lib/pins.js

@@ -3,7 +3,10 @@
 import { listEpisodeRecords } from "./episode.js";
 import { clipToTokenBudget, estimateTokens } from "./tokens.js";
 import { pinsOf, writePins } from "./settings.js";
-import { suggestedNeighborIds } from "./store.js";
+import { archiveNode, deleteNode, suggestedNeighborIds } from "./store.js";
+import { applyCandidates, DECISION_CUES, EXPLICIT_LINE_CHARS, firstEntityName } from "./extract.js";
+import { clip } from "./schema.js";
+import { parseUntilFromText } from "./until.js";
 
 export const PIN_TOKEN_BUDGET = 300;
 export const CHIP_TYPES = Object.freeze(["preference", "decision", "entity"]);
@@ -153,3 +156,102 @@ export function applyPinsUpdate(db, body = {}) {
   }
   return setSessionPins(db, sessionId, Array.isArray(body.ids) ? body.ids : []);
 }
+
+/** Markdown is only markup. Strip fences, emphasis, links, headings, list markers. */
+export function stripMarkdownMarkup(text) {
+  let s = String(text || "");
+  s = s.replace(/```[\s\S]*?```/g, " ");
+  s = s.replace(/`([^`]+)`/g, "$1");
+  s = s.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+  s = s.replace(/\*\*([^*]+)\*\*/g, "$1");
+  s = s.replace(/__([^_]+)__/g, "$1");
+  s = s.replace(/\*([^*]+)\*/g, "$1");
+  s = s.replace(/_([^_]+)_/g, "$1");
+  s = s.replace(/^#{1,6}\s+/gm, "");
+  s = s.replace(/^\s*(?:[-*+]|\d+\.)\s+(?:\[[ xX]\]\s+)?/gm, "");
+  return s.replace(/\s+/g, " ").trim();
+}
+
+/**
+ * One submit → one chip. Long paste stays one node; markdown is stripped, not split.
+ */
+export function splitChipDraft(text) {
+  const body = stripMarkdownMarkup(String(text || "").replace(/\r\n/g, "\n"));
+  return body ? [body] : [];
+}
+
+function candidateFromChipLine(body) {
+  const text = stripMarkdownMarkup(body);
+  if (!text) return null;
+  const name = firstEntityName(text);
+  if (DECISION_CUES.test(text)) {
+    return {
+      skip: null,
+      candidates: [
+        {
+          type: "decision",
+          name,
+          text: clip(text, EXPLICIT_LINE_CHARS),
+          until: parseUntilFromText(text),
+          linkName: name,
+          linkLabel: "decided",
+          quote: clip(text, 120),
+          via: "chip-add",
+        },
+      ],
+    };
+  }
+  return {
+    skip: null,
+    candidates: [
+      {
+        type: "preference",
+        name,
+        text: clip(text, EXPLICIT_LINE_CHARS),
+        linkName: name,
+        linkLabel: "about",
+        quote: clip(text, 120),
+        via: "chip-add",
+      },
+    ],
+  };
+}
+
+export function addChipsFromText(db, text, { sessionId = "", pin = true } = {}) {
+  const lines = splitChipDraft(text);
+  if (!lines.length) return { ok: false, message: "空内容", ids: [], skipped: 0 };
+  const candidates = [];
+  for (const line of lines) {
+    const parsed = candidateFromChipLine(line);
+    if (!parsed) continue;
+    candidates.push(...parsed.candidates);
+  }
+  if (!candidates.length) {
+    return { ok: false, message: "没有可写入的条目", ids: [], skipped: 0 };
+  }
+  const applied = applyCandidates(db, candidates, { sessionId, via: "chip-add" });
+  const ids = [...new Set(applied.map((a) => Number(a.id)).filter((id) => Number.isFinite(id)))];
+  if (pin && sessionId && ids.length) {
+    const merged = [...new Set([...livePinIds(db, sessionId), ...ids])];
+    setSessionPins(db, sessionId, merged);
+  }
+  return {
+    ok: ids.length > 0,
+    message: ids.length ? `已写入 ${ids.length} 条` : "没有新节点",
+    ids,
+    applied: applied.length,
+    skipped: Math.max(0, lines.length - ids.length),
+  };
+}
+
+export function batchChipAction(db, { action, ids, sessionId = "" } = {}) {
+  const verb = action === "delete" ? "delete" : "archive";
+  const list = [...new Set((ids || []).map(Number).filter((id) => Number.isFinite(id)))];
+  let count = 0;
+  for (const id of list) {
+    const ok = verb === "delete" ? deleteNode(db, id) : archiveNode(db, id);
+    if (ok) count += 1;
+  }
+  if (sessionId) prunePins(db, sessionId);
+  return { ok: count > 0 || list.length === 0, action: verb, count, ids: list };
+}

package/lib/server.js

@@ -17,8 +17,8 @@ import {
 import { embeddingPublicStatus } from "./embed.js";
 import { recallModeOf, writeUiSettings } from "./settings.js";
 import { discoverWorkbuddyFiles, exportMarkdown, importWorkbuddy } from "./markdown.js";
-import { renameEpisode, sessionMapSnapshot } from "./episode.js";
-import { applyPinsUpdate, listChips, readSessionPins } from "./pins.js";
+import { backfillSessionMap, renameEpisode, sessionMapSnapshot } from "./episode.js";
+import { applyPinsUpdate, addChipsFromText, batchChipAction, listChips, readSessionPins } from "./pins.js";
 
 export { readUiSettings, writeUiSettings } from "./settings.js";
 
@@ -272,6 +272,23 @@ async function handle(req, res, { liveOptions, status }) {
     return;
   }
 
+  if (path === "/api/dsh-trivium/map/backfill" && method === "POST") {
+    const { cwd, db } = await dbForRequest(url);
+    if (!db) {
+      sendJson(res, 400, { ok: false, message: "no workspace" });
+      return;
+    }
+    const body = JSON.parse((await readBody(req)) || "{}");
+    const sessionId = body.sessionId || url.searchParams.get("sessionId") || "";
+    const result = backfillSessionMap(db, {
+      sessionId,
+      compactations: body.compactations,
+      forks: body.forks,
+    });
+    sendJson(res, 200, { ok: true, cwd, sessionId, ...result });
+    return;
+  }
+
   if (path === "/api/dsh-trivium/chips" && method === "GET") {
     const { cwd, db } = await dbForRequest(url);
     const q = url.searchParams.get("q") || "";
@@ -284,6 +301,52 @@ async function handle(req, res, { liveOptions, status }) {
     return;
   }
 
+  if (path === "/api/dsh-trivium/chips" && method === "POST") {
+    const { cwd, db } = await dbForRequest(url);
+    if (!db) {
+      sendJson(res, 400, { ok: false, message: "no workspace" });
+      return;
+    }
+    const body = JSON.parse((await readBody(req)) || "{}");
+    const sessionId = body.sessionId || url.searchParams.get("sessionId") || "";
+    const result = addChipsFromText(db, body.text, { sessionId, pin: body.pin !== false });
+    const pin = readSessionPins(db, sessionId);
+    sendJson(res, result.ok ? 200 : 400, {
+      ...result,
+      cwd,
+      sessionId,
+      chips: listChips(db, { sessionId }),
+      pinIds: pin.ids,
+      clipped: pin.clipped,
+    });
+    return;
+  }
+
+  if (path === "/api/dsh-trivium/chips/batch" && method === "POST") {
+    const { cwd, db } = await dbForRequest(url);
+    if (!db) {
+      sendJson(res, 400, { ok: false, message: "no workspace" });
+      return;
+    }
+    const body = JSON.parse((await readBody(req)) || "{}");
+    const sessionId = body.sessionId || url.searchParams.get("sessionId") || "";
+    const result = batchChipAction(db, {
+      action: body.action,
+      ids: body.ids,
+      sessionId,
+    });
+    const pin = readSessionPins(db, sessionId);
+    sendJson(res, result.ok ? 200 : 400, {
+      ...result,
+      cwd,
+      sessionId,
+      chips: listChips(db, { sessionId }),
+      pinIds: pin.ids,
+      clipped: pin.clipped,
+    });
+    return;
+  }
+
   if (path === "/api/dsh-trivium/pins" && method === "GET") {
     const { cwd, db } = await dbForRequest(url);
     const sessionId = url.searchParams.get("sessionId") || "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-trivium",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "In-process graph memory and session map for DeepSeek Harness, backed by TriviumDB.",
   "license": "MIT",
   "type": "module",