dsh-engram 0.5.0 → 0.5.1

package/README.md

@@ -264,8 +264,8 @@ curl -s -X POST http://127.0.0.1:3080/api/dsh-engram/import \
 <!-- dsh-market compatibility block — keep labels bilingual and in sync with
      docs/RELEASE-NOTES.TEMPLATE.md (market README convention) -->
 
-- **DSH 版本 / DSH versions**: `>=0.1.2-alpha.2 <0.3.0-0` (本版 `0.5.0`; 已发布的 `0.3.7`、`0.4.0` 仍声明旧的 `0.1.x` 范围 `>=0.1.2-alpha.2 <0.2.0-0` — 见下方矩阵)
-- **最后验证日期 / Last verified**: 2026-10-15 — 设置模型迁移（entry-id volatile Config，兼容 DSH `0.2.x`）落地，npm test 329/329 通过；真实 `dsh 0.2.0-rc.2` 隔离 profile 运行烟测通过（见下方“当前发布”）
+- **DSH 版本 / DSH versions**: `>=0.1.2-alpha.2 <0.3.0-0` (本版 `0.5.1`; 已发布的 `0.3.7`、`0.4.0` 仍声明旧的 `0.1.x` 范围 `>=0.1.2-alpha.2 <0.2.0-0` — 见下方矩阵)
+- **最后验证日期 / Last verified**: 2026-10-19 — 会话扫描修复（`session.v<N>.jsonl.zstd`，issue #8）+ 数据导出/导入与替换/冲突可视化（issue #3），npm test 334/334 通过
 - **安装方式已验证 / Verified install**: `dsh plugin --profile web add dsh-engram`
 
 > **Short version.** Every **published** release (`0.2.0` … `0.3.6`) supports
@@ -279,7 +279,8 @@ curl -s -X POST http://127.0.0.1:3080/api/dsh-engram/import \
 | --- | --- | --- | --- |
 | `0.2.0` … `0.3.6` (npm, GitHub v0.3.3–v0.3.6) | published | **old DSH only** — `0.1.0-rc.7` / `0.1.0-rc.8` / `0.1.1-rc.1` / `0.1.1-rc.2` | peers `@deepseek-ai/dsh-*@^0.1.0-rc.7` |
 | `0.3.7` / `0.4.0` (npm) | published | **new DSH, settings `installSection`** — `>=0.1.2-alpha.2 <0.2.0-0` | `engines.dsh` + peers `>=0.1.2-alpha.2 <0.2.0-0` |
-| `0.5.0` (本期 / this release) | pre-release | **DSH `0.1.2-alpha.2` … `<0.3.0-0`** — 设置卡迁移到 entry-id volatile Config（`0.1.7+`/`0.2.x`），`≤0.1.5` 自动回退 `installSection` | `engines.dsh` + peers `>=0.1.2-alpha.2 <0.3.0-0` |
+| `0.5.0` (npm) | published | **DSH `0.1.2-alpha.2` … `<0.3.0-0`** — 设置卡迁移到 entry-id volatile Config（`0.1.7+`/`0.2.x`），`≤0.1.5` 自动回退 `installSection` | `engines.dsh` + peers `>=0.1.2-alpha.2 <0.3.0-0` |
+| `0.5.1` (本期 / this release) | published | 同 `0.5.0` — 会话扫描修复（`session.v<N>.jsonl.zstd`，issue #8）、数据导出/导入 GUI、替换/冲突可视化（issue #3） | 同 `0.5.0` |
 
 ### Where the API family broke — `0.1.2-alpha.2`
 
@@ -329,7 +330,14 @@ drives mutations).
 So: keep DSH on `0.1.1-rc.2` or older while running a release ≤ `0.3.6`, and
 upgrade the plugin to `>=0.3.7` before moving DSH to `0.1.2-alpha.2`.
 
-### Current release — `0.5.0`
+### Current release — `0.5.1`
+
+Patch release on top of `0.5.0`: session scanning resolves the **versioned** log
+name (`session.v3/v4.jsonl.zstd`) instead of the hardcoded
+`session.jsonl.zstd` — on current DSH that mismatch made `/stats`, `/toolstats`,
+BoundaryPrune's repayment history and the CJK session search all return zero
+silently (issue #8). The memory viewer also gains data export/import and
+supersede/contradict visualization (issue #3).
 
 The published `0.4.0` declared `>=0.1.2-alpha.2 <0.2.0-0` — which the semver
 gate **rejects on every DSH `0.2.0-0` prerelease** (`<0.2.0-0` excludes

package/README.zh.md

@@ -166,8 +166,8 @@ curl -s -X POST http://127.0.0.1:3080/api/dsh-engram/import \
 
 <!-- dsh-market 兼容信息块 —— 与 docs/RELEASE-NOTES.TEMPLATE.md 的市场 README 公约保持一致 -->
 
-- **DSH 版本**：`>=0.1.2-alpha.2 <0.3.0-0`（本版 `0.5.0`；已发布的 `0.3.7`、`0.4.0` 仍声明旧的 `0.1.x` 范围 `>=0.1.2-alpha.2 <0.2.0-0` —— 见下文矩阵）
-- **最后验证日期**：2026-10-15 —— 设置模型迁移（entry-id volatile Config，兼容 DSH `0.2.x`）落地，npm test 329/329 通过；真实 `dsh 0.2.0-rc.2` 隔离 profile 运行烟测通过（见下文“当前发布”）
+- **DSH 版本**：`>=0.1.2-alpha.2 <0.3.0-0`（本版 `0.5.1`；已发布的 `0.3.7`、`0.4.0` 仍声明旧的 `0.1.x` 范围 `>=0.1.2-alpha.2 <0.2.0-0` —— 见下文矩阵）
+- **最后验证日期**：2026-10-19 —— 会话扫描修复（`session.v<N>.jsonl.zstd`，issue #8）+ 数据导出/导入与替换/冲突可视化（issue #3），npm test 334/334 通过
 - **安装方式已验证**：`dsh plugin --profile web add dsh-engram`
 
 > **一句话结论**：所有**已真正发布**的版本（`0.2.0` … `0.3.6`）**只支持旧版
@@ -179,7 +179,8 @@ curl -s -X POST http://127.0.0.1:3080/api/dsh-engram/import \
 | --- | --- | --- | --- |
 | `0.2.0` … `0.3.6`（npm 全量 + GitHub v0.3.3–v0.3.6） | 已发布 | **仅旧版** —— `0.1.0-rc.7` / `0.1.0-rc.8` / `0.1.1-rc.1` / `0.1.1-rc.2` | peers `@deepseek-ai/dsh-*@^0.1.0-rc.7` |
 | `0.3.7` / `0.4.0`（npm） | 已发布 | **新版 DSH，settings `installSection`** —— `>=0.1.2-alpha.2 <0.2.0-0` | `engines.dsh` + peers 同范围 |
-| `0.5.0`（本期 / this release） | 预发布 | **DSH `0.1.2-alpha.2` … `<0.3.0-0`** —— 设置卡迁移到 entry-id volatile Config（`0.1.7+`/`0.2.x`），`≤0.1.5` 自动回退 `installSection` | `engines.dsh` + peers `>=0.1.2-alpha.2 <0.3.0-0` |
+| `0.5.0`（npm） | 已发布 | **DSH `0.1.2-alpha.2` … `<0.3.0-0`** —— 设置卡迁移到 entry-id volatile Config（`0.1.7+`/`0.2.x`），`≤0.1.5` 自动回退 `installSection` | `engines.dsh` + peers `>=0.1.2-alpha.2 <0.3.0-0` |
+| `0.5.1`（本期 / this release） | 已发布 | 同 `0.5.0` —— 会话扫描修复（`session.v<N>.jsonl.zstd`，issue #8）、数据导出/导入 GUI、替换/冲突可视化（issue #3） | 同 `0.5.0` |
 
 ### API 族断裂点:`0.1.2-alpha.2`
 
@@ -219,7 +220,13 @@ profile 条目 id（`engram`）为命名空间，不再需要任何“挂载”
 所以：跑 ≤ `0.3.6` 的已发布版本时请把 DSH 保持在 `0.1.1-rc.2` 或更旧；升级
 DSH 到 `0.1.2-alpha.2` 之前，先升级插件到 `>=0.3.7`。
 
-### 当前发布版本 —— `0.5.0`
+### 当前发布版本 —— `0.5.1`
+
+在 `0.5.0` 之上的补丁版：会话扫描改为解析**版本化**日志名
+（`session.v3/v4.jsonl.zstd`）而不硬编码 `session.jsonl.zstd`——在当前 DSH 上
+这个错位让 `/stats`、`/toolstats`、BoundaryPrune 的偿还历史、CJK 会话搜索全部
+**静默返回 0**（issue #8）。记忆查看器同时补上数据导出/导入与替换/冲突可视化
+（issue #3）。
 
 已发布的 `0.4.0` 声明 `>=0.1.2-alpha.2 <0.2.0-0`——这个范围被 semver 门槛在
 **所有 DSH `0.2.0-0` 预发布**上拒绝（`<0.2.0-0` 排除 `0.2.0-rc.x`），且其宿主设置端

package/docs/RELEASE-NOTES-v0.5.1.md

@@ -0,0 +1,54 @@
+## dsh-engram v0.5.1
+
+补丁版：修复会话日志扫描对**版本化文件名**的硬编码（issue #8，所有会话扫描
+功能静默返回 0），并补齐记忆查看器的**数据导出/导入**与**替换/冲突可视化**
+（issue #3 收尾）。
+
+### 修复
+
+- **会话扫描识别 `session.v<N>.jsonl.zstd`**（#8）—— `lib/usage.js`、
+  `lib/boundary-prune.js`、`lib/session-cjk.js` 曾硬编码 `session.jsonl.zstd`；
+  当前 DSH 把会话格式版本写进文件名（`0.1.x` → `session.v3.jsonl.zstd`，
+  `0.2.x` → `session.v4.jsonl.zstd`），`statSync` 抛 `ENOENT` 后被循环 `continue`
+  静默吞掉，导致：
+
+  - 设置页 → 遥测恒为「样本不足（0 次）」，`GET /stats`、`GET /toolstats` 全 0；
+  - BoundaryPrune 的 `workspaceHistory()`（L0 偿还输入）看不到任何会话；
+  - CJK 跨会话搜索恒返回 `[]`。
+
+  新增 `sessionLogFile(dir)`：正则匹配 `session[.v<N>].jsonl.zstd`，取目录内
+  **mtime 最新**的一个（迁移会话可能 v3/v4/legacy 并存，最新 = 宿主正在追加的
+  文件），无匹配时回退历史名、调用方保留原有 ENOENT 处理。四处调用点统一改用它。
+  本机实测（14 天窗口）：`files 0 → 17`、`events 0 → 643`。
+
+### 功能
+
+- **数据备份面板**（#3）—— 设置页 → Engram 记忆 →「数据备份」：一键导出当前
+  工作区（或全部）为 `dsh-engram/export` v1 JSON 并下载；导入支持 **dry-run 预览**
+  → `merge`（只补缺失，幂等）/ `replace`（需勾选确认，宿主要求
+  `confirm:"restore"`）。宿主端的 `GET /export`、`POST /import` 早已存在，本版只补
+  GUI 入口，GUI 与 API 走同一格式。
+- **替换 / 冲突可视化**（#3）—— 记忆表给被替代的旧行挂「已替换」徽标、给新行挂
+  「替代 #id」跳转；记忆详情面板新增「替换 / 冲突」双向链（出边来自记录的
+  `supersedes`/`contradicts`，入边由已加载列表反查），元数据露出
+  `source`/`conditions`/`filePath`。
+
+### 测试
+
+- 334/334（新增 5 个 #8 用例：版本化/纯 legacy/v3+v4+legacy 混合/陈旧 legacy
+  不遮蔽 v4/无关文件名不被误选，以及 CJK 版本化读取与 `workspaceHistory` 计数）。
+- `npm run typecheck`、`npm run prepublish-check` 通过；`lib/client.js` 重新构建。
+
+## DSH 版本支持
+
+- **支持的 DSH 范围**：>=0.1.2-alpha.2 <0.3.0-0
+- **peer 声明**：
+  - `@deepseek-ai/dsh-compaction`: `>=0.1.2-alpha.2 <0.3.0-0`
+  - `@deepseek-ai/dsh-compaction-basic`: `>=0.1.2-alpha.2 <0.3.0-0`
+  - `@deepseek-ai/dsh-llm`: `>=0.1.2-alpha.2 <0.3.0-0`
+  - `@deepseek-ai/dsh-settings`: `>=0.1.2-alpha.2 <0.3.0-0`
+  - `@deepseek-ai/dsh-storage-domain`: `>=0.1.2-alpha.2 <0.3.0-0`
+- **验证版本**：`dsh-v0.2.0-rc.2`（与 0.5.0 相同的宿主依赖集；本版只改会话日志
+  解析与纯客户端界面，未触碰设置/注入路径）
+- **最后验证日期**：2026-10-19
+- **安装方式已验证**：`dsh plugin --profile web add dsh-engram`

package/lib/boundary-prune.js

@@ -40,6 +40,7 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 
+import { sessionLogFile } from "./usage.js";
 import { workspaceKey as wk } from "./util.js";
 
 /** Fixed fallback for the repayment gate when no history exists yet. */
@@ -93,7 +94,7 @@ export function workspaceHistory(root = path.join(os.homedir(), ".dsh", "session
       let sessions = 0;
       const bdir = path.join(root, bucket);
       for (const sid of fs.readdirSync(bdir)) {
-        const file = path.join(bdir, sid, "session.jsonl.zstd");
+        const file = sessionLogFile(path.join(bdir, sid));
         try {
           const st = fs.statSync(file);
           if (st.size > 0) sessions += 1;

package/lib/client.js

@@ -153,6 +153,28 @@ var EngramApi = class {
       })
     );
   }
+  /**
+   * Data contract (issue #3) — dump the selected workspace, or every
+   * workspace when omitted, as a `dsh-engram/export` v1 payload. The same
+   * format `POST /import` restores, so the dump is a portable backup.
+   */
+  async exportData(workspace) {
+    return readJson(await fetch(`${API_PREFIX}/export${query({ workspace })}`));
+  }
+  /**
+   * Data contract (issue #3) — restore a dump. `merge` adds missing rows
+   * (idempotent), `replace` wipes the target workspace first (the host then
+   * requires `confirm: "restore"`). `dryRun` plans without writing.
+   */
+  async importData(body) {
+    return readJson(
+      await fetch(`${API_PREFIX}/import`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body)
+      })
+    );
+  }
   /** Settings card transport — read the `dsh-engram` namespace through our
    *  own HTTP API instead of the host connection/remote RPC. */
   async getSettings() {
@@ -2254,7 +2276,7 @@ function gapsOf(t) {
   if (!t.memoryRefs || t.memoryRefs.length === 0) gaps.push("memory_ref");
   return gaps;
 }
-function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMemory, onChanged }) {
+function EngramDetail({ target, api, tasks, nodes, links, memories = [], onClose, onNavigateMemory, onChanged }) {
   const { dark, vars } = useEngramTheme();
   const [gArt, setGArt] = (0, import_react6.useState)("");
   const [gEval, setGEval] = (0, import_react6.useState)("");
@@ -2274,6 +2296,15 @@ function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMem
     if (target.kind !== "node" || !node) return [];
     return links.filter((l) => l.source === node.id || l.target === node.id).map((l) => ({ l, outgoing: l.source === node.id }));
   }, [links, node, target.kind]);
+  const memoryLinks = (0, import_react6.useMemo)(() => {
+    if (target.kind !== "memory") return null;
+    const m = target.memory;
+    return {
+      m,
+      replacedBy: memories.filter((x) => x.status === "active" && x.supersedes === m.id),
+      contradictedBy: memories.filter((x) => x.status === "active" && x.contradicts === m.id)
+    };
+  }, [target, memories]);
   const hb2 = {
     root: {
       ...vars,
@@ -2304,6 +2335,8 @@ function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMem
     badge: { fontSize: 10.5, fontWeight: 700, padding: "2px 8px", borderRadius: 999, color: "#fff" },
     tag: { fontSize: 11, padding: "1px 8px", borderRadius: 999, background: "var(--dsh-color-hover-bg, #f3f4f6)", color: "var(--dsh-color-muted, #6b7280)", border: "1px solid var(--dsh-color-border, #e5e7eb)" },
     chip: { fontSize: 11, padding: "2px 9px", borderRadius: 999, background: "rgba(37,99,235,.1)", color: "#2563eb", border: "1px solid rgba(37,99,235,.25)", cursor: "pointer" },
+    chipSup: { fontSize: 11, padding: "2px 9px", borderRadius: 999, background: "rgba(124,58,237,.1)", color: "#7c3aed", border: "1px solid rgba(124,58,237,.25)", cursor: "pointer" },
+    chipDanger: { fontSize: 11, padding: "2px 9px", borderRadius: 999, background: "rgba(220,38,38,.1)", color: "#dc2626", border: "1px solid rgba(220,38,38,.25)", cursor: "pointer" },
     input: { fontSize: 12, padding: "5px 8px", border: "1px solid var(--dsh-color-border, #d1d5db)", borderRadius: 8, background: "var(--dsh-color-surface, #ffffff)", color: "var(--dsh-color-muted-strong, #374151)", width: "100%", boxSizing: "border-box" },
     btn: { fontSize: 11.5, fontWeight: 600, padding: "5px 10px", borderRadius: 8, cursor: "pointer", border: "1px solid var(--dsh-color-border, #d1d5db)", background: "transparent", color: "var(--dsh-color-muted-strong, #374151)" },
     btnPrimary: { fontSize: 11.5, fontWeight: 700, padding: "5px 12px", borderRadius: 8, cursor: "pointer", border: "none", background: "#2563eb", color: "#fff" },
@@ -2442,6 +2475,29 @@ function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMem
             t
           ] }, t)) })
         ] }),
+        memoryLinks && (memoryLinks.m.supersedes || memoryLinks.m.contradicts || memoryLinks.replacedBy.length > 0 || memoryLinks.contradictedBy.length > 0) && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: hb2.section, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { style: hb2.k, children: "\u66FF\u6362 / \u51B2\u7A81" }),
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: { display: "flex", gap: 5, flexWrap: "wrap", marginTop: 3 }, children: [
+            memoryLinks.m.supersedes && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { style: hb2.chipSup, title: `\u672C\u6761\u66FF\u4EE3 ${memoryLinks.m.supersedes}\uFF08\u65E7\u884C\u4FDD\u7559\u3001\u53EC\u56DE\u964D\u7EA7\uFF09`, onClick: () => onNavigateMemory(memoryLinks.m.supersedes), children: [
+              "\u66FF\u4EE3 #",
+              memoryLinks.m.supersedes.slice(0, 8)
+            ] }),
+            memoryLinks.m.contradicts && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { style: hb2.chipDanger, title: `\u672C\u6761\u4E0E ${memoryLinks.m.contradicts} \u51B2\u7A81\uFF08\u4E24\u6761\u90FD\u4FDD\u7559\uFF09`, onClick: () => onNavigateMemory(memoryLinks.m.contradicts), children: [
+              "\u51B2\u7A81 #",
+              memoryLinks.m.contradicts.slice(0, 8)
+            ] }),
+            memoryLinks.replacedBy.map((x) => /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { style: hb2.chipSup, title: `\u5DF2\u88AB ${x.text.slice(0, 40)}\u2026 \u66FF\u4EE3`, onClick: () => onNavigateMemory(x.id), children: [
+              "\u2190 \u88AB #",
+              x.id.slice(0, 8),
+              " \u66FF\u4EE3"
+            ] }, x.id)),
+            memoryLinks.contradictedBy.map((x) => /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { style: hb2.chipDanger, title: `${x.text.slice(0, 40)}\u2026 \u4E0E\u672C\u6761\u51B2\u7A81`, onClick: () => onNavigateMemory(x.id), children: [
+              "\u21C4 #",
+              x.id.slice(0, 8),
+              " \u51B2\u7A81"
+            ] }, x.id))
+          ] })
+        ] }),
         /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: hb2.section, children: [
           /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { style: hb2.k, children: "\u5143\u6570\u636E" }),
           /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: 2, marginTop: 3, fontSize: 11.5, fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace", color: "var(--dsh-color-muted, #6b7280)" }, children: [
@@ -2469,6 +2525,18 @@ function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMem
               " \xB7 updated ",
               fmtDate(target.memory.updatedAt)
             ] }),
+            target.memory.source && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { children: [
+              "source ",
+              target.memory.source
+            ] }),
+            target.memory.conditions && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { children: [
+              "conditions ",
+              target.memory.conditions
+            ] }),
+            target.memory.filePath && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { children: [
+              "file ",
+              target.memory.filePath
+            ] }),
             /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { children: [
               "TTL ",
               daysLeft(target.memory.expiresAt)
@@ -2791,6 +2859,14 @@ function EngramSection({ api, t }) {
   const [closeEval, setCloseEval] = (0, import_react7.useState)("");
   const [closeRefs, setCloseRefs] = (0, import_react7.useState)("");
   const [closeBusy, setCloseBusy] = (0, import_react7.useState)(false);
+  const [importDump, setImportDump] = (0, import_react7.useState)(null);
+  const [importName, setImportName] = (0, import_react7.useState)("");
+  const [importMode, setImportMode] = (0, import_react7.useState)("merge");
+  const [importDryRun, setImportDryRun] = (0, import_react7.useState)(true);
+  const [importReplaceOk, setImportReplaceOk] = (0, import_react7.useState)(false);
+  const [importBusy, setImportBusy] = (0, import_react7.useState)(false);
+  const [importReport, setImportReport] = (0, import_react7.useState)(null);
+  const [dataError, setDataError] = (0, import_react7.useState)(null);
   const refresh = (0, import_react7.useCallback)(async () => {
     setBusy(true);
     setError(null);
@@ -2847,6 +2923,24 @@ function EngramSection({ api, t }) {
     for (const t2 of tasks) map.set(t2.id, t2.name);
     return (id) => map.get(id) ?? id;
   }, [nodes, tasks]);
+  const supersedeIndex = (0, import_react7.useMemo)(() => {
+    const replacedBy = /* @__PURE__ */ new Map();
+    const contradictedBy = /* @__PURE__ */ new Map();
+    for (const m of memories) {
+      if (m.status !== "active") continue;
+      if (m.supersedes) {
+        const list = replacedBy.get(m.supersedes) ?? [];
+        list.push(m);
+        replacedBy.set(m.supersedes, list);
+      }
+      if (m.contradicts) {
+        const list = contradictedBy.get(m.contradicts) ?? [];
+        list.push(m);
+        contradictedBy.set(m.contradicts, list);
+      }
+    }
+    return { replacedBy, contradictedBy };
+  }, [memories]);
   (0, import_react7.useEffect)(() => {
     if (!newTaskWs && workspaces.length > 0 && !workspace) setNewTaskWs(workspaces[0]);
   }, [newTaskWs, workspaces, workspace]);
@@ -2880,6 +2974,60 @@ function EngramSection({ api, t }) {
       setGcRunning(false);
     }
   };
+  const downloadExport = async () => {
+    setDataError(null);
+    try {
+      const dump = await api.exportData(workspace || void 0);
+      const blob = new Blob([JSON.stringify(dump, null, 2)], { type: "application/json" });
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement("a");
+      const safe = (workspace || "all").replace(/[^a-zA-Z0-9._-]+/g, "_");
+      a.href = url;
+      a.download = `dsh-engram-export-${safe}-${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}.json`;
+      a.click();
+      URL.revokeObjectURL(url);
+    } catch (e) {
+      setDataError(e instanceof Error ? e.message : String(e));
+    }
+  };
+  const pickImportFile = async (file) => {
+    setDataError(null);
+    setImportReport(null);
+    setImportDump(null);
+    setImportName("");
+    if (!file) return;
+    try {
+      const text = await file.text();
+      setImportDump(JSON.parse(text));
+      setImportName(file.name);
+    } catch (e) {
+      setDataError(`\u65E0\u6CD5\u89E3\u6790 ${file.name}\uFF1A${e instanceof Error ? e.message : String(e)}`);
+    }
+  };
+  const runImport = async () => {
+    if (importDump === null) return;
+    if (importMode === "replace" && !importReplaceOk) {
+      setDataError("\u66FF\u6362\u6A21\u5F0F\u4F1A\u5148\u6E05\u7A7A\u76EE\u6807\u5DE5\u4F5C\u533A \u2014 \u8BF7\u5148\u52FE\u9009\u786E\u8BA4");
+      return;
+    }
+    setImportBusy(true);
+    setDataError(null);
+    try {
+      const report = await api.importData({
+        payload: importDump,
+        mode: importMode,
+        dryRun: importDryRun,
+        workspace: workspace || void 0,
+        confirm: importMode === "replace" ? "restore" : void 0
+      });
+      setImportReport(report);
+      if (!report.dryRun) await refresh();
+    } catch (e) {
+      setDataError(e instanceof Error ? e.message : String(e));
+    } finally {
+      setImportBusy(false);
+    }
+  };
   const groupedRows = workspace === "" ? groupByWorkspace(memories) : [[workspace, memories]];
   const taskGroups = workspace === "" ? groupByWorkspace(tasks) : [[workspace, tasks]];
   const linkGroups = workspace === "" ? groupByWorkspace(links) : [[workspace, links]];
@@ -3069,6 +3217,90 @@ function EngramSection({ api, t }) {
               ] }, l.id))
             ] })
           ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: s2.subPanel, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: 10, flexWrap: "wrap" }, children: [
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { fontWeight: 700, fontSize: 13 }, children: "\u6570\u636E\u5907\u4EFD\uFF08export / import\uFF09" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { style: s2.btn, title: "\u4E0B\u8F7D\u5F53\u524D\u5DE5\u4F5C\u533A\uFF08\u6216\u5168\u90E8\uFF09\u7684 dsh-engram/export v1 \u8F6C\u50A8", onClick: () => void downloadExport(), children: "\u5BFC\u51FA JSON" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("label", { style: { ...s2.btn, display: "inline-flex", alignItems: "center", gap: 6, cursor: "pointer" }, children: [
+                "\u9009\u62E9\u5BFC\u5165\u6587\u4EF6\u2026",
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+                  "input",
+                  {
+                    type: "file",
+                    accept: "application/json,.json",
+                    style: { display: "none" },
+                    onChange: (e) => {
+                      void pickImportFile(e.target.files?.[0] ?? null);
+                      e.currentTarget.value = "";
+                    }
+                  }
+                )
+              ] }),
+              importName && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: s2.mono, children: importName })
+            ] }),
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { fontSize: 11.5, color: "var(--dsh-color-muted, #6b7280)", marginTop: 4 }, children: [
+              "\u5BFC\u51FA\u5373\u53EF\u79FB\u690D\u5907\u4EFD\uFF08\u8BB0\u5FC6/\u4EFB\u52A1/\u5173\u7CFB/\u8282\u70B9\uFF0C\u542B\u5F52\u6863\uFF09\uFF1B",
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("b", { children: "merge" }),
+              " \u53EA\u8865\u7F3A\u5931\uFF08\u5E42\u7B49\uFF09\uFF0C",
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("b", { children: "replace" }),
+              " \u5148\u6E05\u7A7A\u76EE\u6807\u5DE5\u4F5C\u533A\u518D\u6062\u590D\u3002\u8BB0\u5FC6\u6B63\u6587\u4E0E\u6240\u6709\u5199\u5165\u8DEF\u5F84\u4E00\u6837\u8FC7\u8131\u654F\u3002"
+            ] }),
+            importDump !== null && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { marginTop: 8, display: "flex", flexDirection: "column", gap: 6 }, children: [
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { display: "flex", gap: 10, alignItems: "center", flexWrap: "wrap", fontSize: 12.5 }, children: [
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("label", { style: { display: "inline-flex", gap: 4, alignItems: "center" }, children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("input", { type: "checkbox", checked: importDryRun, onChange: (e) => setImportDryRun(e.target.checked) }),
+                  "\u4EC5\u9884\u89C8\uFF08dry run\uFF09"
+                ] }),
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
+                  "select",
+                  {
+                    style: s2.input,
+                    value: importMode,
+                    onChange: (e) => {
+                      const mode = e.target.value;
+                      setImportMode(mode);
+                      if (mode !== "replace") setImportReplaceOk(false);
+                    },
+                    children: [
+                      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("option", { value: "merge", children: "\u5408\u5E76\uFF08merge\uFF0C\u5E42\u7B49\uFF09" }),
+                      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("option", { value: "replace", children: "\u66FF\u6362\uFF08replace\uFF0C\u5148\u6E05\u7A7A\u5DE5\u4F5C\u533A\uFF09" })
+                    ]
+                  }
+                ),
+                importMode === "replace" && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("label", { style: { display: "inline-flex", gap: 4, alignItems: "center", color: "#b45309" }, children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("input", { type: "checkbox", checked: importReplaceOk, onChange: (e) => setImportReplaceOk(e.target.checked) }),
+                  "\u6211\u786E\u8BA4\u66FF\u6362",
+                  workspace ? `\uFF08${workspace}\uFF09` : "\uFF08\u9700\u5148\u9009\u5DE5\u4F5C\u533A\uFF09"
+                ] }),
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+                  "button",
+                  {
+                    style: s2.btnPrimary,
+                    disabled: importBusy || importMode === "replace" && (!importReplaceOk || !workspace),
+                    onClick: () => void runImport(),
+                    children: importBusy ? "\u2026" : importDryRun ? "\u9884\u89C8\u5BFC\u5165" : "\u6267\u884C\u5BFC\u5165"
+                  }
+                )
+              ] }),
+              importReport && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { fontSize: 12.5 }, children: [
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { children: [
+                  importReport.dryRun ? "dry-run \u9884\u89C8\uFF1A" : "\u5DF2\u5BFC\u5165\uFF1A",
+                  " ",
+                  Object.entries(importReport.written).map(([k, v]) => `${k} ${v}`).join(" \xB7 ") || "\u2014",
+                  importReport.skipped.length > 0 ? ` \xB7 \u8DF3\u8FC7 ${importReport.skipped.length}` : ""
+                ] }),
+                importReport.skipped.slice(0, 5).map((x, i) => /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: s2.mono, children: [
+                  "- ",
+                  x.table,
+                  " ",
+                  x.id ? x.id.slice(0, 8) : "?",
+                  ": ",
+                  x.reason
+                ] }, `${x.table}-${x.id ?? i}`))
+              ] }),
+              dataError && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { style: { fontSize: 12, color: "#dc2626", fontWeight: 600 }, children: dataError })
+            ] })
+          ] }),
           /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: s2.row, children: [
             /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("select", { style: s2.input, value: kind, onChange: (e) => setKind(e.target.value), children: [
               /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("option", { value: "", children: "\u5168\u90E8\u7C7B\u578B" }),
@@ -3142,7 +3374,8 @@ function EngramSection({ api, t }) {
                 ] }) }, `h-${r.ws}`) : /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("tr", { children: [
                   /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("td", { style: { ...s2.td, whiteSpace: "nowrap" }, children: [
                     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { ...s2.badge, background: KIND_COLORS2[r.m.kind] ?? "#6b7280" }, children: KIND_LABEL2[r.m.kind] ?? r.m.kind }),
-                    r.m.status === "archived" && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { ...s2.tag, color: "#b45309", background: "#fef3c7" }, children: "archived" })
+                    r.m.status === "archived" && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { ...s2.tag, color: "#b45309", background: "#fef3c7" }, children: "archived" }),
+                    supersedeIndex.replacedBy.has(r.m.id) && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { ...s2.tag, color: "#b45309", background: "#fef3c7" }, title: `\u5DF2\u88AB ${(supersedeIndex.replacedBy.get(r.m.id) ?? []).map((x) => `#${x.id.slice(0, 8)}`).join(", ")} \u66FF\u4EE3\uFF08\u65E7\u884C\u4FDD\u7559\u3001\u53EC\u56DE\u964D\u7EA7\uFF09`, children: "\u5DF2\u66FF\u6362" })
                   ] }),
                   /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("td", { style: { ...s2.td, minWidth: 0 }, children: [
                     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { title: r.m.text, style: expandedRows.has(r.m.id) ? s2.expanded : s2.clamp3, children: r.m.text }),
@@ -3159,7 +3392,11 @@ function EngramSection({ api, t }) {
                         " \xB7 ",
                         daysLeft2(r.m.expiresAt)
                       ] }),
-                      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { style: s2.linkBtn, onClick: () => toggleExpand(r.m.id), children: expandedRows.has(r.m.id) ? "\u6536\u8D77" : "\u5C55\u5F00\u5168\u6587" })
+                      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { style: s2.linkBtn, onClick: () => toggleExpand(r.m.id), children: expandedRows.has(r.m.id) ? "\u6536\u8D77" : "\u5C55\u5F00\u5168\u6587" }),
+                      r.m.supersedes && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("button", { style: s2.linkBtn, title: `\u6253\u5F00\u88AB\u66FF\u4EE3\u7684\u65E7\u8BB0\u5FC6 ${r.m.supersedes}`, onClick: () => openMemory(r.m.supersedes), children: [
+                        "\u66FF\u4EE3 #",
+                        r.m.supersedes.slice(0, 8)
+                      ] })
                     ] }),
                     r.m.tags.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { style: { marginTop: 3, display: "flex", flexWrap: "wrap", gap: 4 }, children: r.m.tags.map((tag) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: s2.tag, children: tag }, tag)) })
                   ] }),
@@ -3359,6 +3596,7 @@ ${r.m.text.slice(0, 60)}`)) void act(() => api.remove(r.m.id, r.m.workspace));
             tasks,
             nodes,
             links,
+            memories,
             onClose: () => setDetail(null),
             onNavigateMemory: openMemory,
             onChanged: () => void refresh()

package/lib/session-cjk.js

@@ -22,7 +22,7 @@
 import fs from "node:fs";
 import path from "node:path";
 
-import { decodeZstd, sessionsRoot } from "./usage.js";
+import { decodeZstd, sessionLogFile, sessionsRoot } from "./usage.js";
 import { redactText } from "./redact.js";
 
 /** CJK ideographs (incl. Ext-A and compatibility ideographs). */
@@ -135,7 +135,7 @@ export function searchSessionsCJK({
   }
   const files = [];
   for (const sid of sids) {
-    const file = path.join(bucketDir, sid, "session.jsonl.zstd");
+    const file = sessionLogFile(path.join(bucketDir, sid));
     let st;
     try {
       st = fs.statSync(file);

package/lib/usage.js

@@ -7,8 +7,8 @@
  * on every engram/esr tool call, and a separate session-log scan that counted
  * tool calls (to include the built-in `todo` tool). Both are now ONE module:
  * both /stats and /toolstats answer from the canonical log stream
- * `~/.dsh/sessions/<bucket>/<sid>/session.jsonl.zstd`, decompressed on demand
- * with a short TTL cache. No tool call pays a write anymore (pure GUI-side
+ * `~/.dsh/sessions/<bucket>/<sid>/session[.v<N>].jsonl.zstd`, decompressed on
+ * demand with a short TTL cache. No tool call pays a write anymore (pure GUI-side
  * observability), and the log stream is the single source of truth.
  *
  * Zero external dependency: Node >=22.19 provides the zstd codec in
@@ -44,6 +44,49 @@ export function sessionsRoot() {
   return path.join(os.homedir(), ".dsh", "sessions");
 }
 
+/**
+ * Session log file names: current DSH stamps the session format version into
+ * the name (`session.v3.jsonl.zstd` on 0.1.x, `session.v4.jsonl.zstd` on 0.2);
+ * older releases used the unversioned `session.jsonl.zstd` (issue #8).
+ */
+const SESSION_LOG_RE = /^session(?:\.v\d+)?\.jsonl\.zstd$/;
+
+/**
+ * Resolve the log file inside one session directory.
+ *
+ * A directory normally holds exactly one log, but a session migrated across
+ * format versions can hold both a v3 and a v4 file (and a legacy unversioned
+ * one). The newest-mtime match wins — that is the file the host is currently
+ * appending to. When nothing matches, the historical unversioned name is
+ * returned so callers keep their existing ENOENT handling (`statSync` throws →
+ * session skipped) instead of silently scanning the wrong corpus.
+ */
+export function sessionLogFile(dir) {
+  let names;
+  try {
+    names = fs.readdirSync(dir);
+  } catch {
+    return path.join(dir, "session.jsonl.zstd");
+  }
+  let best = null;
+  let bestMtime = -1;
+  for (const name of names) {
+    if (!SESSION_LOG_RE.test(name)) continue;
+    let st;
+    try {
+      st = fs.statSync(path.join(dir, name));
+    } catch {
+      continue; // unreadable entry: ignore
+    }
+    if (!st.isFile()) continue;
+    if (st.mtimeMs > bestMtime) {
+      bestMtime = st.mtimeMs;
+      best = name;
+    }
+  }
+  return path.join(dir, best ?? "session.jsonl.zstd");
+}
+
 /** Byte range of one structurally complete zstd frame in a concatenated stream. */
 function frameRanges(buffer) {
   const frames = [];
@@ -244,7 +287,7 @@ export function collectToolCounts({ root = sessionsRoot(), days = 14, now = Date
   for (const bucket of buckets) {
     const bdir = path.join(root, bucket);
     for (const sid of listDirOrEmpty(bdir)) {
-      const file = path.join(bdir, sid, "session.jsonl.zstd");
+      const file = sessionLogFile(path.join(bdir, sid));
       let st;
       try {
         st = fs.statSync(file);
@@ -330,7 +373,7 @@ export function collectUsageStats({ root = sessionsRoot(), days = 14, now = Date
   const buckets = listDirOrEmpty(root).filter((b) => b.startsWith("--"));
   for (const bucket of buckets) {
     for (const sid of listDirOrEmpty(path.join(root, bucket))) {
-      const file = path.join(root, bucket, sid, "session.jsonl.zstd");
+      const file = sessionLogFile(path.join(root, bucket, sid));
       let st;
       try {
         st = fs.statSync(file);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-engram",
   "description": "Minimalist long-term memory for DeepSeek Harness, distilling symbolic-index + pi-esr ideas: zero-LLM auto-capture, a symbolic [ENGRAM] index with progressive disclosure, and an ESR-lite evidence-closure protocol (esr_task / esr_node / esr_close / esr_link). Real agent-behaviour telemetry (usage rollup + /stats) and a deterministic offline recall benchmark (npm run eval). Hot path is model-free; storage on ctx.storageDomain; web memory viewer, observability panel and config card through DSH's native settings slots.",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "packageManager": "pnpm@11.22.0",
   "license": "MIT",
   "repository": {