TLEWA/dsh-sidebar-row-menu

简体中文 · English

给 DeepSeek Harness（DSH）左侧边栏加右键菜单：

• 工作区行：右键弹出菜单（复刻 dsh-sidebar-context-menu 的能力）；
• 工作区下层的会话行：右键在指针处展开该行内置的「…」菜单，并追加本插件的条目。

菜单使用 DSH 官方的 Menu 组件渲染，视觉、定位、键盘导航和“点外部关闭”都与内置 「…」菜单一致。工作区菜单由本插件组项；会话菜单的内容来自 sidebar.workspaces.session.menu.item slot —— 内置动作和其他插件的动作都在里面， 本插件只追加自己的条目，不复制、不硬编码任何内置动作。

点行尾「…」按钮看到的菜单保持 DSH 原样；本插件自己的三个条目只在右键展开时出现。 右键展开的菜单不会因为鼠标移出而关闭（与工作区右键一致），只有点击外部、选中条目或按 Esc 才关闭。

功能

工作区行右键

菜单项	行为
新会话	展开该工作区并新建会话（等价于行尾 +）
重命名	打开官方“重命名工作区”对话框
使用 VS Code 打开	宿主在新窗口打开该工作区目录
在资源管理器中打开	宿主打开系统文件管理器
复制工作区路径	复制目录路径到剪贴板
在新标签中打开	仅在装有 dsh-project-tabs（暴露 openWorkspaceInTab）时出现
删除工作区	打开官方删除确认对话框

会话行右键

右键会话行不会另起一套菜单，而是展开该行自己的「…」菜单：

来源	条目
DSH 内置	重命名、分叉会话、置顶 / 取消置顶、归档 / 取消归档、复制 Session ID
其他插件	它们注册进 sidebar.workspaces.session.menu.item 的条目
本插件	使用 VS Code 打开、在资源管理器中打开

本插件追加的两个条目：

菜单项	行为
使用 VS Code 打开	优先用会话自己的 cwd，取不到则用所属工作区目录
在资源管理器中打开	同上

这两条是右键专属：点行尾「…」按钮时它们不挂载。实现上使用一个只在右键展开瞬间 有效的窗口标记，窗口外的渲染直接返回 null。

草稿会话（还没有任何消息的空白会话）没有内置「…」菜单，本插件同样不接管。 非工作区 / 非会话的侧边栏行（如“显示更多”）也不会被拦截。

安装

要求：

• DSH 桌面版（或 dsh web）已经至少启动过一次，profile 目录存在；
• Windows PowerShell 5.1+；
• 与 DSH 客户端内置包 0.2.1-rc.5 同代的行组件（见兼容性）。

从 npm 安装（推荐）

包已发布到 npm registry，DSH 的插件安装器可以直接按包名解析：

1. 打开侧边栏 插件 页 → 安装插件；

2. 输入包名并确认：

   dsh-sidebar-row-menu
   

3. 安装完成后硬刷新（Ctrl+Shift+R）；宿主半边未生效时重启桌面端。

要固定版本，在包名后加版本号：

dsh-sidebar-row-menu@1.3.5

命令行等价写法：

dsh plugin --profile desktop add dsh-sidebar-row-menu@1.3.5

从 GitHub 安装

DSH 桌面端通过 pnpm 安装 Git 依赖；本仓库的 lib/ 已是可直接运行的产物，安装时 不需要本地构建。

1. 打开侧边栏 插件 页 → 安装插件；

2. 粘贴仓库地址并确认：

   https://github.com/TLEWA/dsh-sidebar-row-menu
   

3. 安装完成后硬刷新（Ctrl+Shift+R）；宿主半边未生效时重启桌面端。

该地址跟随 main 的最新提交。要固定版本，在地址后加标签：

https://github.com/TLEWA/dsh-sidebar-row-menu#v1.3.5

也可以直接安装 Actions 打出的压缩包（不经过 Git）：

https://github.com/TLEWA/dsh-sidebar-row-menu/releases/download/v1.3.5/dsh-sidebar-row-menu-1.3.5.tgz

命令行等价写法：

dsh plugin --profile desktop add github:TLEWA/dsh-sidebar-row-menu

自动化：每次 push / PR 由 GitHub Actions 执行语法检查、完整测试和打包校验；推送 v* 标签时自动创建 Release，附带 dsh-sidebar-row-menu-<version>.tgz 与 SHA256SUMS.txt。

插件市场

面向 awesome-dsh-plugin 的 提交材料（条目 YAML、预检脚本）只保留在本地，已加入 .gitignore，不随本仓库发布； 正式提交时只需把条目文件放进上游仓库的一个 PR。收录前请继续使用上面的 GitHub 地址安装。

手动安装（克隆仓库）

git clone https://github.com/TLEWA/dsh-sidebar-row-menu.git dsh-sidebar-row-menu
cd dsh-sidebar-row-menu
powershell -NoProfile -File .\scripts\install.ps1

脚本做四件事（不依赖 pnpm）：

1. %DSH_HOME%\plugins\dsh-sidebar-row-menu → 本仓库（发布点目录联接，源码保持可编辑）；
2. 在 profile 的 dependencies 写 link:../../plugins/dsh-sidebar-row-menu；
3. %DSH_HOME%\profiles\<profile>\node_modules\dsh-sidebar-row-menu → 发布点；
4. 校验链接确实解析到本包的 package.json 且带 dsh.bundle.patch，才把包名追加到 dsh.profile.bundles；写回前备份 package.json。

默认安装到 desktop，也可以：

powershell -NoProfile -File .\scripts\install.ps1 -Profile both
powershell -NoProfile -File .\scripts\install.ps1 -Profile 'C:\Users\<you>\.dsh\profiles\web'

安装完：

• 先硬刷新界面（Ctrl+Shift+R）；客户端半边会在控制台打印 [dsh-sidebar-row-menu] installed；
• 若右键没有任何反应，再重启桌面应用，让宿主半边和 bundle 树一起重新装载。

自检（宿主路由应返回 400 bad-target）：

curl.exe -X POST http://127.0.0.1:10102/dsh-sidebar-row-menu/open `
  -H 'content-type: application/json' -d '{"target":"nope","path":"x"}'

然后在侧边栏分别右键一个工作区行和它下面的会话行：菜单应贴着鼠标弹出，样式与 内置「…」菜单一致；Esc、点空白处都能关闭。

卸载：

powershell -NoProfile -File .\scripts\install.ps1 -Uninstall

只移除两个目录联接、依赖项和 bundle 条目，不碰仓库本身。

不要用 dsh plugin add link:<绝对路径>：pnpm 在 Windows 上把 link: 当成相对 profile 的路径，跨盘时会生成坏链接；脚本正是为了绕开这一点。

从脚本安装切换到 pnpm 安装（npm / GitHub）

如果你先用 scripts/install.ps1 装过开发版，再在插件页输入 npm 包名或 GitHub 地址，pnpm 可能报：

[ERR_PNPM_EPERM] [importPackage ...\node_modules\dsh-sidebar-row-menu]
EPERM: operation not permitted, rename
'...\dsh-sidebar-row-menu_tmp_27508_27' -> '...\dsh-sidebar-row-menu'

原因是脚本在 node_modules 里留了一个目录联接，而 pnpm 导入新包时用 rename 覆盖目标； Windows 不允许这样替换一个已存在的联接目录。先卸载脚本安装，再重试：

powershell -NoProfile -File .\scripts\install.ps1 -Uninstall

如果卸载后目录仍在（或安装失败留下了 *_tmp_* 目录），手动删除后重试：

cmd /c rmdir "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-sidebar-row-menu"

全新 profile 不会遇到这个问题；它只影响“先脚本安装、后 pnpm（npm 或 GitHub）安装”的切换场景。

开发

npm run test        # 常规：node --test，逐文件子进程
npm run test:local  # 受限终端 / 沙箱：--test-isolation=none，同进程跑
npm run build       # npm pack（prepack 会先跑 check），产出 .tgz

测试覆盖宿主侧纯函数（路径校验、vscode://file 编码、loopback 判定、路由状态码） 和客户端模块（模块 id、导出、依赖白名单、监听器安装/卸载、slot 注册表），并用伪造的 __reactFiber$、DOM 与 Menu 宿主做集成测试：工作区右键的菜单项顺序、会话右键是否 展开内置菜单而不是自建菜单、草稿行是否被放过、复制工作区路径的 Toast 反馈都在断言里。 真实 fiber 与服务仍需在运行中的 GUI 里做人工验证。

目录：

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 路由与 HTTP 状态码
lib/client.js         客户端半边：fiber 解析、slot 注册、菜单挂载
cordis.patch.yml      bundle patch：把插件插进 profile 插件树
scripts/install.ps1   无 pnpm 的安装 / 卸载脚本
test/*.test.mjs       node:test

实现说明

为什么从 fiber 取数据

侧边栏行只暴露 data-row-key（workspace:<key> / session:<id>），工作区目录、 会话对象和动作回调都不在 DOM 上。行组件是：

• ProjectRowItem({ group, actions, onCreate, ... })，actions 仅在真实工作区行存在；
• SessionNodeItem({ node, onRenameRequest, onOpen, ... })，node 形如 { id, title, blank, running, archived, pinned, updatedAt }。

插件在 contextmenu 捕获阶段从目标节点拿 __reactFiber$，向上最多 60 层找匹配的 memoizedProps。找不到就完全不拦截，避免影响其他行和其他插件。

会话行为什么不硬编码

内置「…」菜单不是硬编码的按钮列表，而是 renderSlot('sidebar.workspaces.session.menu.item', ...) 的结果；内置的分叉、置顶、 归档，以及第三方插件的能力，都以 slot 条目形式注册。slot 的所有权由渲染器校验： 每个条目只能渲染自己声明过的子 slot，第三方无法直接把手伸进别人的 slot 重新排版。

因此会话行右键只做一件事：在行组件的 fiber 子树里找到那个 Menu，触发它 anchor （省略号按钮）的点击，展开的自然是同一份 slot 内容。本插件自己的三个动作也通过 ctx.slots.inject + ctx.slots.register 注册进去，所以：

• 不依赖「分叉」「置顶」这些内置条目是否存在；
• 内置或别的插件以后新增条目，右键菜单自动出现；
• 不复制、不硬编码任何内置动作。

工作区行没有这样的 slot，所以工作区菜单仍由本插件自己组项。

为什么会话菜单能贴着鼠标

官方 Menu 的 anchor 是那个省略号按钮，默认位置就在按钮右侧。右键时插件临时把 该按钮及其两层祖先的 getBoundingClientRect 指到指针位置（0×0 矩形），官方 Menu 每帧读取锚点 rect 重新定位，于是面板出现在鼠标旁；面板从 body 移除时立即还原原始 方法，不影响按钮菜单的默认位置。

「…」按钮菜单与右键菜单共用同一个 Menu 实例和同一份 slot 内容，区别只在 rightClickMenuUntil 窗口：本插件三条只在窗口内挂载，窗口随菜单关闭一并清零。

为什么菜单是命令式挂载

右键事件不是 React 渲染流的一部分。工作区菜单按需创建一个 0×0、 z-index:2147483647 的容器，createRoot 渲染官方 Menu（portal + 显式 getAnchorRect 钉在鼠标位置），关闭时 unmount() 并移除容器。会话菜单不挂载任何 新容器，只是打开行内已有的官方菜单。

宿主路由

POST /dsh-sidebar-row-menu/open，body { target: 'vscode' | 'explorer', path }。

• 只接受 loopback 请求（socket、Host、Sec-Fetch-Site、Origin 四重校验）；
• 只接受 POST，路径必须精确匹配，body ≤ 64 KB；
• path 必须是已存在的绝对目录（拒绝相对路径、NUL、文件、不存在的路径）， 避免把任意命令交给宿主；
• VS Code 解析顺序：DSH_SCM_VSCODE → 注册表 HKCR\vscode\shell\open\command → %LOCALAPPDATA% / %ProgramFiles% 下的 bin\code.cmd → PATH； 都找不到时退回 rundll32 打开 vscode://file/...；
• spawn 用 detached + stdio:'ignore'，不设 windowsHide（否则资源管理器窗口会被隐藏）。

兼容性

按 DSH 客户端 0.2.1-rc.5 的 ProjectRowItem / SessionNodeItem / Menu 实现。 DSH 升级若改动行组件或菜单定位实现：

• 工作区右键会静默不弹（不会报错、不影响原界面）；
• 会话右键会退回行尾「…」按钮旁，内容仍然正确。

已知限制

• 依赖 DSH 内置行组件的 props 形状。DSH 升级若改了这两个组件，右键会静默不弹。
• 会话右键依赖行内 Menu 组件仍在 fiber 子树里。找不到时退回点击行内操作区的 省略号按钮，再找不到就放弃 —— 不会自建菜单，也不会误触行的打开动作。
• 本插件不提供会话“删除”：DSH 官方只支持归档，归档后可恢复；强行删记录容易留下 孤儿数据。会话的归档 / 取消归档由内置菜单条目负责。
• 会话行右键的 VS Code / 资源管理器目录来自 sessions.list 的 cwd，取不到时退回 所属工作区目录；未分组会话可能没有目录，此时会提示“没有可用的目录路径”。

许可与声明

• 代码：MIT。
• 第三方代码引用与许可证全文：NOTICE.md · English。
• AI 使用与代码来源声明：AI_USAGE.md · English。

本项目允许用于商业与非商业场景，但按 MIT 条款不提供任何担保；AI 辅助生成的 代码请在采用前自行审查。