@duke-dsh-plugins/dsh-archive-manager 1.3.6 → 1.5.0

package/README.md

@@ -18,6 +18,12 @@
 
 归档后消失在侧栏的会话，在这里统一呈现——**按项目分组、按更新时间倒序、支持搜索**，并且每个归档都能**一键还原**或**永久删除**。
 
+> **版本适配（自动切换，无需配置）**
+> - **DSH < 0.1.7**：完整归档管理面板（侧栏底部"归档"按钮 → 分组列表 / 搜索 / 还原 / 删除）。
+> - **DSH ≥ 0.1.7**：DSH 自带归档管理（侧栏筛选"仅显示已归档"、行内取消归档），本插件**只补上它缺少的删除功能**——归档会话的 "…" 菜单里多一行"删除会话…"、行尾悬停多一个 🗑 按钮，点击弹出永久删除二次确认框；不再显示本插件自己的面板按钮。
+> - 识别方式是**特性检测**（0.1.7 新增的两个行操作槽位是否声明），不是版本号，因此任何中间版本都会落到正确的一侧。
+> - **支持 DSH 0.1.x 与 0.2.x**。0.2.0 起 DSH 会校验插件声明的 `@deepseek-ai/dsh*` peer 版本范围，不匹配就**整个 bundle 静默跳过**（插件直接消失，控制台只多一行 `skipping profile bundle ...`）；v1.5.0 已放行 0.2.x 并同时保留 0.1.x。
+
 ## 功能
 
 | 功能 | 说明 |
@@ -46,12 +52,14 @@ dsh plugin --profile web add /path/to/dsh-archive-manager
 dsh plugin --profile web add https://github.com/MoonlitDropOfBlood/dsh-archive-manager/releases/download/v1.3.0/dsh-archive-manager-1.3.0.tgz
 ```
 
-重启 DSH 后，侧栏底部（Cordis Plugin 下方、设置上方）会出现"归档"按钮。
+重启 DSH 后生效：**DSH < 0.1.7** 会在侧栏底部（Cordis Plugin 下方、设置上方）出现"归档"按钮；**DSH ≥ 0.1.7** 则在归档会话行上出现删除入口（见"使用"）。
 
 > `dsh plugin add` 把插件装成 profile 的 npm 依赖并追加到 `dsh.profile.bundles`，启动时 DSH 自动应用包内的 `cordis.patch.yml` 挂载插件。卸载：`dsh plugin --profile web remove dsh-archive-manager`。
 
 ## 使用
 
+**DSH < 0.1.7：**
+
 1. 点侧栏底部的 **🗂 归档** 按钮（带归档数量）。
 2. 面板按项目列出所有归档会话：
    - **还原**：会话回到侧栏对应项目下。
@@ -59,6 +67,14 @@ dsh plugin --profile web add https://github.com/MoonlitDropOfBlood/dsh-archive-m
    - **无效的归档记录**：日志已不存在的残留，点删除清理记录。
 3. 顶部搜索框可实时过滤。
 
+**DSH ≥ 0.1.7（自带归档管理，本插件只加删除）：**
+
+1. 侧栏工作区筛选 **仅显示已归档**（DSH 自带功能）。
+2. 归档会话行上任选其一发起删除：
+   - 行尾悬停的 **🗑 按钮**；
+   - "…" 菜单里的 **删除会话…**（危险红行，位于取消归档之后）。
+3. 弹出确认框后点 **永久删除**；运行中的智能体会被拦截，失败原因显示在框内；已删除但驻留内存的会话会提示重启后清除。
+
 ## 工作原理
 
 ```
@@ -79,6 +95,8 @@ dsh-archive-manager/
 ├── client.js           # Client 半：归档管理 UI bundle
 ├── typert.host.js      # Typert Host manifest（Remote 方法描述）
 ├── cordis.patch.yml    # dsh bundle patch（挂载行）
+├── verify-*.mjs        # 四个验证脚本（构造 / typert 线上契约 / client apply / 真实安装）
+├── scripts/            # check-profile-bundle.mjs：DSH 会不会跳过本插件的自检
 ├── .github/workflows/  # GitHub Actions 发布
 ├── AGENTS.md           # 面向 AI agent 的开发指南（含踩坑）
 └── LICENSE             # MIT
@@ -88,9 +106,17 @@ dsh-archive-manager/
 
 ```bash
 npm run check                    # node --check index.js client.js typert.host.js
+npm run verify                   # 四个验证脚本：构造 / 双版本 typert 线上契约 / client apply 冒烟 / 真实 DSH 安装
+node scripts/check-profile-bundle.mjs --sandbox   # 用真实 dsh-app-boot 确认本插件不会被跳过
 dsh plugin --profile web add /path/to/dsh-archive-manager   # 安装/重装到本机 DSH profile
 ```
 
+`verify-typert-compat.mjs` 会用**真实 DSH 安装**里的 `validateTypertManifest` 与 `TypertRegistry` 校验本插件的线格式（同时覆盖 0.1.5 与 0.1.7 两套规则）：默认探测本机 DSH 安装与 `.tmppkg/v017/`（npm 拉取的 0.1.7 包），也可用 `DSH_INSTALL_015` / `DSH_INSTALL_017` 环境变量指定。
+
+`verify-real-install.mjs` 补的是另一个洞——前三个脚本跑在仓库自带的旧版依赖上，在"根本不加载插件"的 DSH 上也会全绿。它直接拿本机 DSH 安装的 `dsh-app-boot.evaluatePluginCompatibility` 跑 0.2.0 的 peer 闸门、断言 0.1.5/0.1.7/当前运行时三条版本线都满足、把 `index.js` 重新绑定到该安装的 cordis/typert-protocol 上构造服务，并在 0.1.x 与 0.2.x 两种磁盘布局上各真删一次会话。
+
+`scripts/check-profile-bundle.mjs --sandbox` 会建一个临时 profile、用软链把**本工作树**挂进去，再调用真实 dsh-app-boot 的 profile 加载器，直接回答"dsh 会不会跳过我"。它不碰任何 DSH home，所以随时可跑。
+
 详见 [AGENTS.md](AGENTS.md)——记录了 DSH 正式插件（Host/Client/Typert 三件套）的完整机制和踩坑。
 
 ## License

package/client.js

@@ -1,17 +1,31 @@
 /**
  * dsh-archive-manager — Client half (web bundle).
  *
- * Rendered by the DSH web shell via `window.__ModuleLoader__.load`. Registers:
- *   - a sidebar footer action button (archived-session entry),
- *   - a frame-wide archive manager panel (search / group / restore / delete),
- *     rendered together with the button from the sidebar.footer.action slot —
- *     mirroring how ui-settings renders its modal from sidebar.settings (see
- *     the registration comment for the stacking-context rationale).
+ * Rendered by the DSH web shell via `window.__ModuleLoader__.load`. Two
+ * operating modes, chosen by feature detection (never by version string):
  *
- * The panel mirrors the DSH 工作区 (workspace) browsing region: a dialog
- * surface using the same design tokens as the workspace browser — folder
- * group headers, compact 32px session rows with a leading slot icon and
- * relative time, and hover-revealed actions (workspace rowActions pattern).
+ * - DSH < 0.1.7 (legacy): registers a sidebar footer action button
+ *   (archived-session entry) plus a frame-wide archive manager panel
+ *   (search / group / restore / delete), rendered together from the
+ *   sidebar.footer.action slot — mirroring how ui-settings renders its modal
+ *   from sidebar.settings (see the registration comment for the
+ *   stacking-context rationale).
+ * - DSH >= 0.1.7 (modern): the shell ships its own archive management (the
+ *   sidebar "仅显示已归档" filter with per-row archive actions), so this
+ *   plugin adds ONLY the missing delete affordance: a danger row in each
+ *   archived session's "..." menu (`sidebar.workspaces.session.menu.item`)
+ *   and a hover trash button at the row end
+ *   (`sidebar.workspaces.session.row.action`), both opening a confirm dialog
+ *   rendered from the sidebar foot slot. Detection = whether those slots
+ *   ever get declared: `ctx.slots.inject()` on an undeclared key never
+ *   fires, so pre-0.1.7 builds stay on the legacy path automatically, and
+ *   the footer button hides itself the moment the modern slots appear.
+ *
+ * The panel/dialog mirrors the DSH 工作区 (workspace) browsing region: a
+ * dialog surface using the same design tokens as the workspace browser —
+ * folder group headers, compact 32px session rows with a leading slot icon
+ * and relative time, and hover-revealed actions (workspace rowActions
+ * pattern).
  *
  * Host communication goes through the `archiveManager` Remote namespace
  * (`ctx.remote.archiveManager.restore/delete/state`), published by the Host
@@ -26,9 +40,11 @@ window.__ModuleLoader__.load({
     const React = require("react");
 
     // ---- CSS (package-owned, mirrors the DSH workspace browser + Modal) ----
-    const CSS = `
-[class*="footerActions"]{flex-direction:column;align-items:center;}
-
+    // CSS_COMMON renders in both modes; CSS_LEGACY is the footer-button
+    // dressing, injected only while the legacy panel exists (cleared the
+    // moment the 0.1.7+ slots declare, so the modern shell keeps its own
+    // footer layout untouched).
+    const CSS_COMMON = `
 /* Overlay — same mask surface as DSH Modal, same z-index tier as the DSH
    settings overlay (1000). This layer MUST be rendered from a slot that sits
    outside any stacking context (the sidebar foot, like Settings does), never
@@ -98,7 +114,37 @@ window.__ModuleLoader__.load({
 .am-error{color:var(--dsw-alias-state-error-primary,#e5484d);padding:8px 24px;font-size:12px;line-height:18px;}
 .am-ghost{color:var(--dsw-alias-label-secondary,inherit);padding:8px 24px;font-size:12px;line-height:18px;}
 
-/* Sidebar footer entry (unchanged) */
+/* ---- 0.1.7+ modern surfaces (delete affordances on the built-in archive) ---- */
+
+/* Danger row in an archived session's "..." menu. Rendered through
+   ui-primitives' MenuItemButton when the module table provides it (native
+   look); this class styles the defensive plain-button fallback. */
+.am-menu-del{display:flex;align-items:center;gap:8px;width:100%;padding:5px 12px;border:none;background:transparent;color:var(--dsw-alias-state-error-primary,#e5484d);font-family:inherit;font-size:13px;line-height:18px;text-align:left;cursor:pointer;border-radius:var(--dsw-radius-sm,6px);}
+.am-menu-del:hover{background:var(--dsw-alias-interactive-bg-hover-danger,rgba(229,72,77,.12));}
+.am-menu-del[disabled]{opacity:.5;cursor:default;}
+
+/* Hover button at the row end — same 28px metrics as ui-workspace's own
+   row-action iconButton so it sits in the strip without reflow. */
+.am-row-del{border-radius:var(--dsw-radius-sm,6px);cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-secondary,inherit);background:0 0;border:none;flex:none;display:inline-flex;justify-content:center;align-items:center;padding:0;}
+.am-row-del:hover{color:var(--dsw-alias-state-error-primary,#e5484d);}
+.am-row-del[disabled]{opacity:.5;cursor:default;}
+
+/* Confirm dialog — same surface family as the legacy panel, compact width.
+   Rendered from the sidebar foot slot (fixed, root stacking context) so
+   dsh-better-sidebar's z-index:25 body layer cannot cover it. */
+.am-confirm{position:relative;display:flex;flex-direction:column;width:440px;max-width:calc(100vw - 48px);overflow:hidden;border:1px solid var(--dsw-alias-border-inverted,rgba(128,128,128,.3));border-radius:24px;background:var(--dsw-alias-bg-layer-2,#fff);color:var(--dsw-alias-label-primary,inherit);box-shadow:var(--dsw-shadow-lv3,0 12px 40px rgba(0,0,0,.25));}
+.am-confirm .am-confirm-body{padding:4px 24px 16px;font-size:13px;line-height:20px;color:var(--dsw-alias-label-secondary,inherit);}
+.am-confirm .am-confirm-title{font-weight:500;font-size:16px;line-height:24px;color:var(--dsw-alias-label-primary,inherit);}
+.am-confirm .am-confirm-actions{display:flex;align-items:center;justify-content:flex-end;gap:8px;padding:0 24px 20px;}
+.am-confirm .am-confirm-error{color:var(--dsw-alias-state-error-primary,#e5484d);font-size:12px;line-height:18px;padding:0 24px 12px;}
+.am-confirm .am-confirm-note{color:var(--dsw-alias-label-tertiary,inherit);font-size:12px;line-height:18px;}
+.am-confirm .am-confirm-btn{border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.2));background:transparent;color:var(--dsw-alias-label-primary,inherit);font-family:inherit;font-size:13px;line-height:18px;padding:6px 14px;border-radius:10px;cursor:pointer;}
+.am-confirm .am-confirm-btn:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(128,128,128,.12));}
+.am-confirm .am-confirm-btn.am-confirm-danger{border-color:transparent;background:var(--dsw-alias-state-error-primary,#e5484d);color:var(--dsw-alias-bg-base,#fff);}
+.am-confirm .am-confirm-btn.am-confirm-danger:hover{background:var(--dsw-alias-state-error-primary,#e5484d);filter:brightness(1.06);}
+.am-confirm .am-confirm-btn[disabled]{opacity:.5;cursor:default;}
+
+/* Sidebar footer entry (legacy mode only) */
 .am-foot-layer{flex:none;width:100%;margin:8px 0 0;display:flex;align-items:center;}
 .am-foot-layer .am-foot{width:100%;height:49px;border-radius:12px;padding:0 8px 0 6px;display:inline-flex;align-items:center;gap:8px;background:transparent;border:none;color:var(--dsw-alias-label-primary,inherit);font-family:inherit;font-size:14px;cursor:pointer;overflow:hidden;}
 .am-foot-layer .am-foot:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(128,128,128,.1));}
@@ -108,6 +154,13 @@ window.__ModuleLoader__.load({
 .am-foot-layer .am-foot .am-badge{color:var(--dsw-alias-label-tertiary,inherit);font-variant-numeric:tabular-nums;flex:none;margin-left:auto;font-size:12px;line-height:16px;}
 .am-foot-layer.am-foot-rail{width:36px;height:36px;margin:0;}
 .am-foot-layer.am-foot-rail .am-foot{width:36px;height:36px;padding:0;justify-content:center;border-radius:10px;}
+`;
+
+    // Footer-column layout: only meaningful while OUR footer button exists.
+    // Injected at boot, cleared permanently once the 0.1.7+ slots declare
+    // (markModern), so a modern DSH footer keeps its own layout rules.
+    const CSS_LEGACY = `
+[class*="footerActions"]{flex-direction:column;align-items:center;}
 `;
 
     // ---- Client Remote contribution ----------------------------------------
@@ -117,8 +170,18 @@ window.__ModuleLoader__.load({
     // must mount its own. Mirrors the invocations in typert.host.js (ids,
     // service/namespace/method, wire fields). zod is not requirable in the
     // browser module loader, so codecs use passthrough schemas — the runtime
-    // contract only requires typeSymbol + schema.parse().
-    const passthrough = () => ({ parse: (v) => v });
+    // contract only needs typeSymbol plus a parse (DSH < 0.1.7 reads
+    // `codec.schema.parse`) or a create() factory (the typert registry on
+    // DSH >= 0.1.7 rejects a strict codec with "has no create() factory").
+    // Every codec therefore carries BOTH fields, like typert.host.js.
+    let passthroughValue;
+    const passthroughSchema = () => (passthroughValue ??= { parse: (v) => v });
+    const strictClientCodec = (typeSymbol) => ({
+      mode: "strict",
+      typeSymbol,
+      schema: passthroughSchema(),
+      create: passthroughSchema,
+    });
     const CLIENT_REMOTE = {
       package: "dsh-archive-manager",
       descriptors: [
@@ -133,10 +196,10 @@ window.__ModuleLoader__.load({
               name: "request",
               wire: "request",
               source: "json",
-              codec: { mode: "strict", typeSymbol: "dsh-archive-manager#ArchiveManagerRestoreRequest", schema: passthrough() },
+              codec: strictClientCodec("dsh-archive-manager#ArchiveManagerRestoreRequest"),
             },
           ],
-          result: { mode: "strict", typeSymbol: "dsh-archive-manager#ArchiveManagerRestoreResult", schema: passthrough() },
+          result: strictClientCodec("dsh-archive-manager#ArchiveManagerRestoreResult"),
         },
         {
           id: "dsh-archive-manager#archiveManager/delete",
@@ -149,10 +212,10 @@ window.__ModuleLoader__.load({
               name: "request",
               wire: "request",
               source: "json",
-              codec: { mode: "strict", typeSymbol: "dsh-archive-manager#ArchiveManagerDeleteRequest", schema: passthrough() },
+              codec: strictClientCodec("dsh-archive-manager#ArchiveManagerDeleteRequest"),
             },
           ],
-          result: { mode: "strict", typeSymbol: "dsh-archive-manager#ArchiveManagerDeleteResult", schema: passthrough() },
+          result: strictClientCodec("dsh-archive-manager#ArchiveManagerDeleteResult"),
         },
         {
           id: "dsh-archive-manager#archiveManager/state",
@@ -161,7 +224,7 @@ window.__ModuleLoader__.load({
           method: "state",
           invocation: { kind: "direct" },
           parameters: [],
-          result: { mode: "strict", typeSymbol: "dsh-archive-manager#ArchiveManagerStateResult", schema: passthrough() },
+          result: strictClientCodec("dsh-archive-manager#ArchiveManagerStateResult"),
         },
       ],
     };
@@ -172,14 +235,33 @@ window.__ModuleLoader__.load({
       await ctx.remote.$mount(CLIENT_REMOTE);
 
       const styleTag = document.createElement("style");
-      styleTag.textContent = CSS;
+      styleTag.textContent = CSS_COMMON;
       document.head.appendChild(styleTag);
       ctx.effect(() => () => styleTag.remove());
 
+      // Legacy footer-column override; cleared for good by markModern() once
+      // the 0.1.7+ built-in archive slots declare.
+      const legacyStyleTag = document.createElement("style");
+      legacyStyleTag.textContent = CSS_LEGACY;
+      document.head.appendChild(legacyStyleTag);
+      ctx.effect(() => () => legacyStyleTag.remove());
+
       // ctx.get() reads the service without the property-accessor inject
       // guard; it exists because the $mount above just created it.
       const remote = ctx.get("remote.archiveManager");
 
+      // ui-primitives (MenuItemButton / Tooltip / IconTrashOutlineRegular) is
+      // part of the 0.1.7+ module table — ui-workspace requires it from the
+      // same table. Loaded defensively: pre-0.1.7 builds may not ship it, and
+      // the modern components (its only consumers) render only when the 0.1.7
+      // slots exist. Fallbacks below keep every surface functional without it.
+      let ui = null;
+      try {
+        ui = require("@deepseek-ai/dsh-client-ui-primitives");
+      } catch {
+        ui = null;
+      }
+
       // Shared open state between the footer button and the overlay.
       let open = false;
       const listeners = new Set();
@@ -208,6 +290,62 @@ window.__ModuleLoader__.load({
         }
       }
 
+      // ---- Modern (DSH >= 0.1.7) mode state --------------------------------
+      // modernStore flips on exactly when the built-in archive's row slots
+      // declare (see the inject registrations at the bottom of apply). Until
+      // then the legacy footer button renders; afterwards it hides itself and
+      // the footer slot only carries the delete confirm dialog.
+      const modernStore = (() => {
+        let value = false;
+        const listeners = new Set();
+        return {
+          getSnapshot: () => value,
+          subscribe: (fn) => { listeners.add(fn); return () => listeners.delete(fn); },
+          set: (next) => { if (value !== next) { value = next; for (const fn of listeners) fn(); } },
+        };
+      })();
+      function useModern() { return React.useSyncExternalStore(modernStore.subscribe, modernStore.getSnapshot); }
+
+      // Pending delete request for the modern confirm dialog ({sessionId,
+      // displayTitle} | null), set by the menu row / hover button.
+      const deleteStore = (() => {
+        let value = null;
+        const listeners = new Set();
+        return {
+          getSnapshot: () => value,
+          subscribe: (fn) => { listeners.add(fn); return () => listeners.delete(fn); },
+          set: (next) => { if (value !== next) { value = next; for (const fn of listeners) fn(); } },
+        };
+      })();
+      function useDeleteRequest() { return React.useSyncExternalStore(deleteStore.subscribe, deleteStore.getSnapshot); }
+
+      // Enter modern mode: hide the legacy button (and its footer-layout CSS)
+      // for good, then let the caller register its slot entries.
+      const markModern = () => {
+        modernStore.set(true);
+        legacyStyleTag.textContent = "";
+      };
+
+      /**
+       * Whether one session is in the registry-global archive set, read from
+       * the framework's global `useWorkspaces` standard hook (delivered to
+       * every slot component on every supported DSH). Fails closed to false
+       * when the hook is unavailable.
+       *
+       * @param {Function} useWorkspaces - the global workspace snapshot hook.
+       * @param {string} sessionId - row session id.
+       * @returns {boolean} archived membership.
+       */
+      function useArchivedMember(useWorkspaces, sessionId) {
+        try {
+          return useWorkspaces(
+            (s) => Array.isArray(s.archivedSessionIds) && s.archivedSessionIds.indexOf(sessionId) !== -1
+          ) === true;
+        } catch {
+          return false;
+        }
+      }
+
       function ArchiveIcon() {
         return React.createElement(
           "svg",
@@ -244,6 +382,24 @@ window.__ModuleLoader__.load({
         );
       }
 
+      // Trash glyph for the modern delete surfaces: ui-primitives' shipped
+      // icon when available (identical to the shell's own artwork), a plain
+      // outline SVG otherwise.
+      function TrashIcon({ size }) {
+        const px = size || 14;
+        if (ui && ui.IconTrashOutlineRegular) {
+          return React.createElement(ui.IconTrashOutlineRegular, { size: px });
+        }
+        return React.createElement(
+          "svg",
+          { width: px, height: px, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: 1.3, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true },
+          React.createElement("path", { d: "M2.5 4.5h11" }),
+          React.createElement("path", { d: "M5.5 4.5v-1a1 1 0 0 1 1-1h3a1 1 0 0 1 1 1v1" }),
+          React.createElement("path", { d: "M4 4.5l.6 8.1a1 1 0 0 0 1 .9h4.8a1 1 0 0 0 1-.9l.6-8.1" }),
+          React.createElement("path", { d: "M6.5 7v4M9.5 7v4" })
+        );
+      }
+
       function fmtTime(ts) {
         if (typeof ts !== "number" || !isFinite(ts) || ts <= 0) return "";
         const diff = Date.now() - ts;
@@ -475,6 +631,194 @@ window.__ModuleLoader__.load({
         );
       }
 
+      // ---- Modern (DSH >= 0.1.7) delete surfaces ---------------------------
+      // The built-in archive management owns listing/restore on 0.1.7+; these
+      // three components add only DELETION on top of it. Both entry points
+      // show for archived, non-ghost rows only and open the shared confirm
+      // dialog (rendered from the sidebar foot slot — see the stacking note
+      // on the footer registration below).
+
+      /**
+       * Danger row in an archived session's "..." menu
+       * (`sidebar.workspaces.session.menu.item`, order 450 — after the
+       * shipped pin/rename/fork/archive rows). Dismisses the menu through the
+       * slot's `useMenuOpenState` hook before raising the confirm dialog.
+       *
+       * @param props - owner share (row identity) + the slot's hook seat + the global workspace hook.
+       * @returns the menu row, or null when delete does not apply.
+       */
+      function DeleteMenuEntry({ sessionId, displayTitle, useMenuOpenState, useWorkspaces }) {
+        const archived = useArchivedMember(useWorkspaces, sessionId);
+        const ghostIds = useGhostIds();
+        const ghost = ghostIds.indexOf(sessionId) !== -1;
+        const menuState = typeof useMenuOpenState === "function" ? useMenuOpenState() : null;
+        const setMenuOpen = menuState ? menuState[1] : () => {};
+        // Keep the ghost list fresh while the menu offering delete is open.
+        React.useEffect(() => { if (archived) refreshState(); }, [archived, sessionId]);
+        if (!archived || ghost) return null;
+        const select = () => {
+          setMenuOpen(false);
+          deleteStore.set({ sessionId, displayTitle });
+        };
+        if (ui && ui.MenuItemButton) {
+          return React.createElement(
+            ui.MenuItemButton,
+            {
+              danger: true,
+              separatorBefore: true,
+              icon: React.createElement(TrashIcon, { size: 14 }),
+              onSelect: select,
+            },
+            "删除会话…"
+          );
+        }
+        return React.createElement(
+          "button",
+          { type: "button", role: "menuitem", className: "am-menu-del", onClick: select },
+          React.createElement(TrashIcon, { size: 14 }),
+          "删除会话…"
+        );
+      }
+
+      /**
+       * Hover trash button at the archived row's end
+       * (`sidebar.workspaces.session.row.action`, order 300 — after the
+       * shipped archive/pin buttons). Clicks inside the row-action strip stay
+       * in the strip, so no propagation handling is needed.
+       *
+       * @param props - owner share (row identity) + the global workspace hook.
+       * @returns the button, or null when delete does not apply.
+       */
+      function DeleteRowButton({ sessionId, displayTitle, useWorkspaces }) {
+        const archived = useArchivedMember(useWorkspaces, sessionId);
+        const ghostIds = useGhostIds();
+        const ghost = ghostIds.indexOf(sessionId) !== -1;
+        React.useEffect(() => { if (archived) refreshState(); }, [archived, sessionId]);
+        if (!archived || ghost) return null;
+        const button = React.createElement(
+          "button",
+          {
+            type: "button",
+            className: "am-row-del",
+            title: "删除会话",
+            "aria-label": "删除会话",
+            onClick: () => deleteStore.set({ sessionId, displayTitle }),
+          },
+          React.createElement(TrashIcon, { size: 14 })
+        );
+        if (ui && ui.Tooltip) {
+          return React.createElement(
+            ui.Tooltip,
+            { label: "删除会话", side: "bottom", align: "end", delayMs: 500 },
+            button
+          );
+        }
+        return button;
+      }
+
+      /**
+       * The modern confirm dialog: permanent deletion gets the same 二次确认
+       * treatment as the legacy panel (per-request state dies with the
+       * request; errors stay visible; a live-but-idle target resolves into a
+       * ghost explanation instead of closing silently).
+       *
+       * @param props - the pending request and its dismissal.
+       * @returns the fixed overlay + dialog.
+       */
+      function DeleteConfirmForm({ req, onClose }) {
+        const [busy, setBusy] = React.useState(false);
+        const [error, setError] = React.useState(null);
+        const [ghost, setGhost] = React.useState(false);
+        // Esc cancels: the dialog owns z-index:1000, so swallow the key to
+        // keep it from reaching the shell's global Escape handlers.
+        React.useEffect(() => {
+          const onKeyDown = (e) => {
+            if (e.key === "Escape") {
+              e.stopPropagation();
+              if (!busy) onClose();
+            }
+          };
+          document.addEventListener("keydown", onKeyDown, true);
+          return () => document.removeEventListener("keydown", onKeyDown, true);
+        }, [busy]);
+        const close = () => { if (!busy) onClose(); };
+        const confirm = async () => {
+          if (busy) return;
+          setBusy(true);
+          setError(null);
+          try {
+            const res = await remote.delete({ sessionId: req.sessionId });
+            if (res && res.ok) {
+              try {
+                const sessions = ctx.get("sessions");
+                if (sessions && typeof sessions.refresh === "function") sessions.refresh();
+              } catch { /* non-fatal */ }
+              refreshState();
+              if (res.value && res.value.live) {
+                // Live-but-idle: files are gone, the archive entry stays as a
+                // ghost until restart (same semantics as the legacy panel).
+                setGhost(true);
+              } else {
+                onClose();
+              }
+            } else {
+              const err = res && res.error;
+              setError((err && err.message) || (err && err.code) || "删除失败");
+            }
+          } catch (e) {
+            setError(e instanceof Error ? e.message : String(e));
+          } finally {
+            setBusy(false);
+          }
+        };
+        const title = req.displayTitle || req.sessionId;
+        return React.createElement(
+          "div", { className: "am-overlay", onClick: close },
+          React.createElement(
+            "div", { className: "am-confirm", onClick: (e) => e.stopPropagation() },
+            React.createElement(
+              "div", { className: "am-header" },
+              React.createElement("span", { className: "am-title" }, ghost ? "已删除会话" : "删除会话"),
+              React.createElement(
+                "button",
+                { className: "am-close", onClick: close, disabled: busy, title: "关闭", "aria-label": "关闭" },
+                "✕"
+              )
+            ),
+            React.createElement(
+              "div", { className: "am-confirm-body" },
+              ghost
+                ? "日志文件已删除。该会话仍驻留内存，删除条目将在重启 DSH 后自动清除。"
+                : "将永久删除「" + title + "」的会话日志文件，此操作不可恢复。"
+            ),
+            error && !ghost
+              ? React.createElement("div", { className: "am-confirm-error" }, error)
+              : null,
+            React.createElement(
+              "div", { className: "am-confirm-actions" },
+              ghost
+                ? React.createElement(
+                    "button",
+                    { type: "button", className: "am-confirm-btn", onClick: onClose },
+                    "关闭"
+                  )
+                : [
+                    React.createElement(
+                      "button",
+                      { key: "cancel", type: "button", className: "am-confirm-btn", disabled: busy, onClick: close },
+                      "取消"
+                    ),
+                    React.createElement(
+                      "button",
+                      { key: "confirm", type: "button", className: "am-confirm-btn am-confirm-danger", disabled: busy, onClick: confirm },
+                      busy ? "删除中…" : "永久删除"
+                    ),
+                  ]
+            )
+          )
+        );
+      }
+
       // Sidebar footer action entry (Cordis Plugin 下方、设置上方；纵向排列由注入
       // CSS 保证) + frame-wide archive manager panel.
       //
@@ -498,6 +842,8 @@ window.__ModuleLoader__.load({
           const count = rawCount - (ghostIds.length > rawCount ? rawCount : ghostIds.length);
           const safeCount = count > 0 ? count : 0;
           const isOpen = useOpen();
+          const modern = useModern();
+          const deleteReq = useDeleteRequest();
           // Esc 关闭弹窗：打开期间在 document 捕获阶段监听 keydown，命中
           // Escape 即关闭并 stopPropagation——弹窗位于 z-index:1000 顶层，
           // 此时 Esc 应只作用于它，不穿透到 shell 的全局快捷键或底层输入框。
@@ -512,6 +858,18 @@ window.__ModuleLoader__.load({
             document.addEventListener("keydown", onKeyDown, true);
             return () => document.removeEventListener("keydown", onKeyDown, true);
           }, [isOpen]);
+          // DSH >= 0.1.7: the shell's built-in archive management owns the
+          // sidebar entry — no button, no panel; this slot carries only the
+          // delete confirm dialog that this mode exists to add.
+          if (modern) {
+            return deleteReq
+              ? React.createElement(DeleteConfirmForm, {
+                  key: deleteReq.sessionId,
+                  req: deleteReq,
+                  onClose: () => deleteStore.set(null),
+                })
+              : null;
+          }
           const children = [];
           children.push(React.createElement("span", { key: "icon", className: "am-foot-icon", "aria-hidden": true }, React.createElement(ArchiveIcon)));
           if (wide) children.push(React.createElement("span", { key: "label", className: "am-foot-label" }, "归档"));
@@ -535,10 +893,36 @@ window.__ModuleLoader__.load({
           return [button, overlay];
         }
       ));
+
+      // ---- Modern-mode registrations (fired only on DSH >= 0.1.7) ----------
+      // ui-workspace declares these two lists when it registers the built-in
+      // archive browsing region (the "仅显示已归档" filter world). On earlier
+      // DSH builds the keys are never declared: ctx.slots.inject() waits
+      // silently, these callbacks never run, no entry is registered, and the
+      // legacy footer button stays — that IS the version switch. The first
+      // declaration also flips markModern(), which hides the legacy button
+      // and drops the footer-column CSS for good.
+      ctx.slots.inject("sidebar.workspaces.session.menu.item", () => {
+        markModern();
+        return ctx.slots.register(
+          { name: "sidebar.workspaces.session.menu.item", id: "dsh-archive-manager.delete", order: 450 },
+          DeleteMenuEntry
+        );
+      });
+      ctx.slots.inject("sidebar.workspaces.session.row.action", () => {
+        markModern();
+        return ctx.slots.register(
+          { name: "sidebar.workspaces.session.row.action", id: "dsh-archive-manager.delete", order: 300 },
+          DeleteRowButton
+        );
+      });
     }
 
     exports.apply = apply;
     exports.inject = ["slots", "remote"];
+    // Exposed for verify-typert-compat.mjs (the browser wiring contract has
+    // to satisfy both DSH typert registries; nothing else reads this).
+    exports.CLIENT_REMOTE = CLIENT_REMOTE;
     return module.exports;
   },
 });

package/index.js

@@ -23,8 +23,9 @@
 
 import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 import { Service } from "@deepseek-ai/cordis";
-import { existsSync } from "node:fs";
+import { existsSync, statSync } from "node:fs";
 import { rm } from "node:fs/promises";
+import { basename, dirname, extname } from "node:path";
 
 /**
  * Mark one instance method as a Remote export without relying on decorator
@@ -71,6 +72,36 @@ function readArchived(domain) {
   return [];
 }
 
+/**
+ * Resolve the session directory that owns a session's log artifact.
+ *
+ * `sessionPersistence.locate(header).path` changed meaning across DSH majors:
+ *   - DSH < 0.2.0: the session DIRECTORY (`…/<project>/<sessionId>/`), which is
+ *     what `rm(..., { recursive: true })` was written against.
+ *   - DSH >= 0.2.0 (`dsh-session-persistence-jsonl`): the current generation's
+ *     log FILE inside that directory (`…/<project>/<sessionId>/session.v4.jsonl.zstd`).
+ *     Removing only that file would leave the directory and any older generation
+ *     (`session.v3.jsonl.zstd`) behind, so a restart could resurrect the session —
+ *     exactly what "永久删除" must not do.
+ *
+ * So: prefer `stat` on the path itself; when the artifact is already gone, fall
+ * back to the name shape — a located log file always carries an extension
+ * (`session.v4.jsonl.zstd`), while a per-session directory never does.
+ *
+ * @param {string} locatedPath - `sessionPersistence.locate(header).path`.
+ * @returns {string} the directory to remove.
+ */
+function deletionTarget(locatedPath) {
+  const target = String(locatedPath);
+  try {
+    if (statSync(target).isDirectory()) return target;
+    if (statSync(target).isFile()) return dirname(target);
+  } catch {
+    /* artifact already gone — infer from the path shape below */
+  }
+  return extname(basename(target)) === "" ? target : dirname(target);
+}
+
 export class ArchiveManagerService extends TypertRemoteService {
   static inject = [
     "workspaceRegistry",
@@ -194,9 +225,20 @@ export class ArchiveManagerService extends TypertRemoteService {
       return { ok: false, error: { code: "agent-running", message: "该会话的智能体正在运行中，请等待其完成或停止后再删除" } };
     }
     const header = await this.findHeader(sessionId);
+    const sessionPersistence = this.ctx.get("sessionPersistence");
+    if (header && (!sessionPersistence || typeof sessionPersistence.locate !== "function")) {
+      // The header exists but this build cannot tell us where its log lives.
+      // Claiming success here would silently keep the session on disk.
+      return {
+        ok: false,
+        error: {
+          code: "locate-unavailable",
+          message: "当前 DSH 版本的会话存储未提供 locate()，无法定位会话日志目录，已保留归档条目",
+        },
+      };
+    }
     let location;
     if (header) {
-      const sessionPersistence = this.ctx.get("sessionPersistence");
       try {
         location = sessionPersistence.locate(header);
       } catch {
@@ -206,7 +248,7 @@ export class ArchiveManagerService extends TypertRemoteService {
     let removed = false;
     let fileError;
     if (location && location.path) {
-      const target = String(location.path);
+      const target = deletionTarget(location.path);
       try {
         // Delete straight from the host process via node:fs — no shell, no
         // PowerShell, no sandbox escalation, so this behaves identically on
@@ -214,7 +256,8 @@ export class ArchiveManagerService extends TypertRemoteService {
         // the host's own privileges, which makes the sandbox ACL dance the
         // previous shell-based implementation needed unnecessary. maxRetries
         // absorbs transient Windows file locks (antivirus / indexers) and is
-        // a no-op elsewhere.
+        // a no-op elsewhere. The whole owning session directory goes, so older
+        // format generations cannot survive the delete (DSH >= 0.2.0).
         await rm(target, { recursive: true, force: true, maxRetries: 3, retryDelay: 200 });
         removed = !existsSync(target);
         if (!removed) fileError = "path-still-exists";
@@ -263,8 +306,10 @@ export class ArchiveManagerService extends TypertRemoteService {
         const session = sessions.get(id);
         if (session === undefined) continue; // not live in memory → not a ghost
         const location = sessionPersistence.locate(session.header);
-        // Live but the log directory is gone → ghost the client hides.
-        if (location && location.path && !existsSync(String(location.path))) ghostIds.push(id);
+        // Live but the log is gone → ghost the client hides. Probed against the
+        // owning session directory, i.e. exactly what `delete` removes: on DSH
+        // >= 0.2.0 `locate` names the current generation's file inside it.
+        if (location && location.path && !existsSync(deletionTarget(location.path))) ghostIds.push(id);
       } catch {
         /* skip */
       }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@duke-dsh-plugins/dsh-archive-manager",
-  "version": "1.3.6",
-  "description": "Archive manager for DeepSeek Harness: group archived sessions by project, newest-first, with search, restore and delete.",
+  "version": "1.5.0",
+  "description": "Archive manager for DeepSeek Harness: DSH < 0.1.7 gets the grouped search/restore/delete panel; DSH >= 0.1.7 adds the delete action missing from the built-in archive management.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/MoonlitDropOfBlood/dsh-archive-manager.git"
@@ -36,13 +36,14 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.6"
+    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.6 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.6 || ^0.2.0-rc.1"
   },
   "dependencies": {
     "zod": "^4.4.3"
   },
   "scripts": {
-    "check": "node --check index.js && node --check client.js && node --check typert.host.js"
+    "check": "node --check index.js && node --check client.js && node --check typert.host.js",
+    "verify": "node verify-constructor.mjs && node verify-typert-compat.mjs && node verify-client-apply.mjs && node verify-real-install.mjs"
   }
 }

package/typert.host.js

@@ -8,72 +8,131 @@
  *
  * Keep the invocation ids, service/namespace names and method names in sync
  * with `index.js` (ArchiveManagerService) and `client.js`.
+ *
+ * Cross-version note: strict codecs carry BOTH `schema` (DSH < 0.1.7 reads
+ * the zod instance) and `create` (DSH >= 0.1.7 requires the factory) — see
+ * the codec contract comment below before touching any codec.
  */
 
 import { z } from "zod";
 
 // ---- shared shapes ---------------------------------------------------------
+//
+// DSH-versioned codec contract (the ONE field that differs across DSH builds):
+//   - DSH < 0.1.7 (typert-loader / typert-registry): a strict codec must carry
+//     `codec.schema` — a zod v4 INSTANCE (`_zod` + `parse`) — and the runtime
+//     calls `codec.schema.parse(...)`.
+//   - DSH >= 0.1.7: a strict codec must carry `codec.create` — a FACTORY
+//     function returning a zod schema — and the runtime calls
+//     `codec.create().parse(...)`; a plain instance in `schema` fails
+//     validation with "strict codec has no create() factory".
+// Every codec below therefore carries BOTH: `schema` (materialized instance,
+// read by <0.1.7) and `create` (memoized factory, read by >=0.1.7). Each
+// version's validator only inspects its own field, so the extra field is
+// ignored everywhere. Same for TYPERT.schemas entries (0.1.7 requires
+// `create`; our list stays empty, which satisfies both).
+
+/**
+ * Memoize one zod schema behind a `create()`-style factory: repeated calls
+ * return the same instance (the official 0.1.7 manifests use this exact
+ * `value ??= build()` pattern).
+ *
+ * @param {() => object} build - constructs the zod schema once.
+ * @returns {() => object} the factory.
+ */
+function lazy(build) {
+  let value;
+  return () => (value ??= build());
+}
 
-const sessionIdSchema = z.intersection(z.string(), z.unknown()).readonly();
+const sessionIdSchema = lazy(() => z.intersection(z.string(), z.unknown()).readonly());
 
-const restoreResultSchema = z.union([
-  z.object({
-    ok: z.literal(true).readonly(),
-    value: z.object({
-      restored: z.literal(true).readonly(),
+const restoreResultSchema = lazy(() =>
+  z.union([
+    z.object({
+      ok: z.literal(true).readonly(),
+      value: z.object({
+        restored: z.literal(true).readonly(),
+      }).readonly(),
     }).readonly(),
-  }).readonly(),
-  z.object({
-    ok: z.literal(false).readonly(),
-    error: z.object({
-      code: z.string().readonly(),
-      message: z.string().readonly().optional(),
+    z.object({
+      ok: z.literal(false).readonly(),
+      error: z.object({
+        code: z.string().readonly(),
+        message: z.string().readonly().optional(),
+      }).readonly(),
     }).readonly(),
-  }).readonly(),
-]);
+  ])
+);
 
-const deleteResultSchema = z.union([
-  z.object({
-    ok: z.literal(true).readonly(),
-    value: z.object({
-      fileRemoved: z.boolean().readonly(),
-      live: z.boolean().readonly(),
+const deleteResultSchema = lazy(() =>
+  z.union([
+    z.object({
+      ok: z.literal(true).readonly(),
+      value: z.object({
+        fileRemoved: z.boolean().readonly(),
+        live: z.boolean().readonly(),
+      }).readonly(),
     }).readonly(),
-  }).readonly(),
-  z.object({
-    ok: z.literal(false).readonly(),
-    error: z.object({
-      code: z.string().readonly(),
-      message: z.string().readonly().optional(),
+    z.object({
+      ok: z.literal(false).readonly(),
+      error: z.object({
+        code: z.string().readonly(),
+        message: z.string().readonly().optional(),
+      }).readonly(),
     }).readonly(),
-  }).readonly(),
-]);
+  ])
+);
 
-const stateResultSchema = z.union([
-  z.object({
-    ok: z.literal(true).readonly(),
-    value: z.object({
-      ghostIds: z.array(sessionIdSchema).readonly(),
+const stateResultSchema = lazy(() =>
+  z.union([
+    z.object({
+      ok: z.literal(true).readonly(),
+      value: z.object({
+        ghostIds: z.array(sessionIdSchema()).readonly(),
+      }).readonly(),
     }).readonly(),
-  }).readonly(),
-  z.object({
-    ok: z.literal(false).readonly(),
-    error: z.object({
-      code: z.string().readonly(),
-      message: z.string().readonly().optional(),
+    z.object({
+      ok: z.literal(false).readonly(),
+      error: z.object({
+        code: z.string().readonly(),
+        message: z.string().readonly().optional(),
+      }).readonly(),
     }).readonly(),
-  }).readonly(),
-]);
+  ])
+);
 
 // ---- per-invocation parameter/result schemas -------------------------------
 
-const _archiveManager_restore_parameter_0$schema = z.object({
-  sessionId: sessionIdSchema,
-});
+const restoreRequestSchema = lazy(() =>
+  z.object({
+    sessionId: sessionIdSchema(),
+  })
+);
+
+const deleteRequestSchema = lazy(() =>
+  z.object({
+    sessionId: sessionIdSchema(),
+  })
+);
 
-const _archiveManager_delete_parameter_0$schema = z.object({
-  sessionId: sessionIdSchema,
-});
+/**
+ * Build the dual-version strict codec: `schema` for DSH < 0.1.7 (instance
+ * read at validation time), `create` for DSH >= 0.1.7 (factory invoked by
+ * the runtime). Both point at the same memoized instance.
+ *
+ * @param {string} typeSymbol - wire type symbol.
+ * @param {() => object} factory - the memoized schema factory.
+ * @returns {object} the codec descriptor.
+ */
+function strictCodec(typeSymbol, factory) {
+  return {
+    mode: "strict",
+    typeSymbol,
+    schema: factory(),
+    create: factory,
+  };
+}
 
 export const TYPERT = {
   package: "@duke-dsh-plugins/dsh-archive-manager",
@@ -91,18 +150,16 @@ export const TYPERT = {
           name: "request",
           wire: "request",
           source: "json",
-          codec: {
-            mode: "strict",
-            typeSymbol: "dsh-archive-manager#ArchiveManagerRestoreRequest",
-            schema: _archiveManager_restore_parameter_0$schema,
-          },
+          codec: strictCodec(
+            "dsh-archive-manager#ArchiveManagerRestoreRequest",
+            restoreRequestSchema
+          ),
         },
       ],
-      result: {
-        mode: "strict",
-        typeSymbol: "dsh-archive-manager#ArchiveManagerRestoreResult",
-        schema: restoreResultSchema,
-      },
+      result: strictCodec(
+        "dsh-archive-manager#ArchiveManagerRestoreResult",
+        restoreResultSchema
+      ),
       sourceLocation: { file: "index.js", line: 1, column: 1 },
     },
     {
@@ -116,18 +173,16 @@ export const TYPERT = {
           name: "request",
           wire: "request",
           source: "json",
-          codec: {
-            mode: "strict",
-            typeSymbol: "dsh-archive-manager#ArchiveManagerDeleteRequest",
-            schema: _archiveManager_delete_parameter_0$schema,
-          },
+          codec: strictCodec(
+            "dsh-archive-manager#ArchiveManagerDeleteRequest",
+            deleteRequestSchema
+          ),
         },
       ],
-      result: {
-        mode: "strict",
-        typeSymbol: "dsh-archive-manager#ArchiveManagerDeleteResult",
-        schema: deleteResultSchema,
-      },
+      result: strictCodec(
+        "dsh-archive-manager#ArchiveManagerDeleteResult",
+        deleteResultSchema
+      ),
       sourceLocation: { file: "index.js", line: 1, column: 1 },
     },
     {
@@ -137,11 +192,10 @@ export const TYPERT = {
       method: "state",
       invocation: { kind: "direct" },
       parameters: [],
-      result: {
-        mode: "strict",
-        typeSymbol: "dsh-archive-manager#ArchiveManagerStateResult",
-        schema: stateResultSchema,
-      },
+      result: strictCodec(
+        "dsh-archive-manager#ArchiveManagerStateResult",
+        stateResultSchema
+      ),
       sourceLocation: { file: "index.js", line: 1, column: 1 },
     },
   ],