dsh-sidebar-row-menu 1.4.1 → 1.4.3

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 1.4.3 — 2026-11-04
+
+### Changed
+
+- **Declared the supported DSH range**: `package.json` now carries
+  `engines.dsh: ">=0.2.1-rc.5 <0.3.0-0"`. DSH refuses to install or activate the
+  plugin on a host outside that range, and the plugin market lists the range on the
+  card instead of treating the plugin as undeclared. No runtime code changed.
+
+### 中文摘要
+
+- 在 `package.json` 中声明 `engines.dsh: ">=0.2.1-rc.5 <0.3.0-0"`：范围外的 DSH 会拒绝
+  安装/激活，插件市场会显示支持版本，不再当作“未声明”。运行代码无改动。
+
+## 1.4.2 — 2026-11-03
+
+### Added
+
+- **Delete workspace and all sessions**: a new workspace row entry removes every
+  session transcript under the workspace first, then drops the workspace
+  registration. The built-in "Delete workspace" is unchanged and still keeps
+  sessions under "Ungrouped". If any session fails to delete, the workspace is kept
+  so the user can retry. Backed by a new `POST /dsh-sidebar-row-menu/workspace/delete`
+  route.
+- **Also show in the "…" menu**: every plugin right-click entry can now be added
+  individually to the row's native "…" menu (Settings → "Row menu" → "Also show in
+  the "…" menu"). Session entries mount through the existing session slot;
+  workspace entries make the plugin render the "…" menu with the official
+  Rename / Delete workspace items plus the enabled entries. All switches are off by
+  default, so the native menu is untouched until opted in.
+
+### 中文摘要
+
+- 工作区右键新增「删除工作区及所有会话」：先逐个永久删除会话日志，全部成功后再删除
+  工作区登记；任一会话失败则保留工作区便于重试。内置「删除工作区」行为不变（会话归入
+  「未分组」）。新增宿主路由 `POST /dsh-sidebar-row-menu/workspace/delete`。
+- 设置 →「行菜单」新增「同时放进「…」菜单」：可逐项把插件右键条目加进行尾「…」菜单。
+  会话条目走原生 slot；工作区开启任意一项后由插件接管「…」按钮，保留官方「重命名 /
+  删除工作区」。全部默认关闭，未开启时「…」菜单与 DSH 原样一致。
+
 ## 1.4.1 — 2026-11-03
 
 ### Added

package/README.en.md

@@ -39,7 +39,8 @@ or hardcode any built-in action.
 | Open with | A submenu of external apps (editors, terminals, file managers) sharing the session menu's catalog, pinning and toggles; hover expands it |
 | Copy workspace path | Copies the directory path |
 | Open in new tab | Only when `dsh-project-tabs` (exposing `openWorkspaceInTab`) is installed |
-| Delete workspace | Opens the official delete confirmation |
+| Delete workspace | Opens the official delete confirmation; removes only the workspace registration and leaves its sessions under "Ungrouped" |
+| Delete workspace and all sessions | Permanently deletes every session and transcript under the workspace first, then the workspace registration. If any session fails, the workspace is kept so the user can retry. The directory itself is not deleted |
 
 ### Session row
 
@@ -67,9 +68,16 @@ Both delete entries are served by this plugin's own host route. They leave
 unarchived sessions alone by default; the opt-in switch extends the single-session
 entry to them. Deletion never cascades into forked child sessions.
 
-These entries are **right-click only**: they do not mount when the "…" button opens
-the menu. A short-lived window flag is set before opening; outside that window the
-entries render `null`.
+These entries are **right-click only by default**: they do not mount when the "…"
+button opens the menu. A short-lived window flag is set before opening; outside that
+window the entries render `null`.
+
+To use them from the row's "…" button, enable them one by one under Settings →
+"Row menu" → "Also show in the "…" menu". Session entries mount into the native
+"…" menu; enabling any workspace entry makes this plugin take over the row's "…"
+button and render the official "Rename / Delete workspace" items alongside the
+enabled plugin entries. With everything off, the "…" button behaves exactly like
+DSH's own.
 
 Blank draft sessions have no native "…" menu and are left alone. Rows that are
 neither a workspace nor a session (e.g. "Show more") are not intercepted.
@@ -85,9 +93,15 @@ 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. 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
+enabled the "…" menu is exactly DSH's own.
 
 Switches live in browser `localStorage` (`dsh.sidebar-row-menu.items.v1`,
-`dsh.sidebar-row-menu.open-with.v1` and `dsh.sidebar-row-menu.open-with.pinned.v1`)
+`dsh.sidebar-row-menu.open-with.v1`, `dsh.sidebar-row-menu.open-with.pinned.v1` and
+`dsh.sidebar-row-menu.ellipsis.v1`)
 and apply immediately. Before the first explicit pin, the plugin derives one: the
 first detected editor (usually VS Code), or the first catalog app when no editor
 exists.
@@ -126,13 +140,13 @@ resolve it directly by name:
 Pin a version by appending it to the name:
 
 ```
-dsh-sidebar-row-menu@1.4.1
+dsh-sidebar-row-menu@1.4.2
 ```
 
 Equivalent command line:
 
 ```powershell
-dsh plugin --profile desktop add dsh-sidebar-row-menu@1.4.1
+dsh plugin --profile desktop add dsh-sidebar-row-menu@1.4.2
 ```
 
 ### Install from GitHub
@@ -152,13 +166,13 @@ repository is already runnable, so **no local build is required**.
 That URL tracks the latest commit on `main`. Pin a tag for a stable version:
 
 ```
-https://github.com/TLEWA/dsh-sidebar-row-menu#v1.4.1
+https://github.com/TLEWA/dsh-sidebar-row-menu#v1.4.2
 ```
 
 Or install the tarball built by Actions directly, without Git:
 
 ```
-https://github.com/TLEWA/dsh-sidebar-row-menu/releases/download/v1.4.1/dsh-sidebar-row-menu-1.4.1.tgz
+https://github.com/TLEWA/dsh-sidebar-row-menu/releases/download/v1.4.2/dsh-sidebar-row-menu-1.4.2.tgz
 ```
 
 Equivalent command line:
@@ -290,8 +304,9 @@ lib/index.js          host entry: name / inject / apply plus re-exported helpers
 lib/host/security.js  loopback request fence
 lib/host/paths.js     path validation, vscode://file encoding
 lib/host/launch.js    VS Code / Explorer launching
-lib/host/route.js     /open and /session/delete routes, HTTP status codes
+lib/host/route.js     /open, /session/delete and /workspace/delete routes, HTTP status codes
 lib/host/session-delete.js transcript verification and deletion (detach / rm / re-check)
+lib/host/workspace-delete.js workspace + all sessions deletion, workspace kept on failure
 lib/client.js         browser half: fiber lookup, slot registration, menu mount
 cordis.patch.yml      bundle patch inserting the plugin into the profile tree
 scripts/install.ps1   pnpm-free install / uninstall
@@ -387,11 +402,26 @@ the row's existing menu.
 - partial failures return `200` + `{ ok:false, deleted, failed, error }`; the dialog
   stays open and reports the counts.
 
+`POST /dsh-sidebar-row-menu/workspace/delete`, body `{ workspaceId: string }`.
+
+- same loopback / POST / 64 KB body checks; `workspaceId` must be a non-empty string;
+- reads `workspaceRegistry.get(workspaceId).sessionIds` and permanently deletes each
+  session with the flow above;
+- only when every session was deleted (including sessions that were already gone)
+  does it call `workspaceRegistry.delete()`; any failure returns `200` + `ok:false`
+  and keeps the workspace, so no orphaned "Ungrouped" sessions are left behind;
+- an unknown workspace returns `ok:true, missing:true` and is not an error.
+
 "Open with" does not touch this plugin's host: it calls DSH's built-in
 `open-in-app/apps`, `open-in-app/open` and `open-in-app/icon/<id>` directly.
 
 ## Compatibility
 
+The package declares its supported DSH range in `package.json` as
+`engines.dsh`: `>=0.2.1-rc.5 <0.3.0-0`. The DSH host uses it to refuse
+incompatible installs, and the plugin market shows it as the supported version;
+0.3 and later need re-verification before the upper bound is raised.
+
 Built against DSH client `0.2.1-rc.5` (`ProjectRowItem`, `SessionNodeItem`,
 `Menu`). If a DSH upgrade changes those row components or the menu positioning:
 

package/README.md

@@ -33,7 +33,8 @@
 | 打开方式 | 二级菜单列出宿主提供的外部应用（编辑器、终端、文件管理器）；与会话菜单共用同一套应用列表、置顶与开关设置，鼠标悬浮自动展开 |
 | 复制工作区路径 | 复制目录路径到剪贴板 |
 | 在新标签中打开 | 仅在装有 `dsh-project-tabs`（暴露 `openWorkspaceInTab`）时出现 |
-| 删除工作区 | 打开官方删除确认对话框 |
+| 删除工作区 | 打开官方删除确认对话框；只删除工作区登记，会话保留并归入「未分组」 |
+| 删除工作区及所有会话 | 先永久删除该工作区下的每个会话及其日志，全部成功后再删除工作区登记；任一会话删除失败则保留工作区，便于重试。工作区目录本身不删除 |
 
 ### 会话行右键
 
@@ -59,9 +60,13 @@
 一级菜单。两个删除入口由本插件自己的宿主路由完成，默认不会删除未归档会话；
 开启「允许删除未归档会话」后才会对普通会话开放。删除不会级联删除 fork 子会话。
 
-这些条目都是**右键专属**：点行尾「…」按钮时它们不挂载。实现上使用一个只在右键展开瞬间
+这些条目默认是**右键专属**：点行尾「…」按钮时它们不挂载。实现上使用一个只在右键展开瞬间
 有效的窗口标记，窗口外的渲染直接返回 `null`。
 
+如果想直接使用行尾「…」菜单，可以在设置 →「行菜单」→「同时放进「…」菜单」里逐个开启：
+会话条目会挂进原生「…」菜单；工作区行开启任意一项后，本插件会接管行尾「…」按钮，用同一套
+菜单展示官方「重命名 / 删除工作区」加上已开启的插件条目。全部关闭时「…」按钮保持 DSH 原样。
+
 草稿会话（还没有任何消息的空白会话）没有内置「…」菜单，本插件同样不接管。
 非工作区 / 非会话的侧边栏行（如“显示更多”）也不会被拦截。
 
@@ -76,9 +81,14 @@
 | 永久删除会话 | 关闭后会话菜单里不再出现单条删除入口 |
 | 允许删除未归档会话 | 默认关闭；开启后未归档会话的右键菜单也会出现「永久删除会话」，需先开启上一项 |
 | 删除所有已归档会话 | 关闭后不再出现批量删除入口 |
+| 同时放进「…」菜单 → 工作区 | 逐项把工作区行右键条目加进行尾「…」菜单：新会话、打开方式、复制工作区路径、在新标签中打开、删除工作区及所有会话。开启任意一项后「…」按钮改由本插件渲染 |
+| 同时放进「…」菜单 → 会话 | 逐项把会话行右键条目加进原生「…」菜单：打开方式、永久删除会话、删除所有已归档会话 |
+
+「同时放进「…」菜单」下的开关默认全部关闭，`…` 菜单在未开启时与 DSH 完全一致。
 
 开关存在浏览器 `localStorage`（`dsh.sidebar-row-menu.items.v1`、
-`dsh.sidebar-row-menu.open-with.v1` 与 `dsh.sidebar-row-menu.open-with.pinned.v1`），
+`dsh.sidebar-row-menu.open-with.v1`、`dsh.sidebar-row-menu.open-with.pinned.v1` 与
+`dsh.sidebar-row-menu.ellipsis.v1`），
 改完立即生效，不需要重启。置顶项在第一次配置前是自动推导的：优先置顶检测到的第一个
 编辑器（通常是 VS Code），没有编辑器时置顶应用列表里的第一个。
 
@@ -113,13 +123,13 @@
 要固定版本，在包名后加版本号：
 
 ```
-dsh-sidebar-row-menu@1.4.1
+dsh-sidebar-row-menu@1.4.2
 ```
 
 命令行等价写法：
 
 ```powershell
-dsh plugin --profile desktop add dsh-sidebar-row-menu@1.4.1
+dsh plugin --profile desktop add dsh-sidebar-row-menu@1.4.2
 ```
 
 ### 从 GitHub 安装
@@ -139,13 +149,13 @@ DSH 桌面端通过 pnpm 安装 Git 依赖；本仓库的 `lib/` 已是可直接
 该地址跟随 `main` 的最新提交。要固定版本，在地址后加标签：
 
 ```
-https://github.com/TLEWA/dsh-sidebar-row-menu#v1.4.1
+https://github.com/TLEWA/dsh-sidebar-row-menu#v1.4.2
 ```
 
 也可以直接安装 Actions 打出的压缩包（不经过 Git）：
 
 ```
-https://github.com/TLEWA/dsh-sidebar-row-menu/releases/download/v1.4.1/dsh-sidebar-row-menu-1.4.1.tgz
+https://github.com/TLEWA/dsh-sidebar-row-menu/releases/download/v1.4.2/dsh-sidebar-row-menu-1.4.2.tgz
 ```
 
 命令行等价写法：
@@ -260,8 +270,9 @@ lib/index.js          宿主入口：name / inject / apply，再导出可测试
 lib/host/security.js  loopback 请求围栏
 lib/host/paths.js     路径校验、vscode://file 编码
 lib/host/launch.js    VS Code / 资源管理器启动
-lib/host/route.js     /open 与 /session/delete 路由、HTTP 状态码
+lib/host/route.js     /open、/session/delete 与 /workspace/delete 路由、HTTP 状态码
 lib/host/session-delete.js 会话日志目录的校验与删除（detach / rm / 复查）
+lib/host/workspace-delete.js 删除工作区及其所有会话；会话失败时保留工作区
 lib/client.js         客户端半边：fiber 解析、slot 注册、菜单挂载
 cordis.patch.yml      bundle patch：把插件插进 profile 插件树
 scripts/install.ps1   无 pnpm 的安装 / 卸载脚本
@@ -341,11 +352,23 @@ test/*.test.mjs       node:test
   `api-session/removed`；
 - 部分失败返回 `200` + `{ ok:false, deleted, failed, error }`，前端保留对话框并显示计数。
 
+`POST /dsh-sidebar-row-menu/workspace/delete`，body `{ workspaceId: string }`。
+
+- 同样的 loopback / POST / 64 KB body 校验；`workspaceId` 必须是非空字符串；
+- 先读取 `workspaceRegistry.get(workspaceId).sessionIds`，用上面的会话删除流程逐个永久删除；
+- 只有全部会话删除成功（包括本来就不存在的会话）才调用 `workspaceRegistry.delete()`；
+  任一会话失败返回 `200` + `ok:false` 并保留工作区，避免留下无人管理的「未分组」会话；
+- 未知工作区返回 `ok:true, missing:true`，不视为错误。
+
 「打开方式」不经过本插件宿主：直接调用 DSH 内置的 `open-in-app/apps`、
 `open-in-app/open`、`open-in-app/icon/<id>`。
 
 ## 兼容性
 
+本包在 `package.json` 的 `engines.dsh` 中声明支持范围：`>=0.2.1-rc.5 <0.3.0-0`。
+DSH 宿主按该范围拒绝安装不兼容的宿主，插件市场也按它显示支持版本；0.3 起需要重新验证后
+再放宽上限。
+
 按 DSH 客户端 `0.2.1-rc.5` 的 `ProjectRowItem` / `SessionNodeItem` / `Menu` 实现。
 DSH 升级若改动行组件或菜单定位实现：
 

package/lib/client.js

@@ -90,6 +90,8 @@ window.__ModuleLoader__.load({
     }
     /** 永久删除会话的宿主端点；是否对未归档会话开放由本地开关决定。 */
     const DELETE_ENDPOINT = '/dsh-sidebar-row-menu/session/delete';
+    /** 删除「工作区 + 其下全部会话」的宿主端点。 */
+    const WORKSPACE_DELETE_ENDPOINT = '/dsh-sidebar-row-menu/workspace/delete';
     /** 官方 open-in-app 的三条路由；用文档相对路径让浏览器自带认证。 */
     const APPS_ROUTE = 'open-in-app/apps';
     const OPEN_ROUTE = 'open-in-app/open';
@@ -115,6 +117,22 @@ window.__ModuleLoader__.load({
       deleteUnarchived: false,
     };
     const ITEM_KEYS = Object.keys(ITEM_DEFAULTS);
+    /**
+     * 「右键专属条目是否也放进行尾…菜单」的逐项开关。
+     * 全部默认关闭：不勾选时点「…」看到的仍是 DSH 原生菜单。
+     */
+    const ELLIPSIS_KEY = 'dsh.sidebar-row-menu.ellipsis.v1';
+    const ELLIPSIS_DEFAULTS = {
+      newSession: false,
+      openWith: false,
+      copyPath: false,
+      openInTab: false,
+      deleteSessions: false,
+      sessionOpenWith: false,
+      sessionDelete: false,
+      sessionDeleteArchived: false,
+    };
+    const ELLIPSIS_KEYS = Object.keys(ELLIPSIS_DEFAULTS);
     /**
      * dsh-session-menu 注册的同一能力条目 id。检测到对方存在时，本插件对应项
      * 自动隐藏，避免同一份菜单里出现两条一模一样的动作。
@@ -135,6 +153,7 @@ window.__ModuleLoader__.load({
       copyPath: '复制工作区路径',
       openInTab: '在新标签中打开',
       deleteWorkspace: '删除工作区',
+      deleteWorkspaceSessions: '删除工作区及所有会话',
       copied: '已复制',
       copyFailed: '复制失败，请重试',
       noPath: '没有可用的目录路径',
@@ -166,6 +185,26 @@ window.__ModuleLoader__.load({
       'settings.appsAllOff': '所有应用都被二级开关隐藏了',
       'settings.expand': '展开应用列表',
       'settings.collapse': '收起应用列表',
+      'settings.ellipsisTitle': '同时放进「…」菜单',
+      'settings.ellipsisHint': '勾选后，对应条目会额外出现在行尾「…」按钮的菜单里，并沿用上面的单项开关；不勾选则只在右键菜单出现。',
+      'settings.ellipsisWorkspace': '工作区行',
+      'settings.ellipsisSession': '会话行',
+      'settings.ellipsis.newSession.label': '新建会话',
+      'settings.ellipsis.newSession.hint': '在「…」菜单里直接新建该工作区的会话。',
+      'settings.ellipsis.openWith.label': '打开方式',
+      'settings.ellipsis.openWith.hint': '在「…」菜单里用外部应用打开工作区或会话目录。',
+      'settings.ellipsis.copyPath.label': '拷贝工作区路径',
+      'settings.ellipsis.copyPath.hint': '在「…」菜单里复制工作区目录路径。',
+      'settings.ellipsis.openInTab.label': '在新标签页打开',
+      'settings.ellipsis.openInTab.hint': '在「…」菜单里把工作区作为标签页打开。',
+      'settings.ellipsis.deleteSessions.label': '删除工作区及所有会话',
+      'settings.ellipsis.deleteSessions.hint': '在「…」菜单里同时清掉工作区记录和它下面的全部会话。',
+      'settings.ellipsis.sessionOpenWith.label': '打开方式',
+      'settings.ellipsis.sessionOpenWith.hint': '在「…」菜单里用外部应用打开会话目录。',
+      'settings.ellipsis.sessionDelete.label': '永久删除会话',
+      'settings.ellipsis.sessionDelete.hint': '在「…」菜单里永久删除这一个会话及其日志。',
+      'settings.ellipsis.sessionDeleteArchived.label': '删除所有已归档会话',
+      'settings.ellipsis.sessionDeleteArchived.hint': '在已归档会话的「…」菜单里一次清理全部归档会话。',
       'delete.title': '永久删除会话？',
       'delete.description': '会话「{name}」的日志将从磁盘永久删除，此操作无法撤销。',
       'delete.archivedTitle': '删除所有已归档会话？',
@@ -180,6 +219,14 @@ window.__ModuleLoader__.load({
       'delete.unavailable': '删除服务不可用',
       'delete.done': '已删除会话',
       'delete.doneMany': '已删除 {n} 个会话',
+      'delete.workspaceTitle': '删除工作区及所有会话？',
+      'delete.workspaceDescription': '工作区「{name}」及其下 {n} 个会话的日志将被永久删除，目录本身保留。此操作无法撤销。',
+      'delete.workspaceEmptyDescription': '工作区「{name}」下没有会话，将只删除工作区记录。',
+      'delete.workspaceConfirm': '全部删除',
+      'delete.workspacePending': '正在删除工作区及会话…',
+      'delete.workspacePartial': '已删除 {done} 个会话，失败 {failed} 个；工作区已保留。',
+      'delete.workspaceDone': '已删除工作区及 {n} 个会话',
+      'delete.workspaceEmptyDone': '已删除工作区',
     };
     const en = {
       newSession: 'New session',
@@ -189,6 +236,7 @@ window.__ModuleLoader__.load({
       copyPath: 'Copy workspace path',
       openInTab: 'Open in new tab',
       deleteWorkspace: 'Delete workspace',
+      deleteWorkspaceSessions: 'Delete workspace and all sessions',
       copied: 'Copied',
       copyFailed: 'Copy failed, please retry',
       noPath: 'No usable directory path',
@@ -220,6 +268,26 @@ window.__ModuleLoader__.load({
       'settings.appsAllOff': 'Every application is hidden by the switches above',
       'settings.expand': 'Show applications',
       'settings.collapse': 'Hide applications',
+      'settings.ellipsisTitle': 'Also show in the "…" menu',
+      'settings.ellipsisHint': 'Checked entries also appear in the row\'s "…" button menu, still subject to the switches above. Unchecked entries stay right-click only.',
+      'settings.ellipsisWorkspace': 'Workspace rows',
+      '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.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',
+      'settings.ellipsis.copyPath.hint': 'Copy the workspace directory path from the "…" menu.',
+      'settings.ellipsis.openInTab.label': 'Open in new tab',
+      'settings.ellipsis.openInTab.hint': 'Open the workspace as a tab from the "…" menu.',
+      'settings.ellipsis.deleteSessions.label': 'Delete workspace and all sessions',
+      'settings.ellipsis.deleteSessions.hint': 'Remove the workspace record and every session under it from the "…" menu.',
+      'settings.ellipsis.sessionOpenWith.label': 'Open with',
+      'settings.ellipsis.sessionOpenWith.hint': 'Open the session directory with an external app from the "…" menu.',
+      'settings.ellipsis.sessionDelete.label': 'Delete session permanently',
+      'settings.ellipsis.sessionDelete.hint': 'Permanently delete this session and its log from the "…" menu.',
+      'settings.ellipsis.sessionDeleteArchived.label': 'Delete all archived sessions',
+      'settings.ellipsis.sessionDeleteArchived.hint': 'Clean up every archived session from an archived row\'s "…" menu.',
       'delete.title': 'Delete this session permanently?',
       'delete.description': 'The log of "{name}" will be removed from disk. This cannot be undone.',
       'delete.archivedTitle': 'Delete all archived sessions?',
@@ -234,6 +302,14 @@ window.__ModuleLoader__.load({
       'delete.unavailable': 'The delete service is unavailable',
       'delete.done': 'Session deleted',
       'delete.doneMany': 'Deleted {n} sessions',
+      'delete.workspaceTitle': 'Delete the workspace and all its sessions?',
+      'delete.workspaceDescription': 'The workspace "{name}" and the logs of its {n} sessions will be permanently deleted; the directory itself is kept. This cannot be undone.',
+      'delete.workspaceEmptyDescription': 'The workspace "{name}" has no sessions; only the workspace record will be deleted.',
+      'delete.workspaceConfirm': 'Delete all',
+      'delete.workspacePending': 'Deleting the workspace and sessions…',
+      'delete.workspacePartial': 'Deleted {done} sessions, failed {failed}; the workspace was kept.',
+      'delete.workspaceDone': 'Deleted the workspace and {n} sessions',
+      'delete.workspaceEmptyDone': 'Workspace deleted',
     };
 
     /** 官方 open-in-app 的应用 id → 显示名。官方 locale 没有这张表。 */
@@ -355,6 +431,8 @@ window.__ModuleLoader__.load({
     /** 当前挂着的菜单宿主与 React root。 */
     let menuHost = null;
     let menuRoot = null;
+    /** 当前「…」菜单锚定的按钮；用来判断再次点击是否应收起。 */
+    let ellipsisTrigger = null;
     /** 客户端根上下文（apply 时记下，右键时用来取服务 / 文案）。 */
     let rootCtx = null;
 
@@ -375,6 +453,7 @@ window.__ModuleLoader__.load({
       const root = menuRoot;
       menuHost = null;
       menuRoot = null;
+      ellipsisTrigger = null;
       unmountAt(host, root);
     }
 
@@ -559,6 +638,76 @@ window.__ModuleLoader__.load({
       return itemSettings[key] ?? ITEM_DEFAULTS[key] ?? false;
     }
 
+    /* -------------------------------- 「…」菜单附加开关（localStorage） */
+
+    function readStoredEllipsis() {
+      const defaults = { ...ELLIPSIS_DEFAULTS };
+      try {
+        const raw = globalThis.localStorage?.getItem(ELLIPSIS_KEY);
+        if (typeof raw !== 'string' || raw === '') return defaults;
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed !== 'object') return defaults;
+        for (const key of ELLIPSIS_KEYS) {
+          if (typeof parsed[key] === 'boolean') defaults[key] = parsed[key];
+        }
+      } catch {
+        /* 坏数据回退默认 */
+      }
+      return defaults;
+    }
+
+    let ellipsisSettings = readStoredEllipsis();
+    const ellipsisListeners = new Set();
+
+    function publishEllipsis() {
+      for (const listener of ellipsisListeners) {
+        try {
+          listener();
+        } catch {
+          /* ignore */
+        }
+      }
+    }
+
+    function subscribeEllipsis(listener) {
+      ellipsisListeners.add(listener);
+      return () => {
+        ellipsisListeners.delete(listener);
+      };
+    }
+
+    function ellipsisSnapshot() {
+      return ellipsisSettings;
+    }
+
+    function useEllipsis() {
+      return useSyncExternalStore(subscribeEllipsis, ellipsisSnapshot, ellipsisSnapshot);
+    }
+
+    function setEllipsis(key, enabled) {
+      if (!ELLIPSIS_KEYS.includes(key)) return;
+      ellipsisSettings = { ...ellipsisSettings, [key]: enabled === true };
+      try {
+        globalThis.localStorage?.setItem(ELLIPSIS_KEY, JSON.stringify(ellipsisSettings));
+      } catch {
+        /* 隐私模式写不进去也照样生效到本次会话 */
+      }
+      publishEllipsis();
+    }
+
+    function ellipsisOn(key) {
+      return ellipsisSettings[key] === true;
+    }
+
+    /** 工作区行是否至少有一项要在「…」菜单里显示（否则完全不接管原生菜单）。 */
+    function workspaceEllipsisOn() {
+      return ellipsisSettings.newSession === true
+        || ellipsisSettings.openWith === true
+        || ellipsisSettings.copyPath === true
+        || ellipsisSettings.openInTab === true
+        || ellipsisSettings.deleteSessions === true;
+    }
+
     /* ------------------------------------- 打开方式：应用列表与二级开关 */
 
     function readStoredChildren() {
@@ -902,6 +1051,20 @@ window.__ModuleLoader__.load({
         .catch(() => ({ ok: false, deleted: 0, failed: ids.length, error: 'network' }));
     }
 
+    function postWorkspaceDelete(workspaceId) {
+      if (typeof fetch !== 'function') return Promise.resolve({ ok: false, deleted: 0, failed: 0, error: 'network' });
+      return fetch(WORKSPACE_DELETE_ENDPOINT, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ workspaceId }),
+      })
+        .then((response) => response.json().catch(() => null)
+          .then((payload) => (payload !== null && typeof payload === 'object'
+            ? payload
+            : { ok: false, deleted: 0, failed: 0, error: `HTTP ${response.status}` })))
+        .catch(() => ({ ok: false, deleted: 0, failed: 0, error: 'network' }));
+    }
+
     /** shell.overlay 上的对话框宿主；没有请求时什么都不渲染。 */
     function DeleteDialog({ t }) {
       const request = useDeleteRequest();
@@ -913,8 +1076,11 @@ window.__ModuleLoader__.load({
       const [busy, setBusy] = useState(false);
       const [error, setError] = useState(null);
       const [partial, setPartial] = useState(null);
+      const workspace = request.mode === 'workspace';
       const bulk = request.mode === 'archived';
-      const ids = bulk ? request.sessionIds : [request.sessionId];
+      const ids = workspace
+        ? (Array.isArray(request.sessionIds) ? request.sessionIds : [])
+        : bulk ? request.sessionIds : [request.sessionId];
       const close = () => {
         if (!busy) closeDelete();
       };
@@ -926,11 +1092,29 @@ window.__ModuleLoader__.load({
         const wasMain = ids.some((id) => isMainSession(id));
         void (async () => {
           try {
-            const result = await postDelete(ids);
+            const result = workspace
+              ? await postWorkspaceDelete(request.workspaceId)
+              : await postDelete(ids);
             if (result.ok !== true && (result.deleted ?? 0) === 0) {
               const reason = typeof result.error === 'string' && result.error !== '' ? result.error : t('delete.unavailable');
               throw new Error(reason);
             }
+            if (workspace) {
+              // 会话删除有失败时 host 会保留工作区，让用户重试；成功才关框。
+              if (result.ok !== true) {
+                setPartial({ done: result.deleted ?? 0, failed: result.failed ?? 0, workspace: true });
+                return;
+              }
+              if (wasMain) serviceOf(rootCtx, 'uiWorkspace')?.clearMain?.();
+              closeDelete();
+              toast(
+                (result.deleted ?? 0) > 0
+                  ? t('delete.workspaceDone', { n: result.deleted ?? 0 })
+                  : t('delete.workspaceEmptyDone'),
+                'success',
+              );
+              return;
+            }
             if (wasMain) serviceOf(rootCtx, 'uiWorkspace')?.clearMain?.();
             if ((result.failed ?? 0) > 0) {
               setPartial({ done: result.deleted ?? 0, failed: result.failed });
@@ -949,24 +1133,34 @@ window.__ModuleLoader__.load({
         open: true,
         onClose: close,
         closeLabel: t('delete.cancel'),
-        title: bulk ? t('delete.archivedTitle') : t('delete.title'),
-        description: bulk
-          ? t('delete.archivedDescription', { n: ids.length })
-          : t('delete.description', { name: request.displayTitle ?? '' }),
+        title: workspace ? t('delete.workspaceTitle') : bulk ? t('delete.archivedTitle') : t('delete.title'),
+        description: workspace
+          ? (ids.length > 0
+            ? t('delete.workspaceDescription', { name: request.displayTitle ?? '', n: ids.length })
+            : t('delete.workspaceEmptyDescription', { name: request.displayTitle ?? '' }))
+          : bulk
+            ? t('delete.archivedDescription', { n: ids.length })
+            : t('delete.description', { name: request.displayTitle ?? '' }),
         footer: h(Fragment, null,
           jsx(Button, { variant: 'outline', disabled: busy, onClick: close, children: t('delete.cancel') }),
           jsx(Button, {
             variant: 'outline',
             disabled: busy,
             onClick: confirm,
-            children: h('span', { className: 'dsrm-danger-label' }, bulk ? t('delete.archivedConfirm') : t('delete.confirm')),
+            children: h('span', { className: 'dsrm-danger-label' }, workspace
+              ? t('delete.workspaceConfirm')
+              : bulk ? t('delete.archivedConfirm') : t('delete.confirm')),
           })),
         children: [
           busy
-            ? h('div', { className: 'dsrm-status-text', role: 'status', key: 'busy' }, bulk ? t('delete.archivedPending') : t('delete.pending'))
+            ? h('div', { className: 'dsrm-status-text', role: 'status', key: 'busy' }, workspace
+              ? t('delete.workspacePending')
+              : bulk ? t('delete.archivedPending') : t('delete.pending'))
             : null,
           partial !== null
-            ? h('div', { className: 'dsrm-status-text', role: 'status', key: 'partial' }, t('delete.archivedPartial', { done: partial.done, failed: partial.failed }))
+            ? h('div', { className: 'dsrm-status-text', role: 'status', key: 'partial' }, partial.workspace
+              ? t('delete.workspacePartial', { done: partial.done, failed: partial.failed })
+              : t('delete.archivedPartial', { done: partial.done, failed: partial.failed }))
             : null,
           error !== null
             ? h('div', { className: 'dsrm-error-text', role: 'alert', key: 'error' }, t('delete.failed', { message: error }))
@@ -1165,7 +1359,9 @@ window.__ModuleLoader__.load({
      * 且和 dsh-session-menu 的同名能力二选一。
      */
     function SessionOpenWithMenuItem({ sessionId, useMenuOpenState, t }) {
-      const visible = useRightClickEntry();
+      const rightClick = useRightClickEntry();
+      const ellipsis = useEllipsis();
+      const visible = rightClick || ellipsis.sessionOpenWith === true;
       const items = useItems();
       const apps = useApps();
       const setMenuOpen = menuCloser(useMenuOpenState);
@@ -1186,7 +1382,9 @@ window.__ModuleLoader__.load({
      * 放进一级菜单，用户也可以在设置里改。置顶项不再重复出现在「打开方式」里。
      */
     function SessionOpenWithPinnedMenuItem({ sessionId, useMenuOpenState, t }) {
-      const visible = useRightClickEntry();
+      const rightClick = useRightClickEntry();
+      const ellipsis = useEllipsis();
+      const visible = rightClick || ellipsis.sessionOpenWith === true;
       const items = useItems();
       useChildren();
       const apps = useApps();
@@ -1223,7 +1421,9 @@ window.__ModuleLoader__.load({
      * 打开「允许删除未归档会话」。和 dsh-session-menu 的同名功能二选一。
      */
     function SessionDeleteMenuItem({ sessionId, displayTitle, useMenuOpenState, t }) {
-      const visible = useRightClickEntry();
+      const rightClick = useRightClickEntry();
+      const ellipsis = useEllipsis();
+      const visible = rightClick || ellipsis.sessionDelete === true;
       const items = useItems();
       const archived = useArchivedIds();
       const setMenuOpen = menuCloser(useMenuOpenState);
@@ -1246,7 +1446,9 @@ window.__ModuleLoader__.load({
      * 和 dsh-session-menu 的同名功能二选一。displayTitle 用作确认文案。
      */
     function SessionDeleteArchivedMenuItem({ sessionId, displayTitle, useMenuOpenState, t }) {
-      const visible = useRightClickEntry();
+      const rightClick = useRightClickEntry();
+      const ellipsis = useEllipsis();
+      const visible = rightClick || ellipsis.sessionDeleteArchived === true;
       const items = useItems();
       const archived = useArchivedIds();
       const setMenuOpen = menuCloser(useMenuOpenState);
@@ -1275,8 +1477,25 @@ window.__ModuleLoader__.load({
       ['deleteArchived', 'settings.deleteArchived.label', 'settings.deleteArchived.hint'],
     ];
 
+    /** 「…」菜单附加开关；按行分组，避免用户分不清工作区项和会话项。 */
+    const ELLIPSIS_ROWS = [
+      ['workspace', 'settings.ellipsisWorkspace', [
+        ['newSession', 'settings.ellipsis.newSession.label', 'settings.ellipsis.newSession.hint'],
+        ['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'],
+        ['deleteSessions', 'settings.ellipsis.deleteSessions.label', 'settings.ellipsis.deleteSessions.hint'],
+      ]],
+      ['session', 'settings.ellipsisSession', [
+        ['sessionOpenWith', 'settings.ellipsis.sessionOpenWith.label', 'settings.ellipsis.sessionOpenWith.hint'],
+        ['sessionDelete', 'settings.ellipsis.sessionDelete.label', 'settings.ellipsis.sessionDelete.hint'],
+        ['sessionDeleteArchived', 'settings.ellipsis.sessionDeleteArchived.label', 'settings.ellipsis.sessionDeleteArchived.hint'],
+      ]],
+    ];
+
     function SettingsSection({ t }) {
       const items = useItems();
+      const ellipsis = useEllipsis();
       const children = useChildren();
       const apps = useApps();
       usePinned();
@@ -1359,10 +1578,36 @@ window.__ModuleLoader__.load({
         return key === 'openWith' && childRows ? [row, childRows] : [row];
       });
 
+      const ellipsisGroups = ELLIPSIS_ROWS.map(([groupKey, titleKey, rows]) => h('div', {
+        className: 'dsrm-settings-group',
+        key: groupKey,
+      },
+        h('div', { className: 'dsrm-settings-group-title' }, t(titleKey)),
+        h('div', { className: 'dsrm-settings-list' }, rows.map(([key, labelKey, hintKey]) => h('div', {
+          className: 'dsrm-settings-row',
+          key,
+        },
+          h('div', { className: 'dsrm-settings-copy' },
+            h('div', { className: 'dsrm-settings-label' }, t(labelKey)),
+            h('div', { className: 'dsrm-settings-hint' }, t(hintKey)),
+          ),
+          h('div', { className: 'dsrm-settings-controls' },
+            jsx(Switch, {
+              checked: ellipsis[key] === true,
+              label: t(labelKey),
+              onChange: (next) => setEllipsis(key, next),
+            }),
+          ),
+        ))),
+      ));
+
       return h('div', { className: 'dsrm-settings' },
         h('h2', { className: 'dsrm-settings-title' }, t('settings.title')),
         anyConflict ? h('div', { className: 'dsrm-settings-note' }, t('settings.conflictNote')) : null,
         h('div', { className: 'dsrm-settings-list' }, rows),
+        h('h2', { className: 'dsrm-settings-title dsrm-settings-subtitle' }, t('settings.ellipsisTitle')),
+        h('div', { className: 'dsrm-settings-note' }, t('settings.ellipsisHint')),
+        h('div', { className: 'dsrm-settings-groups' }, ellipsisGroups),
       );
     }
 
@@ -1372,16 +1617,20 @@ window.__ModuleLoader__.load({
      * 工作区行右键菜单。官方 Menu 的 items 只认单层条目，不支持子菜单，
      * 所以这里自绘 panel；普通行仍用 MenuItemButton，分隔线与菜单外观和官方一致。
      */
-    function WorkspaceRowMenu({ x, y, props, onClose }) {
+    function WorkspaceRowMenu({ x, y, props, onClose, mode = 'context' }) {
       const t = localeOf(rootCtx);
       const items = useItems();
+      const ellipsis = useEllipsis();
       const apps = useApps();
       usePinned();
       useChildren();
       const hostRef = useRef(null);
       const [pos, setPos] = useState(null);
 
-      const openWithOn = items.openWith !== false;
+      const ellipsisMode = mode === 'ellipsis';
+      /** 右键菜单永远显示；「…」菜单只在对应开关打开时显示（内置项除外）。 */
+      const show = (key) => !ellipsisMode || ellipsis[key] === true;
+      const openWithOn = items.openWith !== false && show('openWith');
 
       useEffect(() => {
         if (openWithOn) ensureApps();
@@ -1431,6 +1680,26 @@ window.__ModuleLoader__.load({
         });
       };
 
+      const requestWorkspaceDelete = () => {
+        if (workspaceId === '') {
+          toast(t('actionFailed'));
+          return;
+        }
+        const snapshot = serviceOf(rootCtx, 'workspaces')?.list?.getSnapshot?.();
+        const entry = Array.isArray(snapshot?.items)
+          ? snapshot.items.find((candidate) => candidate?.workspaceId === workspaceId)
+          : undefined;
+        const sessionIds = Array.isArray(entry?.sessionIds)
+          ? entry.sessionIds.filter((id) => typeof id === 'string' && id !== '')
+          : [];
+        const title = typeof group.label === 'string' && group.label !== ''
+          ? group.label
+          : typeof group.title === 'string' && group.title !== ''
+            ? group.title
+            : cwd;
+        requestDelete({ mode: 'workspace', workspaceId, sessionIds, displayTitle: title });
+      };
+
       const run = (id) => {
         if (id === 'new-session') {
           try {
@@ -1456,6 +1725,10 @@ window.__ModuleLoader__.load({
           }
           return;
         }
+        if (id === 'delete-sessions') {
+          requestWorkspaceDelete();
+          return;
+        }
         if (id === 'tab') {
           Promise.resolve().then(() => tabs.openWorkspaceInTab(workspaceId)).catch((reason) => {
             console.warn('[dsh-sidebar-row-menu] open in tab failed:', reason);
@@ -1473,7 +1746,7 @@ window.__ModuleLoader__.load({
       };
 
       const rows = [];
-      if (typeof props.onCreate === 'function') {
+      if (typeof props.onCreate === 'function' && show('newSession')) {
         rows.push(jsx(MenuItemButton, {
           key: 'new-session',
           onSelect: () => {
@@ -1515,17 +1788,19 @@ window.__ModuleLoader__.load({
         }));
       }
 
-      rows.push(jsx(MenuItemButton, {
-        key: 'copy-path',
-        separatorBefore: !openWithOn,
-        onSelect: () => {
-          onClose();
-          run('copy-path');
-        },
-        icon: jsx(IconCopyOutlineRegular, { size: 14 }),
-        children: t('copyPath'),
-      }));
-      if (canOpenInTab) {
+      if (show('copyPath')) {
+        rows.push(jsx(MenuItemButton, {
+          key: 'copy-path',
+          separatorBefore: !openWithOn,
+          onSelect: () => {
+            onClose();
+            run('copy-path');
+          },
+          icon: jsx(IconCopyOutlineRegular, { size: 14 }),
+          children: t('copyPath'),
+        }));
+      }
+      if (canOpenInTab && show('openInTab')) {
         rows.push(jsx(MenuItemButton, {
           key: 'tab',
           onSelect: () => {
@@ -1547,6 +1822,18 @@ window.__ModuleLoader__.load({
         icon: jsx(IconTrashOutlineRegular, {}),
         children: t('deleteWorkspace'),
       }));
+      if (show('deleteSessions')) {
+        rows.push(jsx(MenuItemButton, {
+          key: 'delete-sessions',
+          danger: true,
+          onSelect: () => {
+            onClose();
+            run('delete-sessions');
+          },
+          icon: jsx(IconTrashOutlineRegular, {}),
+          children: t('deleteWorkspaceSessions'),
+        }));
+      }
 
       return h('div', {
         className: 'dsrm-menu',
@@ -1559,8 +1846,8 @@ window.__ModuleLoader__.load({
       }, h(MenuSurface, { role: 'group', className: 'dsrm-menu-surface' }, rows));
     }
 
-    /** 在 (x, y) 处挂出工作区菜单。 */
-    function showWorkspaceMenu(props, x, y) {
+    /** 在 (x, y) 处挂出工作区菜单。mode='ellipsis' 表示从行尾「…」按钮打开。 */
+    function showWorkspaceMenu(props, x, y, mode = 'context') {
       closeMenu();
       menuHost = document.createElement('div');
       menuHost.setAttribute(MENU_ATTR, '1');
@@ -1571,6 +1858,7 @@ window.__ModuleLoader__.load({
         x,
         y,
         props,
+        mode,
         onClose: () => closeMenu(),
       }));
     }
@@ -1585,9 +1873,44 @@ window.__ModuleLoader__.load({
     }
 
     /** 工作区行右键菜单（没有 slot 可复用，只能自己组）。 */
-    function openWorkspaceMenu(props, x, y) {
+    function openWorkspaceMenu(props, x, y, mode = 'context') {
       if (rootCtx === null) return;
-      showWorkspaceMenu(props, x, y);
+      showWorkspaceMenu(props, x, y, mode);
+    }
+
+    /**
+     * 行尾「…」按钮已经展开内置菜单时，用同一个按钮位置改挂本插件菜单。
+     * 只在用户为工作区行开启了至少一个「…」附加项时接管；否则原生菜单原样工作。
+     */
+    function onWorkspaceEllipsisClick(event) {
+      if (event.defaultPrevented || event.button !== 0) return;
+      if (event.target === null || event.target === undefined) return;
+      if (rootCtx === null || !workspaceEllipsisOn()) return;
+      const target = event.target;
+      if (typeof target.closest !== 'function') return;
+      const row = target.closest('[data-row-key]');
+      if (row === null) return;
+      const rowKey = row.getAttribute('data-row-key') ?? '';
+      if (!rowKey.startsWith('workspace:')) return;
+      const button = target.closest('button');
+      if (button === null || !row.contains(button)) return;
+      // 只接管行内第一个按钮（「…」）；新建会话按钮带快捷键标记，直接放行。
+      const buttons = row.querySelectorAll('button');
+      if (buttons.length === 0 || buttons[0] !== button) return;
+      if (button.getAttribute('aria-keyshortcuts') !== null) return;
+      const props = resolveWorkspaceRow(target);
+      if (props === null) return;
+      event.preventDefault();
+      event.stopPropagation();
+      event.stopImmediatePropagation?.();
+      // 再点一次「…」视为收起当前菜单。
+      if (menuHost !== null && ellipsisTrigger === button) {
+        closeMenu();
+        return;
+      }
+      const rect = button.getBoundingClientRect();
+      openWorkspaceMenu(props, rect.left + rect.width, rect.bottom + 4, 'ellipsis');
+      ellipsisTrigger = button;
     }
 
     /* ------------------------------------------------ 会话菜单的插件条目 */
@@ -1858,6 +2181,9 @@ window.__ModuleLoader__.load({
 .dsrm-app-icon{width:14px;height:14px;border-radius:3px;display:block;object-fit:contain}
 .dsrm-settings{max-width:820px;margin:0 auto;padding:2px 0 36px}
 .dsrm-settings-title{margin:0;font-size:16px;line-height:24px;font-weight:600}
+.dsrm-settings-subtitle{margin-top:28px}
+.dsrm-settings-groups{margin-top:10px;display:flex;flex-direction:column;gap:18px}
+.dsrm-settings-group-title{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px;font-weight:600;margin-bottom:2px}
 .dsrm-settings-note{margin-top:8px;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}
 .dsrm-settings-list{margin-top:10px;display:flex;flex-direction:column}
 .dsrm-settings-row{display:flex;align-items:center;justify-content:space-between;gap:24px;padding:14px 0;border-top:.5px solid var(--dsw-alias-border-l2)}
@@ -1932,9 +2258,11 @@ window.__ModuleLoader__.load({
 
     function install() {
       window.addEventListener('contextmenu', onContextMenu, true);
+      document.addEventListener('click', onWorkspaceEllipsisClick, true);
       console.info('[dsh-sidebar-row-menu] installed');
       return () => {
         window.removeEventListener('contextmenu', onContextMenu, true);
+        document.removeEventListener('click', onWorkspaceEllipsisClick, true);
         closeMenu();
         closeToast();
       };

package/lib/host/route.js

@@ -1,20 +1,23 @@
 /**
- * HTTP 边界：/open 与 /session/delete。
+ * HTTP 边界：/open、/session/delete 与 /workspace/delete。
  *
- * 浏览器端不能自己打开系统应用，也不该直接碰会话日志，所以这两件事都放在 host：
- *   POST /dsh-sidebar-row-menu/open            打开目录（VS Code / 资源管理器）
- *   POST /dsh-sidebar-row-menu/session/delete  永久删除会话（归档范围由 UI 把关）
+ * 浏览器端不能自己打开系统应用，也不该直接碰会话日志，所以这几件事都放在 host：
+ *   POST /dsh-sidebar-row-menu/open             打开目录（VS Code / 资源管理器）
+ *   POST /dsh-sidebar-row-menu/session/delete   永久删除会话（归档范围由 UI 把关）
+ *   POST /dsh-sidebar-row-menu/workspace/delete 永久删除工作区及其全部会话
  */
 
 import { inspectOpenPath } from './paths.js';
 import { isLoopbackRequest } from './security.js';
 import { openInVscode, revealDirectory } from './launch.js';
 import { DELETE_BATCH_LIMIT, removeSessions } from './session-delete.js';
+import { removeWorkspaceWithSessions } from './workspace-delete.js';
 
 /** 路由前缀；客户端半边硬编码同一个值。 */
 export const ROUTE_PREFIX = '/dsh-sidebar-row-menu';
 export const ROUTE_OPEN = `${ROUTE_PREFIX}/open`;
 export const ROUTE_DELETE = `${ROUTE_PREFIX}/session/delete`;
+export const ROUTE_WORKSPACE_DELETE = `${ROUTE_PREFIX}/workspace/delete`;
 /** 请求体上限（只传路径或会话 id 列表，64KB 足够）。 */
 const MAX_BODY_BYTES = 64 * 1024;
 
@@ -171,8 +174,65 @@ export async function handleSessionDeleteRequest(request, response, ctx) {
   }
 }
 
-/** 构造 webServer 路由对象（kind=prefix）。 */
-export function createOpenRoute(ctx) {
+/**
+ * 处理一次「删除工作区及其全部会话」请求。
+ * 请求体：{ workspaceId: string }。
+ * 200 返回 { ok, sessions, deleted, failed, workspaceDeleted, error?, code? }。
+ * 会话删除有失败时不会删工作区，返回 ok:false 让客户端保留工作区并提示重试。
+ */
+export async function handleWorkspaceDeleteRequest(request, response, ctx) {
+  if (!isLoopbackRequest(request)) {
+    writeJson(response, 403, { ok: false, error: 'forbidden' });
+    return;
+  }
+  if (request.method !== 'POST') {
+    writeJson(response, 405, { ok: false, error: 'method-not-allowed' });
+    return;
+  }
+  if (pathnameOf(request) !== ROUTE_WORKSPACE_DELETE) {
+    writeJson(response, 404, { ok: false, error: 'not-found' });
+    return;
+  }
+
+  let payload;
+  try {
+    payload = await readJsonBody(request);
+  } catch {
+    writeJson(response, 400, { ok: false, error: 'bad-request' });
+    return;
+  }
+  const workspaceId = payload?.workspaceId;
+  if (typeof workspaceId !== 'string' || workspaceId.trim() === '') {
+    writeJson(response, 400, { ok: false, error: 'bad-request' });
+    return;
+  }
+
+  if (ctx === undefined || ctx === null || typeof ctx.get !== 'function') {
+    writeJson(response, 503, { ok: false, error: 'service-unavailable' });
+    return;
+  }
+  for (const name of ['sessions', 'sessionQuery', 'sessionPersistence', 'workspaceRegistry']) {
+    let available;
+    try {
+      available = ctx.get(name) !== undefined && ctx.get(name) !== null;
+    } catch {
+      available = false;
+    }
+    if (!available) {
+      writeJson(response, 503, { ok: false, error: 'service-unavailable' });
+      return;
+    }
+  }
+  try {
+    const outcome = await removeWorkspaceWithSessions(ctx, workspaceId);
+    writeJson(response, 200, outcome);
+  } catch (error) {
+    ctx.logger?.warn?.('[dsh-sidebar-row-menu] workspace delete failed:', error);
+    writeJson(response, 500, { ok: false, error: 'delete-failed' });
+  }
+}
+
+/** 构造 webServer 路由对象（kind=prefix）。 */export function createOpenRoute(ctx) {
   return {
     kind: 'prefix',
     path: ROUTE_PREFIX,
@@ -180,6 +240,7 @@ export function createOpenRoute(ctx) {
       const pathname = pathnameOf(request);
       if (pathname === ROUTE_OPEN) return handleOpenRequest(request, response);
       if (pathname === ROUTE_DELETE) return handleSessionDeleteRequest(request, response, ctx);
+      if (pathname === ROUTE_WORKSPACE_DELETE) return handleWorkspaceDeleteRequest(request, response, ctx);
       if (!isLoopbackRequest(request)) {
         writeJson(response, 403, { ok: false, error: 'forbidden' });
         return undefined;

package/lib/host/workspace-delete.js

@@ -0,0 +1,101 @@
+/**
+ * 删除工作区及其下所有会话。
+ *
+ * 内置 `workspaces.delete(id)`（registry.delete）只摘掉工作区登记，会话会被
+ * 重新归到「未分组」。这里先按工作区的 sessionIds 永久删除每个会话日志，
+ * 全部成功后再删工作区登记；任何一个会话删除失败就保留工作区，避免留下
+ * 一堆没人管的「未分组」会话。
+ *
+ * 工作区目录本身不删（和内置行为一致），只删会话日志与工作区记录。
+ */
+
+import { removeSessions } from './session-delete.js';
+
+function service(ctx, name) {
+  try {
+    return ctx.get(name);
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * 永久删除一个工作区及其全部会话。
+ * @param ctx - 宿主插件上下文。
+ * @param workspaceId - 工作区 id。
+ * @returns {Promise<{ok:boolean,sessions:number,deleted:number,failed:number,
+ *   workspaceDeleted:boolean,missing?:boolean,code?:string,error:string}>}
+ */
+export async function removeWorkspaceWithSessions(ctx, workspaceId) {
+  const registry = service(ctx, 'workspaceRegistry');
+  if (
+    registry === null
+    || registry === undefined
+    || typeof registry.get !== 'function'
+    || typeof registry.delete !== 'function'
+  ) {
+    return {
+      ok: false,
+      sessions: 0,
+      deleted: 0,
+      failed: 0,
+      workspaceDeleted: false,
+      code: 'unavailable',
+      error: 'workspace-registry-unavailable',
+    };
+  }
+
+  let workspace;
+  try {
+    workspace = registry.get(workspaceId);
+  } catch (error) {
+    return {
+      ok: false,
+      sessions: 0,
+      deleted: 0,
+      failed: 0,
+      workspaceDeleted: false,
+      code: 'lookup-failed',
+      error: error instanceof Error ? error.message : String(error),
+    };
+  }
+  if (workspace === null || workspace === undefined) {
+    return { ok: true, sessions: 0, deleted: 0, failed: 0, workspaceDeleted: false, missing: true, error: '' };
+  }
+
+  const ids = Array.isArray(workspace.sessionIds)
+    ? workspace.sessionIds.filter((id) => typeof id === 'string' && id.trim() !== '')
+    : [];
+  let deleted = 0;
+  if (ids.length > 0) {
+    const outcome = await removeSessions(ctx, ids);
+    deleted = outcome.deleted ?? 0;
+    if (outcome.ok !== true) {
+      return {
+        ok: false,
+        sessions: ids.length,
+        deleted,
+        failed: outcome.failed ?? Math.max(0, ids.length - deleted),
+        workspaceDeleted: false,
+        code: typeof outcome.code === 'string' ? outcome.code : 'session-delete-failed',
+        error: typeof outcome.error === 'string' ? outcome.error : '',
+      };
+    }
+  }
+
+  let workspaceDeleted = false;
+  try {
+    workspaceDeleted = (await registry.delete(workspaceId)) !== false;
+  } catch (error) {
+    return {
+      ok: false,
+      sessions: ids.length,
+      deleted,
+      failed: 0,
+      workspaceDeleted: false,
+      code: 'workspace-delete-failed',
+      error: error instanceof Error ? error.message : String(error),
+    };
+  }
+  return { ok: true, sessions: ids.length, deleted, failed: 0, workspaceDeleted, error: '' };
+}

package/lib/index.js

@@ -4,18 +4,21 @@
  * 两件事：
  *  1. `/open` 让浏览器请宿主用系统命令打开目录；
  *  2. `/session/delete` 永久删除会话日志（默认由 UI 对已归档会话开放；
+ *  3. `/workspace/delete` 永久删除工作区及其下全部会话。
  *
- * 具体实现拆成四个模块：
+ * 具体实现拆成六个模块：
  *
- *   lib/host/security.js        loopback 请求围栏
- *   lib/host/paths.js           路径校验与 vscode:// URL 编码
- *   lib/host/launch.js          VS Code / 资源管理器启动
- *   lib/host/session-delete.js  停跑、摘运行时、删日志、清归档记录
- *   lib/host/route.js           HTTP 边界与状态码
+ *   lib/host/security.js          loopback 请求围栏
+ *   lib/host/paths.js             路径校验与 vscode:// URL 编码
+ *   lib/host/launch.js            VS Code / 资源管理器启动
+ *   lib/host/session-delete.js    停跑、摘运行时、删日志、清归档记录
+ *   lib/host/workspace-delete.js  先删会话再摘工作区登记
+ *   lib/host/route.js             HTTP 边界与状态码
  *
  * 浏览器自己不能打开资源管理器，也不该直接删会话日志，所以这些必须放在 host。
  * 打开请求体：{ target: 'vscode' | 'explorer', path: '<绝对目录路径>' }
- * 删除请求体：{ sessionIds: ['<会话 id>', ...] }
+ * 删除会话请求体：{ sessionIds: ['<会话 id>', ...] }
+ * 删除工作区请求体：{ workspaceId: '<工作区 id>' }
  *
  * 删除流程参考 dsh-session-menu v0.1.3（MIT, big-head-pigeon），不引入 Typert 依赖。
  */
@@ -29,8 +32,9 @@ export const inject = ['webServer', 'sessions', 'sessionPersistence', 'sessionQu
 export { isLoopbackRequest } from './host/security.js';
 export { inspectOpenPath, toVscodeFileUrl } from './host/paths.js';
 export { resolveVscodeLauncher } from './host/launch.js';
-export { createOpenRoute, handleSessionDeleteRequest } from './host/route.js';
+export { createOpenRoute, handleSessionDeleteRequest, handleWorkspaceDeleteRequest } from './host/route.js';
 export { DELETE_BATCH_LIMIT, removeSession, removeSessions } from './host/session-delete.js';
+export { removeWorkspaceWithSessions } from './host/workspace-delete.js';
 
 /**
  * 注册路由。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-sidebar-row-menu",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "type": "module",
   "description": "DSH sidebar right-click menus: a self-composed menu for workspace rows, and the native slot menu opened at the pointer for session rows, with open-with and archived-session cleanup.",
   "keywords": [
@@ -55,12 +55,13 @@
     }
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=20",
+    "dsh": ">=0.2.1-rc.5 <0.3.0-0"
   },
   "scripts": {
-    "test": "node --test test/host.test.mjs test/client.test.mjs",
-    "test:local": "node --test --test-isolation=none test/host.test.mjs test/client.test.mjs",
-    "check": "node --check lib/index.js && node --check lib/client.js && node --check lib/host/paths.js && node --check lib/host/security.js && node --check lib/host/launch.js && node --check lib/host/route.js && node --check lib/host/session-delete.js",
+    "test": "node --test test/host.test.mjs test/manifest.test.mjs test/client.test.mjs",
+    "test:local": "node --test --test-isolation=none test/host.test.mjs test/manifest.test.mjs test/client.test.mjs",
+    "check": "node --check lib/index.js && node --check lib/client.js && node --check lib/host/paths.js && node --check lib/host/security.js && node --check lib/host/launch.js && node --check lib/host/route.js && node --check lib/host/session-delete.js && node --check lib/host/workspace-delete.js",
     "build": "npm pack",
     "marketplace:check": "node scripts/marketplace-preflight.mjs",
     "prepack": "npm run check",

package/scripts/marketplace-preflight.mjs

@@ -65,6 +65,13 @@ String(pkg.repository?.url ?? '').includes(repoSlug)
   ? pass('repository', pkg.repository.url)
   : fail('repository', 'does not point at the GitHub repo');
 
+// The market index and the DSH host both read the top-level `engines.dsh`; the
+// nested `dsh.engines.dsh` the organizer-style manifests use is ignored by both.
+const enginesDsh = pkg.engines?.dsh;
+typeof enginesDsh === 'string' && enginesDsh.trim()
+  ? pass('engines.dsh', enginesDsh)
+  : fail('engines.dsh', 'missing — the market would show no supported DSH version');
+
 // --- storefront icon --------------------------------------------------------
 
 if (!existsSync(iconPath)) {