dsh-trivium 0.4.7 → 0.4.8

package/lib/client.js

@@ -9,69 +9,333 @@ window.__ModuleLoader__.load({
     const { jsx, jsxs } = require("react/jsx-runtime");
     const { Button } = require("@deepseek-ai/dsh-client-ui-primitives");
 
-    const L = {
-      nav: "Trivium 记忆",
-      sub: "按节点和边记。默认不自动灌全文。归档后 find 不再返回；删除从 .tdb 去掉且不可恢复。",
-      loading: "加载中…",
-      empty: "还没有打开过工作区，或当前库为空。",
-      path: "当前 .tdb",
-      nodes: "节点数",
-      tokens: "上次短地图 token",
-      recall: "注入策略（三选一，默认关）",
-      recallHint: "与 autoRecall、实体名折中互斥。改完点右上角保存。",
-      recallOff: "关（默认）",
-      recallOffHint: "仅 session-start 短地图（≤400 token）。模型自行 ctx_find / ctx_read。",
-      recallAuto: "autoRecall",
-      recallAutoHint: "本步含直接用户文本时注入最多 3 条 L0（≤300 token）。不调用 ctx_find 工具。",
-      recallAnchor: "实体名折中",
-      recallAnchorHint: "用户文本命中已有 entity 的 name/aliases 时，注入该实体 1 跳 about/decided/broke/fixed 邻居（≤300 token）。",
-      extract: "compaction/end 抽取",
-      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: "已就绪",
-      embedWait: "未就绪：打开开关并填写 http(s) URL 后保存。",
-      embedUrl: "Embedding URL",
-      embedModel: "模型",
-      embedKey: "API Key",
-      embedKeyHint: "已保存则留空不改。也可设环境变量 DSH_TRIVIUM_EMBED_KEY。",
-      embedBackfill: "回填已有节点向量",
-      list: "记忆条目",
-      filter: "类型",
-      search: "搜索",
-      all: "全部",
-      archive: "归档",
-      remove: "删除",
-      saveNode: "保存条目",
-      merge: "合并进来",
-      mergePick: "并入本条…",
-      exportJson: "导出 JSON",
-      importJson: "导入 JSON",
-      archiveHint: "归档：软删除，find / 短地图不再出现。删除：从库里去掉，不可恢复。合并：同类型节点并入本条，对方 same_as 后归档。",
-      save: "保存设置",
-      saved: "已保存",
-      refresh: "刷新",
-      noMatch: "没有匹配的节点。换个关键词，或清空搜索。",
-      showStale: "显示过期决策",
-      neighbors: "邻居（业务边）",
-      aboutThis: "只看挂在这上面的",
-      aboutOn: "正在看挂在",
-      clearAbout: "返回全部",
-      stale: "过期",
-      until: "until",
-      name: "名称",
-      text: "正文",
-      aliases: "别名",
+    const I18N = {
+      zh: {
+        nav: "Trivium 记忆",
+        sub: "按节点和边记。默认不自动灌全文。归档后 find 不再返回；删除从 .tdb 去掉且不可恢复。",
+        loading: "加载中…",
+        empty: "还没有打开过工作区，或当前库为空。",
+        path: "当前 .tdb",
+        nodes: "节点数",
+        tokens: "上次短地图 token",
+        recall: "注入策略（三选一，默认关）",
+        recallHint: "与 autoRecall、实体名折中互斥。改完点右上角保存。",
+        recallOff: "关（默认）",
+        recallOffHint: "仅 session-start 短地图（≤400 token）。模型自行 ctx_find / ctx_read。",
+        recallAuto: "autoRecall",
+        recallAutoHint: "本步含直接用户文本时注入最多 3 条 L0（≤300 token）。不调用 ctx_find 工具。",
+        recallAnchor: "实体名折中",
+        recallAnchorHint: "用户文本命中已有 entity 的 name/aliases 时，注入该实体 1 跳 about/decided/broke/fixed 邻居（≤300 token）。",
+        extract: "compaction/end 抽取",
+        extractHint: "规则 + 一次小 prompt；失败只记日志。turn 结束后约 12 秒空闲会再抽一次，下次 session-start 也会重放 pending。每轮写入正文合计 ≤3000 字、最多 24 条。",
+        markdown: "Markdown 投影",
+        markdownHint: "只读导出，带边（- 鉴权走 header X —about→ AuthGateway）。给编辑器和 git 看。改完回写用 JSON 导入或本页编辑，不解析自由散文。",
+        exportMd: "导出 Markdown",
+        external: "外部记忆一次性导入",
+        externalHint: "发现 WorkBuddy MEMORY.md、Claude Code CLAUDE.md、Codex AGENTS.md。偏严宁漏：闲聊、一次性改文件、密钥、乱码、工具 dump、无规则线索的段落跳过。不持续同步，不导入会话 jsonl。每批同样 ≤3000 字 / 24 条。",
+        externalImport: "导入找到的文件",
+        externalNone: "当前没有找到这些文件。",
+        externalFound: "找到",
+        update: "检查更新",
+        updateHint: "对比本机安装版本和 npm 上的 latest。有新版时给出安装命令，不会在后台自动升级。",
+        updateChecking: "正在检查…",
+        updateCurrent: "已是最新",
+        updateNewer: "有新版本",
+        updateInstalled: "已安装",
+        updateLatest: "npm latest",
+        updateFailed: "暂时查不到 registry",
+        embed: "远程 embedding（OpenAI 兼容，默认关）",
+        embedHint: "失败退回关键词 + 图检索。需单独的 embeddings endpoint；官方 DeepSeek chat API 不含 embedding。",
+        embedReady: "已就绪",
+        embedWait: "未就绪：打开开关并填写 http(s) URL 后保存。",
+        embedUrl: "Embedding URL",
+        embedModel: "模型",
+        embedKey: "API Key",
+        embedKeyHint: "已保存则留空不改。也可设环境变量 DSH_TRIVIUM_EMBED_KEY。",
+        embedBackfill: "回填已有节点向量",
+        list: "记忆条目",
+        filter: "类型",
+        search: "搜索",
+        all: "全部",
+        archive: "归档",
+        remove: "删除",
+        saveNode: "保存条目",
+        merge: "合并进来",
+        mergePick: "并入本条…",
+        exportJson: "导出 JSON",
+        importJson: "导入 JSON",
+        archiveHint: "归档：软删除，find / 短地图不再出现。删除：从库里去掉，不可恢复。合并：同类型节点并入本条，对方 same_as 后归档。",
+        save: "保存设置",
+        saved: "已保存",
+        savedKey: "已保存",
+        refresh: "刷新",
+        noMatch: "没有匹配的节点。换个关键词，或清空搜索。",
+        showStale: "显示过期决策",
+        neighbors: "邻居（业务边）",
+        aboutThis: "只看挂在这上面的",
+        aboutOn: "正在看挂在",
+        clearAbout: "返回全部",
+        stale: "过期",
+        dirty: "脏",
+        until: "until",
+        name: "名称",
+        text: "正文",
+        aliases: "别名",
+        aliasesPh: "逗号分隔",
+        untilPh: "周五 / 下周 / ISO",
+        searchPh: "鉴权 / until / about",
+        importOk: "导入 {created} 新建 / {merged} 合并，跳过 {skipped}",
+        importFail: "导入失败",
+        justNow: "刚刚",
+        minutesAgo: "{n} 分钟前",
+        hoursAgo: "{n} 小时前",
+        daysAgo: "{n} 天前",
+        boxNext: "后续",
+        boxFork: "分支",
+        boxCheck: "检查点",
+        forkDefault: "分叉 (1)",
+        forkName: "分叉",
+        trajectory: "轨迹",
+        fork: "分叉",
+        openChat: "打开对话",
+        chatShort: "对",
+        boxTitle: "方框标题",
+        renameHint: "双击改名",
+        rename: "改名",
+        noSummary: "（尚无摘要）",
+        backfillNone: "没有发现压缩标记或分叉。没压过的会话本来就只有「后续」。要分段请点「生成检查点」。",
+        backfillOk: "已同步 {checks} 个检查点、{forks} 条分叉。",
+        cutNeedTurn: "当前对话还没有可切的轮次。先在对话里发一条，再生成检查点。",
+        cutOk: "已把当前「后续」收成左边一格（seq {seq}），右边仍是后续。这不压缩 DSH 上下文。",
+        cutDup: "这个位置已经切过了（seq {seq}）。再聊几轮后再生成。",
+        forkOpenFail: "无法打开分叉会话：会话图没有拿到 session.open",
+        chatViewFail: "无法切换到对话页：会话图没有拿到同一 chat store 的 setView",
+        trajViewFail: "无法切换到轨迹页：会话图没有拿到同一 chat store 的 setView",
+        noFork: "当前壳没有 session.fork",
+        renameFail: "会话已分叉，但侧边栏改名失败：{err}",
+        deleteConfirm: "删除会从 .tdb 里拿掉这 {n} 条，不可恢复。归档只是藏起来，find / 短地图 / 芯片都不再出现。确定删除？",
+        sessionMap: "会话图",
+        chips: "记忆芯片",
+        chipsHint: "共 {n} 条，已钉 {pins}。默认不勾选：不钉就不会按芯片白名单注入，但仍可能被开场短地图点名带上，模型也能 find 到。",
+        cutBtn: "生成检查点",
+        cutting: "生成中…",
+        cutTitle: "把当前「后续」收成左边一格，右边继续当后续。只切情节图，不触发 DSH 压缩。要压上下文请在对话里输入 /compact。",
+        updateBtn: "更新检查点",
+        updating: "更新中…",
+        updateTitle: "读取当前对话里 DSH 已有的压缩标记和侧边栏分叉，补进图。没压过就补不出历史方框。",
+        collapse: "收起",
+        expand: "展开勾选",
+        searchChips: "搜索芯片",
+        inheritPins: "分叉时继承钉选",
+        addChip: "新增",
+        cancelAdd: "取消新增",
+        select: "选择",
+        cancelSelect: "取消选择",
+        chipSelectHint: "点芯片多选。归档：软删除，find / 短地图 / 芯片不再出现，节点还在库里。删除：从 .tdb 去掉，不可恢复。",
+        chipClipped: "已截到预算（≤300 token）",
+        chipPinHint: "勾选后从当前这段的下一轮注入。空白处拖动画布，滚轮缩放。",
+        chipDraftPh: "粘贴或输入要记住的内容。点一次写入，整段就是一条芯片。",
+        writePin: "写入并钉选",
+        suggested: "建议",
+        noChipMatch: "没有匹配的芯片。",
+        noChips: "还没有可钉选的 preference / decision / entity。用「新增」写一条。",
+        forkDialog: "分叉为新会话",
+        forkDialogHint: "这个名字会出现在左侧会话列表里。",
+        newSessionName: "新会话名称",
+        cancel: "取消",
+        forking: "分叉中…",
+        noRename: "当前壳没有 session.rename",
+      },
+      en: {
+        nav: "Trivium memory",
+        sub: "Stored as nodes and edges. Full text is not auto-injected. Archive hides from find; delete removes from .tdb and cannot be undone.",
+        loading: "Loading…",
+        empty: "No workspace is open, or the store is empty.",
+        path: "Current .tdb",
+        nodes: "Nodes",
+        tokens: "Last short-map tokens",
+        recall: "Injection (pick one, default off)",
+        recallHint: "autoRecall and entity-name path are mutually exclusive. Save in the top-right when done.",
+        recallOff: "Off (default)",
+        recallOffHint: "Session-start short map only (≤400 tokens). The model calls ctx_find / ctx_read itself.",
+        recallAuto: "autoRecall",
+        recallAutoHint: "When the step has user text, inject at most 3 L0 hits (≤300 tokens). Does not call ctx_find.",
+        recallAnchor: "Entity-name path",
+        recallAnchorHint: "When user text names an existing entity, inject 1-hop about/decided/broke/fixed neighbors (≤300 tokens).",
+        extract: "Extract on compaction/end",
+        extractHint: "Rules + one small prompt; failures are logged. Idle ~12s after turn/end also extracts; pending replays on next session-start. Per batch: body ≤3000 chars, at most 24 items.",
+        markdown: "Markdown projection",
+        markdownHint: "Read-only export with edges (e.g. - auth in header X —about→ AuthGateway). For editors and git. Write back with JSON import or this page, not free prose.",
+        exportMd: "Export Markdown",
+        external: "One-shot external import",
+        externalHint: "Discovers WorkBuddy MEMORY.md, Claude Code CLAUDE.md, and Codex AGENTS.md. Strict: skip chitchat, one-off file edits, secrets, mojibake, tool dumps, and lines with no rule cue. No watch, no session jsonl. Same cap: ≤3000 chars / 24 items.",
+        externalImport: "Import found files",
+        externalNone: "None of these files were found.",
+        externalFound: "Found",
+        update: "Check for updates",
+        updateHint: "Compare the installed version with npm latest. If a newer version exists, the install command is shown — it does not auto-upgrade.",
+        updateChecking: "Checking…",
+        updateCurrent: "Up to date",
+        updateNewer: "Update available",
+        updateInstalled: "Installed",
+        updateLatest: "npm latest",
+        updateFailed: "Registry unavailable",
+        embed: "Remote embedding (OpenAI-compatible, off by default)",
+        embedHint: "Failures fall back to keyword + graph search. Needs a separate embeddings endpoint; the official DeepSeek chat API has none.",
+        embedReady: "Ready",
+        embedWait: "Not ready: turn on and fill an http(s) URL, then save.",
+        embedUrl: "Embedding URL",
+        embedModel: "Model",
+        embedKey: "API Key",
+        embedKeyHint: "Leave blank to keep the saved key. Or set DSH_TRIVIUM_EMBED_KEY.",
+        embedBackfill: "Backfill vectors",
+        list: "Memory entries",
+        filter: "Type",
+        search: "Search",
+        all: "All",
+        archive: "Archive",
+        remove: "Delete",
+        saveNode: "Save entry",
+        merge: "Merge in",
+        mergePick: "Merge into this…",
+        exportJson: "Export JSON",
+        importJson: "Import JSON",
+        archiveHint: "Archive: soft delete, gone from find / short map. Delete: removed from the store, not recoverable. Merge: same-type node into this one; the other is same_as then archived.",
+        save: "Save settings",
+        saved: "Saved",
+        savedKey: "Saved",
+        refresh: "Refresh",
+        noMatch: "No matching nodes. Try another keyword, or clear the search.",
+        showStale: "Show expired decisions",
+        neighbors: "Neighbors (business edges)",
+        aboutThis: "Only nodes hanging on this",
+        aboutOn: "Showing nodes on",
+        clearAbout: "Back to all",
+        stale: "expired",
+        dirty: "dirty",
+        until: "until",
+        name: "Name",
+        text: "Body",
+        aliases: "Aliases",
+        aliasesPh: "comma-separated",
+        untilPh: "Friday / next week / ISO",
+        searchPh: "auth / until / about",
+        importOk: "Imported {created} new / {merged} merged, skipped {skipped}",
+        importFail: "Import failed",
+        justNow: "just now",
+        minutesAgo: "{n} min ago",
+        hoursAgo: "{n} h ago",
+        daysAgo: "{n} d ago",
+        boxNext: "Next",
+        boxFork: "Branch",
+        boxCheck: "Checkpoint",
+        forkDefault: "Fork (1)",
+        forkName: "Fork",
+        trajectory: "Trajectory",
+        fork: "Fork",
+        openChat: "Open conversation",
+        chatShort: "C",
+        boxTitle: "Box title",
+        renameHint: "Double-click to rename",
+        rename: "Rename",
+        noSummary: "(no summary yet)",
+        backfillNone: "No compaction markers or forks. A never-compacted session only has Next. Split with Create checkpoint.",
+        backfillOk: "Synced {checks} checkpoints, {forks} forks.",
+        cutNeedTurn: "This conversation has no turn to cut yet. Send a message, then create a checkpoint.",
+        cutOk: "Folded current Next into a left box (seq {seq}). Right side is still Next. This does not compact DSH context.",
+        cutDup: "Already cut at seq {seq}. Chat a few more turns, then create another.",
+        forkOpenFail: "Cannot open the forked session: session map has no session.open",
+        chatViewFail: "Cannot switch to Conversation: session map has no shared chat store setView",
+        trajViewFail: "Cannot switch to Trajectory: session map has no shared chat store setView",
+        noFork: "This host has no session.fork",
+        renameFail: "Session forked, but sidebar rename failed: {err}",
+        deleteConfirm: "Delete removes these {n} nodes from .tdb and cannot be undone. Archive only hides them from find / short map / chips. Delete anyway?",
+        sessionMap: "Session graph",
+        chips: "Memory chips",
+        chipsHint: "{n} chips, {pins} pinned. Unchecked by default: pinning is a whitelist, but the short map may still name them and the model can still find them.",
+        cutBtn: "Create checkpoint",
+        cutting: "Creating…",
+        cutTitle: "Fold current Next into a left box; the right side stays Next. Plot only — does not compact DSH. Type /compact in the conversation to compact context.",
+        updateBtn: "Update checkpoints",
+        updating: "Updating…",
+        updateTitle: "Read DSH compression markers and sidebar forks in this conversation and backfill the graph. Never compacted still means only Next.",
+        collapse: "Collapse",
+        expand: "Expand to pin",
+        searchChips: "Search chips",
+        inheritPins: "Inherit pins on fork",
+        addChip: "Add",
+        cancelAdd: "Cancel add",
+        select: "Select",
+        cancelSelect: "Cancel select",
+        chipSelectHint: "Click chips to multi-select. Archive: soft delete, gone from find / short map / chips, node stays in .tdb. Delete: removed from .tdb, not recoverable.",
+        chipClipped: "Clipped to budget (≤300 tokens)",
+        chipPinHint: "Checked chips inject from the next turn of this segment. Drag empty canvas to pan, scroll to zoom.",
+        chipDraftPh: "Paste or type a fact. One click writes one chip; a whole paste is still one node.",
+        writePin: "Write and pin",
+        suggested: "suggested",
+        noChipMatch: "No matching chips.",
+        noChips: "No preference / decision / entity chips yet. Use Add to write one.",
+        forkDialog: "Fork as new session",
+        forkDialogHint: "This name appears in the left session list.",
+        newSessionName: "New session name",
+        cancel: "Cancel",
+        forking: "Forking…",
+        noRename: "This host has no session.rename",
+      },
     };
 
+    let uiLocale = "zh";
+    const localeListeners = new Set();
+
+    function normalizeLocale(value) {
+      const s = String(value || "").toLowerCase();
+      if (s.startsWith("en")) return "en";
+      if (s.startsWith("zh")) return "zh";
+      return "";
+    }
+
+    function setUiLocale(next) {
+      const loc = normalizeLocale(next) || "zh";
+      if (loc === uiLocale) return;
+      uiLocale = loc;
+      localeListeners.forEach((fn) => {
+        try {
+          fn();
+        } catch {
+          // ignore
+        }
+      });
+    }
+
+    function t(key, vars) {
+      let s = (I18N[uiLocale] && I18N[uiLocale][key]) || I18N.en[key] || I18N.zh[key] || key;
+      if (vars) {
+        Object.keys(vars).forEach((k) => {
+          s = s.split("{" + k + "}").join(String(vars[k]));
+        });
+      }
+      return s;
+    }
+
+    function useT() {
+      const [, bump] = react.useState(0);
+      react.useEffect(() => {
+        const fn = () => bump((n) => n + 1);
+        localeListeners.add(fn);
+        return () => localeListeners.delete(fn);
+      }, []);
+      return t;
+    }
+
+    const L = new Proxy(
+      {},
+      {
+        get(_target, key) {
+          return t(key);
+        },
+      },
+    );
+
     const TYPES = ["", "entity", "preference", "decision", "experience", "workspace"];
 
     const ui = {
@@ -131,6 +395,7 @@ window.__ModuleLoader__.load({
     }
 
     function TriviumCard() {
+      useT();
       const [status, setStatus] = react.useState(null);
       const [nodes, setNodes] = react.useState([]);
       const [type, setType] = react.useState("");
@@ -153,6 +418,8 @@ window.__ModuleLoader__.load({
       const fileRef = react.useRef(null);
       const [buddyFiles, setBuddyFiles] = react.useState([]);
       const [buddyNote, setBuddyNote] = react.useState("");
+      const [updateInfo, setUpdateInfo] = react.useState(null);
+      const [updateBusy, setUpdateBusy] = react.useState(false);
 
       const load = react.useCallback(async () => {
         setError("");
@@ -173,7 +440,7 @@ 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");
+          const wb = await api("/api/dsh-trivium/external");
           setBuddyFiles(wb.files || []);
         } catch (err) {
           setError(String(err.message || err));
@@ -317,19 +584,18 @@ window.__ModuleLoader__.load({
         setBusy(true);
         setBuddyNote("");
         try {
-          const r = await api("/api/dsh-trivium/import-workbuddy", {
+          const r = await api("/api/dsh-trivium/import-external", {
             method: "POST",
             headers: { "content-type": "application/json" },
             body: "{}",
           });
           setSaved(true);
           setBuddyNote(
-            "导入 " +
-              (r.created || 0) +
-              " 新建 / " +
-              (r.merged || 0) +
-              " 合并，跳过 " +
-              (r.skipped || 0),
+            t("importOk", {
+              created: r.created || 0,
+              merged: r.merged || 0,
+              skipped: r.skipped || 0,
+            }),
           );
           await load();
         } catch (err) {
@@ -339,6 +605,17 @@ window.__ModuleLoader__.load({
         }
       };
 
+      const checkUpdate = async () => {
+        setUpdateBusy(true);
+        try {
+          setUpdateInfo(await api("/api/dsh-trivium/update?force=1"));
+        } catch (err) {
+          setUpdateInfo({ ok: false, error: String(err.message || err) });
+        } finally {
+          setUpdateBusy(false);
+        }
+      };
+
       const importJson = async (file) => {
         if (!file) return;
         setBusy(true);
@@ -354,11 +631,11 @@ window.__ModuleLoader__.load({
           setError(
             r.ok
               ? ""
-              : String(r.message || "导入失败"),
+              : String(r.message || t("importFail")),
           );
           await load();
         } catch (err) {
-          setError("导入失败：" + String(err.message || err));
+          setError(t("importFail") + "：" + String(err.message || err));
         } finally {
           setBusy(false);
           if (fileRef.current) fileRef.current.value = "";
@@ -461,6 +738,42 @@ window.__ModuleLoader__.load({
                 ],
               })
             : null,
+          jsxs("div", {
+            style: ui.card,
+            children: [
+              jsx("div", { style: ui.cardTitle, children: L.update }),
+              jsx("div", { style: ui.hint, children: L.updateHint }),
+              jsx("div", {
+                style: ui.hint,
+                children: updateBusy
+                  ? L.updateChecking
+                  : updateInfo
+                    ? [
+                        L.updateInstalled + "  " + (updateInfo.installed || status?.version || "—"),
+                        L.updateLatest + "  " + (updateInfo.latest || "—"),
+                        updateInfo.error
+                          ? L.updateFailed
+                          : updateInfo.newer
+                            ? L.updateNewer
+                            : L.updateCurrent,
+                      ].join(" · ")
+                    : L.updateInstalled + "  " + (status?.version || "—"),
+              }),
+              updateInfo && updateInfo.newer && updateInfo.command
+                ? jsx("code", { style: { fontSize: 12 }, children: updateInfo.command })
+                : null,
+              jsx("div", {
+                style: { display: "flex", flexWrap: "wrap", gap: 8 },
+                children: jsx(Button, {
+                  variant: "outline",
+                  size: "sm",
+                  disabled: updateBusy,
+                  onClick: checkUpdate,
+                  children: updateBusy ? L.updateChecking : L.update,
+                }),
+              }),
+            ],
+          }),
           jsxs("div", {
             style: ui.card,
             children: [
@@ -493,18 +806,18 @@ window.__ModuleLoader__.load({
             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.cardTitle, children: L.external }),
+              jsx("div", { style: ui.hint, children: L.externalHint }),
               jsx("div", {
                 style: { ...ui.hint, wordBreak: "break-all" },
                 children: (buddyFiles || []).some((f) => f.exists)
-                  ? L.workbuddyFound +
+                  ? L.externalFound +
                     "  " +
                     buddyFiles
                       .filter((f) => f.exists)
-                      .map((f) => f.path)
+                      .map((f) => (f.family ? f.family + " · " : "") + f.path)
                       .join(" · ")
-                  : L.workbuddyNone,
+                  : L.externalNone,
               }),
               buddyNote ? jsx("div", { style: ui.saved, children: buddyNote }) : null,
               jsx("div", {
@@ -514,7 +827,7 @@ window.__ModuleLoader__.load({
                   size: "sm",
                   disabled: busy || !(buddyFiles || []).some((f) => f.exists),
                   onClick: importBuddy,
-                  children: L.workbuddyImport,
+                  children: L.externalImport,
                 }),
               }),
             ],
@@ -581,7 +894,7 @@ window.__ModuleLoader__.load({
                       type: "password",
                       value: embeddingApiKey,
                       onChange: (e) => setEmbeddingApiKey(e.target.value),
-                      placeholder: embeddingApiKeySet ? "已保存" : "",
+                      placeholder: embeddingApiKeySet ? L.savedKey : "",
                       style: ui.input,
                     }),
                   ),
@@ -614,7 +927,7 @@ window.__ModuleLoader__.load({
                   jsx("input", {
                     value: q,
                     onChange: (e) => setQ(e.target.value),
-                    placeholder: L.search + "  鉴权 / until / about",
+                    placeholder: L.search + "  " + L.searchPh,
                     style: { ...ui.input, flex: 1, minWidth: 160 },
                   }),
                   jsxs("label", {
@@ -682,6 +995,7 @@ window.__ModuleLoader__.load({
                                 n.name ? " · " + n.name : "",
                                 n.until ? " · " + L.until + " " + n.until : "",
                                 n.stale ? " · " + L.stale : "",
+                                n.dirty ? " · " + L.dirty : "",
                               ],
                             }),
                             jsx("div", { style: { fontSize: 13, opacity: 0.9, lineHeight: 1.4 }, children: n.text }),
@@ -730,7 +1044,7 @@ window.__ModuleLoader__.load({
                                                 ...prev,
                                                 [n.id]: { ...editOf(n), aliases: ev.target.value },
                                               })),
-                                            placeholder: "逗号分隔",
+                                            placeholder: L.aliasesPh,
                                             style: ui.input,
                                           }),
                                         )
@@ -745,7 +1059,7 @@ window.__ModuleLoader__.load({
                                                 ...prev,
                                                 [n.id]: { ...editOf(n), until: ev.target.value },
                                               })),
-                                            placeholder: "周五 / 下周 / ISO",
+                                            placeholder: L.untilPh,
                                             style: ui.input,
                                           }),
                                         )
@@ -874,22 +1188,35 @@ window.__ModuleLoader__.load({
     }
 
     function relTime(iso) {
-      const t = Date.parse(iso);
-      if (!Number.isFinite(t)) return "";
-      const sec = Math.max(0, Math.round((Date.now() - t) / 1000));
-      if (sec < 60) return "刚刚";
-      if (sec < 3600) return Math.floor(sec / 60) + " 分钟前";
-      if (sec < 86400) return Math.floor(sec / 3600) + " 小时前";
-      return Math.floor(sec / 86400) + " 天前";
+      const at = Date.parse(iso);
+      if (!Number.isFinite(at)) return "";
+      const sec = Math.max(0, Math.round((Date.now() - at) / 1000));
+      if (sec < 60) return t("justNow");
+      if (sec < 3600) return t("minutesAgo", { n: Math.floor(sec / 60) });
+      if (sec < 86400) return t("hoursAgo", { n: Math.floor(sec / 3600) });
+      return t("daysAgo", { n: Math.floor(sec / 86400) });
     }
 
     function kindLabel(kind, current) {
-      if (current || kind === "tail") return "后续";
-      if (kind === "fork") return "分支";
-      return "检查点";
+      if (current || kind === "tail") return t("boxNext");
+      if (kind === "fork") return t("boxFork");
+      return t("boxCheck");
     }
 
-    const GENERIC_BOX_NAMES = { "当前": 1, "已压缩": 1, "分叉": 1, "分叉点": 1, "后续": 1, "分支": 1 };
+    const GENERIC_BOX_NAMES = {
+      当前: 1,
+      已压缩: 1,
+      分叉: 1,
+      分叉点: 1,
+      后续: 1,
+      分支: 1,
+      Current: 1,
+      Compacted: 1,
+      Fork: 1,
+      Checkpoint: 1,
+      Next: 1,
+      Branch: 1,
+    };
     const MAP_BOX_W = 220;
     const MAP_ARROW_W = 96;
     const MAP_PAD = 40;
@@ -1115,7 +1442,7 @@ window.__ModuleLoader__.load({
 
     function increasedForkTitle(title) {
       const text = String(title || "").trim();
-      if (!text) return "分叉 (1)";
+      if (!text) return t("forkDefault");
       const ascii = /^(.*?)\((\d+)\)$/u.exec(text);
       if (ascii?.[1] != null && ascii[2] != null) return ascii[1] + "(" + (Number(ascii[2]) + 1) + ")";
       const fullWidth = /^(.*?)（(\d+)）$/u.exec(text);
@@ -1129,8 +1456,8 @@ window.__ModuleLoader__.load({
     }
 
     function boxKicker(node, { current, child, sessionTitle }) {
-      if (child) return sessionTitle || "分叉";
-      if (current || node?.kind === "tail") return "后续";
+      if (child) return sessionTitle || t("forkName");
+      if (current || node?.kind === "tail") return t("boxNext");
       if (node?.atSeq != null && Number(node.atSeq) > 0) return "seq " + node.atSeq;
       return kindLabel(node?.kind, current);
     }
@@ -1604,8 +1931,8 @@ window.__ModuleLoader__.load({
       };
       const inspectBtn = jsx("button", {
         type: "button",
-        title: "轨迹",
-        "aria-label": "轨迹",
+        title: t("trajectory"),
+        "aria-label": t("trajectory"),
         "data-map-inspect": "1",
         style: mapUi.iconBtn,
         onPointerDown: stopIcon,
@@ -1618,8 +1945,8 @@ window.__ModuleLoader__.load({
       });
       const forkBtn = jsx("button", {
         type: "button",
-        title: "分叉",
-        "aria-label": "分叉",
+        title: t("fork"),
+        "aria-label": t("fork"),
         "data-map-fork": "1",
         disabled: !!busy,
         style: { ...mapUi.iconBtn, ...(busy ? { opacity: 0.4 } : {}) },
@@ -1635,8 +1962,8 @@ window.__ModuleLoader__.load({
         !canSetView
           ? jsx("button", {
               type: "button",
-              title: "打开对话",
-              "aria-label": "打开对话",
+              title: t("openChat"),
+              "aria-label": t("openChat"),
               "data-map-open": "1",
               style: mapUi.iconBtn,
               onPointerDown: stopIcon,
@@ -1645,14 +1972,14 @@ window.__ModuleLoader__.load({
                 stopIcon(e);
                 onJump(node);
               },
-              children: "对",
+              children: t("chatShort"),
             })
           : null;
       const titleNode = editing
         ? jsx("input", {
             value: draft,
             autoFocus: true,
-            "aria-label": "方框标题",
+            "aria-label": t("boxTitle"),
             style: mapUi.titleInput,
             onPointerDown: (e) => e.stopPropagation(),
             onClick: (e) => e.stopPropagation(),
@@ -1672,7 +1999,7 @@ window.__ModuleLoader__.load({
           })
         : jsx("div", {
             style: mapUi.title,
-            title: "双击改名",
+            title: t("renameHint"),
             onClick: (e) => e.stopPropagation(),
             onDoubleClick: startEdit,
             children: customTitle,
@@ -1714,7 +2041,7 @@ window.__ModuleLoader__.load({
                 children: [
                   jsxs("div", {
                     style: { ...mapUi.kicker, flex: 1, minWidth: 0 },
-                    title: canRename ? "双击改名" : undefined,
+                    title: canRename ? t("renameHint") : undefined,
                     onDoubleClick: startEdit,
                     children: [
                       boxKicker(node, { current, child, sessionTitle }),
@@ -1726,13 +2053,13 @@ window.__ModuleLoader__.load({
                         style: mapUi.ghostBtn,
                         onPointerDown: stopIcon,
                         onClick: startEdit,
-                        children: "改名",
+                        children: t("rename"),
                       })
                     : null,
                 ],
               }),
               customTitle || editing ? titleNode : null,
-              jsx("div", { style: mapUi.summary, children: body || "（尚无摘要）" }),
+              jsx("div", { style: mapUi.summary, children: body || t("noSummary") }),
               jsx("div", { style: mapUi.hint, children: relTime(node.createdAt) }),
             ],
           }),
@@ -1749,6 +2076,7 @@ window.__ModuleLoader__.load({
     let pendingSessionNav = null;
 
     function SessionMapView({ sessionId, useSessions, useSession, fork, open, renameSession, actions, seedLengthOf }) {
+      useT();
       const canSetView = typeof actions?.setView === "function";
       const chat = useSession((s) => s.chat);
       const cwd = useSessions((s) => (sessionId == null ? "" : s.byId[sessionId]?.cwd || ""));
@@ -1860,9 +2188,9 @@ window.__ModuleLoader__.load({
           const checks = Number(resp.checkpoints) || 0;
           const forkN = Number(resp.forks) || 0;
           if (!checks && !forkN) {
-            setBackfillNote("没有发现压缩标记或分叉。没压过的会话本来就只有「后续」。要分段请点「生成检查点」。");
+            setBackfillNote(t("backfillNone"));
           } else {
-            setBackfillNote("已同步 " + checks + " 个检查点、" + forkN + " 条分叉。");
+            setBackfillNote(t("backfillOk", { checks, forks: forkN }));
           }
         } catch (err) {
           setError(String(err.message || err));
@@ -1875,7 +2203,7 @@ window.__ModuleLoader__.load({
         if (!sessionId || busy) return;
         const atSeq = lastChatSeq(chat);
         if (atSeq == null) {
-          setError("当前对话还没有可切的轮次。先在对话里发一条，再生成检查点。");
+          setError(t("cutNeedTurn"));
           return;
         }
         setBusy(true);
@@ -1892,9 +2220,9 @@ window.__ModuleLoader__.load({
           });
           applyMap(resp);
           if (resp.created) {
-            setBackfillNote("已把当前「后续」收成左边一格（seq " + atSeq + "），右边仍是后续。这不压缩 DSH 上下文。");
+            setBackfillNote(t("cutOk", { seq: atSeq }));
           } else {
-            setBackfillNote("这个位置已经切过了（seq " + atSeq + "）。再聊几轮后再生成。");
+            setBackfillNote(t("cutDup", { seq: atSeq }));
           }
         } catch (err) {
           setError(String(err.message || err));
@@ -1974,7 +2302,7 @@ window.__ModuleLoader__.load({
 
       const openSession = (id, nav) => {
         if (typeof open !== "function") {
-          setError("无法打开分叉会话：会话图没有拿到 session.open");
+          setError(t("forkOpenFail"));
           return false;
         }
         try {
@@ -1994,7 +2322,7 @@ window.__ModuleLoader__.load({
           return;
         }
         if (typeof actions?.setView !== "function") {
-          setError("无法切换到对话页：会话图没有拿到同一 chat store 的 setView");
+          setError(t("chatViewFail"));
           return;
         }
         const toEnd = node.kind === "tail" || !!node.current || !Number(node.atSeq);
@@ -2017,7 +2345,7 @@ window.__ModuleLoader__.load({
         if (typeof actions?.setView === "function") {
           actions.setView("trajectory");
         } else {
-          setError("无法切换到轨迹页：会话图没有拿到同一 chat store 的 setView");
+          setError(t("trajViewFail"));
         }
       };
 
@@ -2040,7 +2368,7 @@ window.__ModuleLoader__.load({
         setBusy(true);
         setError("");
         try {
-          if (typeof fork !== "function") throw new Error("当前壳没有 session.fork");
+          if (typeof fork !== "function") throw new Error(t("noFork"));
           const sourceId = String(node.sessionId || sessionId);
           const opts = { sessionId: sourceId, increaseTitle: true };
           if (!node.current && node.kind !== "tail" && Number.isFinite(Number(node.atSeq))) {
@@ -2052,7 +2380,7 @@ window.__ModuleLoader__.load({
             try {
               await renameSession(childId, wanted);
             } catch (err) {
-              setError("会话已分叉，但侧边栏改名失败：" + String(err.message || err));
+              setError(t("renameFail", { err: String(err.message || err) }));
             }
           }
           if (inheritPins && childId) {
@@ -2123,12 +2451,7 @@ window.__ModuleLoader__.load({
       const runChipBatch = async (action) => {
         if (!pickedIds.length || busy) return;
         if (action === "delete") {
-          const ok = window.confirm(
-            "删除会从 .tdb 里拿掉这 " +
-              pickedIds.length +
-              " 条，不可恢复。归档只是藏起来，find / 短地图 / 芯片都不再出现。确定删除？",
-          );
-          if (!ok) return;
+          if (!window.confirm(t("deleteConfirm", { n: pickedIds.length }))) return;
         }
         setBusy(true);
         setError("");
@@ -2195,16 +2518,12 @@ window.__ModuleLoader__.load({
           jsxs("div", {
             style: mapUi.chipsHead,
             children: [
-              jsx("div", { style: mapUi.chipsTitle, children: "记忆芯片" }),
+              jsx("div", { style: mapUi.chipsTitle, children: t("chips") }),
               jsx("div", {
                 style: mapUi.hint,
                 children:
                   backfillNote ||
-                  "共 " +
-                    chips.length +
-                    " 条，已钉 " +
-                    pinIds.length +
-                    "。默认不勾选：不钉就不会按芯片白名单注入，但仍可能被开场短地图点名带上，模型也能 find 到。",
+                  t("chipsHint", { n: chips.length, pins: pinIds.length }),
               }),
               jsxs("div", {
                 style: mapUi.chipsActions,
@@ -2213,23 +2532,23 @@ window.__ModuleLoader__.load({
                     type: "button",
                     style: mapUi.actionBtn,
                     disabled: busy,
-                    title: "把当前「后续」收成左边一格，右边继续当后续。只切情节图，不触发 DSH 压缩。要压上下文请在对话里输入 /compact。",
+                    title: t("cutTitle"),
                     onClick: cutCheckpoint,
-                    children: busy ? "生成中…" : "生成检查点",
+                    children: busy ? t("cutting") : t("cutBtn"),
                   }),
                   jsx("button", {
                     type: "button",
                     style: mapUi.actionBtn,
                     disabled: busy,
-                    title: "读取当前对话里 DSH 已有的压缩标记和侧边栏分叉，补进图。没压过就补不出历史方框。",
+                    title: t("updateTitle"),
                     onClick: syncCheckpoints,
-                    children: busy ? "更新中…" : "更新检查点",
+                    children: busy ? t("updating") : t("updateBtn"),
                   }),
                   jsx("button", {
                     type: "button",
                     style: mapUi.actionBtn,
                     onClick: () => setChipsOpen((v) => !v),
-                    children: chipsOpen ? "收起" : "展开勾选",
+                    children: chipsOpen ? t("collapse") : t("expand"),
                   }),
                 ],
               }),
@@ -2244,7 +2563,7 @@ window.__ModuleLoader__.load({
                     children: [
                       jsx("input", {
                         type: "search",
-                        placeholder: "搜索芯片",
+                        placeholder: t("searchChips"),
                         value: chipQuery,
                         onChange: (e) => setChipQuery(e.target.value),
                         style: mapUi.search,
@@ -2257,7 +2576,7 @@ window.__ModuleLoader__.load({
                             checked: inheritPins,
                             onChange: (e) => setInheritPins(e.target.checked),
                           }),
-                          "分叉时继承钉选",
+                          t("inheritPins"),
                         ],
                       }),
                       jsxs("div", {
@@ -2271,7 +2590,7 @@ window.__ModuleLoader__.load({
                               setChipSelect(false);
                               setPickedIds([]);
                             },
-                            children: draftOpen ? "取消新增" : "新增",
+                            children: draftOpen ? t("cancelAdd") : t("addChip"),
                           }),
                           jsx("button", {
                             type: "button",
@@ -2281,7 +2600,7 @@ window.__ModuleLoader__.load({
                               setPickedIds([]);
                               setDraftOpen(false);
                             },
-                            children: chipSelect ? "取消选择" : "选择",
+                            children: chipSelect ? t("cancelSelect") : t("select"),
                           }),
                           chipSelect
                             ? jsx("button", {
@@ -2289,7 +2608,7 @@ window.__ModuleLoader__.load({
                                 style: mapUi.actionBtn,
                                 disabled: !pickedIds.length || busy,
                                 onClick: () => runChipBatch("archive"),
-                                children: "归档" + (pickedIds.length ? " " + pickedIds.length : ""),
+                                children: t("archive") + (pickedIds.length ? " " + pickedIds.length : ""),
                               })
                             : null,
                           chipSelect
@@ -2298,7 +2617,7 @@ window.__ModuleLoader__.load({
                                 style: mapUi.dangerBtn,
                                 disabled: !pickedIds.length || busy,
                                 onClick: () => runChipBatch("delete"),
-                                children: "删除" + (pickedIds.length ? " " + pickedIds.length : ""),
+                                children: t("remove") + (pickedIds.length ? " " + pickedIds.length : ""),
                               })
                             : null,
                         ],
@@ -2308,10 +2627,10 @@ window.__ModuleLoader__.load({
                   jsx("div", {
                     style: mapUi.hint,
                     children: chipSelect
-                      ? "点芯片多选。归档：软删除，find / 短地图 / 芯片不再出现，节点还在库里。删除：从 .tdb 去掉，不可恢复。"
+                      ? t("chipSelectHint")
                       : clipped
-                        ? "已截到预算（≤300 token）"
-                        : "勾选后从当前这段的下一轮注入。空白处拖动画布，滚轮缩放。",
+                        ? t("chipClipped")
+                        : t("chipPinHint"),
                   }),
                   draftOpen
                     ? jsxs("div", {
@@ -2320,7 +2639,7 @@ window.__ModuleLoader__.load({
                           jsx("textarea", {
                             value: draftText,
                             onChange: (e) => setDraftText(e.target.value),
-                            placeholder: "粘贴或输入要记住的内容。点一次写入，整段就是一条芯片。",
+                            placeholder: t("chipDraftPh"),
                             style: mapUi.draftBox,
                           }),
                           jsx("button", {
@@ -2328,7 +2647,7 @@ window.__ModuleLoader__.load({
                             style: { ...mapUi.actionBtn, alignSelf: "flex-start" },
                             disabled: busy || !draftText.trim(),
                             onClick: submitChipDraft,
-                            children: "写入并钉选",
+                            children: t("writePin"),
                           }),
                         ],
                       })
@@ -2367,7 +2686,7 @@ window.__ModuleLoader__.load({
                                       checked: pinSet.has(c.id),
                                       onChange: (e) => togglePin(c.id, e.target.checked),
                                     }),
-                                c.suggested ? jsx("span", { style: mapUi.suggest, children: "建议" }) : null,
+                                c.suggested ? jsx("span", { style: mapUi.suggest, children: t("suggested") }) : null,
                                 jsx("span", {
                                   style: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
                                   children: (c.type || "") + " · " + (c.l0 || c.name || "#" + c.id),
@@ -2381,8 +2700,8 @@ window.__ModuleLoader__.load({
                     : jsx("div", {
                         style: mapUi.hint,
                         children: chips.length
-                          ? "没有匹配的芯片。"
-                          : "还没有可钉选的 preference / decision / entity。用「新增」写一条。",
+                          ? t("noChipMatch")
+                          : t("noChips"),
                       }),
                 ],
               })
@@ -2503,15 +2822,15 @@ window.__ModuleLoader__.load({
                     if (forkDraft?.node) forkBox(forkDraft.node, forkDraft.title);
                   },
                   children: [
-                    jsx("div", { style: mapUi.dialogTitle, children: "分叉为新会话" }),
+                    jsx("div", { style: mapUi.dialogTitle, children: t("forkDialog") }),
                     jsx("div", {
                       style: mapUi.hint,
-                      children: "这个名字会出现在左侧会话列表里。",
+                      children: t("forkDialogHint"),
                     }),
                     jsx("input", {
                       autoFocus: true,
                       value: forkDraft.title,
-                      "aria-label": "新会话名称",
+                      "aria-label": t("newSessionName"),
                       onChange: (e) => setForkDraft({ ...forkDraft, title: e.target.value }),
                       style: { ...mapUi.titleInput, flex: "none", width: "100%" },
                     }),
@@ -2522,13 +2841,13 @@ window.__ModuleLoader__.load({
                           type: "button",
                           style: mapUi.foldBtn,
                           onClick: () => setForkDraft(null),
-                          children: "取消",
+                          children: t("cancel"),
                         }),
                         jsx("button", {
                           type: "submit",
                           style: mapUi.foldBtn,
                           disabled: busy,
-                          children: busy ? "分叉中…" : "分叉",
+                          children: busy ? t("forking") : t("fork"),
                         }),
                       ],
                     }),
@@ -2543,6 +2862,19 @@ window.__ModuleLoader__.load({
     function apply(ctx) {
       workspacesList = ctx.workspaces?.list || null;
       const sessions = ctx.sessions;
+      try {
+        const snap = ctx.locale && typeof ctx.locale.getLocale === "function" ? ctx.locale.getLocale() : null;
+        if (snap && snap.active) setUiLocale(snap.active);
+      } catch {
+        // host may not expose locale
+      }
+      try {
+        ctx.on("locale/change", (snap) => {
+          if (snap && snap.active) setUiLocale(snap.active);
+        });
+      } catch {
+        // ignore
+      }
       ctx.slots.inject(
         "settings.section",
         () =>
@@ -2567,7 +2899,7 @@ window.__ModuleLoader__.load({
               name: "conversation.view",
               id: "session-map",
               order: 20,
-              label: () => "会话图",
+              label: () => t("sessionMap"),
               ...(chatStore ? { store: chatStore } : {}),
               inject: () => ({
                 fork: (opts) => sessions.fork(opts),
@@ -2584,7 +2916,7 @@ window.__ModuleLoader__.load({
                 renameSession: async (id, title) => {
                   const face = sessions.binding?.(id)?.session;
                   if (!face || typeof face.rename !== "function") {
-                    throw new Error("当前壳没有 session.rename");
+                    throw new Error(t("noRename"));
                   }
                   const result = await face.rename(title);
                   if (result && result.ok === false) {