dsh-session-conductor 1.3.8 → 1.3.10

package/README.md

@@ -10,7 +10,8 @@
 
 | 功能 | 说明 | 入口 |
 |---|---|---|
-| 会话管理面板 | 全部/已归档/活跃/说明四视图；归档、恢复、删除（批量/按条件）、置为不活跃、释放全部空闲 | 侧边栏「会话管理」按钮 |
+| 会话管理面板 | 全部/已归档/活跃/**回收站**/说明五视图；归档、恢复、删除（批量/筛选）、置为不活跃、释放全部空闲 | 侧边栏「会话管理」按钮 |
+| 回收站 | **删除只打标记、不动会话文件**：删掉的会话进回收站，可单条还原、多选还原、按批次撤销（还原最近一次删除），到期（保留天数可设，默认 7 天）或「一键清空」才真正删盘。真正删盘由每小时一次的到期清理执行 | 面板「回收站」标签页 |
 | 自动重命名 | 每个回合后 AI 分析会话内容，主题明显偏离时自动生成新标题（带运行状态后缀） | 面板逐会话开关 |
 | 自动续跑 | 识别非人为中断（崩溃/限流/超时/错误），自动继续原任务；失败后 30s 重试 | 面板逐会话开关（临时设置，重启即默认关） |
 | 会话分组 | 按工作区分组显示；「在分组下新建会话」 | 设置 → 插件 → 会话分组 |
@@ -122,8 +123,13 @@ allowBuilds:
 - **全部**：列出每个会话（标题/目录/时间/状态），支持归档、删除、撤回、自动重命名/续跑开关、搜索、价值分析
 - **已归档**：列出被归档的会话，可恢复（取消归档）、删除
 - **活跃**：当前活跃（live/running）的会话
+- **回收站**：列出被删除（只打了标记）的会话，显示删除时间与剩余天数；五个操作：**设置保留天数**、**撤销上次删除**（还原最近一个批次）、**还原选中**、**全选**、**一键清空**（二次确认后立即真删）。单条也能点行内「还原」
 - **说明**：损坏修复（seq-gap / EIO / 双格式）+ 使用说明
 
+> 删除语义：面板上的「删除」= 在索引里打标记 + 从列表隐藏，**会话日志文件原样保留**，
+> 所以还原是秒级且零风险。真正删盘只发生在回收站到期（`trashRetentionDays`，默认 7 天）
+> 或「一键清空」，由 `purgeExpiredTrash` 执行。
+
 ### 设置页（设置 → 会话管理）
 
 左侧栏「会话管理」独立页：

package/lib/apply.js

@@ -60,6 +60,8 @@ import { findTargetAgent, switchAgentModel, getMemberModelOverride, applyModelOv
   registerModelSwitchCommand } from './features/member-model/index.js';
 // 会话操作的路由注册已抽到独立模块（handler 实现见该模块；此处只留注册入口）
 import { registerSessionOpsRoutes } from './features/session-ops-routes.js';
+import { registerTrashRoutes } from './features/session-ops-routes.js';
+import { purgeExpiredTrash } from './features/session-ops.js';
 import { installProcessGuards } from './guards.js';
 import { readJson, send } from './http.js';
 import { CONDUCTOR_SETTINGS_NS, PresenceSchema } from './shared/settings.js';
@@ -92,6 +94,8 @@ export async function apply(ctx, config = {}) {
     scanIntervalMs: num(config?.scanIntervalMs, 30 * 1000, 24 * 3600 * 1000, DEFAULTS.scanIntervalMs),
     // 价值判定索引有效期（小时）：同一份会话内容在该时长内只算一次（默认 24 小时，可配置覆盖）
     valueIndexTtlHours: num(config?.valueIndexTtlHours, 1, 24 * 30, DEFAULTS.valueIndexTtlHours),
+    // 回收站保留天数（面板上设置的值优先；这里是兜底默认）
+    trashRetentionDays: num(config?.trashRetentionDays, 1, 365, DEFAULTS.trashRetentionDays),
     // 自动重命名模型路由（成对配置才生效；缺省 = 继承会话 request/header 的对话模型）
     autoRenameProvider: typeof config?.autoRenameProvider === "string" && config.autoRenameProvider !== "" ? config.autoRenameProvider : undefined,
     autoRenameModel: typeof config?.autoRenameModel === "string" && config.autoRenameModel !== "" ? config.autoRenameModel : undefined,
@@ -657,6 +661,20 @@ export async function apply(ctx, config = {}) {
     //   具体 handler 实现见该模块（行为逐字不变，依赖以 deps 传入）。
     registerSessionOpsRoutes({ webServer, ctx, send, readJson, invalidateSessionListCache });
 
+    // ---------- 回收站路由 ----------
+    // 删除只是打标记（文件不动），所以还原零成本；真删只发生在到期与一键清空。
+    registerTrashRoutes({ webServer, ctx, send, readJson, invalidateSessionListCache });
+
+    // 到期清理：每小时扫一次（回收站保留天数可配，默认 7 天）。
+    // 用 unref 的定时器 + 单次 try/catch：清理失败绝不能影响宿主进程。
+    try {
+      const purgeTimer = setInterval(() => {
+        purgeExpiredTrash(ctx).catch(() => { /* 单次清理失败，下一小时再试 */ });
+      }, 3600_000);
+      if (typeof purgeTimer?.unref === "function") purgeTimer.unref();
+      ctx.effect?.(() => () => { try { clearInterval(purgeTimer); } catch { /* 已清理 */ } }, "session-conductor: trash purge timer");
+    } catch { /* 定时器建不起来也不影响手动清理 */ }
+
     // ---------- POST /api/session-conductor/search ----------
     // 全文搜索：跨会话搜消息内容，返回命中会话 + 上下文片段
     webServer.register({
@@ -1515,7 +1533,8 @@ export async function apply(ctx, config = {}) {
         // 先校验组合有效性——无效组合会让后续回合的模型请求被拒（表现为「切换生效但回合失败」）
         const pair = await validateModelPair(ctx, provider, model);
         if (pair.error) return `切换失败：${pair.error}`;
-        const found = findTargetAgent(ctx, args?.target);
+        // 显式传发起方：与聊天指令 /model-switch 走**同一条**解析路径（抽公共后两边只此一份）
+        const found = findTargetAgent(ctx, args?.target, { caller: exec?.agent ?? null });
         if (found.error) return `切换失败：${found.error}`;
         const switchResult = await switchAgentModel(ctx, found.sessionId, provider, model, found.agent);
         if (switchResult.error) return `切换失败：${switchResult.error}`;

package/lib/client-parts/components/panel.js

@@ -17,6 +17,11 @@
       const [ruleDays, setRuleDays] = react.useState(7);
       const [rulePrefix, setRulePrefix] = react.useState("");
       const [ruleLowValue, setRuleLowValue] = react.useState(false); // 低价值筛选（复用价值分析）
+      // —— 回收站（删除只是打标记，这里管理被标记的会话）——
+      const [trashItems, setTrashItems] = react.useState(null); // null = 尚未加载
+      const [trashSel, setTrashSel] = react.useState(() => new Set());
+      const [trashRetention, setTrashRetention] = react.useState(7); // 保留天数
+      const [trashBatch, setTrashBatch] = react.useState(null); // 最近一个删除批次（撤销用）
 
       // list 流式——NDJSON 每行一个会话，读到立即追加显示（每获取一个追加一个，
       // 不等全部）；按 updatedAt 倒序插入保持列表顺序；旧一次性 JSON（预览页离线垫片/
@@ -563,6 +568,93 @@
         setSelected(new Set((Array.isArray(ids) ? ids : []).filter((id) => typeof id === "string" && id !== "")));
       };
 
+      // —— 回收站操作 ——
+      // 删除只是打标记，所以还原就是「删标记」，几乎零成本；真删只发生在到期与一键清空。
+      const loadTrashItems = async () => {
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash", { headers: { accept: "application/json" } }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "trash load failed");
+          const items = Array.isArray(body.items) ? body.items : [];
+          setTrashItems(items);
+          setTrashRetention(Number(body.retentionDays) || 7);
+          setTrashBatch(body.latestBatch ?? null);
+          setTrashSel((prev) => new Set([...prev].filter((id) => items.some((it) => it.sessionId === id))));
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const restoreTrash = async (ids) => {
+        if (!Array.isArray(ids) || ids.length === 0) return;
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash/restore", {
+            method: "POST",
+            headers: { "Content-Type": CONTENT_TYPE_JSON },
+            body: JSON.stringify({ sessionIds: ids }),
+          }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "restore failed");
+          setTrashSel(new Set());
+          await loadTrashItems();
+          await refresh();
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const restoreLastBatch = async () => {
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash/restore-last-batch", { method: "POST", headers: { "Content-Type": CONTENT_TYPE_JSON }, body: "{}" }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "restore batch failed");
+          if ((body.restored ?? []).length === 0) window.alert(t("trash.nothingToUndo"));
+          setTrashSel(new Set());
+          await loadTrashItems();
+          await refresh();
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const emptyTrashAll = async () => {
+        const n = (trashItems ?? []).length;
+        if (n === 0) return;
+        if (!window.confirm(t("trash.emptyConfirm", { n }))) return;
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash/empty", {
+            method: "POST",
+            headers: { "Content-Type": CONTENT_TYPE_JSON },
+            body: JSON.stringify({ confirm: true }),
+          }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "empty failed");
+          setTrashSel(new Set());
+          await loadTrashItems();
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const saveTrashRetention = async () => {
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash/retention", {
+            method: "POST",
+            headers: { "Content-Type": CONTENT_TYPE_JSON },
+            body: JSON.stringify({ days: Number(trashRetention) || 7 }),
+          }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "retention failed");
+          setTrashRetention(Number(body.retentionDays) || 7);
+          await loadTrashItems();
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const toggleTrashSel = (sessionId, checked) => {
+        setTrashSel((prev) => {
+          const next = new Set(prev);
+          if (checked) next.add(sessionId); else next.delete(sessionId);
+          return next;
+        });
+      };
+
       // —— 筛选：按条件把会话**自动勾选**到列表里 ——
       // 批量删除只有一条路径：「勾选 → 删除选中」。条件（归档 / 价值 / 时间 / 目录）只负责把该勾的勾上。
       // ① 归档 / 时间 / 目录：面板手里每一行已经带着 archived / cwd / updatedAt，
@@ -652,6 +744,84 @@
         }
       };
 
+      /** 回收站面板：工具栏（保留期 / 撤销 / 还原选中 / 全选 / 一键清空）+ 条目列表 */
+      const renderTrash = () => (0, react_jsx_runtime.jsxs)("div", {
+        style: { padding: PADDING_BAR },
+        children: [
+          (0, react_jsx_runtime.jsxs)("div", {
+            style: { display: "flex", gap: 6, alignItems: "center", flexWrap: "wrap", marginBottom: 8, fontSize: FONT_SIZE_SMALL },
+            children: [
+              (0, react_jsx_runtime.jsx)("span", { style: { color: CSS_LABEL_SECONDARY }, children: t("trash.retention.label") }),
+              (0, react_jsx_runtime.jsx)("input", {
+                type: "number", min: 1, max: 365, value: trashRetention,
+                style: { width: 64, height: SMALL_CONTROL_HEIGHT, borderRadius: CONTROL_RADIUS, border: CSS_BORDER_L2, background: CSS_BG_BASE, color: CSS_LABEL_PRIMARY, padding: "0 6px", fontSize: FONT_SIZE_SMALL },
+                onChange: (e) => setTrashRetention(e.target.value),
+              }),
+              (0, react_jsx_runtime.jsx)("span", { style: { color: CSS_LABEL_TERTIARY }, children: t("trash.retention.unit") }),
+              (0, react_jsx_runtime.jsx)("button", { style: S.actionBtn(false), onClick: saveTrashRetention, children: t("trash.retention.save") }),
+              (0, react_jsx_runtime.jsx)("button", {
+                style: S.actionBtn(false),
+                disabled: !trashBatch || (trashBatch.ids ?? []).length === 0,
+                title: trashBatch ? t("trash.undo.title", { n: (trashBatch.ids ?? []).length }) : t("trash.nothingToUndo"),
+                onClick: restoreLastBatch,
+                children: t("trash.undo"),
+              }),
+              (0, react_jsx_runtime.jsx)("button", {
+                style: S.actionBtn(false),
+                disabled: trashSel.size === 0,
+                onClick: () => restoreTrash([...trashSel]),
+                children: t("trash.restoreSelected", { n: trashSel.size }),
+              }),
+              (0, react_jsx_runtime.jsx)("button", {
+                style: S.actionBtn(false),
+                disabled: (trashItems ?? []).length === 0,
+                onClick: () => setTrashSel(new Set((trashItems ?? []).map((it) => it.sessionId))),
+                children: t("trash.selectAll"),
+              }),
+              (0, react_jsx_runtime.jsx)("button", {
+                style: { ...S.actionBtn(true), borderColor: CSS_DANGER, color: CSS_DANGER, marginLeft: "auto" },
+                disabled: (trashItems ?? []).length === 0,
+                onClick: emptyTrashAll,
+                children: t("trash.empty"),
+              }),
+            ],
+          }),
+          (0, react_jsx_runtime.jsx)("div", { style: { fontSize: 11.5, color: CSS_LABEL_TERTIARY, marginBottom: 6 }, children: t("trash.hint") }),
+          trashItems === null
+            ? (0, react_jsx_runtime.jsx)("div", { style: S.empty, children: t("list.loading") })
+            : trashItems.length === 0
+              ? (0, react_jsx_runtime.jsx)("div", { style: S.empty, children: t("trash.emptyList") })
+              : trashItems.map((item) => (0, react_jsx_runtime.jsxs)("div", {
+                  style: { display: "flex", alignItems: "center", gap: 8, padding: "6px 4px", borderTop: "1px solid var(--dsw-alias-border-l1, rgba(128,128,128,.15))" },
+                  children: [
+                    (0, react_jsx_runtime.jsx)("input", {
+                      type: "checkbox",
+                      checked: trashSel.has(item.sessionId),
+                      onChange: (e) => toggleTrashSel(item.sessionId, e.target.checked),
+                    }),
+                    (0, react_jsx_runtime.jsxs)("div", {
+                      style: { flex: 1, minWidth: 0 },
+                      children: [
+                        (0, react_jsx_runtime.jsx)("div", {
+                          style: { fontSize: FONT_SIZE_SMALL, color: CSS_LABEL_PRIMARY, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
+                          children: item.title || basenameOf(item.cwd) || item.sessionId,
+                        }),
+                        (0, react_jsx_runtime.jsx)("div", {
+                          style: { fontSize: 11.5, color: CSS_LABEL_TERTIARY, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
+                          children: `${item.cwd || item.sessionId} ｜ ${t("trash.remaining", { n: item.remainingDays ?? 0 })}`,
+                        }),
+                      ],
+                    }),
+                    (0, react_jsx_runtime.jsx)("button", {
+                      style: S.actionBtn(false),
+                      onClick: () => restoreTrash([item.sessionId]),
+                      children: t("trash.restore"),
+                    }),
+                  ],
+                }, item.sessionId)),
+        ],
+      });
+
       const rows = sessions ?? [];
       // 列表过滤：标题 / cwd / id / 状态词（大小写不敏感）
       const ql = query.trim().toLowerCase();
@@ -1107,6 +1277,11 @@
                           onClick: () => setTab("active"),
                           children: `${t("tab.active")} (${rows.filter((row) => !row.archived && (row.live === true || row.running === true)).length})`,
                         }),
+                        (0, react_jsx_runtime.jsx)("button", {
+                          style: S.tab(tab === "trash"),
+                          onClick: () => { setTab("trash"); loadTrashItems(); },
+                          children: `${t("tab.trash")}${trashItems === null ? "" : ` (${trashItems.length})`}`,
+                        }),
                         (0, react_jsx_runtime.jsx)("button", {
                           style: S.tab(tab === "help"),
                           onClick: () => setTab("help"),
@@ -1216,6 +1391,8 @@
                       style: S.body,
                       children: tab === "help"
                         ? renderHelp()
+                        : tab === "trash"
+                        ? renderTrash()
                         : (0, react_jsx_runtime.jsxs)(react.Fragment, {
                             children: [
                               // —— 全文搜索结果区（官方 FTS5 优先，自研兜底） ——

package/lib/client.js

@@ -430,6 +430,11 @@ window.__ModuleLoader__.load({
       const [ruleDays, setRuleDays] = react.useState(7);
       const [rulePrefix, setRulePrefix] = react.useState("");
       const [ruleLowValue, setRuleLowValue] = react.useState(false); // 低价值筛选（复用价值分析）
+      // —— 回收站（删除只是打标记，这里管理被标记的会话）——
+      const [trashItems, setTrashItems] = react.useState(null); // null = 尚未加载
+      const [trashSel, setTrashSel] = react.useState(() => new Set());
+      const [trashRetention, setTrashRetention] = react.useState(7); // 保留天数
+      const [trashBatch, setTrashBatch] = react.useState(null); // 最近一个删除批次（撤销用）
 
       // list 流式——NDJSON 每行一个会话，读到立即追加显示（每获取一个追加一个，
       // 不等全部）；按 updatedAt 倒序插入保持列表顺序；旧一次性 JSON（预览页离线垫片/
@@ -976,6 +981,93 @@ window.__ModuleLoader__.load({
         setSelected(new Set((Array.isArray(ids) ? ids : []).filter((id) => typeof id === "string" && id !== "")));
       };
 
+      // —— 回收站操作 ——
+      // 删除只是打标记，所以还原就是「删标记」，几乎零成本；真删只发生在到期与一键清空。
+      const loadTrashItems = async () => {
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash", { headers: { accept: "application/json" } }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "trash load failed");
+          const items = Array.isArray(body.items) ? body.items : [];
+          setTrashItems(items);
+          setTrashRetention(Number(body.retentionDays) || 7);
+          setTrashBatch(body.latestBatch ?? null);
+          setTrashSel((prev) => new Set([...prev].filter((id) => items.some((it) => it.sessionId === id))));
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const restoreTrash = async (ids) => {
+        if (!Array.isArray(ids) || ids.length === 0) return;
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash/restore", {
+            method: "POST",
+            headers: { "Content-Type": CONTENT_TYPE_JSON },
+            body: JSON.stringify({ sessionIds: ids }),
+          }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "restore failed");
+          setTrashSel(new Set());
+          await loadTrashItems();
+          await refresh();
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const restoreLastBatch = async () => {
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash/restore-last-batch", { method: "POST", headers: { "Content-Type": CONTENT_TYPE_JSON }, body: "{}" }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "restore batch failed");
+          if ((body.restored ?? []).length === 0) window.alert(t("trash.nothingToUndo"));
+          setTrashSel(new Set());
+          await loadTrashItems();
+          await refresh();
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const emptyTrashAll = async () => {
+        const n = (trashItems ?? []).length;
+        if (n === 0) return;
+        if (!window.confirm(t("trash.emptyConfirm", { n }))) return;
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash/empty", {
+            method: "POST",
+            headers: { "Content-Type": CONTENT_TYPE_JSON },
+            body: JSON.stringify({ confirm: true }),
+          }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "empty failed");
+          setTrashSel(new Set());
+          await loadTrashItems();
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const saveTrashRetention = async () => {
+        try {
+          const res = await window.__scFetch("/api/session-conductor/trash/retention", {
+            method: "POST",
+            headers: { "Content-Type": CONTENT_TYPE_JSON },
+            body: JSON.stringify({ days: Number(trashRetention) || 7 }),
+          }, 0);
+          const body = await res.json();
+          if (!body?.ok) throw new Error(body?.error?.message ?? "retention failed");
+          setTrashRetention(Number(body.retentionDays) || 7);
+          await loadTrashItems();
+        } catch (cause) {
+          window.alert(t("error.action", { message: cause instanceof Error ? cause.message : String(cause) }));
+        }
+      };
+      const toggleTrashSel = (sessionId, checked) => {
+        setTrashSel((prev) => {
+          const next = new Set(prev);
+          if (checked) next.add(sessionId); else next.delete(sessionId);
+          return next;
+        });
+      };
+
       // —— 筛选：按条件把会话**自动勾选**到列表里 ——
       // 批量删除只有一条路径：「勾选 → 删除选中」。条件（归档 / 价值 / 时间 / 目录）只负责把该勾的勾上。
       // ① 归档 / 时间 / 目录：面板手里每一行已经带着 archived / cwd / updatedAt，
@@ -1065,6 +1157,84 @@ window.__ModuleLoader__.load({
         }
       };
 
+      /** 回收站面板：工具栏（保留期 / 撤销 / 还原选中 / 全选 / 一键清空）+ 条目列表 */
+      const renderTrash = () => (0, react_jsx_runtime.jsxs)("div", {
+        style: { padding: PADDING_BAR },
+        children: [
+          (0, react_jsx_runtime.jsxs)("div", {
+            style: { display: "flex", gap: 6, alignItems: "center", flexWrap: "wrap", marginBottom: 8, fontSize: FONT_SIZE_SMALL },
+            children: [
+              (0, react_jsx_runtime.jsx)("span", { style: { color: CSS_LABEL_SECONDARY }, children: t("trash.retention.label") }),
+              (0, react_jsx_runtime.jsx)("input", {
+                type: "number", min: 1, max: 365, value: trashRetention,
+                style: { width: 64, height: SMALL_CONTROL_HEIGHT, borderRadius: CONTROL_RADIUS, border: CSS_BORDER_L2, background: CSS_BG_BASE, color: CSS_LABEL_PRIMARY, padding: "0 6px", fontSize: FONT_SIZE_SMALL },
+                onChange: (e) => setTrashRetention(e.target.value),
+              }),
+              (0, react_jsx_runtime.jsx)("span", { style: { color: CSS_LABEL_TERTIARY }, children: t("trash.retention.unit") }),
+              (0, react_jsx_runtime.jsx)("button", { style: S.actionBtn(false), onClick: saveTrashRetention, children: t("trash.retention.save") }),
+              (0, react_jsx_runtime.jsx)("button", {
+                style: S.actionBtn(false),
+                disabled: !trashBatch || (trashBatch.ids ?? []).length === 0,
+                title: trashBatch ? t("trash.undo.title", { n: (trashBatch.ids ?? []).length }) : t("trash.nothingToUndo"),
+                onClick: restoreLastBatch,
+                children: t("trash.undo"),
+              }),
+              (0, react_jsx_runtime.jsx)("button", {
+                style: S.actionBtn(false),
+                disabled: trashSel.size === 0,
+                onClick: () => restoreTrash([...trashSel]),
+                children: t("trash.restoreSelected", { n: trashSel.size }),
+              }),
+              (0, react_jsx_runtime.jsx)("button", {
+                style: S.actionBtn(false),
+                disabled: (trashItems ?? []).length === 0,
+                onClick: () => setTrashSel(new Set((trashItems ?? []).map((it) => it.sessionId))),
+                children: t("trash.selectAll"),
+              }),
+              (0, react_jsx_runtime.jsx)("button", {
+                style: { ...S.actionBtn(true), borderColor: CSS_DANGER, color: CSS_DANGER, marginLeft: "auto" },
+                disabled: (trashItems ?? []).length === 0,
+                onClick: emptyTrashAll,
+                children: t("trash.empty"),
+              }),
+            ],
+          }),
+          (0, react_jsx_runtime.jsx)("div", { style: { fontSize: 11.5, color: CSS_LABEL_TERTIARY, marginBottom: 6 }, children: t("trash.hint") }),
+          trashItems === null
+            ? (0, react_jsx_runtime.jsx)("div", { style: S.empty, children: t("list.loading") })
+            : trashItems.length === 0
+              ? (0, react_jsx_runtime.jsx)("div", { style: S.empty, children: t("trash.emptyList") })
+              : trashItems.map((item) => (0, react_jsx_runtime.jsxs)("div", {
+                  style: { display: "flex", alignItems: "center", gap: 8, padding: "6px 4px", borderTop: "1px solid var(--dsw-alias-border-l1, rgba(128,128,128,.15))" },
+                  children: [
+                    (0, react_jsx_runtime.jsx)("input", {
+                      type: "checkbox",
+                      checked: trashSel.has(item.sessionId),
+                      onChange: (e) => toggleTrashSel(item.sessionId, e.target.checked),
+                    }),
+                    (0, react_jsx_runtime.jsxs)("div", {
+                      style: { flex: 1, minWidth: 0 },
+                      children: [
+                        (0, react_jsx_runtime.jsx)("div", {
+                          style: { fontSize: FONT_SIZE_SMALL, color: CSS_LABEL_PRIMARY, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
+                          children: item.title || basenameOf(item.cwd) || item.sessionId,
+                        }),
+                        (0, react_jsx_runtime.jsx)("div", {
+                          style: { fontSize: 11.5, color: CSS_LABEL_TERTIARY, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
+                          children: `${item.cwd || item.sessionId} ｜ ${t("trash.remaining", { n: item.remainingDays ?? 0 })}`,
+                        }),
+                      ],
+                    }),
+                    (0, react_jsx_runtime.jsx)("button", {
+                      style: S.actionBtn(false),
+                      onClick: () => restoreTrash([item.sessionId]),
+                      children: t("trash.restore"),
+                    }),
+                  ],
+                }, item.sessionId)),
+        ],
+      });
+
       const rows = sessions ?? [];
       // 列表过滤：标题 / cwd / id / 状态词（大小写不敏感）
       const ql = query.trim().toLowerCase();
@@ -1520,6 +1690,11 @@ window.__ModuleLoader__.load({
                           onClick: () => setTab("active"),
                           children: `${t("tab.active")} (${rows.filter((row) => !row.archived && (row.live === true || row.running === true)).length})`,
                         }),
+                        (0, react_jsx_runtime.jsx)("button", {
+                          style: S.tab(tab === "trash"),
+                          onClick: () => { setTab("trash"); loadTrashItems(); },
+                          children: `${t("tab.trash")}${trashItems === null ? "" : ` (${trashItems.length})`}`,
+                        }),
                         (0, react_jsx_runtime.jsx)("button", {
                           style: S.tab(tab === "help"),
                           onClick: () => setTab("help"),
@@ -1629,6 +1804,8 @@ window.__ModuleLoader__.load({
                       style: S.body,
                       children: tab === "help"
                         ? renderHelp()
+                        : tab === "trash"
+                        ? renderTrash()
                         : (0, react_jsx_runtime.jsxs)(react.Fragment, {
                             children: [
                               // —— 全文搜索结果区（官方 FTS5 优先，自研兜底） ——

package/lib/core/config.js

@@ -35,6 +35,9 @@ export const DEFAULTS = {
   // 同一条会话的价值结论在「内容没变（updatedAt 未变）+ 未超过该时长」时直接复用，
   // 不再重读日志（实测单条 0.2 MB≈85 ms / 7 MB≈1.1 s / 86 MB≈16 s）。默认 24 小时。
   valueIndexTtlHours: 24,
+  // ── 回收站 ──
+  // 删除只打标记；超过该天数才真正删盘（面板上改的值存在索引里，优先于这里）
+  trashRetentionDays: 7,
 };
 
 /** 运行期配置（面板/测试可改）。外部只读引用；改整体请用 setConfig。 */

package/lib/core/index-store.js

@@ -0,0 +1,148 @@
+// 插件索引的唯一落盘位置：<DSH_HOME>/storages/dsh-session-conductor/index.json
+//
+// 【为什么要收敛】此前每类索引各写一个文件（list-cache.json / value-index.json / trash.json），
+// 于是同一个目录里躺着三套「版本号 + 原子写 + 路径解析」的复制品：改一处忘一处、
+// 备份/迁移要记三份名字、出问题时不知道先看哪个。现在统一成**一个文件、一个版本号、一个原子写**，
+// 各模块只关心自己的 section。
+//
+// 【结构】
+//   {
+//     version: 1,
+//     list:  { entries: { [sessionId]: {...} } },          // 会话列表解析缓存
+//     value: { entries: { [sessionId]: {...} } },          // 价值判定索引
+//     trash: { entries: { [sessionId]: {...} }, retentionDays }  // 回收站
+//   }
+//
+// 【迁移】首次加载若发现旧文件，按 section 合并进来，并把旧文件改名为
+// `<原名>.migrated`（不删、可回滚）。
+//
+// 【写入】原子写（tmp + rename）。整文件重写：当前规模 30~80 KB、序列化 ~1 ms，
+// 各模块的写盘本来就有节流/低频，代价可忽略；等真到上千条再评估换存储。
+
+import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync } from "node:fs";
+import path from "node:path";
+
+import { cfg, resolveDshHome } from "./config.js";
+
+const STORE_VERSION = 1;
+const STORE_SUBDIR = ["storages", "dsh-session-conductor"];
+const STORE_FILE = "index.json";
+/** 旧文件 → section 名（迁移用） */
+const LEGACY_FILES = [
+  ["list-cache.json", "list"],
+  ["value-index.json", "value"],
+  ["trash.json", "trash"],
+];
+
+let storeCache = null;
+let storePath = null;
+
+/** 索引文件绝对路径（首次解析后缓存）。 */
+export function storeFilePath(ctx) {
+  if (storePath !== null) return storePath;
+  const home = resolveDshHome(ctx, cfg);
+  storePath = home ? path.join(home, ...STORE_SUBDIR, STORE_FILE) : "";
+  return storePath;
+}
+
+/** 空结构（各 section 都带默认值，调用方不必判空）。 */
+function emptyStore() {
+  return { version: STORE_VERSION, list: { entries: {} }, value: { entries: {} }, trash: { entries: {} } };
+}
+
+/**
+ * 读索引（进程内只读一次）。文件缺失/损坏 → 空结构；随后尝试从旧文件迁移一次。
+ */
+export function loadStore(ctx) {
+  if (storeCache !== null) return storeCache;
+  storeCache = emptyStore();
+  const file = storeFilePath(ctx);
+  if (!file) return storeCache;
+  let loaded = false;
+  try {
+    const parsed = JSON.parse(readFileSync(file, "utf8"));
+    if (parsed && typeof parsed === "object") {
+      storeCache = {
+        version: STORE_VERSION,
+        list: { entries: parsed.list?.entries && typeof parsed.list.entries === "object" ? parsed.list.entries : {} },
+        value: { entries: parsed.value?.entries && typeof parsed.value.entries === "object" ? parsed.value.entries : {} },
+        trash: {
+          entries: parsed.trash?.entries && typeof parsed.trash.entries === "object" ? parsed.trash.entries : {},
+          ...(Number.isFinite(parsed.trash?.retentionDays) ? { retentionDays: parsed.trash.retentionDays } : {}),
+        },
+      };
+      loaded = true;
+    }
+  } catch {
+    // 首次运行 / 文件损坏：保持空结构
+  }
+  if (!loaded) migrateLegacyFiles(ctx);
+  return storeCache;
+}
+
+/**
+ * 一次性迁移旧文件：按 section 合并，成功则把旧文件改名 `.migrated`（保留可回滚）。
+ * 任一文件解析失败就跳过它（不阻断启动）。
+ */
+function migrateLegacyFiles(ctx) {
+  const file = storeFilePath(ctx);
+  if (!file) return;
+  const dir = path.dirname(file);
+  let migratedAny = false;
+  for (const [legacyName, section] of LEGACY_FILES) {
+    const legacyPath = path.join(dir, legacyName);
+    if (!existsSync(legacyPath)) continue;
+    try {
+      const parsed = JSON.parse(readFileSync(legacyPath, "utf8"));
+      const entries = parsed?.entries && typeof parsed.entries === "object" ? parsed.entries : null;
+      if (entries) {
+        storeCache[section] = {
+          entries,
+          ...(section === "trash" && Number.isFinite(parsed?.retentionDays) ? { retentionDays: parsed.retentionDays } : {}),
+        };
+        migratedAny = true;
+      }
+      // 迁移后改名：不删除，出问题可人工回滚
+      renameSync(legacyPath, `${legacyPath}.migrated`);
+    } catch {
+      // 旧文件坏了：跳过，保持空 section
+    }
+  }
+  if (migratedAny) saveStoreNow(ctx);
+}
+
+/** 立即落盘（原子写：tmp + rename）。失败只丢本次写入，不抛。 */
+export function saveStoreNow(ctx) {
+  const file = storeFilePath(ctx);
+  if (!file || storeCache === null) return false;
+  try {
+    mkdirSync(path.dirname(file), { recursive: true });
+    const tmpPath = `${file}.tmp-${process.pid}`;
+    writeFileSync(tmpPath, JSON.stringify(storeCache), "utf8");
+    renameSync(tmpPath, file);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** 取某个 section（不存在时给默认值）。 */
+export function getSection(ctx, name) {
+  const store = loadStore(ctx);
+  if (!store[name]) store[name] = { entries: {} };
+  if (!store[name].entries || typeof store[name].entries !== "object") store[name].entries = {};
+  return store[name];
+}
+
+/** 写某个 section（只改内存，落盘由调用方决定时机）。 */
+export function setSection(ctx, name, value) {
+  const store = loadStore(ctx);
+  store[name] = value;
+  return store[name];
+}
+
+/** 测试钩子：清空内存态。 */
+export function resetStoreForTest() {
+  storeCache = null;
+  storePath = null;
+}