@max-null/dsh-memory 0.4.1 → 0.5.2

package/README.md

@@ -1,5 +1,9 @@
 # dsh-memory
 
+本插件属于 **`@max-null/*` 插件系列**——这一系列共同构成 **[SSID（思灵 · Seek Soul in Darkness）](https://github.com/Max-Null/seek-soul-in-darkness)** 桌面体验。SSID 是整合它们的盒：`dsh-capture` · `dsh-chat-rail` · `dsh-chinese-thinking` · `dsh-draft-polish` · `dsh-guardian` · `dsh-habit` · `dsh-header-unify` · `dsh-memory` · `dsh-node-appearance` · `dsh-plugin-center` · `dsh-skill-mcp-center` · `dsh-ssid-panels` · `dsh-ssid-zh-ui`。
+
+This plugin belongs to the **`@max-null/*` family** — a set of plugins that together form the **[SSID (思灵 · Seek Soul in Darkness)](https://github.com/Max-Null/seek-soul-in-darkness)** desktop experience.
+
 一个面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的**跨会话明文记忆插件**。遵循「一切皆插件」——它不修改 DSH 源码，声明 `name`/`inject`/`apply`，由 Loader 从 `cordis.yml` 加载。
 
 ## 设计原则
@@ -7,7 +11,7 @@
 1. **人是所有者**：模型只能写入 `suggested` 状态的记忆，绝不自我提升；只有人工确认（`setStatus`）才能让记忆生效。
 2. **可观测先于精准**：每条记忆是明文，`memory_list` 随时可见、`memory_forget` 随时删除——不存在"静默暗礁"。
 3. **明文是人机共享的审计窗口**：记忆是可读文本，模型可自检其是否过期或出错（规划中的 v2）。
-4. **确定性且缓存安全**：BM25 关键词检索是存储的纯函数、无 LLM 调用；固定指引进 system-prompt section，`auto` 记忆进 context。
+4. **确定性且缓存安全**：BM25 关键词检索是存储的纯函数、无 LLM 调用；固定指引进 system-prompt section，`approved + injected` 记忆进 recall context（global 全量 + 当前会话工作区），逐条为单行摘要并按注入预算截断（超预算按最近使用优先，省略数在面板可见）。
 
 ## 用法
 
@@ -25,8 +29,9 @@ npm install @max-null/dsh-memory
 ## 提供的服务与工具
 
 - **服务** `ctx.memory`：`remember` / `list` / `search` / `forget` / `setStatus`
-- **工具**：`memory_save`、`memory_list`、`memory_search`、`memory_confirm`、`memory_forget`
-- **注入**：`tool:memory` 指引 section + `memory:recall` 召回 context（`auto` 记忆，带 `[memory:<id>]` 来源标记）
+- **工具**：`memory_save`、`memory_list`、`memory_search`、`memory_confirm`、`memory_forget`、`memory_update`
+- **注入**：`tool:memory` 指引 section + `memory:recall` 召回 context（global 的 `approved + injected` + 当前会话工作区的 `approved + injected`，带 `[memory:<id>:<namespace>]` 来源标记；摘要化 + 预算截断）
+- **检索**：BM25（CJK 单字 + 2-gram，content 与 keywords 字段分离加权；中文多字查询精度显著优于单字切分）；可选语义融合（见「可选配置」）
 
 ## 两层存储（global / project）
 
@@ -35,16 +40,17 @@ npm install @max-null/dsh-memory
 | namespace | 默认位置 | 用途 |
 |---|---|---|
 | `global` | `$DSH_HOME/storages/memory.json` | 跨项目的个人偏好 |
-| `project` | `<cwd>/.dsh/storages/memory_project.json` | 跟随仓库的项目共识，可 git 分享 |
+| `project` | `<cwd>/.dsh/storages/memory_project_<hash>.json` | 跟随仓库的项目共识，可 git 分享 |
 
-两个根都可用 config 覆盖（`globalRoot` / `projectRoot`）。`memory_list` / `memory_search` 不带 `namespace` 过滤时会同时查两层。
+两个根都可用 config 覆盖（`globalRoot` / `projectRoot`）。`memory_list` / `memory_search` 不带 `namespace` 过滤时会同时查两层。旧版双重前缀文件名（`memory_project_memory_project_<hash>.json`）在打开时自动迁移为规范名。
 
 ## 使用流程（人工确认闸门）
 
 ```
 模型 memory_save     →  status: suggested（只是建议，未生效）
-人 memory_confirm    →  status: auto（生效，自动进入每轮的 recall context）
-memory_search        →  随时按关键词召回任意状态的记忆
+人 memory_confirm    →  status: approved（已审核；是否常驻注入由独立开关 injected 决定）
+人（面板/开关）       →  injected: true（每轮注入：global + 当前会话工作区，摘要化 + 预算截断）
+memory_search        →  关键词/语义召回任意状态的记忆（命中标记 lastUsedAt 冷热追踪）
 memory_forget        →  随时删除
 ```
 
@@ -52,15 +58,28 @@ memory_forget        →  随时删除
 
 ## 为什么明文 + BM25，而不是向量检索
 
-向量检索的记忆本体是一串不可读的数字，过期信息会成为**无法观测、无法修复的静默暗礁**；BM25 + 明文让每一次召回都可解释、每一条记忆都可见可删。语义（向量）检索留作 v2 的可选项，且以"可观测 + 可修复"为门槛，而非时间表。
+向量检索的记忆本体是一串不可读的数字，过期信息会成为**无法观测、无法修复的静默暗礁**；BM25 + 明文让每一次召回都可解释、每一条记忆都可见可删。语义（向量）检索作为**可插拔的可选项**（0.5.2，见「可选配置」）——记忆本体仍是明文，向量仅作为检索辅助字段（`vector`，明文可读），且以"可观测 + 可修复"为门槛。
 
-明文还有一层**跟随仓库分享**的好处：`project` 命名空间的记忆落在项目文件夹内（`<cwd>/.dsh/storages/memory_project.json`），随 `git` 提交、分享给所有协作者；`global` 命名空间的记忆留在本地 `$DSH_HOME`。团队的共识（"本项目统一用 Vue3 `<script setup>`"）能沉淀进仓库，而不是散落在每个人的本地。FTS5 的 SQLite 二进制、向量的数字串，都无法这样"跟着仓库走"。
+明文还有一层**跟随仓库分享**的好处：`project` 命名空间的记忆落在项目文件夹内（`<cwd>/.dsh/storages/memory_project_<hash>.json`），随 `git` 提交、分享给所有协作者；`global` 命名空间的记忆留在本地 `$DSH_HOME`。团队的共识（"本项目统一用 Vue3 `<script setup>`"）能沉淀进仓库，而不是散落在每个人的本地。FTS5 的 SQLite 二进制无法这样"跟着仓库走"。
 
-## SSID 系列
+## 可选配置
 
-本插件属于 **`@max-null/*` 插件系列**——这一系列共同构成 **[SSID（思灵 · Seek Soul in Darkness）](https://github.com/Max-Null/seek-soul-in-darkness)** 桌面体验。SSID 是整合它们的盒：`dsh-plugin-center` · `dsh-memory` · `dsh-chinese-thinking` · `dsh-guardian` · `dsh-habit`。
+在 `cordis.yml` 的 `config` 里传给插件（均可省略）：
 
-This plugin belongs to the **`@max-null/*` family** — a set of plugins that together form the **[SSID (思灵 · Seek Soul in Darkness)](https://github.com/Max-Null/seek-soul-in-darkness)** desktop experience.
+```yaml
+- id: memory
+  name: '@max-null/dsh-memory'
+  config:
+    injectionBudget: 1500        # 常驻注入预算（字符；null = 不限制）
+    summaryChars: 80             # 单条注入摘要截断上限（字符）
+    semanticTopK: 5              # 语义侧参与融合的 topK（仅配置 embeddings 时生效）
+    # 混合语义检索（可插拔；缺省 = 纯 BM25）
+    # embeddings: { embed: '...' 提供 embed(texts) 的宿主函数 或 插件名 ... }
+```
+
+`embeddings` 接受 `{ embed(texts): Promise<number[][]>, similarity? }` 对象——由宿主装配层提供嵌入实现（如 DeepSeek 嵌入端点）；配置后 `memory_search` 以 BM25 + 语义 RRF 融合，向量增量生成并持久化，嵌入调用失败自动降级为纯 BM25。
+
+## SSID 系列
 
 ## 开发
 

package/client.js

@@ -173,7 +173,8 @@ var STRINGS = {
     keywordsLabel: "\u5173\u952E\u8BCD",
     suggested: "\u5F85\u5BA1\u6838",
     approved: "\u5DF2\u5BA1\u6838",
-    refresh: "\u5237\u65B0"
+    refresh: "\u5237\u65B0",
+    coldHint: "\u51B7\u6570\u636E \xB7 \u5EFA\u8BAE\u6309\u9700\u5316"
   },
   en: {
     tabMemory: "Memory",
@@ -197,7 +198,8 @@ var STRINGS = {
     keywordsLabel: "Keywords",
     suggested: "Suggested",
     approved: "Approved",
-    refresh: "Refresh"
+    refresh: "Refresh",
+    coldHint: "Cold \xB7 consider on-demand"
   }
 };
 var localeId = "zh";
@@ -226,7 +228,26 @@ function useT() {
 }
 var ssid = {
   accent: "#4FC3F7",
-  wrap: { display: "flex", flexDirection: "column", gap: 8, padding: "10px 12px", overflowY: "auto", height: "100%", boxSizing: "border-box" },
+  // Root column: toolbar + namespace tabs stay pinned at the top (flex:none);
+  // only the content area below scrolls (2026-08-22 用户: tab 与功能不应随滚动)。
+  wrap: { display: "flex", flexDirection: "column", gap: 8, padding: "10px 12px", height: "100%", boxSizing: "border-box" },
+  header: { display: "flex", flexDirection: "column", gap: 8, flex: "none" },
+  content: { flex: 1, minHeight: 0, overflowY: "auto", display: "flex", flexDirection: "column", gap: 8, marginRight: -4, paddingRight: 4 },
+  // 计数徽标（醒目：accent 底 + 白色数字）。
+  count: {
+    display: "inline-flex",
+    alignItems: "center",
+    justifyContent: "center",
+    minWidth: 18,
+    height: 18,
+    padding: "0 6px",
+    borderRadius: 9,
+    background: "var(--dsw-alias-state-business-primary, #4FC3F7)",
+    color: "#fff",
+    fontSize: 11,
+    fontWeight: 600,
+    lineHeight: 1
+  },
   card: {
     background: "var(--dsw-alias-bg-layer-1, #131a26)",
     border: "1px solid var(--dsw-alias-border-l2, #1e2836)",
@@ -275,11 +296,20 @@ var memoryApi = {
   setInjected(id, injected, cwd) {
     return api("setInjected", { id, injected, ...cwd === void 0 ? {} : { cwd } });
   },
-  injectionPreview() {
-    return api("injectionPreview");
+  injectionPreview(cwd) {
+    return api("injectionPreview", { ...cwd === void 0 ? {} : { cwd } });
   }
 };
 var ORGANIZE_PROMPT = "\u8BF7\u6574\u7406\u6211\u7684\u8BB0\u5FC6\u5E93\uFF1A\u7528 memory_list \u67E5\u770B\u5168\u90E8\u8BB0\u5FC6\u3002\u6574\u7406\u89C4\u5219\uFF08\u5FC5\u987B\u6267\u884C\uFF09\uFF1A\u2460\u540C\u7C7B\u6761\u76EE\u5408\u5E76\u2014\u2014\u5DE5\u4F5C\u4E60\u60EF/\u7EA6\u5B9A\u7C7B\u591A\u6761\u5408\u5E76\u4E3A\u4E00\u6761\uFF08\u5185\u5BB9\u7528 \u2460\u2461\u2462 \u5E76\u5217\uFF0C\u907F\u514D\u788E\u7247\u5316\uFF09\uFF1B\u2461\u4E0E\u300C[\u8BB0\u5FC6\u7CFB\u7EDF\u81EA\u8FF0]\u300D\uFF08\u4F60\u4E0A\u4E0B\u6587\u4E2D\u7684\u8BB0\u5FC6\u673A\u5236\u8BF4\u660E\uFF09\u5185\u5BB9\u91CD\u590D\u7684\u63D2\u4EF6\u4ECB\u7ECD\u6761\u76EE\uFF08\u5982 dsh-memory \u63D2\u4EF6\u53D1\u5E03\u4FE1\u606F\uFF09\u5E94\u5220\u9664\u2014\u2014\u673A\u5236\u8BF4\u660E\u5DF2\u7531\u7CFB\u7EDF\u5E38\u9A7B\u63D0\u4F9B\uFF0C\u65E0\u9700\u7528\u6237\u5B58\u50A8\uFF1B\u2462\u5BF9\u8FC7\u65F6\u3001\u9519\u8BEF\u6216\u5DF2\u53D8\u5316\u7684\u5185\u5BB9\u7528 memory_update \u4FEE\u6B63\uFF08\u4F1A\u91CD\u7F6E\u4E3A\u5F85\u5BA1\u6838\uFF09\uFF1B\u2463\u7CBE\u7B80\u5197\u957F\u5185\u5BB9\uFF0C\u4E3A\u6BCF\u6761\u8865\u5145\u6216\u4FEE\u6B63 keywords\uFF1B\u2464\u9700\u8981\u5220\u9664\u7684\u7528 memory_forget\uFF0C\u9700\u8981\u65B0\u589E\u7684\u7528 memory_save\u3002\u5224\u65AD\u5185\u5BB9\u662F\u5426\u8FC7\u65F6\u7684\u65B9\u6CD5\uFF1A\u628A\u8BB0\u5FC6\u91CC\u63D0\u5230\u7684\u5DE5\u5177\u540D/\u6570\u91CF\u4E0E\u4F60\u5F53\u524D\u5B9E\u9645\u53EF\u7528\u7684\u8BB0\u5FC6\u5DE5\u5177\u5BF9\u7167\u2014\u2014\u4F60\u5F53\u524D\u53EF\u7528\uFF1Amemory_save / memory_list / memory_search / memory_confirm / memory_forget / memory_update\uFF08\u5171 6 \u4E2A\uFF09\uFF1B\u82E5\u8BB0\u5FC6\u4E2D\u7684\u5DE5\u5177\u5217\u8868\u3001\u6570\u91CF\u3001\u6D41\u7A0B\u4E0E\u6B64\u4E0D\u7B26\u5373\u4E3A\u8FC7\u65F6\uFF0C\u7528 memory_update \u4FEE\u6B63\u3002\u6539\u52A8\u5168\u90E8\u843D\u5728 suggested \u7B49\u5F85\u5BA1\u6838\uFF08\u4E0D\u8981\u8C03\u7528 memory_confirm\uFF09\uFF0C\u5B8C\u6210\u540E\u7528\u4E00\u53E5\u8BDD\u6C47\u62A5\u6574\u7406\u7ED3\u679C\u3002";
+var DAY_MS = 864e5;
+var COLD_DAYS = 30;
+function fmtDate(ms) {
+  const date = new Date(ms);
+  return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+}
+function isCold(usedAt, now = Date.now()) {
+  return usedAt === void 0 || now - usedAt > COLD_DAYS * DAY_MS;
+}
 function MemoryView(props) {
   const t = useT();
   const [records, setRecords] = (0, import_react.useState)([]);
@@ -295,7 +325,7 @@ function MemoryView(props) {
       return;
     }
     try {
-      setPreview(await memoryApi.injectionPreview());
+      setPreview(await memoryApi.injectionPreview(props.cwd));
     } catch {
       setPreview(null);
     }
@@ -369,6 +399,11 @@ function MemoryView(props) {
   const q = query.trim().toLowerCase();
   const byNs = namespace === null ? records : namespace === "workspace" ? records.filter((record) => record.namespace === "project") : records.filter((record) => record.namespace === "global");
   const filtered = byNs.filter((record) => q === "" || record.content.toLowerCase().includes(q));
+  const nsCounts = {
+    all: records.length,
+    global: records.filter((record) => record.namespace === "global").length,
+    workspace: records.filter((record) => record.namespace === "project").length
+  };
   const groups = [
     { key: "pending", label: t("groupPending"), items: filtered.filter((record) => record.status === "suggested") },
     { key: "ondemand", label: t("groupOnDemand"), items: filtered.filter((record) => record.status === "approved" && !record.injected) },
@@ -379,164 +414,174 @@ function MemoryView(props) {
     { style: ssid.wrap },
     (0, import_react.createElement)(
       "div",
-      { style: { display: "flex", gap: 6 } },
-      (0, import_react.createElement)("button", {
-        type: "button",
-        title: t("organizeMemory"),
-        onClick: () => {
-          void organize();
-        },
-        disabled: organizing,
-        style: { ...ssid.btn, color: ssid.accent, borderColor: ssid.accent }
-      }, organizing ? "\u2026" : t("organizeMemory")),
-      (0, import_react.createElement)("button", {
-        type: "button",
-        title: t("injectPreview"),
-        onClick: () => {
-          void togglePreview();
-        },
-        style: { ...ssid.btn, ...previewOpen ? { color: ssid.accent, borderColor: ssid.accent } : {} }
-      }, t("injectPreview")),
-      (0, import_react.createElement)("input", {
-        value: query,
-        onChange: (event) => {
-          setQuery(event.target.value);
-        },
-        placeholder: t("memorySearch"),
-        style: {
-          flex: 1,
-          padding: "6px 10px",
-          fontSize: 12.5,
-          boxSizing: "border-box",
-          background: "var(--dsw-alias-bg-layer-1, #0f141d)",
-          border: "1px solid var(--dsw-alias-border-l2, #1e2836)",
-          borderRadius: 8,
-          color: "var(--dsw-alias-label-primary, #d8e0ea)",
-          outline: "none"
-        }
-      }),
-      (0, import_react.createElement)("button", {
-        type: "button",
-        title: t("refresh"),
-        onClick: () => {
-          void refreshFromDisk();
-        },
-        disabled: refreshing,
-        style: ssid.btn
-      }, refreshing ? "\u2026" : "\u21BB")
-    ),
-    (0, import_react.createElement)(
-      "div",
-      { style: { display: "flex", gap: 4 } },
-      [null, "global", "workspace"].map((ns) => (0, import_react.createElement)("button", {
-        key: ns ?? "all",
-        onClick: () => {
-          setNamespace(ns);
-        },
-        style: { flex: 1, ...ssid.btn, ...namespace === ns ? { color: ssid.accent, borderColor: ssid.accent } : {} }
-      }, ns === null ? t("allNamespaces") : ns === "global" ? t("nsGlobal") : t("nsWorkspace")))
-    ),
-    // 注入预览（开发者）：self 自述 + 当前注入的记忆 + 上下文占用统计
-    previewOpen && preview !== null ? (0, import_react.createElement)(
-      "div",
-      { style: { ...ssid.card, display: "flex", flexDirection: "column", gap: 6 } },
+      { style: ssid.header },
       (0, import_react.createElement)(
         "div",
-        { style: { ...ssid.muted, fontSize: 10.5, display: "flex", justifyContent: "space-between", alignItems: "center" } },
-        (0, import_react.createElement)("span", null, t("contextUsage")),
-        (0, import_react.createElement)("span", null, (() => {
-          const selfChars = preview.self.length;
-          const injectedChars = preview.injected.reduce((sum, record) => sum + record.content.length + record.keywords.join("").length, 0);
-          const total = selfChars + injectedChars;
-          const tokens = Math.ceil(total / 2);
-          return `${selfChars}+${injectedChars} \u5B57\u7B26 \u2248 ${tokens} token`;
-        })())
+        { style: { display: "flex", gap: 6 } },
+        (0, import_react.createElement)("button", {
+          type: "button",
+          title: t("organizeMemory"),
+          onClick: () => {
+            void organize();
+          },
+          disabled: organizing,
+          style: { ...ssid.btn, color: ssid.accent, borderColor: ssid.accent }
+        }, organizing ? "\u2026" : t("organizeMemory")),
+        (0, import_react.createElement)("button", {
+          type: "button",
+          title: t("injectPreview"),
+          onClick: () => {
+            void togglePreview();
+          },
+          style: { ...ssid.btn, ...previewOpen ? { color: ssid.accent, borderColor: ssid.accent } : {} }
+        }, t("injectPreview")),
+        (0, import_react.createElement)("input", {
+          value: query,
+          onChange: (event) => {
+            setQuery(event.target.value);
+          },
+          placeholder: t("memorySearch"),
+          style: {
+            flex: 1,
+            padding: "6px 10px",
+            fontSize: 12.5,
+            boxSizing: "border-box",
+            background: "var(--dsw-alias-bg-layer-1, #0f141d)",
+            border: "1px solid var(--dsw-alias-border-l2, #1e2836)",
+            borderRadius: 8,
+            color: "var(--dsw-alias-label-primary, #d8e0ea)",
+            outline: "none"
+          }
+        }),
+        (0, import_react.createElement)("button", {
+          type: "button",
+          title: t("refresh"),
+          onClick: () => {
+            void refreshFromDisk();
+          },
+          disabled: refreshing,
+          style: ssid.btn
+        }, refreshing ? "\u2026" : "\u21BB")
       ),
-      (0, import_react.createElement)("div", { style: { ...ssid.text, fontSize: 11, whiteSpace: "pre-wrap", wordBreak: "break-all" } }, preview.self),
-      preview.injected.length === 0 ? (0, import_react.createElement)("div", { style: ssid.muted }, t("empty")) : preview.injected.map((record) => (0, import_react.createElement)(
-        "div",
-        { key: record.id, style: { ...ssid.muted, fontSize: 11 } },
-        `- [memory:${record.id.slice(0, 8)}] ${record.content}`
-      ))
-    ) : null,
-    // 未选择工作区：工作区视图显示占位（0.3.4 工作区路由语义）
-    namespace === "workspace" && (props.cwd === void 0 || props.cwd === "") ? (0, import_react.createElement)("div", { style: ssid.empty }, t("noWorkspace")) : groups.length === 0 ? (0, import_react.createElement)("div", { style: ssid.empty }, t("empty")) : groups.map((group) => (0, import_react.createElement)(
-      "div",
-      { key: group.key, style: { display: "flex", flexDirection: "column", gap: 6 } },
       (0, import_react.createElement)(
         "div",
-        { style: ssid.title },
-        (0, import_react.createElement)("span", null, group.label),
-        (0, import_react.createElement)(
-          "div",
-          { style: { display: "flex", alignItems: "center", gap: 6 } },
-          group.key === "pending" && group.items.length > 0 ? (0, import_react.createElement)("button", {
-            type: "button",
-            title: t("confirmAll"),
+        { style: { display: "flex", gap: 4 } },
+        [null, "global", "workspace"].map((ns) => {
+          const label = ns === null ? t("allNamespaces") : ns === "global" ? t("nsGlobal") : t("nsWorkspace");
+          const count = ns === null ? nsCounts.all : ns === "global" ? nsCounts.global : nsCounts.workspace;
+          return (0, import_react.createElement)("button", {
+            key: ns ?? "all",
             onClick: () => {
-              void confirmAll();
+              setNamespace(ns);
             },
-            style: { ...ssid.btn, padding: "1px 8px", fontSize: 10.5 }
-          }, t("confirmAll")) : null,
-          (0, import_react.createElement)("span", null, `${group.items.length}`)
-        )
-      ),
-      group.items.map((record) => (0, import_react.createElement)(
+            style: { flex: 1, display: "flex", alignItems: "center", justifyContent: "center", gap: 6, ...ssid.btn, ...namespace === ns ? { color: ssid.accent, borderColor: ssid.accent } : {} }
+          }, (0, import_react.createElement)("span", null, label), (0, import_react.createElement)("span", { style: ssid.count }, String(count)));
+        })
+      )
+    ),
+    // 内容区独立滚动：预览 + 分组列表。
+    (0, import_react.createElement)(
+      "div",
+      { style: ssid.content },
+      // 注入预览（开发者）：self 自述 + 实际注入行（摘要化+预算）+ 预算使用统计
+      previewOpen && preview !== null ? (0, import_react.createElement)(
         "div",
-        { key: record.id, style: ssid.card },
-        (0, import_react.createElement)("div", { style: ssid.text }, ContentWithRefs({ text: record.content })),
-        // keywords 展示（0.3.5：设计约定 UI 显示 keywords）
-        record.keywords !== void 0 && record.keywords.length > 0 ? (0, import_react.createElement)(
-          "div",
-          { style: { display: "flex", flexWrap: "wrap", gap: 4, marginTop: 6 } },
-          record.keywords.map((keyword) => (0, import_react.createElement)("span", {
-            key: keyword,
-            style: {
-              fontSize: 10,
-              padding: "1px 7px",
-              borderRadius: 8,
-              background: "var(--dsw-alias-bg-module-platform, rgba(128,148,168,.14))",
-              color: "var(--dsw-alias-label-secondary, #67748a)"
-            }
-          }, keyword))
-        ) : null,
+        { style: { ...ssid.card, display: "flex", flexDirection: "column", gap: 6 } },
         (0, import_react.createElement)(
           "div",
-          { style: { ...ssid.muted, marginTop: 6 } },
-          `${record.namespace} \xB7 ${record.status === "approved" ? t("approved") : t("suggested")}${record.injected ? ` \xB7 ${t("groupInjected")}` : ""}`
+          { style: { ...ssid.muted, fontSize: 10.5, display: "flex", justifyContent: "space-between", alignItems: "center" } },
+          (0, import_react.createElement)("span", null, t("contextUsage")),
+          (0, import_react.createElement)("span", null, (() => {
+            const selfChars = preview.self.length;
+            const total = selfChars + preview.chars;
+            const tokens = Math.ceil(total / 2);
+            const budgetText = preview.budget === null ? "" : ` / \u9884\u7B97 ${preview.budget}`;
+            const omittedText = preview.omitted > 0 ? `\uFF08\u7701\u7565 ${preview.omitted} \u6761\uFF09` : "";
+            return `${selfChars}+${preview.chars} \u5B57\u7B26${budgetText}${omittedText} \u2248 ${tokens} token`;
+          })())
         ),
+        (0, import_react.createElement)("div", { style: { ...ssid.text, fontSize: 11, whiteSpace: "pre-wrap", wordBreak: "break-all" } }, preview.self),
+        preview.lines.length === 0 ? (0, import_react.createElement)("div", { style: ssid.muted }, t("empty")) : preview.lines.map((line, index) => (0, import_react.createElement)("div", { key: index, style: { ...ssid.muted, fontSize: 11 } }, line))
+      ) : null,
+      // 未选择工作区：工作区视图显示占位（0.3.4 工作区路由语义）
+      namespace === "workspace" && (props.cwd === void 0 || props.cwd === "") ? (0, import_react.createElement)("div", { style: ssid.empty }, t("noWorkspace")) : groups.length === 0 ? (0, import_react.createElement)("div", { style: ssid.empty }, t("empty")) : groups.map((group) => (0, import_react.createElement)(
+        "div",
+        { key: group.key, style: { display: "flex", flexDirection: "column", gap: 6 } },
         (0, import_react.createElement)(
           "div",
-          { style: { display: "flex", gap: 6, marginTop: 8, alignItems: "center" } },
-          (0, import_react.createElement)("button", {
-            type: "button",
-            title: record.status === "approved" ? t("injectSwitch") : t("approveFirst"),
-            disabled: record.status !== "approved",
-            onClick: () => {
-              void toggleInjected(record);
-            },
-            style: {
-              ...ssid.btn,
-              ...record.injected ? { color: ssid.accent, borderColor: ssid.accent } : {},
-              opacity: record.status !== "approved" ? 0.4 : 1,
-              cursor: record.status !== "approved" ? "not-allowed" : "pointer"
-            }
-          }, record.injected ? `\u2713 ${t("injectSwitch")}` : t("injectSwitch")),
-          record.status === "suggested" ? (0, import_react.createElement)("button", {
-            style: ssid.btn,
-            onClick: () => {
-              void memoryApi.confirm(record.id, props.cwd).then(() => reload());
-            }
-          }, t("confirm")) : null,
-          (0, import_react.createElement)("button", {
-            style: ssid.btn,
-            onClick: () => {
-              void memoryApi.forget(record.id, props.cwd).then(() => reload());
-            }
-          }, t("forget"))
-        )
+          { style: ssid.title },
+          (0, import_react.createElement)("span", null, group.label),
+          (0, import_react.createElement)(
+            "div",
+            { style: { display: "flex", alignItems: "center", gap: 6 } },
+            group.key === "pending" && group.items.length > 0 ? (0, import_react.createElement)("button", {
+              type: "button",
+              title: t("confirmAll"),
+              onClick: () => {
+                void confirmAll();
+              },
+              style: { ...ssid.btn, padding: "1px 8px", fontSize: 10.5 }
+            }, t("confirmAll")) : null,
+            (0, import_react.createElement)("span", { style: ssid.count }, String(group.items.length))
+          )
+        ),
+        group.items.map((record) => (0, import_react.createElement)(
+          "div",
+          { key: record.id, style: ssid.card },
+          (0, import_react.createElement)("div", { style: ssid.text }, ContentWithRefs({ text: record.content })),
+          // keywords 展示（0.3.5：设计约定 UI 显示 keywords）
+          record.keywords !== void 0 && record.keywords.length > 0 ? (0, import_react.createElement)(
+            "div",
+            { style: { display: "flex", flexWrap: "wrap", gap: 4, marginTop: 6 } },
+            record.keywords.map((keyword) => (0, import_react.createElement)("span", {
+              key: keyword,
+              style: {
+                fontSize: 10,
+                padding: "1px 7px",
+                borderRadius: 8,
+                background: "var(--dsw-alias-bg-module-platform, rgba(128,148,168,.14))",
+                color: "var(--dsw-alias-label-secondary, #67748a)"
+              }
+            }, keyword))
+          ) : null,
+          (0, import_react.createElement)(
+            "div",
+            { style: { ...ssid.muted, marginTop: 6 } },
+            `${record.namespace} \xB7 ${record.status === "approved" ? t("approved") : t("suggested")}${record.injected ? ` \xB7 ${t("groupInjected")}` : ""}${record.lastUsedAt !== void 0 ? ` \xB7 \u4E0A\u641C ${fmtDate(record.lastUsedAt)}` : ""}${isCold(record.lastUsedAt) ? ` \xB7 ${t("coldHint")}` : ""}`
+          ),
+          (0, import_react.createElement)(
+            "div",
+            { style: { display: "flex", gap: 6, marginTop: 8, alignItems: "center" } },
+            (0, import_react.createElement)("button", {
+              type: "button",
+              title: record.status === "approved" ? t("injectSwitch") : t("approveFirst"),
+              disabled: record.status !== "approved",
+              onClick: () => {
+                void toggleInjected(record);
+              },
+              style: {
+                ...ssid.btn,
+                ...record.injected ? { color: ssid.accent, borderColor: ssid.accent } : {},
+                opacity: record.status !== "approved" ? 0.4 : 1,
+                cursor: record.status !== "approved" ? "not-allowed" : "pointer"
+              }
+            }, record.injected ? `\u2713 ${t("injectSwitch")}` : t("injectSwitch")),
+            record.status === "suggested" ? (0, import_react.createElement)("button", {
+              style: ssid.btn,
+              onClick: () => {
+                void memoryApi.confirm(record.id, props.cwd).then(() => reload());
+              }
+            }, t("confirm")) : null,
+            (0, import_react.createElement)("button", {
+              style: ssid.btn,
+              onClick: () => {
+                void memoryApi.forget(record.id, props.cwd).then(() => reload());
+              }
+            }, t("forget"))
+          )
+        ))
       ))
-    ))
+    )
   );
 }
 function currentSessionCwd(ctx) {

package/dist/bm25.d.ts

@@ -3,7 +3,31 @@
  * store — no model call — so recall is deterministic and a miss is explainable
  * as "no keyword match".
  */
-/** Split text into lowercase terms: English/number runs stay whole, each CJK ideograph its own term. */
+/**
+ * Split text into lowercase terms: English/number runs stay whole; each CJK
+ * ideograph its own term AND each adjacent pair its own bigram (0.5.2) —
+ * bigram raises Chinese multi-char hit precision, single chars keep
+ * single-character queries working.
+ */
 export declare function tokenize(text: string): string[];
 /** Score one query against each document with BM25, in document order. */
 export declare function bm25Scores(query: string, docs: readonly string[]): number[];
+/**
+ * 字段加权 BM25（0.5.2）：body（记忆内容）与 tags（人工关键词）分离打分，
+ * tags 命中 ×TAG_BOOST；用于 memory_search，人工关键词比正文更可检索。
+ */
+export declare function bm25FieldScores(query: string, docs: readonly {
+    body: string;
+    tags?: string;
+}[]): number[];
+/**
+ * RRF（Reciprocal Rank Fusion，0.5.2 混合检索）：按各通道排名倒数融合。
+ * 只依赖排名不依赖分数，两个异构打分通道（BM25 / 余弦相似度）可直接合流。
+ * @param rankings - 每通道一个 id → 排名（0 = 第一）；同一 id 在多个通道的
+ *   分数累加。
+ * @param k - RRF 常数（惯例 60）。
+ * @returns id → 融合分数（按降序排序的数组）。
+ */
+export declare function rrfFuse(rankings: readonly (readonly string[])[], k?: number): Array<[string, number]>;
+/** 余弦相似度（默认 similarity；向量维度不一致返回 0）。 */
+export declare function cosineSimilarity(left: readonly number[], right: readonly number[]): number;