dsh-prime-memory 0.24.2 → 0.25.0

package/CHANGELOG.en.md

@@ -7,6 +7,17 @@
 
 This file covers the **0.12.0** release notes and the current **unreleased** changes in English. For the full history, see [CHANGELOG.md](./CHANGELOG.md) (Chinese).
 
+## [0.25.0] — 2026-10-14
+
+### Added
+
+- **Keyword-distillation backfill (producer for `metadata.dsh_keywords`)**: the `keywords` axis reserved in `l1_fts` had no producer and stayed dormant. New independent batch scan `src/keyword-backfill.ts` (mirrors wing-backfill: single-flight / background / bounded / failures leave records untouched) sends existing L1 records missing `dsh_keywords` to the LLM in chunks, normalizes via `normKeywords` (≤5, dedupe, length clamp) and writes back. New endpoint `dsh-memory/keyword-backfill`; a "Keyword Backfill" button in the WingWheel panel. Config `keyword.enabled` defaults **off** — off means no backfill and `l1_fts` byte-for-byte unchanged (zero drift).
+- **`patchMetadataAndReindex`**: `patchMetadata` only updates `l1_records`, never `l1_fts`, so backfilling through it would write keywords BM25 never sees. Added per-row FTS re-indexing (threaded through MemoryDb→L1Store→backend→InProc/Worker→worker dispatch) so new keywords enter the retrieval axis immediately. Test includes a reverse control (plain patchMetadata does not match; AndReindex does).
+
+### Changed
+
+- **Input-area popup no longer renders the session recall list**: WingWheel drops `SessionRecalledArea` — recall display is now owned by brief-sidebar, so a second copy in the input popup was redundant (component file kept for rollback).
+
 ## [0.24.2] — 2026-10-14
 
 ### Added

package/CHANGELOG.ja.md

@@ -9,6 +9,17 @@
 
 本ファイルは **0.12.0** リリースノートと現在の**未リリース**変更の日本語版です。全履歴は [CHANGELOG.md](./CHANGELOG.md)（中文）を参照してください。
 
+## [0.25.0] — 2026-10-14
+
+### 追加
+
+- **キーワード蒸留フィッシュバック（`metadata.dsh_keywords` の産出側）**：`l1_fts` に予約された `keywords` 检索軸は産出側がなく休止状態でした。新モジュール `src/keyword-backfill.ts`（wing 回填を镜像：単飛/後台/有界/失敗時原記録不変）で `dsh_keywords` 缺失の存量 L1 を chunk で LLM に贈り、`normKeywords`（≤5、重複除去、長さ鉗制）で正规化して書き戻す。新端点 `dsh-memory/keyword-backfill`、パネル（WingWheel）に「キーワード回填」ボタン。設定 `keyword.enabled` はデフォルト**关**——关時は回填なし、`l1_fts` 逐字不変（ゼロドリフト）。
+- **`patchMetadataAndReindex`**：`patchMetadata` は `l1_records` のみ更新し `l1_fts` に触れないため、これで回填すると BM25 に永遠に見えない。行別 FTS 重索引（MemoryDb→L1Store→backend→InProc/Worker→worker 分派を貫通）を追加し、新キーワードが即座に检索軸に入る。テストは反向対照（純 patchMetadata は不命中 / AndReindex は命中）入り。
+
+### 変更
+
+- **输入区ポップアップで本会话召回リストの描画を廃止**：WingWheel から `SessionRecalledArea` を除去——召回表示は brief-sidebar が接管済みのため重复排除（コンポーネントファイルはロールバック用に保持）。
+
 ## [0.24.2] — 2026-10-14
 
 ### 追加

package/CHANGELOG.ko.md

@@ -9,6 +9,17 @@
 
 이 파일은 **0.12.0** 릴리스 노트와 현재 **미출시** 변경 사항의 한국어판입니다. 전체 이력은 [CHANGELOG.md](./CHANGELOG.md)（中文）를 참조하세요.
 
+## [0.25.0] — 2026-10-14
+
+### 신규
+
+- **키워드 증류 백필(`metadata.dsh_keywords` 산출측)**: `l1_fts` 에 예약된 `keywords` 축은 산출측이 없어 휴면이었습니다. 신규 모듈 `src/keyword-backfill.ts`(wing 백필 미러: 단일비행/후대/유계/실패시 원 기록불변)가 `dsh_keywords` 누락 L1 을 chunk 로 LLM 에 보내 키워드와 사용 시나리오를 뽑고 `normKeywords`(≤5、중복 제거、길이鉗制)로 정규화 후 기입。新 엔드 `dsh-memory/keyword-backfill`、패널(WingWheel)에 “키워드 백필” 버튼。설정 `keyword.enabled` **기본关**——关 시 백필 없음、`l1_fts` 글자 그대로 동일(영 드리프트)。
+- **`patchMetadataAndReindex`**: `patchMetadata` 는 `l1_records` 만更新하고 `l1_fts` 에 안 닿아서 이대로 백필하면 BM25 가 영영 못 봄。행별 FTS 재인덱싱(MemoryDb→L1Store→backend→InProc/Worker→worker 분派 관통)추가, 새 키워드가 즉시 검색축에。테스트에역方向 대조(순수 patchMetadata 불命中 / AndReindex 命中) 포함。
+
+### 변경
+
+- **입력영 팝업에서 본 대화召回 목록 렌더를中止**: WingWheel 의 `SessionRecalledArea` 제거——召回 表示은 brief-sidebar 가接管,重复 제거(컴포넌트 파일은 롤백용 유지)。
+
 ## [0.24.2] — 2026-10-14
 
 ### 신규

package/CHANGELOG.md

@@ -17,6 +17,17 @@
   - **建议状态(`longtask-hint-get`)以纯端点提供**:判定 = 上下文占用达 `contextThresholdPct` 或 todo 漂移达 `driftThreshold`(部署配置可调);配合 `longtask-compress-tail` 作手动压缩入口。
   - **撤下浮动球 UI(`client/src/longtask-fab.ts`;beta.1 起曾随包发布)**:悬浮建议面板的归属本在 context-compression 侧(「建议启动压缩」是其领域),pm 属误载——2026-10-02 用户裁定撤下。撤下不违座位契约(settings.section 恰一个 + 输入栏 pill,body 单例不占座位),但全应用级 overlay 会与其他插件的悬浮 UI 抢占屏幕角落;长任务开关与手动压缩入口待长任务定版时落记忆设置分节。
   - **`session-mode-set` 的 `mode` 转为可选**:与 `longTask` 二选一必传——纯切长任务开关不再被迫发送档位(旧客户端恒传 mode,行为不变)。响应 `mode` 改回当前生效值。
+## [0.25.0] — 2026-10-14
+
+### 新增
+
+- **关键词蒸馏回填（`metadata.dsh_keywords` 产出方）**：此前 `l1_fts` 预留的 `keywords` 检索轴因无产出方而休眠。新增独立回填批扫 `src/keyword-backfill.ts`（镜像 wing 回填：单飞/后台/有界/失败原记录不动），对缺 `dsh_keywords` 的存量 L1 逐块送 LLM 提炼关键词与使用场景，经 `normKeywords`（≤5、去重、长度钳）归一后写回。端点 `dsh-memory/keyword-backfill`（立即返回 `{started,running,enabled,updated,failed}`），面板（WingWheel）加「关键词回填」按钮。配置 `keyword.enabled` **默认关**——关时不回填、`l1_fts` 逐字不变（零漂移）。
+- **`patchMetadataAndReindex`（关键词轴真能生效的关键）**：`patchMetadata` 只改 `l1_records`、不碰 `l1_fts`，回填若走它则写了关键词但 BM25 永远看不到。新增按行重索引（贯穿 MemoryDb→L1Store→backend 接口→InProc/Worker→worker 分派），回填写完元数据顺带重跑该行 fts 插入，新关键词立即进检索轴。测试含反向对照（纯 patchMetadata 不命中 / AndReindex 命中）。
+
+### 变更
+
+- **输入区弹窗不再渲染本会话召回列表**：WingWheel 移除 `SessionRecalledArea`——召回展示已由 brief-sidebar 接管，输入区弹窗再渲染一份属重复（组件文件保留以备回滚）。
+
 ## [0.24.2] — 2026-10-14
 
 ### 新增

package/dist/client.js

@@ -2078,7 +2078,7 @@ var __defProp = Object.defineProperty;
 		  const showInput = scope === "all" || scope === "input";
 		  const effNote = layers.map((l) => eff[l[0]] || "?").join(" / ");
 		  const rowLabel = (key) => key === "extract" ? "抽取输出" : key === "dedup" ? "去重输出" : key === "l2" ? "L2 输出" : "L3 输出";
-		  const rowStyle2 = { display: "flex", alignItems: "center", gap: 8 };
+		  const rowStyle = { display: "flex", alignItems: "center", gap: 8 };
 		  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { children: [
 		    showOutputs ? /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { style: { marginTop: 12 }, children: [
 		      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
@@ -2089,7 +2089,7 @@ var __defProp = Object.defineProperty;
 		          children: "输出预算"
 		        }
 		      ),
-		      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { style: { display: "flex", flexDirection: "column", gap: 6, marginTop: 4 }, children: layers.map((l) => /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { style: rowStyle2, children: [
+		      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { style: { display: "flex", flexDirection: "column", gap: 6, marginTop: 4 }, children: layers.map((l) => /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { style: rowStyle, children: [
 		        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("span", { style: { width: 68, flexShrink: 0, fontSize: 12, color: "var(--dsh-mem-text-2)" }, children: rowLabel(l[0]) }),
 		        inputBox(
 		          l[0],
@@ -2111,7 +2111,7 @@ var __defProp = Object.defineProperty;
 		          children: "输入预算"
 		        }
 		      ),
-		      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { style: { display: "flex", flexDirection: "column", gap: 6, marginTop: 4 }, children: /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { style: rowStyle2, children: [
+		      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { style: { display: "flex", flexDirection: "column", gap: 6, marginTop: 4 }, children: /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { style: rowStyle, children: [
 		        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("span", { style: { width: 68, flexShrink: 0, fontSize: 12, color: "var(--dsh-mem-text-2)" }, children: "单次输入" }),
 		        inputBox(
 		          "input",
@@ -5869,7 +5869,7 @@ var __defProp = Object.defineProperty;
 		}
 		
 		// client/src/pill/MemoryModePill.tsx
-		var import_react26 = require("react");
+		var import_react25 = require("react");
 		
 		// src/util/context-occupancy.ts
 		var CONTEXT_METER_CIRCUMFERENCE = 34.55751918948772;
@@ -6185,7 +6185,7 @@ var __defProp = Object.defineProperty;
 		}
 		
 		// client/src/pill/WingWheel.tsx
-		var import_react25 = require("react");
+		var import_react24 = require("react");
 		
 		// client/src/pill/SessionInfoArea.tsx
 		var import_react23 = require("react");
@@ -6296,101 +6296,8 @@ var __defProp = Object.defineProperty;
 		  ] });
 		}
 		
-		// client/src/pill/SessionRecalledArea.tsx
-		var import_react24 = require("react");
-		var import_jsx_runtime24 = require("react/jsx-runtime");
-		var SHOW_CAP = 6;
-		var POLL_MS2 = 4e3;
-		var MATURITY_LABEL = { high: "成熟·高", mid: "成熟·中", low: "成熟·低" };
-		function SessionRecalledArea(props) {
-		  const rpc = props.rpc;
-		  const sessionId = props.sessionId;
-		  const [records, setRecords] = (0, import_react24.useState)(void 0);
-		  (0, import_react24.useEffect)(() => {
-		    if (!rpc || !sessionId) return void 0;
-		    let alive = true;
-		    let timer = null;
-		    let seq = 0;
-		    const tick = () => {
-		      const token = ++seq;
-		      rpc("dsh-memory/session-recalled", { sessionId }).then((r) => {
-		        if (!alive || token !== seq) return;
-		        if (r && r.ok && r.value) {
-		          registerTypeCatalog(r.value.typeCatalog);
-		          setRecords(r.value.records);
-		        }
-		      }).catch(() => {
-		      }).then(() => {
-		        if (alive) timer = setTimeout(tick, POLL_MS2);
-		      });
-		    };
-		    tick();
-		    return () => {
-		      alive = false;
-		      if (timer) clearTimeout(timer);
-		    };
-		  }, [rpc, sessionId]);
-		  if (records === void 0) return null;
-		  const rows = records.filter((r) => r.superseded !== true || r.retired === true);
-		  const recentFirst = [...rows].reverse();
-		  const shown = recentFirst.slice(0, SHOW_CAP);
-		  const hidden = recentFirst.length - shown.length;
-		  const allSuperseded = rows.length === 0 && records.length > 0;
-		  return /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("div", { className: "dsh-mem-sinfo", children: [
-		    /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
-		      "div",
-		      {
-		        style: { fontSize: 11, color: "var(--dsh-mem-text-3)", marginBottom: 6 },
-		        title: "本会话召回、且正文仍在上下文里的记忆（正文被摘要顶掉的已折叠不显示；清空会话才清除；不是常驻注入）",
-		        children: "本会话召回 " + rows.length + " 条"
-		      }
-		    ),
-		    allSuperseded ? (
-		      // 不是“还没召回到”——那批确实注入过，只是正文已被摘要顶掉。说谎的空态比不显示更糟。
-		      /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("div", { style: { fontSize: 11, color: "var(--dsh-mem-text-3)", lineHeight: "16px" }, children: "本会话注入过的 " + records.length + " 条记忆正文已被摘要取代" })
-		    ) : records.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("div", { style: { fontSize: 11, color: "var(--dsh-mem-text-3)", lineHeight: "16px" }, children: "还没召回到记忆（聊几轮后按相关性自动浮现）" }) : /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: 6 }, children: [
-		      shown.map((r) => /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("div", { style: rowStyle, title: rowTitle(r), children: [
-		        /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
-		          "span",
-		          {
-		            className: tagClass(r.type),
-		            style: { flexShrink: 0, whiteSpace: "nowrap" },
-		            children: typeLabel(r.type)
-		          }
-		        ),
-		        /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { className: "dsh-mem-sinfo-val", style: r.retired === true ? STALE_TEXT_STYLE : textStyle, children: r.content }),
-		        r.retired === true ? /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { style: { fontSize: 10, color: "var(--dsh-mem-text-3)", whiteSpace: "nowrap", flexShrink: 0 }, children: "已判过时" }) : null,
-		        r.maturity ? /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { style: { fontSize: 10, color: "var(--dsh-mem-text-3)", whiteSpace: "nowrap", flexShrink: 0 }, children: MATURITY_LABEL[r.maturity] }) : null
-		      ] }, r.id)),
-		      hidden > 0 ? /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("div", { style: { fontSize: 11, color: "var(--dsh-mem-text-3)" }, children: "+ " + hidden + " 条更早召回（详见面板「记忆」页）" }) : null
-		    ] })
-		  ] });
-		}
-		var rowStyle = {
-		  display: "flex",
-		  alignItems: "flex-start",
-		  gap: 6,
-		  lineHeight: "16px"
-		};
-		var textStyle = {
-		  fontSize: 12,
-		  lineHeight: "16px",
-		  fontWeight: 400,
-		  minWidth: 0,
-		  display: "-webkit-box",
-		  WebkitLineClamp: 2,
-		  WebkitBoxOrient: "vertical",
-		  overflow: "hidden"
-		};
-		var STALE_TEXT_STYLE = { ...textStyle, textDecoration: "line-through" };
-		function rowTitle(r) {
-		  const head = "[" + typeLabel(r.type) + "] " + r.content;
-		  const sc = r.usageScenario && r.usageScenario.length > 0 ? "\n使用场景：" + r.usageScenario.join("；") : "";
-		  return head + sc;
-		}
-		
 		// client/src/pill/WingWheel.tsx
-		var import_jsx_runtime25 = require("react/jsx-runtime");
+		var import_jsx_runtime24 = require("react/jsx-runtime");
 		var SIZE = 196;
 		var CENTER = SIZE / 2;
 		var R = 64;
@@ -6433,17 +6340,19 @@ var __defProp = Object.defineProperty;
 		function WingWheel(props) {
 		  ensureThemeStyle();
 		  const isOff = props.mode === "off";
-		  const [overview, setOverview] = (0, import_react25.useState)(null);
-		  const [backfillBusy, setBackfillBusy] = (0, import_react25.useState)(false);
-		  const [localError, setLocalError] = (0, import_react25.useState)(null);
-		  const timersRef = (0, import_react25.useRef)([]);
-		  (0, import_react25.useEffect)(
+		  const [overview, setOverview] = (0, import_react24.useState)(null);
+		  const [backfillBusy, setBackfillBusy] = (0, import_react24.useState)(false);
+		  const [kwBusy, setKwBusy] = (0, import_react24.useState)(false);
+		  const [kwSummary, setKwSummary] = (0, import_react24.useState)(null);
+		  const [localError, setLocalError] = (0, import_react24.useState)(null);
+		  const timersRef = (0, import_react24.useRef)([]);
+		  (0, import_react24.useEffect)(
 		    () => () => {
 		      for (const t of timersRef.current) window.clearTimeout(t);
 		    },
 		    []
 		  );
-		  (0, import_react25.useEffect)(() => {
+		  (0, import_react24.useEffect)(() => {
 		    let alive = true;
 		    props.rpc("dsh-memory/wing-overview", {}).then((r) => {
 		      if (!alive) return;
@@ -6489,28 +6398,80 @@ var __defProp = Object.defineProperty;
 		      finish();
 		    });
 		  };
-		  const boxRef = (0, import_react25.useRef)(null);
-		  const startRef = (0, import_react25.useRef)(null);
-		  const movedRef = (0, import_react25.useRef)(false);
-		  const downIndexRef = (0, import_react25.useRef)(null);
-		  const dragTargetRef = (0, import_react25.useRef)(null);
-		  const [drag, setDrag] = (0, import_react25.useState)(null);
+		  const keywordBackfill = () => {
+		    if (kwBusy) return;
+		    setKwBusy(true);
+		    setKwSummary(null);
+		    setLocalError(null);
+		    let polls = 0;
+		    const finish = () => setKwBusy(false);
+		    const showResult = (v) => {
+		      const fail = v.failed ?? 0;
+		      setKwSummary(`关键词回填完成：成功 ${v.updated ?? 0} 条${fail > 0 ? `，失败 ${fail} 条` : ""}`);
+		    };
+		    const failMsg = (m) => {
+		      setLocalError(m);
+		      finish();
+		    };
+		    const tick = () => {
+		      polls++;
+		      props.rpc("dsh-memory/keyword-backfill", {}).then((r) => {
+		        const v = r && r.ok ? r.value : null;
+		        if (!v) {
+		          failMsg("关键词回填失败");
+		          return;
+		        }
+		        if (!v.enabled) {
+		          failMsg("关键词回填未开启：请先在设置里打开 keyword.enabled");
+		          return;
+		        }
+		        if (!v.running) {
+		          showResult(v);
+		          finish();
+		          return;
+		        }
+		        if (polls >= 20) {
+		          showResult(v);
+		          finish();
+		          return;
+		        }
+		        timersRef.current.push(window.setTimeout(tick, 3e3));
+		      }).catch(() => failMsg("关键词回填失败"));
+		    };
+		    props.rpc("dsh-memory/keyword-backfill", {}).then((r) => {
+		      if (!r || !r.ok) {
+		        failMsg(r && r.error ? "关键词回填失败：" + r.error.message : "关键词回填失败");
+		        return;
+		      }
+		      if (!r.value || !r.value.enabled) {
+		        failMsg("关键词回填未开启：请先在设置里打开 keyword.enabled");
+		        return;
+		      }
+		      timersRef.current.push(window.setTimeout(tick, 3e3));
+		    }).catch((e) => failMsg("关键词回填失败：" + String(e && e.message || e)));
+		  };
+		  const boxRef = (0, import_react24.useRef)(null);
+		  const startRef = (0, import_react24.useRef)(null);
+		  const movedRef = (0, import_react24.useRef)(false);
+		  const downIndexRef = (0, import_react24.useRef)(null);
+		  const dragTargetRef = (0, import_react24.useRef)(null);
+		  const [drag, setDrag] = (0, import_react24.useState)(null);
 		  const lockedIndex = (() => {
 		    if (props.halls.length !== 1 || !overview) return null;
 		    const i = overview.corners.findIndex((c) => c.id === props.halls[0]);
 		    return i >= 0 ? i : null;
 		  })();
 		  const activeCorner = drag ? drag.index : lockedIndex;
-		  const blockPosRef = (0, import_react25.useRef)(
+		  const blockPosRef = (0, import_react24.useRef)(
 		    activeCorner != null ? cornerXY(activeCorner) : { x: CENTER, y: CENTER }
 		  );
-		  const blockTargetRef = (0, import_react25.useRef)(blockPosRef.current);
-		  const [blockPos, setBlockPos] = (0, import_react25.useState)(blockPosRef.current);
-		  (0, import_react25.useEffect)(() => {
+		  const blockTargetRef = (0, import_react24.useRef)(blockPosRef.current);
+		  const [blockPos, setBlockPos] = (0, import_react24.useState)(blockPosRef.current);
+		  (0, import_react24.useEffect)(() => {
 		    blockTargetRef.current = activeCorner != null ? cornerXY(activeCorner) : { x: CENTER, y: CENTER };
 		  }, [activeCorner]);
-		  const reducedMotionRef = (0, import_react25.useRef)(false);
-		  (0, import_react25.useEffect)(() => {
+		  const reducedMotionRef = (0, import_react24.useRef)(false);
+		  (0, import_react24.useEffect)(() => {
 		    const mq = window.matchMedia("(prefers-reduced-motion: reduce)");
 		    const apply2 = () => {
 		      reducedMotionRef.current = mq.matches;
@@ -6519,7 +6480,7 @@ var __defProp = Object.defineProperty;
 		    mq.addEventListener("change", apply2);
 		    return () => mq.removeEventListener("change", apply2);
 		  }, []);
-		  (0, import_react25.useEffect)(() => {
+		  (0, import_react24.useEffect)(() => {
 		    let raf = 0;
 		    const loop = () => {
 		      const cur = blockPosRef.current;
@@ -6608,8 +6569,8 @@ var __defProp = Object.defineProperty;
 		  }).join(" ");
 		  const grayStyle = isOff ? { opacity: 0.45, pointerEvents: "none" } : {};
 		  const boundariesDisabled = props.halls.length === 0 || isOff;
-		  return /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("div", { style: { width: SIZE }, children: [
-		    /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
+		  return /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("div", { style: { width: SIZE }, children: [
+		    /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)(
 		      "div",
 		      {
 		        ref: boxRef,
@@ -6619,7 +6580,7 @@ var __defProp = Object.defineProperty;
 		        onPointerUp: onBoxUp,
 		        onPointerCancel: onBoxUp,
 		        children: [
-		          /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
+		          /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)(
 		            "svg",
 		            {
 		              width: SIZE,
@@ -6627,7 +6588,7 @@ var __defProp = Object.defineProperty;
 		              style: { position: "absolute", inset: 0, pointerEvents: "none" },
 		              "aria-hidden": "true",
 		              children: [
-		                /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		                /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		                  "polygon",
 		                  {
 		                    points: polyPoints,
@@ -6638,7 +6599,7 @@ var __defProp = Object.defineProperty;
 		                    opacity: 0.45
 		                  }
 		                ),
-		                /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		                /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		                  "polygon",
 		                  {
 		                    points: polyPoints,
@@ -6649,7 +6610,7 @@ var __defProp = Object.defineProperty;
 		                ),
 		                [0, 1, 2, 3, 4, 5, 6, 7].map((i) => {
 		                  const p = cornerPos(i);
-		                  return /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		                  return /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		                    "line",
 		                    {
 		                      x1: CENTER,
@@ -6665,7 +6626,7 @@ var __defProp = Object.defineProperty;
 		              ]
 		            }
 		          ),
-		          /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		          /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		            "div",
 		            {
 		              "aria-hidden": "true",
@@ -6684,7 +6645,7 @@ var __defProp = Object.defineProperty;
 		              }
 		            }
 		          ),
-		          /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		          /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		            "button",
 		            {
 		              type: "button",
@@ -6718,7 +6679,7 @@ var __defProp = Object.defineProperty;
 		            const dim = activeCorner != null && !active;
 		            const empty = count === 0;
 		            const p = cornerPos(i);
-		            return /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
+		            return /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)(
 		              "div",
 		              {
 		                title: id ? `「${label}」${count ?? 0} 条
@@ -6747,8 +6708,8 @@ var __defProp = Object.defineProperty;
 		                  zIndex: 2
 		                },
 		                children: [
-		                  /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("span", { children: label }),
-		                  /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("span", { style: { fontSize: 8, opacity: 0.75, fontVariantNumeric: "tabular-nums" }, children: count === null ? " " : empty ? "空角" : `${count} 条` })
+		                  /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { children: label }),
+		                  /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { style: { fontSize: 8, opacity: 0.75, fontVariantNumeric: "tabular-nums" }, children: count === null ? " " : empty ? "空角" : `${count} 条` })
 		                ]
 		              },
 		              id ?? i
@@ -6757,7 +6718,7 @@ var __defProp = Object.defineProperty;
 		        ]
 		      }
 		    ),
-		    /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
+		    /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)(
 		      "div",
 		      {
 		        title: props.halls.length === 0 ? "选定某个角（单 Wing）后，这两项才生效" : "锁定 Wing 时两类无角记忆是否参与召回",
@@ -6771,9 +6732,9 @@ var __defProp = Object.defineProperty;
 		          pointerEvents: boundariesDisabled ? "none" : void 0
 		        },
 		        children: [
-		          /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("span", { style: { fontSize: 11, color: "var(--dsh-mem-text-3)" }, children: overview ? `另有 ${overview.unlabeled} 条未打标` : "未打标" }),
-		          /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: 6 }, children: [
-		            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		          /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { style: { fontSize: 11, color: "var(--dsh-mem-text-3)" }, children: overview ? `另有 ${overview.unlabeled} 条未打标` : "未打标" }),
+		          /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: 6 }, children: [
+		            /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		              Segmented,
 		              {
 		                value: props.hallIncludeUnlabeled ? "in" : "ex",
@@ -6784,7 +6745,7 @@ var __defProp = Object.defineProperty;
 		                onChange: (key) => props.onCommitWingBoundaries({ includeUnlabeled: key === "in" })
 		              }
 		            ),
-		            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		            /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		              Segmented,
 		              {
 		                value: props.hallIncludeGeneral ? "in" : "ex",
@@ -6799,7 +6760,7 @@ var __defProp = Object.defineProperty;
 		        ]
 		      }
 		    ),
-		    /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(Row, { label: "会话", children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		    /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(Row, { label: "会话", children: /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		      Segmented,
 		      {
 		        value: isOff ? "off" : "on",
@@ -6814,7 +6775,7 @@ var __defProp = Object.defineProperty;
 		        onChange: (key) => props.onCommit(key === "off" ? "off" : "auto")
 		      }
 		    ) }),
-		    props.recall !== void 0 && props.onCommitRecall ? /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(Row, { label: "注入", children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		    props.recall !== void 0 && props.onCommitRecall ? /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(Row, { label: "注入", children: /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		      Segmented,
 		      {
 		        value: props.recall === null ? "follow" : props.recall ? "on" : "off",
@@ -6827,7 +6788,7 @@ var __defProp = Object.defineProperty;
 		        onChange: (key) => props.onCommitRecall(key === "on" ? true : key === "off" ? false : null)
 		      }
 		    ) }) : null,
-		    /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
+		    /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)(
 		      "div",
 		      {
 		        style: {
@@ -6838,8 +6799,8 @@ var __defProp = Object.defineProperty;
 		          marginTop: 10
 		        },
 		        children: [
-		          /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("span", { style: { fontSize: 11, color: "var(--dsh-mem-text-3)" }, children: overview ? `未打标 ${overview.unlabeled} 条` : "未打标计数加载中" }),
-		          /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+		          /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { style: { fontSize: 11, color: "var(--dsh-mem-text-3)" }, children: overview ? `未打标 ${overview.unlabeled} 条` : "未打标计数加载中" }),
+		          /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
 		            ActionButton,
 		            {
 		              label: backfillBusy ? "回填中…" : "回填",
@@ -6851,13 +6812,36 @@ var __defProp = Object.defineProperty;
 		        ]
 		      }
 		    ),
-		    props.error || localError ? /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("div", { style: { fontSize: 11, color: "var(--dsh-mem-danger)", marginTop: 8 }, children: props.error || localError }) : null,
-		    /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(SessionRecalledArea, { rpc: props.rpc, sessionId: props.sessionId }),
-		    /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(SessionInfoArea, { rpc: props.rpc, sessionId: props.sessionId })
+		    /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)(
+		      "div",
+		      {
+		        style: {
+		          display: "flex",
+		          justifyContent: "space-between",
+		          alignItems: "center",
+		          gap: 8,
+		          marginTop: 10
+		        },
+		        children: [
+		          /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { style: { fontSize: 11, color: "var(--dsh-mem-text-3)" }, children: kwSummary || "为存量记忆补检索关键词" }),
+		          /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+		            ActionButton,
+		            {
+		              label: kwBusy ? "回填中…" : "关键词回填",
+		              title: "对缺 dsh_keywords 的存量记忆批量补关键词，喂 FTS 关键词检索轴（需先开 keyword.enabled）",
+		              disabled: kwBusy,
+		              onClick: () => keywordBackfill()
+		            }
+		          )
+		        ]
+		      }
+		    ),
+		    props.error || localError ? /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("div", { style: { fontSize: 11, color: "var(--dsh-mem-danger)", marginTop: 8 }, children: props.error || localError }) : null,
+		    /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(SessionInfoArea, { rpc: props.rpc, sessionId: props.sessionId })
 		  ] });
 		}
 		function Row(props) {
-		  return /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
+		  return /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)(
 		    "div",
 		    {
 		      style: {
@@ -6867,7 +6851,7 @@ var __defProp = Object.defineProperty;
 		        marginTop: 10
 		      },
 		      children: [
-		        /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("span", { style: { fontSize: 12, color: "var(--dsh-mem-text-3)" }, children: props.label }),
+		        /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("span", { style: { fontSize: 12, color: "var(--dsh-mem-text-3)" }, children: props.label }),
 		        props.children
 		      ]
 		    }
@@ -6875,9 +6859,9 @@ var __defProp = Object.defineProperty;
 		}
 		var LABEL_FALLBACK = ["工作", "人际", "学习", "创作娱乐", "居家", "健康", "财务", "出行"];
 		function useViewportClamp(popRef) {
-		  const shiftRef = (0, import_react25.useRef)(0);
-		  const [shiftX, setShiftX] = (0, import_react25.useState)(0);
-		  (0, import_react25.useEffect)(() => {
+		  const shiftRef = (0, import_react24.useRef)(0);
+		  const [shiftX, setShiftX] = (0, import_react24.useState)(0);
+		  (0, import_react24.useEffect)(() => {
 		    const clamp = () => {
 		      const el = popRef.current;
 		      if (!el) return;
@@ -6907,24 +6891,24 @@ var __defProp = Object.defineProperty;
 		}
 		
 		// client/src/pill/MemoryModePill.tsx
-		var import_jsx_runtime26 = require("react/jsx-runtime");
+		var import_jsx_runtime25 = require("react/jsx-runtime");
 		function MemoryModePill(props) {
 		  const rpc = props.rpc;
 		  const sessionId = props.sessionId || props.session && props.session.sessionId;
-		  const [mode, setMode] = (0, import_react26.useState)(null);
-		  const [recall, setRecall] = (0, import_react26.useState)(null);
-		  const [recallResolved, setRecallResolved] = (0, import_react26.useState)(true);
-		  const [halls, setWings] = (0, import_react26.useState)([]);
-		  const [hallIncludeUnlabeled, setWingIncludeUnlabeled] = (0, import_react26.useState)(true);
-		  const [hallIncludeGeneral, setWingIncludeGeneral] = (0, import_react26.useState)(false);
-		  const [wingLabels, setHallLabels] = (0, import_react26.useState)({});
-		  const [error, setError] = (0, import_react26.useState)(null);
-		  const [open, setOpen] = (0, import_react26.useState)(false);
-		  const wrapRef = (0, import_react26.useRef)(null);
-		  const popRef = (0, import_react26.useRef)(null);
+		  const [mode, setMode] = (0, import_react25.useState)(null);
+		  const [recall, setRecall] = (0, import_react25.useState)(null);
+		  const [recallResolved, setRecallResolved] = (0, import_react25.useState)(true);
+		  const [halls, setWings] = (0, import_react25.useState)([]);
+		  const [hallIncludeUnlabeled, setWingIncludeUnlabeled] = (0, import_react25.useState)(true);
+		  const [hallIncludeGeneral, setWingIncludeGeneral] = (0, import_react25.useState)(false);
+		  const [wingLabels, setHallLabels] = (0, import_react25.useState)({});
+		  const [error, setError] = (0, import_react25.useState)(null);
+		  const [open, setOpen] = (0, import_react25.useState)(false);
+		  const wrapRef = (0, import_react25.useRef)(null);
+		  const popRef = (0, import_react25.useRef)(null);
 		  const shiftX = useViewportClamp(popRef);
-		  const seqRef = (0, import_react26.useRef)(0);
-		  const load = (0, import_react26.useCallback)(() => {
+		  const seqRef = (0, import_react25.useRef)(0);
+		  const load = (0, import_react25.useCallback)(() => {
 		    if (!sessionId || !rpc) return;
 		    const token = ++seqRef.current;
 		    setError(null);
@@ -6949,13 +6933,13 @@ var __defProp = Object.defineProperty;
 		    }).catch(() => {
 		    });
 		  }, [sessionId, rpc]);
-		  (0, import_react26.useEffect)(() => {
+		  (0, import_react25.useEffect)(() => {
 		    load();
 		  }, [load]);
-		  (0, import_react26.useEffect)(() => {
+		  (0, import_react25.useEffect)(() => {
 		    watchSidebarIcon();
 		  }, []);
-		  (0, import_react26.useEffect)(() => {
+		  (0, import_react25.useEffect)(() => {
 		    initOccupancyIndicator(
 		      (endpoint, payload) => rpc(endpoint, payload)
 		    );
@@ -6963,7 +6947,7 @@ var __defProp = Object.defineProperty;
 		    watchContextMeter();
 		    noteOccupancySession(sessionId ?? null);
 		  }, [sessionId, rpc]);
-		  (0, import_react26.useEffect)(() => {
+		  (0, import_react25.useEffect)(() => {
 		    if (!open) return;
 		    const onDown = (e) => {
 		      if (wrapRef.current && !wrapRef.current.contains(e.target)) setOpen(false);
@@ -7103,8 +7087,8 @@ var __defProp = Object.defineProperty;
 		    pillStyle.boxShadow = "0 0 12px color-mix(in srgb, " + info.color + " 30%, transparent)";
 		    pillStyle["--dsh-mem-pill-tint"] = info.color;
 		  }
-		  return /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)("div", { ref: wrapRef, style: { position: "relative", display: "inline-flex" }, children: [
-		    /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)(
+		  return /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("div", { ref: wrapRef, style: { position: "relative", display: "inline-flex" }, children: [
+		    /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
 		      "button",
 		      {
 		        type: "button",
@@ -7117,11 +7101,11 @@ var __defProp = Object.defineProperty;
 		        style: pillStyle,
 		        children: [
 		          "记忆 · ",
-		          /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("span", { children: faceLabel })
+		          /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("span", { children: faceLabel })
 		        ]
 		      }
 		    ),
-		    open ? /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+		    open ? /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
 		      "div",
 		      {
 		        ref: popRef,
@@ -7132,12 +7116,12 @@ var __defProp = Object.defineProperty;
 		          transform: "translateX(calc(-50% + " + shiftX + "px))",
 		          zIndex: 1e3
 		        },
-		        children: /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+		        children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
 		          "div",
 		          {
 		            className: "dsh-mem-popover",
 		            style: { position: "relative", padding: "10px 12px" },
-		            children: /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+		            children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
 		              WingWheel,
 		              {
 		                mode: mode || "auto",

package/dist/config.d.ts

@@ -193,6 +193,18 @@ export interface MemoryConfig {
     usageScenario: {
         enabled: boolean;
     };
+    /**
+     * 关键词蒸馏回填（keyword 检索轴的产出方）：**独立回填批扫**，为缺 `metadata.dsh_keywords` 的
+     * L1 记录批量补关键词，喂 `l1_fts` 的关键词轴（`ftsKeywordText` 读该键）。由
+     * `dsh-memory/keyword-backfill` 端点触发，镜像 wing 回填（单飞/后台/有界）。
+     *
+     * **默认关**：关时不回填、不产该键、`l1_fts.keywords` 列逐字不变（零漂移）。护栏复用 `backfill`。
+     * 注：写回走 `patchMetadata` 只改主表，回填会**额外重索引该记录的 fts 行**（见 keyword-backfill），
+     * 否则关键词轴对存量记录不生效。
+     */
+    keyword: {
+        enabled: boolean;
+    };
     /**
      * 类型叙述模板（G2）：抽取时按 7 类型各自的“前因后果”骨架写 content。
      *

package/dist/config.js

@@ -226,6 +226,10 @@ export const memorySchema = Schema.object({
     usageScenario: Schema.object({
         enabled: Schema.boolean().default(false),
     }),
+    // 关键词蒸馏回填：默认关（关时不回填、不产 dsh_keywords、FTS 逐字不变）；护栏复用 backfill。
+    keyword: Schema.object({
+        enabled: Schema.boolean().default(false),
+    }),
     // 类型叙述模板（G2）：默认**开**；开时抽取 prompt 追加分类型 content 骨架（关时仍逐字不变）。
     // 默认值从关改开的理由写在上方接口注释：只给定义实测骨架齐备 0/23，
     // 而"没前因后果就不算可用"是用户定的判据，所以默认值要按可用性定而不是按保守定。

package/dist/contract.d.ts

@@ -647,6 +647,18 @@ export interface WingBackfillResponse {
     started: boolean;
     running: boolean;
 }
+/** dsh-memory/keyword-backfill（关键词蒸馏回填，后台任务；门控关时 enabled=false 不启动）。 */
+export interface KeywordBackfillResponse {
+    /** true = 本次触发启动了新任务；false = 已有任务在跑或门控关。 */
+    started: boolean;
+    running: boolean;
+    /** 门控 `cfg.keyword.enabled`；关时不启动，面板据此提示先开开关。 */
+    enabled: boolean;
+    /** 本进程累计成功回填条数（重启归零；观测用）。 */
+    updated: number;
+    /** 失败/跳过数。 */
+    failed: number;
+}
 /** dsh-memory/session-stats(悬浮卡信息区;热路径端点)。 */
 export interface SessionStatsRequest {
     sessionId: string;
@@ -1650,6 +1662,7 @@ export interface DshMemoryRequestMap {
     'dsh-memory/room-register': RoomRegisterRequest;
     'dsh-memory/room-admin': RoomAdminRequest;
     'dsh-memory/wing-backfill': Record<string, never>;
+    'dsh-memory/keyword-backfill': Record<string, never>;
     'dsh-memory/session-stats': SessionStatsRequest;
     'dsh-memory/settings-get': Record<string, never>;
     'dsh-memory/settings-set': SettingsSetRequest;
@@ -1712,6 +1725,7 @@ export interface DshMemoryResponseMap {
     'dsh-memory/room-register': RoomRegisterResponse;
     'dsh-memory/room-admin': RoomAdminResponse;
     'dsh-memory/wing-backfill': WingBackfillResponse;
+    'dsh-memory/keyword-backfill': KeywordBackfillResponse;
     'dsh-memory/session-stats': SessionStatsResponse;
     'dsh-memory/settings-get': SettingsGetResponse;
     'dsh-memory/settings-set': SettingsSetResponse;

package/dist/keyword-backfill.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 关键词蒸馏回填（keyword axis 产出方）。
+ *
+ * 职责：从 L1 记录中找「缺 dsh_keywords」的存量记录，按 chunk 20 条一批送 LLM 提炼关键词
+ * 与使用场景，归一后写 `metadata.dsh_keywords` + `metadata.dsh_usage_scenario`，
+ * 并用 `patchMetadataAndReindex` 保证新关键词**立即进 FTS BM25 轴**。
+ *
+ * 安全边界（继承 wing-backfill）：
+ * - 单飞：同时最多一个回填任务,重复触发直接返回 running(不排队不叠加)
+ * - 后台执行：端点立即返回,逐块推进(每块 20 条),不阻塞 RPC/管线
+ * - 失败可退：LLM 失败/输出不合法只跳过当前块,原记录零改动(标签只写成功的)
+ * - 有界：单次任务最多处理 cfg.backfill.maxRecords 条,防止一次跑飞;其余可再次触发
+ * - 门控关（`cfg.keyword.enabled = false`）：run() 入口立即跳过——无回填、FTS 逐字不变
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { MemoryLogger, MemoryRecord } from './types.js';
+import type { MemoryBackend } from './store/memory-backend.js';
+import type { MemoryConfig } from './config.js';
+export interface KeywordBackfillDeps {
+    ctx: Context;
+    cfg: MemoryConfig;
+    backend: MemoryBackend;
+    logger: MemoryLogger;
+}
+export interface KeywordBackfillState {
+    running: boolean;
+    updated: number;
+    failed: number;
+}
+export declare function keywordBackfillState(): KeywordBackfillState;
+/** 启动后台关键词回填；已在运行返回 false（单飞）。 */
+export declare function startKeywordBackfill(deps: KeywordBackfillDeps): {
+    started: boolean;
+    running: boolean;
+};
+/**
+ * 回填主体（导出供单测 await 到完成；生产走 `startKeywordBackfill` 的单飞后台包装）。
+ * 门控关（`cfg.keyword.enabled = false`）时入口立即返回，不碰任何记录与 fts。
+ */
+export declare function runKeywordBackfillOnce(deps: KeywordBackfillDeps): Promise<void>;
+/** 关键词标注器（导出供单测）。 */
+export declare function labelKeywordChunk(ctx: Context, cfg: MemoryConfig, logger: MemoryLogger, chunk: MemoryRecord[]): Promise<Array<{
+    record: MemoryRecord;
+    keywords: string[];
+    usageScenario?: string[];
+}>>;

package/dist/keyword-backfill.js

@@ -0,0 +1,143 @@
+import { callLLM, parseJsonLogged } from './llm.js';
+import { normKeywords, normUsageScenario, KEYWORDS_METADATA_KEY } from './metadata-validators.js';
+import { yieldLoop } from './util/yield.js';
+/** 每块条数（一次 LLM 调用判定的记录数；与 wing-backfill 同口径）。 */
+const CHUNK = 20;
+/** 扫描页大小（轻量投影分页；与 wing-backfill 一致）。 */
+const PAGE = 200;
+/** 单次任务默认处理上限（cfg.backfill.maxRecords 优先）。 */
+const DEFAULT_MAX_RECORDS = 300;
+/** 墙钟默认预算（cfg.backfill.timeBudgetMs 优先）。 */
+const DEFAULT_TIME_BUDGET_MS = 120_000;
+const state = { running: false, updated: 0, failed: 0 };
+export function keywordBackfillState() {
+    return { ...state };
+}
+// ── SYSTEM 提示词（定稿版，由 tools/keyword-distill.prompt.md 的 ```text 块迁移） ──
+const SYSTEM_PROMPT = [
+    '你是记忆库的关键词与情景标注器。给定若干条记忆（每条含 id、标题、正文摘要），为每条提炼：',
+    '1) keywords：最能代表该记忆的检索词，用于精确命中；2) usage_scenario：未来「何时应当浮现这条记忆」的场景短语。',
+    '',
+    '严格规则：',
+    '- keywords 的唯一判据：**用户未来会输入什么词把这条记忆捞出来**。优先具体名词性标识——项目/模块/文件/函数/配置项/命令/错误码/版本号/数字阈值/工具名/专有实体名。',
+    '- **禁止**把正文里的动宾短语压缩成抽象黑话当关键词（反例：把"判定批量流量"压成"批量流量判定"、把"做窗口滑动归因"压成"窗口滑动归因"、把"保持只读约束"压成"只读约束"）——这类词没人会拿去搜，一律换成它指向的具体实体/标识，或直接删掉。',
+    '- keywords：2–5 个（宁少勿滥，够区分即可）；每个 2–6 词或 1 个复合术语；不得与标题字面重复、不得互相近义堆叠、不收停用词/整句。',
+    '- usage_scenario：1–3 条；每条 5–10 词的短场景描述（不是完整命令句）；彼此必须可区分，相似的合并成更泛化的一条。',
+    '- 语言跟随该记忆正文：中文记忆产出中文（技术标识符、API 名、错误码原样保留），英文记忆产出英文。',
+    '- id 必须原样照抄，不得改写、截断或改用序号；一条记忆只产一组，不要拆分。',
+    '',
+    '输出：只输出一个 JSON 数组，不要多余文字、不要解释。每项形如：',
+    '{"id":"<原id>","keywords":["…","…"],"usage_scenario":["…","…"]}',
+].join('\n');
+/** 启动后台关键词回填；已在运行返回 false（单飞）。 */
+export function startKeywordBackfill(deps) {
+    if (state.running)
+        return { started: false, running: true };
+    state.running = true;
+    state.updated = 0;
+    state.failed = 0;
+    void runKeywordBackfillOnce(deps).finally(() => {
+        state.running = false;
+        deps.logger.info(`[memory] keyword 回填结束:成功 ${state.updated} 条,失败 ${state.failed} 条`);
+    });
+    return { started: true, running: true };
+}
+/**
+ * 回填主体（导出供单测 await 到完成；生产走 `startKeywordBackfill` 的单飞后台包装）。
+ * 门控关（`cfg.keyword.enabled = false`）时入口立即返回，不碰任何记录与 fts。
+ */
+export async function runKeywordBackfillOnce(deps) {
+    const { cfg, backend, logger } = deps;
+    if (!cfg.keyword?.enabled) {
+        logger.info('[memory] keyword 回填跳过：keyword.enabled = false（功能关，不回填）');
+        return;
+    }
+    const MAX_RECORDS = cfg.backfill?.maxRecords ?? DEFAULT_MAX_RECORDS;
+    const TIME_BUDGET_MS = cfg.backfill?.timeBudgetMs ?? DEFAULT_TIME_BUDGET_MS;
+    const startedAt = Date.now();
+    // ── 扫描阶段（轻量投影，不反序列化正文）──
+    const total = await backend.size();
+    const pendingIds = [];
+    let scanned = 0;
+    for (let offset = 0;; offset += PAGE) {
+        const page = await backend.allLite(PAGE, offset);
+        if (page.length === 0)
+            break;
+        for (const r of page) {
+            const kw = r.metadata?.[KEYWORDS_METADATA_KEY];
+            if (!(Array.isArray(kw) && kw.length > 0))
+                pendingIds.push(r.id);
+        }
+        scanned += page.length;
+        if (Date.now() - startedAt > TIME_BUDGET_MS) {
+            logger.info(`[memory] keyword 回填：墙钟预算(${TIME_BUDGET_MS / 1000}s)在扫描阶段用尽(已扫 ${scanned}/${total}),留待再触发`);
+            return;
+        }
+        await yieldLoop();
+    }
+    let budget = Math.min(pendingIds.length, MAX_RECORDS);
+    logger.info(`[memory] keyword 回填启动：缺关键词 ${pendingIds.length} 条,本次上限 ${budget} 条`);
+    // ── 标注阶段（补水→LLM→归一→写回）──
+    for (let offset = 0; offset < pendingIds.length && budget > 0; offset += CHUNK) {
+        if (Date.now() - startedAt > TIME_BUDGET_MS) {
+            logger.info(`[memory] keyword 回填：墙钟预算用尽,剩余 ${pendingIds.length - offset} 条留待再触发`);
+            break;
+        }
+        const hydrated = await backend.getByIds(pendingIds.slice(offset, offset + CHUNK));
+        const chunk = hydrated.filter((r) => r.content && r.content.trim() !== '');
+        if (chunk.length === 0)
+            continue;
+        budget -= chunk.length;
+        const labeled = await labelKeywordChunk(deps.ctx, cfg, logger, chunk);
+        for (const { record, keywords, usageScenario } of labeled) {
+            const meta = { ...(record.metadata ?? {}) };
+            meta[KEYWORDS_METADATA_KEY] = keywords;
+            if (usageScenario && usageScenario.length > 0)
+                meta.dsh_usage_scenario = usageScenario;
+            if (await backend.patchMetadataAndReindex(record.id, meta))
+                state.updated++;
+            else
+                state.failed++;
+            await yieldLoop();
+        }
+    }
+}
+/** 关键词标注器（导出供单测）。 */
+export async function labelKeywordChunk(ctx, cfg, logger, chunk) {
+    const list = chunk.map((r, i) => `${i + 1}. id=${r.id}\n标题：${r.name ?? ''}\n正文：${r.content.slice(0, 300)}`).join('\n\n');
+    const user = '记忆列表:\n' + list;
+    try {
+        const raw = await callLLM(ctx, cfg, {
+            system: SYSTEM_PROMPT,
+            user,
+            maxTokens: 4096,
+            layer: 'l1-extract',
+            logger,
+        });
+        const parsed = parseJsonLogged(raw, 'keyword 回填', logger);
+        if (!Array.isArray(parsed))
+            return [];
+        const byId = new Map(chunk.map((r) => [r.id, r]));
+        const out = [];
+        for (const item of parsed) {
+            const record = typeof item?.id === 'string' ? byId.get(item.id) : undefined;
+            if (!record) {
+                logger.warn(`[memory] keyword 回填:id 配对失败,已丢弃(id=${String(item?.id).slice(0, 40)})`);
+                continue;
+            }
+            const keywords = normKeywords(item.keywords, 5);
+            if (keywords.length === 0) {
+                logger.warn(`[memory] keyword 回填:normKeywords 结果为空,已跳过(id=${record.id})`);
+                continue;
+            }
+            const usageScenario = normUsageScenario(item.usage_scenario, 3);
+            out.push({ record, keywords, usageScenario: usageScenario.length > 0 ? usageScenario : undefined });
+        }
+        return out;
+    }
+    catch (err) {
+        logger.warn(`[memory] keyword 回填块失败(跳过 ${chunk.length} 条,原记录未改): ${err instanceof Error ? err.message : String(err)}`);
+        state.failed += chunk.length;
+        return [];
+    }
+}

package/dist/metadata-validators.d.ts

@@ -32,6 +32,15 @@ export { isCognitiveHall, COGNITIVE_HALLS, type CognitiveHall } from './cognitiv
  * 非数组或空→ `[]`（缺字段中性，不抛——防单条抽取失败波及整切片重试）。
  */
 export declare function normUsageScenario(v: unknown, max?: number): string[];
+/** 关键词检索轴的磁盘保留键（喂 `l1_fts.keywords` 列，读取侧见 `sqlite.ftsKeywordText`）。 */
+export declare const KEYWORDS_METADATA_KEY = "dsh_keywords";
+/**
+ * 关键词归一 + 去重（忽略大小写）+ 长度钳 + 上限。**所有 `dsh_keywords` 写回点必须过这里**。
+ *
+ * 与 `normUsageScenario` 同范式（关键词是自然语言术语/标识符，非 slug，不做字符集校验），
+ * 只是上限更紧（≤5）、单条更短。非数组/空→`[]`（缺字段中性，不抛——防单条产出失败波及整批）。
+ */
+export declare function normKeywords(v: unknown, max?: number): string[];
 /**
  * 读 **Wing（生活域）**。⚠️ 磁盘键是 `metadata.hall`——历史别名，存的其实是 **wing 值**。
  * 只认词表内的合法 wing（8 角 + general），否则 undefined。

package/dist/metadata-validators.js

@@ -92,6 +92,37 @@ export function normUsageScenario(v, max = 3) {
     }
     return out;
 }
+/** 关键词检索轴的磁盘保留键（喂 `l1_fts.keywords` 列，读取侧见 `sqlite.ftsKeywordText`）。 */
+export const KEYWORDS_METADATA_KEY = 'dsh_keywords';
+/** 单个关键词最大字符数：按“词”太主观，用字符上限兜住整句泄漏（CJK 复合术语通常 ≤12）。 */
+const KEYWORD_MAX_CHARS = 24;
+/**
+ * 关键词归一 + 去重（忽略大小写）+ 长度钳 + 上限。**所有 `dsh_keywords` 写回点必须过这里**。
+ *
+ * 与 `normUsageScenario` 同范式（关键词是自然语言术语/标识符，非 slug，不做字符集校验），
+ * 只是上限更紧（≤5）、单条更短。非数组/空→`[]`（缺字段中性，不抛——防单条产出失败波及整批）。
+ */
+export function normKeywords(v, max = 5) {
+    if (!Array.isArray(v) || max <= 0)
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const raw of v) {
+        if (typeof raw !== 'string')
+            continue;
+        const t = raw.trim();
+        if (!t)
+            continue;
+        const key = t.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(t.slice(0, KEYWORD_MAX_CHARS));
+        if (out.length >= max)
+            break;
+    }
+    return out;
+}
 /**
  * 读 **Wing（生活域）**。⚠️ 磁盘键是 `metadata.hall`——历史别名，存的其实是 **wing 值**。
  * 只认词表内的合法 wing（8 角 + general），否则 undefined。

package/dist/stats.js

@@ -33,6 +33,7 @@ import { isRoomSlug } from './metadata-validators.js';
 import { InProcMemoryBackend } from './store/memory-backend.js';
 import { isWingCorner } from './store/session-modes.js';
 import { startWingBackfill } from './wing-backfill.js';
+import { startKeywordBackfill, keywordBackfillState } from './keyword-backfill.js';
 import { errDetail } from './util/filelog.js';
 import { snapshotTokenCost } from './token-cost.js';
 import { computeMaturity } from './util/maturity.js';
@@ -70,6 +71,7 @@ export const MEMORY_ENDPOINTS = [
     'dsh-memory/room-register',
     'dsh-memory/room-admin',
     'dsh-memory/wing-backfill',
+    'dsh-memory/keyword-backfill',
     'dsh-memory/session-stats',
     'dsh-memory/settings-get',
     'dsh-memory/settings-set',
@@ -1140,6 +1142,19 @@ export async function handleEndpoint(endpoint, payload, deps) {
             });
             return r;
         }
+        case 'dsh-memory/keyword-backfill': {
+            // 门控关：不启动，如实报 enabled=false（面板据此提示“先开关键词回填开关”）。
+            if (!cfg.keyword?.enabled)
+                return { started: false, running: false, enabled: false, updated: 0, failed: 0 };
+            const r = startKeywordBackfill({
+                ctx: deps.ctx,
+                cfg: deps.cfg,
+                backend: stores.backend ?? new InProcMemoryBackend(stores.l1),
+                logger: deps.logger,
+            });
+            const st = keywordBackfillState();
+            return { started: r.started, running: r.running, enabled: true, updated: st.updated, failed: st.failed };
+        }
         // ── 会话级统计(悬浮卡信息区;热路径端点,见 SessionInfoSource 的零 I/O 硬规则) ──
         case 'dsh-memory/session-stats': {
             if (!sessionInfo)

package/dist/store/l1.d.ts

@@ -127,6 +127,12 @@ export declare class L1Store {
      * 返回 false 表示 id 不存在或写入失败——调用方须记账,不许静默。
      */
     patchMetadata(id: string, metadata: Record<string, unknown>): boolean;
+    /**
+     * 写 metadata_json + 顺带重索引 `l1_fts`（关键词回填专用）。
+     * 与 `patchMetadata` 的区分：后者只改主表（适合 tags/room/relabel 这类不进 fts 的元数据）；
+     * 本方法额外重跑该行的 fts 插入，让新写的 `dsh_keywords` 立刻进 BM25 关键词轴。
+     */
+    patchMetadataAndReindex(id: string, metadata: Record<string, unknown>): boolean;
     /** repo 归属修补(ADR-0015 T3.3;人工消歧用)。CAS:expectRepoKeyName 非空时要求当前值匹配。 */
     patchRepoKey(id: string, patch: {
         repoKeyName?: string;

package/dist/store/l1.js

@@ -156,6 +156,14 @@ export class L1Store {
     patchMetadata(id, metadata) {
         return this.db.patchL1Metadata(id, metadata);
     }
+    /**
+     * 写 metadata_json + 顺带重索引 `l1_fts`（关键词回填专用）。
+     * 与 `patchMetadata` 的区分：后者只改主表（适合 tags/room/relabel 这类不进 fts 的元数据）；
+     * 本方法额外重跑该行的 fts 插入，让新写的 `dsh_keywords` 立刻进 BM25 关键词轴。
+     */
+    patchMetadataAndReindex(id, metadata) {
+        return this.db.patchL1MetadataAndReindex(id, metadata);
+    }
     /** repo 归属修补(ADR-0015 T3.3;人工消歧用)。CAS:expectRepoKeyName 非空时要求当前值匹配。 */
     patchRepoKey(id, patch, expectRepoKeyName) {
         const changed = this.db.patchRepoKey(id, patch, expectRepoKeyName);

package/dist/store/memory-backend-worker.d.ts

@@ -29,6 +29,7 @@ export declare class WorkerMemoryBackend implements MemoryBackend {
     getByIds(ids: string[]): Promise<MemoryRecord[]>;
     list(opts: L1ListOpts): Promise<L1ListResult>;
     patchMetadata(id: string, metadata: Record<string, unknown>): Promise<boolean>;
+    patchMetadataAndReindex(id: string, metadata: Record<string, unknown>): Promise<boolean>;
     size(): Promise<number>;
     dispose(): Promise<void>;
 }

package/dist/store/memory-backend-worker.js

@@ -100,6 +100,9 @@ export class WorkerMemoryBackend {
     async patchMetadata(id, metadata) {
         return this.call('patchMetadata', [id, metadata]);
     }
+    async patchMetadataAndReindex(id, metadata) {
+        return this.call('patchMetadataAndReindex', [id, metadata]);
+    }
     async size() {
         return this.call('size', []);
     }

package/dist/store/memory-backend.d.ts

@@ -50,6 +50,8 @@ export interface MemoryBackend {
     list(opts: L1ListOpts): Promise<L1ListResult>;
     /** **只**更新 metadata_json(不动 content,不重算嵌入)。 */
     patchMetadata(id: string, metadata: Record<string, unknown>): Promise<boolean>;
+    /** 写 metadata_json + 重索引该行的 `l1_fts`（关键词回填专用；新 `dsh_keywords` 要立刻进 BM25 轴）。 */
+    patchMetadataAndReindex(id: string, metadata: Record<string, unknown>): Promise<boolean>;
     /** L1 记录总数(巡检进度分母)。 */
     size(): Promise<number>;
     /** 释放后端(worker 实现会 terminate 线程)。 */
@@ -68,6 +70,7 @@ export declare class InProcMemoryBackend implements MemoryBackend {
     getByIds(ids: string[]): Promise<MemoryRecord[]>;
     list(opts: L1ListOpts): Promise<L1ListResult>;
     patchMetadata(id: string, metadata: Record<string, unknown>): Promise<boolean>;
+    patchMetadataAndReindex(id: string, metadata: Record<string, unknown>): Promise<boolean>;
     size(): Promise<number>;
     dispose(): Promise<void>;
 }

package/dist/store/memory-backend.js

@@ -21,6 +21,9 @@ export class InProcMemoryBackend {
     async patchMetadata(id, metadata) {
         return this.l1.patchMetadata(id, metadata);
     }
+    async patchMetadataAndReindex(id, metadata) {
+        return this.l1.patchMetadataAndReindex(id, metadata);
+    }
     async size() {
         return this.l1.size;
     }

package/dist/store/memory-worker.js

@@ -60,6 +60,9 @@ else {
                     case 'patchMetadata':
                         reply(id, true, handle.patchL1Metadata(String(args[0]), args[1]));
                         return;
+                    case 'patchMetadataAndReindex':
+                        reply(id, true, handle.patchL1MetadataAndReindex(String(args[0]), args[1]));
+                        return;
                     case 'size':
                         reply(id, true, handle.countL1());
                         return;

package/dist/store/sqlite.d.ts

@@ -305,6 +305,17 @@ export declare class MemoryDb {
     /** 打标作业完成/失败(失败保留行供诊断;重算由下一次触发再入队)。 */
     finishSceneRecluster(jobId: string, ok: boolean): void;
     patchL1Metadata(id: string, metadata: Record<string, unknown>): boolean;
+    /**
+     * 更新 metadata_json 后**顺带重索引该行的 `l1_fts`**（关键词回填专用）。
+     *
+     * `patchL1Metadata` 本身不碰 fts——多数写回点（tags / room / relabel）不需要、也不想付这个代价；
+     * 但关键词轴若只写元数据不重索引，`ftsKeywordText` 读不到新 `dsh_keywords`，那条 BM25 轴
+     * 对存量记录永远空。故把「写元数据 + 重索引」焊在一个方法里，杜绝“写了关键词但检索看不到”。
+     *
+     * 退场/不存在的行：只从 fts 删除（幂等），不插入。fts 不可用时降级为纯 `patchL1Metadata`。
+     * 参数列表与 `stmtL1FtsInsert` / `backfillL1Fts` 逐位对齐（同三处列清单，漏一列静默丢索引）。
+     */
+    patchL1MetadataAndReindex(id: string, metadata: Record<string, unknown>): boolean;
     /** 全量读取(调试/迁移/重嵌入用;检索请走 FTS/向量)。 */
     getAllL1(): MemoryRecord[];
     getL1ByIds(ids: string[]): MemoryRecord[];

package/dist/store/sqlite.js

@@ -1509,6 +1509,39 @@ export class MemoryDb {
             return false;
         }
     }
+    /**
+     * 更新 metadata_json 后**顺带重索引该行的 `l1_fts`**（关键词回填专用）。
+     *
+     * `patchL1Metadata` 本身不碰 fts——多数写回点（tags / room / relabel）不需要、也不想付这个代价；
+     * 但关键词轴若只写元数据不重索引，`ftsKeywordText` 读不到新 `dsh_keywords`，那条 BM25 轴
+     * 对存量记录永远空。故把「写元数据 + 重索引」焊在一个方法里，杜绝“写了关键词但检索看不到”。
+     *
+     * 退场/不存在的行：只从 fts 删除（幂等），不插入。fts 不可用时降级为纯 `patchL1Metadata`。
+     * 参数列表与 `stmtL1FtsInsert` / `backfillL1Fts` 逐位对齐（同三处列清单，漏一列静默丢索引）。
+     */
+    patchL1MetadataAndReindex(id, metadata) {
+        const ok = this.patchL1Metadata(id, metadata);
+        if (!ok || this.degraded || !this.ftsAvailable)
+            return ok;
+        try {
+            const r = this.db
+                .prepare(`SELECT record_id, content, type, priority, scene_name, session_id, version,
+                  timestamp_str, timestamp_start, timestamp_end, metadata_json, family,
+                  scope, workspace_id FROM l1_records
+           WHERE record_id = ? AND NOT (${retiredL1Sql()})`)
+                .get(id);
+            // 退场/缺失行：只确保从 fts 剔除（幂等），不插入；活跃行：删旧行再按当前（含新关键词）元数据重插。
+            this.stmtL1FtsDelete.run(id);
+            if (r) {
+                this.stmtL1FtsInsert.run(tokenizeForFts(ftsKeywordText(parseMetadataJson(String(r.metadata_json ?? '{}')))), tokenizeForFts(String(r.content ?? '')), String(r.content ?? ''), String(r.record_id ?? ''), String(r.type ?? ''), Number(r.priority ?? 50), String(r.scene_name ?? ''), String(r.session_id ?? 'default'), Number(r.version ?? 0), String(r.timestamp_str ?? ''), String(r.timestamp_start ?? ''), String(r.timestamp_end ?? ''), String(r.metadata_json ?? '{}'), String(r.family ?? 'chat'), normScope(r.scope), String(r.workspace_id ?? ''));
+            }
+        }
+        catch (err) {
+            // 重索引失败不回滚元数据写（关键词已落主表）；下次全量 FTS 重建会对齐，并留痕。
+            this.logger?.warn(`${TAG} 关键词重索引失败(id=${id}，元数据已写、fts 待重建对齐): ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return ok;
+    }
     /** 全量读取(调试/迁移/重嵌入用;检索请走 FTS/向量)。 */
     getAllL1() {
         if (this.degraded)

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-prime-memory",
   "name": "dsh-prime-memory",
-  "version": "0.24.2",
+  "version": "0.25.0",
   "description": {
     "en": "Layered distilled memory plugin (L0 capture → L1 atomic memory → L2 scenes → L3 persona) with automatic recall injection before each model step.",
     "zh": "L0~L3 分层蒸馏记忆插件:自动捕获对话、抽取原子记忆、整合场景块、蒸馏核心画像,并在模型步骤前自动召回注入。"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.24.2",
+  "version": "0.25.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",