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）：
- 在 C 盘建「发布点」
\plugins\<包名>，它是指向源码目录的 junction
—— 源码仍然是活的，改完不用重新发布； dependencies写同盘符的相对链接link:../../plugins/<包名>；- 直接建
\node_modules\<包名>的 junction 指向发布点； - 校验链接真能解析到插件清单之后，才把包名写进
dsh.profile.bundles
（bundle 行指向解析不到的包会让该 profile 起不来或整条 bundle 被跳过）。
然后：
- 重启桌面端（桌面端的 profile 是活的，开了 HMR 的话可能已经热挂上了）；
- 页面硬刷新（Ctrl+Shift+R）；
- 左侧工作区行上右键 → 应该看到官方样式的菜单。
卸载：.\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 盘的 \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:"（: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 处理器，默认沿用当前窗口；
改成 CLICode.exe --new-window。
另外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,（在父目录里选中文件夹）而不是直接进目录。
DSH 自己的工作区 / 归档语义（跟插件无关，但容易踩）
数据都在 ~/.dsh/storages/workspace.json：
{ "global": { "workspaceIds": ["..."], "archivedSessionIds": ["..."] },
"tables": { "workspaces": { "": { "path": "...", "title": "...", "sessionIds": ["..."] } } } }
- 删除工作区 = 只删登记行（
tables.workspaces.+global.workspaceIds里的 id）。
目录和会话日志都不动，会话掉进「未分组」。找回：重新添加同一目录建工作区，
再把老会话拖进那个分组（UI 支持拖拽 →insertSessionBefore）。 - 归档会话 = 把 id 加进
global.archivedSessionIds（全局列表）。数据都在：
从数组里删掉 id（重启 + 硬刷新）就回到原分组，位置也不变。 - 归档 不省空间。会话日志在
~/.dsh/sessions/<路径转义>//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$键）向上找到
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/rundll32.exe url.dll,FileProtocolHandler vscode://file/detached 拉起，
请求只接受本机 loopback（同源）调用。 - 「在新标签中打开」走另一个插件提供的客户端服务
projectTabs，读的时候
ctx.get('projectTabs') ?? window.__DSH_PROJECT_TABS__，没装就整项不显示。
测试
node scripts\smoke-test.mjs # 客户端：加载 bundle、fiber 识别、菜单、动作分发
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）那一段没有工作区实体，右键不会弹菜单（符合预期）。
