dsh-prime-memory 0.16.1-beta.0 → 0.16.1-beta.1

package/CHANGELOG.md

@@ -58,6 +58,10 @@
 
 ## [0.16.1] — 2026-09-24
 
+### 新增
+
+- **记录面板「退场筛查」**：软删记录按设计不隐藏（可恢复），但与活跃记录混排不便分辨——现在列表工具行加了三态筛选「**全部 / 仅活跃 / 仅退场**」。后端 `listL1` 补同口径三态过滤（缺省全量，快照/重建不受影响；`retired:true` 与 `listRetiredL1` 同一判据，两份视图看到同一批行）；契约 `ListRecordsRequest.retired?: boolean`。筛查仅浏览路径生效——关键词检索只覆盖检索面，已退场记录本就不在其中。「加载更多」与删除/恢复后的自动刷新都会保持当前筛查态。
+
 ### 修复
 
 - **面板「删除记忆」确认后看似毫无反应——退场态没有透传给 UI。** 软删（retire）在服务端一直正常（`valid_to` 闭合 + 撤出检索面 + 可恢复），但按设计活动列表**保留**退场记录（`l1-retire` 测试钉死「面板浏览路径不隐藏退场记录」），而 `UiRecord` 契约里根本没有"是否已退场"字段、活动列表的记录行也没有任何视觉差异，"已退场"区又默认折叠——用户确认删除后看到的是**一条一模一样的记录**，自然以为"删除没生效"。

package/dist/client.js

@@ -3226,6 +3226,11 @@ var __defProp = Object.defineProperty;
 		// client/src/tabs/RecordsTab.tsx
 		var import_react15 = require("react");
 		var import_jsx_runtime15 = require("react/jsx-runtime");
+		function retiredSelOf(r) {
+		  if (r === "active") return false;
+		  if (r === "retired") return true;
+		  return void 0;
+		}
 		var TYPE_CHOICES = [
 		  "persona",
 		  "episodic",
@@ -3255,9 +3260,10 @@ var __defProp = Object.defineProperty;
 		  const [sceneFilter, setSceneFilter] = (0, import_react15.useState)("");
 		  const [hallFilter, setHallFilter] = (0, import_react15.useState)([]);
 		  const [tagFilter, setTagFilter] = (0, import_react15.useState)("");
+		  const [retiredFilter, setRetiredFilter] = (0, import_react15.useState)("");
 		  const [rooms, setRooms] = (0, import_react15.useState)([]);
 		  const [wingCatalog, setHallCatalog] = (0, import_react15.useState)(null);
-		  const [last, setLast] = (0, import_react15.useState)({ query: "", type: "", scene: "", halls: [], tag: "" });
+		  const [last, setLast] = (0, import_react15.useState)({ query: "", type: "", scene: "", halls: [], tag: "", retired: "" });
 		  const seqRef = (0, import_react15.useRef)(0);
 		  const fetchPage = (0, import_react15.useCallback)(
 		    (conds, offset, append) => {
@@ -3270,6 +3276,8 @@ var __defProp = Object.defineProperty;
 		      if (conds.scene) payload.scene = conds.scene;
 		      if (conds.halls.length > 0) payload.halls = conds.halls;
 		      if (conds.tag) payload.tag = conds.tag;
+		      const retiredSel = retiredSelOf(conds.retired);
+		      if (retiredSel !== void 0) payload.retired = retiredSel;
 		      rpc("dsh-memory/list-records", payload).then((r) => {
 		        if (token !== seqRef.current) return;
 		        setLoading(false);
@@ -3294,7 +3302,13 @@ var __defProp = Object.defineProperty;
 		    [rpc]
 		  );
 		  const search = () => {
-		    const conds = { query: query.trim(), type: typeFilter, scene: sceneFilter, halls: hallFilter, tag: tagFilter };
+		    const conds = { query: query.trim(), type: typeFilter, scene: sceneFilter, halls: hallFilter, tag: tagFilter, retired: retiredFilter };
+		    setLast(conds);
+		    fetchPage(conds, 0, false);
+		  };
+		  const applyRetiredFilter = (next) => {
+		    setRetiredFilter(next);
+		    const conds = { query: query.trim(), type: typeFilter, scene: sceneFilter, halls: hallFilter, tag: tagFilter, retired: next };
 		    setLast(conds);
 		    fetchPage(conds, 0, false);
 		  };
@@ -3305,7 +3319,7 @@ var __defProp = Object.defineProperty;
 		    });
 		  }, [rpc]);
 		  (0, import_react15.useEffect)(() => {
-		    fetchPage({ query: "", type: "", scene: "", halls: [], tag: "" }, 0, false);
+		    fetchPage({ query: "", type: "", scene: "", halls: [], tag: "", retired: "" }, 0, false);
 		    loadRooms();
 		  }, [fetchPage, loadRooms]);
 		  const loadHiPriv = (0, import_react15.useCallback)(() => {
@@ -3486,7 +3500,7 @@ var __defProp = Object.defineProperty;
 		            onClick: () => {
 		              const next = on ? "" : r.room;
 		              setTagFilter(next);
-		              const conds = { query: query.trim(), type: typeFilter, scene: sceneFilter, halls: hallFilter, tag: next };
+		              const conds = { query: query.trim(), type: typeFilter, scene: sceneFilter, halls: hallFilter, tag: next, retired: retiredFilter };
 		              setLast(conds);
 		              fetchPage(conds, 0, false);
 		            },
@@ -3508,6 +3522,29 @@ var __defProp = Object.defineProperty;
 		    ] }) : /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("div", { style: { ...S.muted, marginBottom: 10 }, children: "Room 分类：暂无（由反刍涌现的标签自动生成，无需手工建立）" }),
 		    /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { style: { ...S.flexRow, marginBottom: 10 }, children: [
 		      /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: loading ? "加载中…" : countText }),
+		      /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("span", { style: S.muted, children: "退场筛查" }),
+		      [["", "全部"], ["active", "仅活跃"], ["retired", "仅退场"]].map(([val, label]) => {
+		        const on = retiredFilter === val;
+		        return /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
+		          "button",
+		          {
+		            type: "button",
+		            title: val === "" ? "活跃与已退场混排（已退场的带徽标）" : val === "active" ? "只看未退场的记忆" : "只看已退场（软删）的记忆，可在此恢复",
+		            onClick: () => applyRetiredFilter(val),
+		            style: {
+		              cursor: "pointer",
+		              fontSize: 12,
+		              padding: "2px 10px",
+		              borderRadius: 999,
+		              border: on ? "1px solid var(--dsh-mem-accent)" : "1px solid var(--dsh-mem-border)",
+		              background: on ? "var(--dsh-mem-bg-inset)" : "transparent",
+		              color: on ? "var(--dsh-mem-accent)" : "var(--dsh-mem-text-2)"
+		            },
+		            children: label
+		          },
+		          val
+		        );
+		      }),
 		      /* @__PURE__ */ (0, import_jsx_runtime15.jsx)(
 		        NButton,
 		        {

package/dist/contract.d.ts

@@ -650,6 +650,12 @@ export interface ListRecordsRequest {
      * Room 由 tags 派生(自生长),故这里传的是**具体 tag 名**而非枚举 id。
      */
     tag?: string;
+    /**
+     * 退场(软删)筛查:三态。省略 = 全部(活跃+已退场混排,靠 `UiRecord.retired`
+     * 徽标区分);`false` = 仅活跃;`true` = 仅已退场。
+     * **仅浏览路径生效**:关键词检索只覆盖检索面,已退场记录本就不在其中。
+     */
+    retired?: boolean;
     /** 1~200,默认 50。 */
     limit?: number;
     /** 0~1_000_000。 */

package/dist/stats.js

@@ -746,6 +746,9 @@ export async function handleEndpoint(endpoint, payload, deps) {
             const p = (payload ?? {});
             if (p.query !== undefined && p.query.length > 4096)
                 throw new Error('query 过长(≤4096 字符)');
+            // 退场筛查:三态(缺省=全部混排/false=仅活跃/true=仅已退场)。显式布尔才透传,
+            // 其余值(字符串/数字等)一律视为缺省——宁可宽看,不可静默筛掉一半。
+            const retiredSel = typeof p.retired === 'boolean' ? p.retired : undefined;
             // Room 过滤:tag 是**自生长**的 slug(无枚举),只做形状与长度校验(SQL 侧参数化)
             const tagSel = typeof p.tag === 'string' ? p.tag.trim().slice(0, 64) : '';
             if (tagSel && !isTag(tagSel))
@@ -803,7 +806,9 @@ export async function handleEndpoint(endpoint, payload, deps) {
                 };
                 return resp;
             }
-            const { items, total } = stores.l1.list({ type: p.type || undefined, scene: p.scene || undefined, hall: p.hall || undefined, halls: wingSel.length > 0 ? wingSel : undefined, tag: tagSel || undefined, limit, offset });
+            // 退场筛查仅浏览路径透传;检索路径不接——FTS/向量里本就没有已退场行,
+            // 接了只会让「仅退场+关键词」永远空结果,不如如实不筛。
+            const { items, total } = stores.l1.list({ type: p.type || undefined, scene: p.scene || undefined, hall: p.hall || undefined, halls: wingSel.length > 0 ? wingSel : undefined, tag: tagSel || undefined, retired: retiredSel, limit, offset });
             const resp = {
                 items: items.map(hitToUiRecord),
                 hasMore: offset + items.length < total,

package/dist/store/l1.d.ts

@@ -292,6 +292,8 @@ export declare class L1Store {
         /** Room 过滤(metadata.tags 含该 slug)。 */
         tag?: string;
         workspaceId?: string;
+        /** 退场筛查:三态(`undefined` 全部 / `false` 仅活跃 / `true` 仅已退场)。 */
+        retired?: boolean;
         limit: number;
         offset: number;
     }): {

package/dist/store/sqlite.d.ts

@@ -385,6 +385,15 @@ export declare class MemoryDb {
         /** Room 过滤(metadata.tags 含该 slug)。 */
         tag?: string;
         workspaceId?: string;
+        /**
+         * 退场(软删)筛查:三态。
+         * - 省略(undefined):不过滤,活跃+已退场都列(快照导出/重建需要全量;面板「全部」同此);
+         * - `false`:只列**活跃**记录(`valid_to` 为空);
+         * - `true`:只列**已退场**记录(`valid_to` 非空)——与 `listRetiredL1` 同口径。
+         * 面板默认不过滤而是靠徽标区分(「退场了」与「根本没这条」必须能分辨),
+         * 筛查只是把混排的两种态**分开看**,不改变"浏览路径不隐藏退场记录"的设计。
+         */
+        retired?: boolean;
         limit: number;
         offset: number;
     }): {

package/dist/store/sqlite.js

@@ -1486,6 +1486,14 @@ export class MemoryDb {
                 where.push(`EXISTS (SELECT 1 FROM json_each(CASE WHEN json_valid(metadata_json) THEN metadata_json ELSE '{}' END, '$.tags') j WHERE j.value = ?)`);
                 params.push(opts.tag);
             }
+            // 退场筛查(三态,见 opts.retired 注释):与 listRetiredL1 同一判据,保证
+            // 「仅退场」视图与「已退场」区看到同一批行。
+            if (opts.retired === false) {
+                where.push("COALESCE(valid_to, '') = ''");
+            }
+            else if (opts.retired === true) {
+                where.push("COALESCE(valid_to, '') <> ''");
+            }
             const whereSql = where.length > 0 ? ` WHERE ${where.join(' AND ')}` : '';
             const totalRow = this.db.prepare(`SELECT COUNT(*) AS n FROM l1_records${whereSql}`).get(...params);
             const rows = this.db

package/package.json

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