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…」。
• 纯本地：没有外部依赖、没有遥测；接口只监听本机回环地址，并做同源校验。

安装

方式 A：通过 DSH 插件管理器（推荐）

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

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

   github:xichen-62/dsh-power-menu
   

3. 安装完成后重启一次 DSH。

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

方式 B：命令行安装

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

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

方式 C：本地开发安装

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/ 里的文件重启即可。

使用

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

动作	结果	需要手动重开？
关闭DSH	结束整个桌面应用，不重新启动	是
重启DSH	结束应用 → 等端口释放 → 重新拉起	否，窗口自动回来

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

工作原理

桌面版的进程树大致是：

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），插件只负责拉起新实例，不假设端口不变。

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

卸载

• 插件管理器里移除 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 restart DSH.

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

MIT licensed.