dsh-sidebar-row-menu 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.7.0 — 2026-11-05
+
+### Added
+
+- **Per-workspace archived-session toggle in the workspace menu.** A workspace
+  whose group holds archived sessions now gets "Show archived sessions" /
+  "Hide archived sessions" in its right-click menu (and in the row's "…" menu
+  when opted in), using the same archive glyphs as the native View options
+  items. DSH only offers one global archived filter; the plugin switches it to
+  "all conversations" and hides every other workspace's (and "Ungrouped")
+  archived rows, so each workspace can reveal its own archived sessions
+  independently. The choice persists across reloads, and changing the native filter clears it so the
+  host's global choice stays authoritative. The entry can be switched off under
+  Settings → row menu and is only shown when the workspace actually has
+  archived sessions.
+
 ## 1.6.0 — 2026-11-05
 
 ### Added

package/README.en.md

@@ -44,8 +44,8 @@ its own entries; it does not copy or hardcode any built-in action.
 On 0.2.2 the host renders this menu, and the plugin's items interleave with the
 built-in Rename (100), Reveal in file manager (200) and Delete workspace (300),
 using the same grouping rules as the session menu: New session 90, Open in new
-tab 110, Copy workspace path 150, pinned app 210, Open with 220, Delete workspace
-and all sessions 310. These items are right-click only by default; the row's "…"
+tab 110, archived-session toggle 130, Copy workspace path 150, pinned app 210,
+Open with 220, Delete workspace and all sessions 310. These items are right-click only by default; the row's "…"
 menu keeps its native content unless you opt entries in under Settings → "Also
 show in the "…" menu → workspace". On 0.2.1 the plugin draws the whole menu and
 runs the official dialogs for Rename and Delete workspace.
@@ -55,6 +55,7 @@ runs the official dialogs for Rename and Delete workspace.
 | New session | Expands the workspace and starts a session (same as the row's `+`) |
 | Rename (built-in) | Opens the official "Rename workspace" dialog; on 0.2.1 the plugin renders this item itself |
 | Open in new tab | Only when `dsh-project-tabs` (exposing `openWorkspaceInTab`) is installed |
+| Show / hide archived sessions | Only on workspaces that have archived sessions; the label follows the current state. "Show archived sessions" switches the sidebar's global archived filter to all conversations and then hides every other workspace's archived rows (including "Ungrouped"), so only this workspace's archived sessions appear; "Hide archived sessions" puts them back. Per-workspace choices persist across reloads; changing the global filter under "View options" wins over them |
 | Copy workspace path | Copies the directory path |
 | Reveal in file manager (built-in) | Opens the workspace directory in Explorer; provided by the host on 0.2.2, absent on 0.2.1 |
 | Pinned open-with app | A pinned app shows directly at the top level (e.g. "Open with Visual Studio Code") and opens the workspace directory |
@@ -124,7 +125,8 @@ Settings → "Row menu" toggles every new entry:
 | Delete session | Hides the single-session delete entry in session menus |
 | Allow deleting unarchived sessions | Off by default; also shows "Delete session permanently" on unarchived rows. Requires the previous switch |
 | Delete all archived sessions | Hides the bulk-delete entry |
-| Also show in the "…" menu → workspace | Adds workspace right-click entries one by one to the row's "…" menu: New session, Open with, Copy workspace path, Open in new tab, Delete workspace and all sessions. On 0.2.1 enabling any of them makes this plugin render the "…" menu |
+| Show archived sessions | Hides the workspace "Show / hide archived sessions" entry (on by default; the entry itself only appears when that workspace has archived sessions) |
+| Also show in the "…" menu → workspace | Adds workspace right-click entries one by one to the row's "…" menu: New session, Open with, Copy workspace path, Open in new tab, archived-session toggle, Delete workspace and all sessions. On 0.2.1 enabling any of them makes this plugin render the "…" menu |
 | Also show in the "…" menu → session | Adds session right-click entries one by one to the native "…" menu: Open with, Delete session, Delete all archived sessions |
 
 The "Also show in the "…" menu" switches are all off by default; until one is
@@ -370,6 +372,17 @@ trigger (`memoizedProps.onContextMenu` is a function): if it does, the host open
 menu at the pointer by itself and the plugin only drops a gesture mark, never
 touching the event.
 
+### Why archived sessions cannot use the global filter alone
+
+DSH exposes one global archived-visibility filter (`archivedFilter`: hide archived /
+all conversations / archived only) and no per-workspace equivalent. The plugin builds
+the per-workspace layer on top of it: it drives the host view action to "all
+conversations", then hides other workspaces' (and "Ungrouped") archived rows with an inline
+`display:none`. The snapshot's `archivedSessionIds` tells it which rows are archived,
+and a MutationObserver re-applies the hiding whenever React replaces the row nodes.
+The plugin does not keep the global filter hostage: once the user picks a filter under
+"View options", the per-workspace hidden set is cleared and the host's choice wins.
+
 ### Why session actions are not hardcoded
 
 The native session menu is not a hardcoded button list: it is

package/README.md

@@ -34,7 +34,7 @@ DSH 0.2.2 把侧栏右键改成数据驱动：工作区菜单由宿主统一渲
 
 0.2.2 上这份菜单由宿主渲染，本插件条目与内置「重命名」（100）、「在文件夹显示」（200）、
 「删除工作区」（300）按 order 交错，分组规则与会话菜单一致：新会话 90、在新标签打开 110、
-复制工作区路径 150、置顶应用 210、打开方式 220、删除工作区及所有会话 310。这些条目默认
+归档会话开关 130、复制工作区路径 150、置顶应用 210、打开方式 220、删除工作区及所有会话 310。这些条目默认
 只出现在右键菜单；行尾「…」里的菜单保持原生，想让它也带上插件条目，可在设置里逐项开启
 「同时放进「…」菜单 → 工作区」。0.2.1 上整份菜单由本插件自绘，「重命名」「删除工作区」
 由插件调用官方对话框。
@@ -44,6 +44,7 @@ DSH 0.2.2 把侧栏右键改成数据驱动：工作区菜单由宿主统一渲
 | 新会话 | 展开该工作区并新建会话（等价于行尾 `+`） |
 | 重命名（内置） | 打开官方“重命名工作区”对话框；0.2.1 上由本插件代为渲染 |
 | 在新标签中打开 | 仅在装有 `dsh-project-tabs`（暴露 `openWorkspaceInTab`）时出现 |
+| 显示 / 隐藏已归档会话 | 只在该工作区有已归档会话时出现，文案随当前状态切换。点击「显示已归档会话」会把侧边栏的全局归档筛选切到「全部对话」，再藏起其他工作区（含「未分组」）的归档行，于是只有这个工作区的已归档会话露出来；点击「隐藏已归档会话」把它重新收回。逐工作区的选择存在本地、刷新后保持；在「视图选项」里改全局筛选则以全局选择为准 |
 | 复制工作区路径 | 复制目录路径到剪贴板 |
 | 在文件夹显示（内置） | 在资源管理器里打开工作区目录；0.2.2 由宿主提供，0.2.1 上不出现 |
 | 置顶的打开方式 | 被置顶的应用直接显示在一级菜单（例如「用 Visual Studio Code 打开」），点击后用该应用打开工作区目录 |
@@ -102,7 +103,8 @@ DSH 0.2.2 把侧栏右键改成数据驱动：工作区菜单由宿主统一渲
 | 永久删除会话 | 关闭后会话菜单里不再出现单条删除入口 |
 | 允许删除未归档会话 | 默认关闭；开启后未归档会话的右键菜单也会出现「永久删除会话」，需先开启上一项 |
 | 删除所有已归档会话 | 关闭后不再出现批量删除入口 |
-| 同时放进「…」菜单 → 工作区 | 逐项把工作区行右键条目也放进行尾「…」菜单：新会话、打开方式、复制工作区路径、在新标签中打开、删除工作区及所有会话。0.2.1 上开启任意一项后「…」按钮改由本插件渲染 |
+| 显示已归档会话 | 关闭后工作区菜单里不再出现「显示 / 隐藏已归档会话」（默认开启；该项只在当前工作区存在已归档会话时出现） |
+| 同时放进「…」菜单 → 工作区 | 逐项把工作区行右键条目也放进行尾「…」菜单：新会话、打开方式、复制工作区路径、在新标签中打开、归档会话开关、删除工作区及所有会话。0.2.1 上开启任意一项后「…」按钮改由本插件渲染 |
 | 同时放进「…」菜单 → 会话 | 逐项把会话行右键条目加进原生「…」菜单：打开方式、永久删除会话、删除所有已归档会话 |
 
 「同时放进「…」菜单」下的开关默认全部关闭，`…` 菜单在未开启时与 DSH 完全一致。
@@ -321,6 +323,14 @@ test/*.test.mjs       node:test
 这一行是否天生带宿主右键触发器（`memoizedProps.onContextMenu` 是函数）：有就说明宿主会把
 菜单开在指针处，插件只补一个手势标记，不再干预事件。
 
+### 归档会话为什么不是纯全局筛选
+
+DSH 的归档可见性只有一个全局筛选（`archivedFilter`：隐藏已归档 / 全部对话 / 仅显示已归档），
+没有逐工作区的概念。插件把「逐工作区」做成两层：先通过宿主视图动作把全局切到「全部对话」，
+再把其他工作区（含「未分组」）的归档行用行内 `display:none` 藏起来；快照里的 `archivedSessionIds` 决定哪些
+行是归档行，React 重渲染替换掉节点后由 MutationObserver 重新隐藏。插件不长期改写全局筛选：
+用户在「视图选项」里改过之后，之前逐工作区的隐藏会被清空，完全跟随宿主的选择。
+
 ### 会话行为什么不硬编码
 
 内置会话菜单不是硬编码的按钮列表，而是

package/lib/client.js

@@ -69,6 +69,8 @@ window.__ModuleLoader__.load({
       IconWarningOutlineRegular,
       IconCopyOutlineRegular,
       IconChevronRightOutlineRegular,
+      IconArchiveOutlineRegular,
+      IconArchiveOffOutlineRegular,
       IconRightUpOutlineRegular,
       IconTriangleRightFillRegular,
     } = require('@deepseek-ai/dsh-client-ui-primitives');
@@ -112,6 +114,7 @@ window.__ModuleLoader__.load({
      */
     const ITEM_DEFAULTS = {
       openWith: true,
+      archivedSessions: true,
       deleteSession: true,
       deleteArchived: true,
       deleteUnarchived: false,
@@ -122,8 +125,16 @@ window.__ModuleLoader__.load({
      * 全部默认关闭：不勾选时点「…」看到的仍是 DSH 原生菜单。
      */
     const ELLIPSIS_KEY = 'dsh.sidebar-row-menu.ellipsis.v1';
+    /**
+     * 按工作区「已隐藏归档会话」的集合。宿主只有全局归档筛选（default/show/only），
+     * 没有「这个工作区显示归档、那个工作区不显示」的概念，所以这里记住要单独
+     * 隐藏归档行的工作区，再把全局筛选开到 show，最后在 DOM 里把其余工作区的
+     * 归档行藏起来。
+     */
+    const ARCHIVED_HIDDEN_KEY = 'dsh.sidebar-row-menu.archived-hidden.v1';
     const ELLIPSIS_DEFAULTS = {
       newSession: false,
+      showArchived: false,
       openWith: false,
       copyPath: false,
       openInTab: false,
@@ -154,6 +165,8 @@ window.__ModuleLoader__.load({
       openInTab: '在新标签中打开',
       deleteWorkspace: '删除工作区',
       deleteWorkspaceSessions: '删除工作区及所有会话',
+      showArchivedSessions: '显示已归档会话',
+      hideArchivedSessions: '隐藏已归档会话',
       copied: '已复制',
       copyFailed: '复制失败，请重试',
       noPath: '没有可用的目录路径',
@@ -166,6 +179,8 @@ window.__ModuleLoader__.load({
       'settings.title': '行菜单',
       'settings.openWith.label': '打开方式',
       'settings.openWith.hint': '在子菜单里选择编辑器、终端或文件管理器打开工作区或会话目录；置顶的应用直接显示在菜单一级。',
+      'settings.archivedSessions.label': '显示已归档会话',
+      'settings.archivedSessions.hint': '在工作区右键菜单里单独显示或隐藏该工作区内所有已归档会话，不影响其他工作区。',
       'settings.deleteSession.label': '永久删除会话',
       'settings.deleteSession.hint': '在会话菜单里永久删除这一个会话及其日志；默认只对已归档会话显示。',
       'settings.deleteArchived.label': '删除所有已归档会话',
@@ -191,6 +206,8 @@ window.__ModuleLoader__.load({
       'settings.ellipsisSession': '会话行',
       'settings.ellipsis.newSession.label': '新建会话',
       'settings.ellipsis.newSession.hint': '在「…」菜单里直接新建该工作区的会话。',
+      'settings.ellipsis.showArchived.label': '显示已归档会话',
+      'settings.ellipsis.showArchived.hint': '在「…」菜单里单独显示或隐藏该工作区的已归档会话。',
       'settings.ellipsis.openWith.label': '打开方式',
       'settings.ellipsis.openWith.hint': '在「…」菜单里用外部应用打开工作区或会话目录。',
       'settings.ellipsis.copyPath.label': '拷贝工作区路径',
@@ -238,6 +255,8 @@ window.__ModuleLoader__.load({
       openInTab: 'Open in new tab',
       deleteWorkspace: 'Delete workspace',
       deleteWorkspaceSessions: 'Delete workspace and all sessions',
+      showArchivedSessions: 'Show archived sessions',
+      hideArchivedSessions: 'Hide archived sessions',
       copied: 'Copied',
       copyFailed: 'Copy failed, please retry',
       noPath: 'No usable directory path',
@@ -250,6 +269,8 @@ window.__ModuleLoader__.load({
       'settings.title': 'Row menu',
       'settings.openWith.label': 'Open with',
       'settings.openWith.hint': 'Pick an editor, terminal or file manager for workspace or session directories; pinned apps show up directly in the menu.',
+      'settings.archivedSessions.label': 'Show archived sessions',
+      'settings.archivedSessions.hint': 'Show or hide this workspace\'s archived sessions from its context menu, without affecting other workspaces.',
       'settings.deleteSession.label': 'Delete session permanently',
       'settings.deleteSession.hint': 'Permanently delete one session and its transcript from its menu; shown on archived sessions by default.',
       'settings.deleteArchived.label': 'Delete all archived sessions',
@@ -275,6 +296,8 @@ window.__ModuleLoader__.load({
       'settings.ellipsisSession': 'Session rows',
       'settings.ellipsis.newSession.label': 'New session',
       'settings.ellipsis.newSession.hint': 'Create a session for this workspace from the "…" menu.',
+      'settings.ellipsis.showArchived.label': 'Show archived sessions',
+      'settings.ellipsis.showArchived.hint': 'Show or hide this workspace\'s archived sessions from the "…" menu.',
       'settings.ellipsis.openWith.label': 'Open with',
       'settings.ellipsis.openWith.hint': 'Open the workspace or session directory with an external app from the "…" menu.',
       'settings.ellipsis.copyPath.label': 'Copy workspace path',
@@ -1477,6 +1500,7 @@ window.__ModuleLoader__.load({
       ['deleteSession', 'settings.deleteSession.label', 'settings.deleteSession.hint'],
       ['deleteUnarchived', 'settings.deleteUnarchived.label', 'settings.deleteUnarchived.hint'],
       ['deleteArchived', 'settings.deleteArchived.label', 'settings.deleteArchived.hint'],
+      ['archivedSessions', 'settings.archivedSessions.label', 'settings.archivedSessions.hint'],
     ];
 
     /** 「…」菜单附加开关；按行分组，避免用户分不清工作区项和会话项。 */
@@ -1486,6 +1510,7 @@ window.__ModuleLoader__.load({
         ['openWith', 'settings.ellipsis.openWith.label', 'settings.ellipsis.openWith.hint'],
         ['copyPath', 'settings.ellipsis.copyPath.label', 'settings.ellipsis.copyPath.hint'],
         ['openInTab', 'settings.ellipsis.openInTab.label', 'settings.ellipsis.openInTab.hint'],
+        ['showArchived', 'settings.ellipsis.showArchived.label', 'settings.ellipsis.showArchived.hint'],
         ['deleteSessions', 'settings.ellipsis.deleteSessions.label', 'settings.ellipsis.deleteSessions.hint'],
       ]],
       ['session', 'settings.ellipsisSession', [
@@ -1744,7 +1769,9 @@ window.__ModuleLoader__.load({
             return;
           }
           copyText(cwd, t);
+          return;
         }
+        if (id === 'archived') toggleWorkspaceArchived(workspaceId);
       };
 
       const rows = [];
@@ -1813,6 +1840,19 @@ window.__ModuleLoader__.load({
           children: t('openInTab'),
         }));
       }
+      const archivedCount = items.archivedSessions === false ? 0 : archivedCountOfWorkspace(workspaceId);
+      if (archivedCount > 0 && show('showArchived')) {
+        const archivedVisible = archivedRowsVisibleIn(workspaceId);
+        rows.push(jsx(MenuItemButton, {
+          key: 'archived',
+          onSelect: () => {
+            onClose();
+            run('archived');
+          },
+          icon: jsx(archivedVisible ? IconArchiveOffOutlineRegular : IconArchiveOutlineRegular, { size: 14 }),
+          children: t(archivedVisible ? 'hideArchivedSessions' : 'showArchivedSessions'),
+        }));
+      }
       rows.push(jsx(MenuItemButton, {
         key: 'delete',
         danger: true,
@@ -2065,6 +2105,275 @@ window.__ModuleLoader__.load({
       });
     }
 
+    /* --------------------- 工作区归档会话：按工作区单独显示/隐藏 */
+
+    function readHiddenWorkspaces() {
+      const hidden = new Set();
+      try {
+        const raw = globalThis.localStorage?.getItem(ARCHIVED_HIDDEN_KEY);
+        if (typeof raw !== 'string' || raw === '') return hidden;
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) return hidden;
+        for (const id of parsed) {
+          if (typeof id === 'string' && id !== '') hidden.add(id);
+        }
+      } catch {
+        /* 坏数据按空集合处理 */
+      }
+      return hidden;
+    }
+
+    let hiddenArchivedWorkspaces = readHiddenWorkspaces();
+
+    function persistHiddenWorkspaces() {
+      try {
+        globalThis.localStorage?.setItem(ARCHIVED_HIDDEN_KEY, JSON.stringify([...hiddenArchivedWorkspaces]));
+      } catch {
+        /* 隐私模式写不进去也照样生效到本次会话 */
+      }
+    }
+
+    /**
+     * 读宿主工作区视图的归档筛选。插件没有公开 API 订阅宿主视图 store，但视图
+     * 状态会持久化到 localStorage 的 `dsh.workspace.view.vN`（筛选一变就写），
+     * 所以读这里就能知道用户是否在「视图选项」里改过全局筛选。
+     */
+    function readViewFilter() {
+      try {
+        const storage = globalThis.localStorage;
+        if (storage === null || storage === undefined || typeof storage.key !== 'function') return 'default';
+        const keys = [];
+        for (let index = 0; index < storage.length; index += 1) {
+          const key = storage.key(index);
+          if (typeof key === 'string' && key.startsWith('dsh.workspace.view.')) keys.push(key);
+        }
+        // 版本号是数字后缀，v10 必须排在 v5 前面。
+        const versionOf = (key) => {
+          const match = /\.v(\d+)$/.exec(key);
+          return match === null ? -1 : Number(match[1]);
+        };
+        keys.sort((left, right) => versionOf(right) - versionOf(left));
+        for (const key of keys) {
+          const parsed = JSON.parse(storage.getItem(key) ?? '');
+          if (parsed !== null && typeof parsed === 'object' && typeof parsed.archivedFilter === 'string') {
+            return parsed.archivedFilter;
+          }
+        }
+      } catch {
+        /* 视图状态不可读时按默认筛选处理 */
+      }
+      return 'default';
+    }
+
+    /**
+     * 宿主把 view actions 挂在 WorkspaceBrowser 组件的 props 上；插件没有服务可以
+     * 拿到它，只能从行的 __reactFiber$ 往上找。找不到时静默放弃（筛选仍可手动切）。
+     */
+    function findArchivedViewActions() {
+      if (typeof document === 'undefined' || typeof document.querySelector !== 'function') return null;
+      const row = document.querySelector('[data-row-key^="session:"], [data-row-key^="workspace:"]');
+      if (row === null || row === undefined) return null;
+      const field = Object.keys(row).find((name) => name.startsWith('__reactFiber$'));
+      let fiber = field === undefined ? null : row[field];
+      for (let depth = 0; depth < 48 && fiber !== null && fiber !== undefined; depth += 1) {
+        const actions = fiber.memoizedProps?.actions;
+        if (actions !== null && typeof actions === 'object' && typeof actions.setArchivedFilter === 'function') {
+          return actions;
+        }
+        fiber = fiber.return;
+      }
+      return null;
+    }
+
+    let lastViewFilter = readViewFilter();
+
+    function writeViewFilter(filter) {
+      const actions = findArchivedViewActions();
+      if (actions === null) return false;
+      try {
+        actions.setArchivedFilter(filter);
+        lastViewFilter = filter;
+        return true;
+      } catch (error) {
+        console.warn('[dsh-sidebar-row-menu] archived filter change failed:', error);
+        return false;
+      }
+    }
+
+    /** 当前快照里的归档会话集合，以及每个会话所属工作区（未归组的会话没有）。 */
+    function archivedWorkspaceIndex() {
+      const snapshot = serviceOf(rootCtx, 'workspaces')?.list?.getSnapshot?.();
+      const archived = new Set(Array.isArray(snapshot?.archivedSessionIds) ? snapshot.archivedSessionIds : []);
+      const owner = new Map();
+      for (const item of Array.isArray(snapshot?.items) ? snapshot.items : []) {
+        const workspaceId = typeof item?.workspaceId === 'string' ? item.workspaceId : '';
+        if (workspaceId === '' || !Array.isArray(item?.sessionIds)) continue;
+        for (const sessionId of item.sessionIds) {
+          if (typeof sessionId === 'string' && sessionId !== '') owner.set(sessionId, workspaceId);
+        }
+      }
+      return { archived, owner };
+    }
+
+    function archivedCountOfWorkspace(workspaceId) {
+      const { archived } = archivedWorkspaceIndex();
+      let count = 0;
+      for (const sessionId of workspaceSessionIds(workspaceId)) {
+        if (archived.has(sessionId)) count += 1;
+      }
+      return count;
+    }
+
+    /**
+     * 归档会话的归属桶：工作区 id，未归组的会话算在 UNGROUPED_OWNER 这个桶里。
+     * 逐工作区显示时未归组的归档也要一起藏起来，否则它们会跟着全局 show 漏出来。
+     */
+    const UNGROUPED_OWNER = '';
+
+    function archivedHolders() {
+      const { archived, owner } = archivedWorkspaceIndex();
+      const holders = new Set();
+      for (const sessionId of archived) holders.add(owner.get(sessionId) ?? UNGROUPED_OWNER);
+      return holders;
+    }
+
+    function archivedRowsVisibleIn(workspaceId) {
+      return readViewFilter() !== 'default' && !hiddenArchivedWorkspaces.has(workspaceId);
+    }
+
+    /**
+     * 逐工作区开关：宿主只有全局筛选，所以「显示某工作区」= 全局切到 show，
+     * 再把其他所有归档归属桶（含未归组）记进隐藏集合；「隐藏」= 记进隐藏集合，
+     * 全部藏完后把全局收回 default，侧边栏恢复原样。
+     */
+    function toggleWorkspaceArchived(workspaceId) {
+      if (workspaceId === '') return;
+      const filter = readViewFilter();
+      const visible = filter !== 'default' && !hiddenArchivedWorkspaces.has(workspaceId);
+      if (visible) {
+        hiddenArchivedWorkspaces.add(workspaceId);
+      } else {
+        hiddenArchivedWorkspaces.delete(workspaceId);
+        // 从「隐藏已归档」进入逐工作区显示：只留这一个工作区，其他桶全部藏掉。
+        if (filter === 'default') {
+          for (const holder of archivedHolders()) {
+            if (holder !== workspaceId) hiddenArchivedWorkspaces.add(holder);
+          }
+        }
+      }
+      // 清掉已经没有归档会话的桶，避免隐藏集合里堆着永远不会再出现的 id。
+      const holders = archivedHolders();
+      for (const id of [...hiddenArchivedWorkspaces]) {
+        if (!holders.has(id)) hiddenArchivedWorkspaces.delete(id);
+      }
+      persistHiddenWorkspaces();
+      if (!visible) {
+        if (filter === 'default') writeViewFilter('show');
+      } else if (filter === 'show') {
+        // 有归档会话的桶全部被藏起来后，就没必要再把全局筛选停在 show。
+        if (holders.size > 0 && [...holders].every((id) => hiddenArchivedWorkspaces.has(id))) {
+          hiddenArchivedWorkspaces = new Set();
+          persistHiddenWorkspaces();
+          writeViewFilter('default');
+        }
+      }
+      scheduleArchivedRows();
+    }
+
+    const ARCHIVED_ROW_ATTR = 'data-dsrm-archived-hidden';
+
+    /**
+     * 把不需要显示的归档行藏掉。宿主在 show 模式下会把所有工作区的归档行都渲染
+     * 出来（没有逐工作区筛选），所以这里只能按 data-row-key 的会话 id 与快照
+     * 里的归属关系决定藏哪些行。行组件重渲染时会被整体替换，MutationObserver
+     * 会再次跑一遍。
+     */
+    function applyArchivedRows() {
+      if (typeof document === 'undefined' || typeof document.querySelectorAll !== 'function') return;
+      syncViewFilter();
+      const filter = readViewFilter();
+      const active = (filter === 'show' || filter === 'only') && hiddenArchivedWorkspaces.size > 0;
+      const { archived, owner } = active ? archivedWorkspaceIndex() : { archived: new Set(), owner: new Map() };
+      for (const row of document.querySelectorAll('[data-row-key^="session:"]')) {
+        const sessionId = row.getAttribute('data-row-key').slice('session:'.length);
+        const bucket = owner.get(sessionId) ?? UNGROUPED_OWNER;
+        const hide = active && archived.has(sessionId) && hiddenArchivedWorkspaces.has(bucket);
+        if (hide) {
+          if (row.style.display !== 'none') {
+            row.setAttribute(ARCHIVED_ROW_ATTR, '1');
+            row.style.display = 'none';
+          }
+        } else if (row.getAttribute(ARCHIVED_ROW_ATTR) === '1') {
+          row.removeAttribute(ARCHIVED_ROW_ATTR);
+          row.style.display = '';
+        }
+      }
+    }
+
+    /** 用户在「视图选项」里改了全局筛选：以全局选择为准，清掉逐工作区隐藏。 */
+    function syncViewFilter() {
+      const current = readViewFilter();
+      if (current === lastViewFilter) return;
+      lastViewFilter = current;
+      hiddenArchivedWorkspaces = new Set();
+      persistHiddenWorkspaces();
+    }
+
+    let archivedApplyTimer = 0;
+    let archivedObserver = null;
+
+    function scheduleArchivedRows() {
+      if (typeof setTimeout !== 'function') {
+        applyArchivedRows();
+        return;
+      }
+      if (archivedApplyTimer !== 0) return;
+      archivedApplyTimer = setTimeout(() => {
+        archivedApplyTimer = 0;
+        applyArchivedRows();
+      }, 40);
+    }
+
+    function archivedRowMutation(records) {
+      for (const record of records) {
+        for (const node of record.addedNodes) {
+          if (node.nodeType === 1 && (node.matches?.('[data-row-key]') || node.querySelector?.('[data-row-key]'))) {
+            return true;
+          }
+        }
+        for (const node of record.removedNodes) {
+          if (node.nodeType === 1 && (node.matches?.('[data-row-key]') || node.querySelector?.('[data-row-key]'))) {
+            return true;
+          }
+        }
+      }
+      return false;
+    }
+
+    function startArchivedRows() {
+      scheduleArchivedRows();
+      if (typeof MutationObserver !== 'function') return () => {};
+      if (typeof document === 'undefined' || document.body === null || document.body === undefined) return () => {};
+      archivedObserver = new MutationObserver((records) => {
+        if (archivedRowMutation(records)) scheduleArchivedRows();
+      });
+      archivedObserver.observe(document.body, { childList: true, subtree: true });
+      return () => {
+        archivedObserver?.disconnect();
+        archivedObserver = null;
+        if (archivedApplyTimer !== 0 && typeof clearTimeout === 'function') {
+          clearTimeout(archivedApplyTimer);
+          archivedApplyTimer = 0;
+        }
+        if (typeof document === 'undefined' || typeof document.querySelectorAll !== 'function') return;
+        for (const row of document.querySelectorAll(`[${ARCHIVED_ROW_ATTR}="1"]`)) {
+          row.removeAttribute(ARCHIVED_ROW_ATTR);
+          row.style.display = '';
+        }
+      };
+    }
+
+
     function workspaceSessionIds(workspaceId) {
       const snapshot = serviceOf(rootCtx, 'workspaces')?.list?.getSnapshot?.();
       const entry = Array.isArray(snapshot?.items)
@@ -2137,6 +2446,20 @@ window.__ModuleLoader__.load({
         });
       }
 
+      // 归档会话的显示开关：只有该工作区确实存在归档会话时才出现，状态用图标
+      // 与文案区分（宿主菜单项没有 checked 字段）。
+      const archivedCount = itemOn('archivedSessions') ? archivedCountOfWorkspace(workspaceId) : 0;
+      if (archivedCount > 0) {
+        const archivedVisible = archivedRowsVisibleIn(workspaceId);
+        items.push({
+          id: 'archived',
+          group: 'archived',
+          label: t(archivedVisible ? 'hideArchivedSessions' : 'showArchivedSessions'),
+          icon: { key: archivedVisible ? 'sidebar-row-menu.archive-off' : 'sidebar-row-menu.archive' },
+          run: () => toggleWorkspaceArchived(workspaceId),
+        });
+      }
+
       items.push({
         id: 'copy-path',
         group: 'copy',
@@ -2210,6 +2533,7 @@ window.__ModuleLoader__.load({
     const WORKSPACE_MENU_GROUPS = [
       { key: 'new', order: 90 },
       { key: 'tab', order: 110 },
+      { key: 'archived', order: 130 },
       { key: 'copy', order: 150 },
       { key: 'pinned', order: 210 },
       { key: 'open-with', order: 220 },
@@ -2226,6 +2550,7 @@ window.__ModuleLoader__.load({
       'open-with': 'openWith',
       copy: 'copyPath',
       tab: 'openInTab',
+      archived: 'showArchived',
       delete: 'deleteSessions',
     };
 
@@ -2248,6 +2573,8 @@ window.__ModuleLoader__.load({
           yield ctx.slots.register({ name: 'contextMenu.icon', key: 'sidebar-row-menu.new' }, IconNewChatOutlineRegular);
           yield ctx.slots.register({ name: 'contextMenu.icon', key: 'sidebar-row-menu.copy' }, IconCopyOutlineRegular);
           yield ctx.slots.register({ name: 'contextMenu.icon', key: 'sidebar-row-menu.tab' }, IconProjectAddOutlineRegular);
+          yield ctx.slots.register({ name: 'contextMenu.icon', key: 'sidebar-row-menu.archive' }, IconArchiveOutlineRegular);
+          yield ctx.slots.register({ name: 'contextMenu.icon', key: 'sidebar-row-menu.archive-off' }, IconArchiveOffOutlineRegular);
           yield ctx.slots.register({ name: 'contextMenu.icon', key: 'sidebar-row-menu.open-with' }, IconRightUpOutlineRegular);
           yield ctx.slots.register({ name: 'contextMenu.icon', key: 'sidebar-row-menu.delete' }, IconTrashOutlineRegular);
           yield ctx.slots.register({ name: 'contextMenu.icon', key: 'sidebar-row-menu.app' }, ContextMenuAppIcon);
@@ -2668,11 +2995,13 @@ window.__ModuleLoader__.load({
         ctx.effect(() => installStyles(), 'sidebar-row-menu: styles');
       }
       const stopWorkspaceMenu = registerWorkspaceContextMenu(ctx);
+      const stopArchivedRows = startArchivedRows();
       const teardown = install();
       if (ctx !== null && typeof ctx.effect === 'function') {
         ctx.effect(() => () => {
           rootCtx = null;
           stopWorkspaceMenu();
+          stopArchivedRows();
           teardown();
         }, 'sidebar-row-menu: row context menus');
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-sidebar-row-menu",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "type": "module",
   "description": "Adds open-with and cleanup entries to the DSH sidebar context menus: interleaved with the built-in workspace menu and extending the session menu at the pointer on DSH 0.2.2+, with a self-drawn workspace menu on 0.2.1.",
   "keywords": [