dsh-power-menu

dsh-power-menu

给 DeepSeek Harness 桌面版加一个右上角电源按钮：点开只有 关闭DSH 和 重启DSH 两项，省得每次改完插件/配置还要去系统托盘里翻「退出」。

Windows 专用 · 只支持 DSH Desktop · 纯本地 · 无外部依赖 · MIT

⭐ 如果这个小工具帮你省了点时间，欢迎点个 Star 支持一下，感谢～

为什么做这个

DSH Desktop 关窗口只是收进托盘，真正退出或重启要走托盘菜单；而改插件、改配置之后又经常需要重启一次。这个插件把这两步搬到会话标题栏右上角：一个电源键，两项操作，点完就走。

功能

• 右上角电源按钮：位于会话标题栏图标行最右侧，顺序为「布局 / 侧栏 / 电源」。
• 空会话也显示：欢迎页和对话内使用同一个挂载位置，透明无底色，不会破坏主题，也不会出现两个按钮。
• Windows 电源菜单风格：白色圆角卡片、悬浮阴影、左侧线性图标 + 右侧文本，只有两项，不塞多余入口。
• 关闭DSH：结束整个 DeepSeek Harness 桌面应用（Electron 主进程 + Host），不重新启动。
• 重启DSH：结束整个应用，等旧端口释放后用原可执行文件重新拉起，窗口自动回来。
• 键盘可用：↑ / ↓ / Home / End 在两项间移动，Enter / 空格执行，Esc 关闭，点菜单外部也能关。
• 执行反馈：点击后整页盖一层半透明遮罩，显示「正在关闭DSH…」/「正在重启DSH…」。
• 纯本地：没有外部依赖、没有遥测；接口只监听本机回环地址，并做同源校验。

安装

重要：装完插件后，必须再运行一次 enable.ps1（或直接用下面的 install.ps1），把 dsh-power-menu 补进 profile 的 dsh.profile.bundles，然后重启 DSH。少了这一步，按钮会 404——这是 DSH 插件管理器只写 dependencies、不写 bundles 的已知行为，不是插件本身的问题。

方式 A：一键脚本（推荐）

从仓库下载 ZIP 或 git clone 后，在目录里运行：

powershell -ExecutionPolicy Bypass -File .\install.ps1

脚本会：清理旧的 link/junction 残留（避免 pnpm 的 ERR_PNPM_EPERM，界面上表现为「没有写入权限」）→ 用 DSH 自带 CLI 安装 → 补齐 dsh.profile.bundles → 提示重启。

GitHub 直连慢或不通时，改用镜像：

powershell -ExecutionPolicy Bypass -File .\install.ps1 -Mirror

机器上没有 git 也能装：install.ps1 会先检查 git；没有就自动从 GitHub Release 下载 dsh-power-menu-0.1.17.tgz，再用本地文件安装，全程不调用 git（这正是 ERR_PNPM_GIT_RESOLVE_FAILED 的解法）。直连下不动会自动改走 gh-proxy 镜像；也可以用 -TgzPath 指定已经拷到本机的安装包，完全离线安装。

脚本默认不改用户 PATH；需要让插件管理器以后也能解析便携 git 时，加 -Github -WritePath。下载 tgz 会优先用 Release 的 SHA256SUMS.txt 校验，离线包可用 -Sha256 <hash> 手动校验。

方式 B：通过 DSH 插件管理器

1. 打开 DSH Desktop 的 插件 / 插件市场。

2. 选择 添加插件，输入：

   github:xichen-62/dsh-power-menu
   

3. 安装完成后，下载/克隆本仓库，运行 enable.ps1 补一次 bundles（这一步不能省）：

   powershell -ExecutionPolicy Bypass -File .\enable.ps1
   

4. 重启 DSH，并在 插件市场 → 已安装 里确认 dsh-power-menu 处于「启用中」。

如果装完点按钮报 HTTP 404，说明插件只进了 dependencies、没进 dsh.profile.bundles，宿主半没加载。运行仓库里的 enable.ps1（右键使用 PowerShell 运行），它会先备份 profile，再把 dsh-power-menu 补进 dsh.profile.bundles；然后重启 DSH。

方式 C：命令行安装

dsh plugin --profile desktop add github:xichen-62/dsh-power-menu
powershell -ExecutionPolicy Bypass -File .\enable.ps1

dsh 是 DSH 自带的 CLI；如果 PATH 里没有，请用 DSH 安装目录里的 dsh / dsh.cmd。

方式 D：本地开发安装

git clone https://github.com/xichen-62/dsh-power-menu.git

把插件链接进 desktop profile：

# Windows PowerShell
$profileDir = "$env:USERPROFILE\.dsh\profiles\desktop"
New-Item -ItemType Junction `
  -Path "$profileDir\node_modules\dsh-power-menu" `
  -Target "<你 clone 下来的目录>"

然后在 $profileDir\package.json 里：

• dependencies 增加 "dsh-power-menu": "link:<你 clone 下来的目录>"
• dsh.profile.bundles 增加 "dsh-power-menu"

重启 DSH 生效。这个插件没有构建步骤，改完 lib/ 里的文件重启即可。

注意：link: 安装会在 node_modules 里创建 junction。之后如果改用插件管理器（github: 安装）升级同一个包，pnpm 的临时目录 rename 会撞上这个 junction，报 ERR_PNPM_EPERM，界面上显示「没有写入权限」。遇到时先删链接再重装：cmd /c rmdir "$profileDir\node_modules\dsh-power-menu"（只删链接，不动 clone 的源码）。

使用

1. 在会话标题栏右上角点电源图标。
2. 选择 关闭DSH 或 重启DSH。
3. 等待遮罩出现：关闭会退出应用；重启会在几秒后把窗口拉回来。

注意：点击即执行，没有二次确认。两个动作都会中断正在生成的回答、运行中的工具和后台任务。请在点之前保存手头的事情。

工作原理

桌面版的进程树大致是：

Electron 主进程
└── Host 子进程（dsh-desktop-host，ELECTRON_RUN_AS_NODE=1）
    └── 本插件

插件跑在 Host 里，不能直接调用 Electron 的 app.quit() / app.relaunch()。所以 Host 只负责“交接”，真正的进程切换交给一个分离的 helper：

flowchart LR
  UI[电源菜单] -->|POST| Host[Host 插件]
  Host -->|写 handoff + spawn| Helper[detached helper]
  Helper -->|taskkill /PID main /F<br/>不带 /T| Main[Electron 主进程]
  Main -.->|IPC 断开| Host
  Host -->|application.shutdown| Disk[(会话日志落盘)]
  Helper -->|等端口释放 + 重新拉起| NewMain[新的 Electron 主进程]

具体步骤：

1. Host 把交接信息写到 %USERPROFILE%\.dsh\dsh-power-menu\，用 process.execPath + ELECTRON_RUN_AS_NODE=1 启动 lib/helper.cjs。
2. helper 等 1.2 秒，让 HTTP 应答先到浏览器。
3. helper 执行 taskkill /PID <主进程> /F，刻意不带 /T：只结束 Electron 主进程，让 Host 子进程有机会收到 IPC 断开。
4. Host 检测到断开后走自己的 application.shutdown，尽量把会话日志正常落盘。
5. 重启模式下，helper 等旧监听端口释放，清掉 ELECTRON_RUN_AS_NODE / DSH_DESKTOP_NODE_EXECUTABLE，用原可执行文件重新拉起，并确认新进程存活；失败会重试，仍失败就弹窗提示手动打开。
6. 关闭模式下不拉起，等 Host 自己退出。

接口

Host 半注册三个仅限本机回环的接口：

POST /api/dsh-power-menu/shutdown
POST /api/dsh-power-menu/restart
GET  /api/dsh-power-menu/health

安全

• 三个接口只接受回环地址（127.0.0.1 / ::1），校验 Host 必须是本机，拒绝 sec-fetch-site: cross-site，带 Origin 时必须与本机同源。
• 没有鉴权令牌的第三方网页无法跨站触发关机/重启。
• 只支持桌面版；dsh web 下接口返回 409，不会去杀别的进程。
• 不收集任何数据，不联网，不写注册表；日志只写在本地 %USERPROFILE%\.dsh\dsh-power-menu\。

兼容性

• 系统：Windows 10 / 11。插件依赖 taskkill 和 Electron 桌面进程树，其他系统未实现。
• DSH：在 DSH Desktop 0.2.1-rc.2 上实测通过（2026-10-18）。其他 0.2.x 版本可能可用，但未逐一验证。
• Node：跟随 DSH 自带的 Node（22+），无需单独安装。

开发

dsh-power-menu/
├── lib/
│   ├── index.js        Host 半：三个回环接口 + 交接调度
│   ├── client.js       浏览器半：window.__ModuleLoader__ bundle
│   └── helper.cjs      分离的交接 helper
├── cordis.patch.yml    bundle 插入层
├── package.json
├── docs/screenshot.png
└── README.md

• 客户端 bundle 不是普通 ESM，必须用 window.__ModuleLoader__.load({ id, factory }) 格式；dsh.client.inject 声明 @deepseek-ai/dsh-client-ui-slots。

• 没有构建步骤，也没有运行时 npm 依赖。

• 提交前跑一次静态检查：

  npm run check
  

• 本地调试日志：%USERPROFILE%\.dsh\dsh-power-menu\power-menu.log 和 helper-*.log。

常见问题

按钮没出现？ 确认插件处于「启用中」，并重启过一次 DSH；按钮只出现在有会话标题栏的页面。

插件卡片上没显示介绍？ 本地开发（link 安装）的插件，卡片不读 package.json 的 description，需要在卡片上点「添加备注」自己填。这是 DSH 插件管理器的行为，不是插件的问题。

重启后端口变了？ 正常。DSH Desktop 每次启动用随机端口（--port 0），插件只负责拉起新实例，不假设端口不变。

DSH 装在中文路径 / 用户名含中文能用吗？ 可以。插件不拼 cmd 字符串：启动用 spawn(exe, [], { cwd })，路径作为单个 argv 交给 Node 的 Unicode API；交接 JSON 和日志按 UTF-8 读写；helper 自带 --pathtest，会在“中文 + 空格”的临时目录里实测 UTF-8 读写和从中文路径启动 exe。安装脚本也按 UTF-8 BOM 保存。

点了没反应？ 看 %USERPROFILE%\.dsh\dsh-power-menu\ 下的日志；dsh web 环境会返回 409（仅支持桌面版）。

为什么按钮不挂真实 slot？ DSH 的 conversation.session.header.corner 是单占用槽，已经被侧栏开关占用；conversation.session.header.utilities 会排在侧栏左侧；sidebar.footer.action 在左下角。要在不修改 DSH 的前提下保持右上角，只能把按钮挂进 headerCorner 的 DOM。代价是上游改头部结构时可能失效；插件用 MutationObserver 跟随，不再 500ms 轮询。

关闭/重启会跳过 profile 收尾吗？ 会有一点：插件只结束 Electron 主进程，Host 会走 application.shutdown，但主进程的 before-quit 可能被跳过，Chromium 的 Cookie / Local Storage 不保证落盘。0.1.15 起会在 Host 退出后定向清理非 Host 孤儿进程（不再留 GPU / 渲染器 / 插件后台），但追求最干净的退出请用托盘「退出」。真正的 app.quit() 需要 DSH 提供协作退出 IPC，插件单方面做不到。

装完点按钮报 HTTP 404？ 说明宿主半没加载：插件只在 dependencies 里，不在 dsh.profile.bundles 里。运行仓库里的 enable.ps1，或手动把 dsh-power-menu 加进 profile 的 dsh.profile.bundles，再重启 DSH。0.1.9 起不再依赖 postinstall——pnpm 11 默认会拦截依赖的生命周期脚本，装不上钩子。

插件安装失败，提示「没有写入权限，无法安装」？ 多半是之前用 link: 装过（node_modules\dsh-power-menu 是 junction），pnpm 升级时 rename 覆盖不了它，报 ERR_PNPM_EPERM，被安装器误读成权限问题。先删链接再重装：

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

或者直接运行 install.ps1，它会自动处理这一步。

GitHub 直连很慢 / 报网络错误？ 用 install.ps1 -Mirror，或把安装来源换成 https://gh-proxy.com/https://github.com/xichen-62/dsh-power-menu.git。插件本身不联网，这只是下载阶段的网络问题。

装的时候报 ERR_PNPM_GIT_RESOLVE_FAILED / 这台电脑没装 git？ 这不是插件的问题：github: 安装是 pnpm 的 git 依赖，pnpm 必须先调起系统里的 git 做 ls-remote，没有 git 就直接失败（界面上的 added 0 说明一个文件都没下载）。两条路：

• 跑 install.ps1：检测到没有 git 会自动改用 Release 里的 .tgz，不碰 git。

• 想保留 github: spec：跑 install.ps1 -Github，它会下载便携版 git；需要写进用户 PATH 时再加 -WritePath，之后 github: 和仓库 URL 都能装（重启 DSH 后插件管理器也生效）。

• 或者直接装 tarball（pnpm 走 HTTP 下载后本地解包）：

  dsh plugin --profile desktop add https://github.com/xichen-62/dsh-power-menu/releases/latest/download/dsh-power-menu-0.1.17.tgz
  

  GitHub 慢的话，在前面加 https://gh-proxy.com/ 走镜像；也可以把 tgz 下载到本机后用 dsh plugin --profile desktop add file:<路径> 安装。

卸载

• 插件管理器里移除 dsh-power-menu，或者从 profile 的 dependencies / dsh.profile.bundles 里删掉，再删掉 node_modules 里的链接。
• 可选：删除 %USERPROFILE%\.dsh\dsh-power-menu\ 下的日志与交接文件。
• 重启 DSH 生效。

更新日志

见 CHANGELOG.md。

许可证

MIT © 2026 xichen-62

致谢

• 分离 helper 做进程交接、只结束主进程让 Host 优雅退出的思路，参考了 dsh-desktop-restart（MIT）。本项目的实现是独立编写的。
• 菜单样式参考 Windows 电源菜单；图标为内联 SVG，无第三方图标库。

---

English

A small DSH Desktop plugin that adds a power button to the top-right of the session header. It opens a Windows-style menu with exactly two actions:

• 关闭DSH — quit the whole desktop app (no relaunch).
• 重启DSH — quit and relaunch the app, so the window comes back automatically.

Windows only, DSH Desktop only. No telemetry, no external dependencies; the three HTTP routes are loopback-only and same-origin fenced.

Install from GitHub:

dsh plugin --profile desktop add github:xichen-62/dsh-power-menu

or add github:xichen-62/dsh-power-menu in the DSH plugin manager, then run enable.ps1 and restart DSH. The one-click install.ps1 handles both the install and the dsh.profile.bundles registration, and cleans up a stale link: junction that would otherwise make pnpm fail with ERR_PNPM_EPERM ("No write permission; the plugin cannot be installed").

No git on the machine? The github: spec is a pnpm git dependency, so pnpm must spawn git and fails with ERR_PNPM_GIT_RESOLVE_FAILED when it is missing. install.ps1 detects that and installs the .tgz attached to the GitHub Release instead (no git involved); the tarball URL can also be passed to dsh plugin add directly.

If this saves you some time, a ⭐ star is much appreciated. Thanks!

MIT licensed.