侧栏右键菜单 miao-ge/dsh-sidebar-context-menu

dsh-sidebar-context-menu

给 DSH 左侧菜单（工作区 / 会话列表里的「工作区行」）加一个右键菜单：

| 菜单项 | 行为 |
| 重命名 | 和原来「…」按钮一样，打开官方重命名对话框 |
| 删除工作区 | 和原来「…」按钮一样，打开官方删除确认框 |
| 使用 VS Code 打开 | --new-window <路径>：新开一个窗口，不动你当前那个窗口 |
| 在资源管理器中打开 | 宿主执行 explorer.exe <路径>，直接进入该目录 |
| 在新标签中打开 | 装了 dsh-project-tabs 才出现：把该项目在新标签里打开 |

原来要靠 … 按钮的两项没有删掉，只是多了一个右键入口；其余是新增的。

菜单用的是 DSH 官方组件（@deepseek-ai/dsh-client-ui-primitives 的 Menu + 图标），所以外观、键盘导航、点外部 / Esc 关闭都是原生的那一套。

安装

用 dsh 自带的插件安装器（推荐）：

dsh plugin --profile desktop add dsh-sidebar-context-menu

桌面端也可以直接在界面里装：左侧栏「插件」→「添加插件」→ 填包名 → 安装 → 立即启用。

从源码装（开发用）： 克隆本仓库，然后

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1

脚本会读本仓库 package.json 里的包名，所以两个插件仓库里是同一份脚本。
默认装进 desktop profile——桌面端（DeepSeek Harness 0.2.0 桌面版）读的就是它； web profile 是给浏览器版 dsh web 用的。想装那边就加 -Profile web，两边都装用 -Profile both。它是幂等的，可以反复运行。

脚本（不需要 pnpm）：

1. 在 C 盘建「发布点」<DSH_HOME>\plugins\<包名>，它是指向源码目录的 junction —— 源码仍然是活的，改完不用重新发布；
2. dependencies 写同盘符的相对链接 link:../../plugins/<包名>；
3. 直接建 <profile>\node_modules\<包名> 的 junction 指向发布点；
4. 校验链接真能解析到插件清单之后，才把包名写进 dsh.profile.bundles （bundle 行指向解析不到的包会让该 profile 起不来或整条 bundle 被跳过）。

然后：

1. 重启桌面端（桌面端的 profile 是活的，开了 HMR 的话可能已经热挂上了）；
2. 页面硬刷新（Ctrl+Shift+R）；
3. 左侧工作区行上右键 → 应该看到官方样式的菜单。

卸载：.\scripts\install.ps1 -Uninstall，然后重启 + 硬刷新。

为什么不能直接 dsh plugin --profile desktop add link:H:/DSH

pnpm 10 在 Windows 上把 link: / file: 的路径当相对 profile 目录处理。profile 在 C:、
源码在 H: 时跨盘符无法表示相对路径，于是 pnpm 退化成 path.join，生成垃圾链接：

node_modules\dsh-sidebar-context-menu -> C:\Users\...\.dsh\profiles\desktop\H:\DSH ← 不存在

所以本脚本先把源码「代理」到 C 盘的 <DSH_HOME>\plugins\...（junction → 源码目录），再用同盘符的相对链接。脚本自己建 junction，连 pnpm 都不用跑。

0.2.0 兼容性（和 0.1.7 的差异）

对着 0.2.0 的 dsh-client-ui-workspace/lib/client.js 核对过，原来那套识别逻辑没变：

| 依赖点 | 0.2.0 |
| ProjectRowItem 的 props {group, actions} | 签名一致（:1270），调用点 :2509-2539 形状不变 |
| actions = {rename, delete} 只对真实工作区存在 | 仍在 :2529（未分组行 workspaceId 和 actions 双双为 undefined） |
| group.workspaceId / cwd / label | 仍在（buildGroup :395，cwd = workspace.path） |
| 宿主 ctx.webServer.register({kind:'prefix',path,handler}) | 契约不变，handler 仍独占 response（dsh-host-webserver/lib/index.js:177） |
| 桌面端的 loopback 围栏 | 桌面代理转发任意方法/body 并删掉 origin 头（lib/main.js:7461-7492），围栏照旧通过 |

0.2.0 顺手用上的两个新东西：

- 工作区行多了 data-row-key="workspace:<id>"（:1287），做一个廉价前置过滤：右键落在 data-row-key 不是 workspace: 前缀的行上（比如会话行）直接放行，不做 fiber 回溯；
- 客户端 bundle 可以直接 require 平台静态模块表里的官方组件，菜单因此换成了 Menu。

打开方式踩过的坑（宿主半边，仍然有效）

- 资源管理器点了没反应：spawn 里带 windowsHide: true 会给子进程 STARTF_USESHOWWINDOW | SW_HIDE，explorer.exe 会把窗口真建成隐藏的。不要加这个选项。
- VS Code 顶掉当前窗口：vscode://file/... 走 VS Code 自己的 URL 处理器，默认沿用当前窗口；改成 CLI Code.exe --new-window <path>。
另外 PATH 上的第一个 code.cmd 很可能是 Cursor 的，所以启动器按这个顺序找： DSH_SCM_VSCODE 环境变量 → 注册表 HKCR\vscode\shell\open\command 里的 Code.exe （本机是 D:\Program Files\Microsoft VS Code\Code.exe）→ 常见安装目录 → PATH。
- 排查：点击后浏览器 F12 会打印宿主实际用的命令，例如 [dsh-sidebar-context-menu] vscode -> vscode-cli D:\Program Files\Microsoft VS Code\Code.exe。
想换成 Cursor / Windsurf：设 DSH_SCM_VSCODE=<它的 exe 或 code.cmd 路径>，重启桌面端 / dsh web。

0.2.0 自带 dsh-host-open-in-app（POST /open-in-app/open，目录里就有 vscode 和 explorer），理论上可以复用。之所以没用：它不带 --new-window（会顶掉你当前的 VS Code 窗口），而且 explorer 是 /select,<dir>（在父目录里选中文件夹）而不是直接进目录。

DSH 自己的工作区 / 归档语义（跟插件无关，但容易踩）

数据都在 ~/.dsh/storages/workspace.json：

{ "global": { "workspaceIds": ["..."], "archivedSessionIds": ["..."] },
"tables": { "workspaces": { "<id>": { "path": "...", "title": "...", "sessionIds": ["..."] } } } }

- 删除工作区 = 只删登记行（tables.workspaces.<id> + global.workspaceIds 里的 id）。
目录和会话日志都不动，会话掉进「未分组」。找回：重新添加同一目录建工作区，再把老会话拖进那个分组（UI 支持拖拽 → insertSessionBefore）。
- 归档会话 = 把 id 加进 global.archivedSessionIds（全局列表）。数据都在：从数组里删掉 id（重启 + 硬刷新）就回到原分组，位置也不变。
- 归档 不省空间。会话日志在 ~/.dsh/sessions/<路径转义>/<session-id>/session.jsonl.zstd；要省空间只能删这些目录，删了历史就真没了。

文件

package.json DSH 插件清单（dsh.bundle.patch + dsh.client） cordis.patch.yml bundle patch：把本插件的一行插进 profile 插件树 lib/index.js 宿主半边：POST /dsh-sidebar-context-menu/open lib/client.js 客户端半边：右键拦截 + 官方 Menu（无需打包） scripts/install.ps1 安装 / 卸载（发布点 + junction + bundles + 校验） scripts/smoke-test.mjs 客户端离线冒烟测试 scripts/host-test.mjs 宿主半边离线测试

配套的另一个插件（窗口顶部的项目标签栏）在 dsh-project-tabs 仓库里。

原理（为什么这么写）

- 左侧菜单内容由内置包 @deepseek-ai/dsh-client-ui-workspace 渲染。0.2.0 里 sidebar.workspaces 是 single 插槽且已被占用，它下面的 sidebar.workspaces.session.menu.item / sidebar.session.row.action 全是按会话的（owner props 是 {sessionId, displayTitle}），没有任何「工作区行」的菜单插槽。
而那个包是编译产物（只有 lib/client.js），改它又会被升级覆盖。所以这里改用事件层介入：
1. 在 window 上挂 contextmenu 监听（捕获阶段）。
2. 用 data-row-key 做一次廉价前置过滤（非 workspace: 前缀直接放行）。
3. 命中目标时用 React fiber（DOM 节点上的 __reactFiber$<random> 键）向上找到 ProjectRowItem 的 props —— actions = { rename, delete } 只对真实工作区存在，是最稳的特征。
4. 从 group 拿 workspaceId / cwd / label，从 actions 复用官方的重命名 / 删除。
5. 找不到工作区行就完全不拦截，不影响页面上其它任何右键。
- 菜单本体是官方 Menu 组件，而右键是命令式的，所以按需 createRoot 一个小 React 根，关掉时 unmount() + 摘掉容器（Menu 自己处理定位、夹取、键盘导航、点外部 / Esc 关闭）。
- 「打开资源管理器 / VS Code」浏览器做不到，所以走宿主： lib/index.js 注册 POST /dsh-sidebar-context-menu/open，用 explorer.exe <path> / rundll32.exe url.dll,FileProtocolHandler vscode://file/<path> detached 拉起，请求只接受本机 loopback（同源）调用。
- 「在新标签中打开」走另一个插件提供的客户端服务 projectTabs，读的时候
ctx.get('projectTabs') ?? window.__DSH_PROJECT_TABS__，没装就整项不显示。

测试

node scripts\smoke-test.mjs # 客户端：加载 bundle、fiber 识别、菜单、动作分发bash
node scripts\host-test.mjs # 宿主：URL 构造、loopback 围栏、请求校验

两个测试都是离线的（不需要浏览器 / 联网 / 安装 React），DOM 借本机 DSH 安装里的 @mixmark-io/domino（也可用环境变量 DSH_DOMINO 指定）。

已知限制

- 只在浏览器端那个 Web 客户端里生效（桌面端也是它）。VSCode 扩展 mrtsels.dsh-for-vs-code 自带一份打包好的客户端 UI，不读 profile 里的插件。
- 依赖 React 18/19 在宿主节点上挂 __reactFiber$ 这一事实；DSH 大版本升级后如果识别不到，右键会安静地不生效（不会报错、不会影响其它功能），届时需要按新结构复查 resolveWorkspaceRow。
- 升级 / 重装 DSH、profile 被重置、或桌面端走了「禁用所有插件」的恢复流程后， dsh.profile.bundles 会丢，重跑一次 install.ps1 即可。
- 仓库目录移动后 junction 会失效，重跑 install.ps1 会重建。
- 未分组（Ungrouped）那一段没有工作区实体，右键不会弹菜单（符合预期）。