前言¶
在 DeepSeek Harness(DSH)的桌面应用中,刷新界面比较方便,但要重启或关闭整个桌面应用,通常需要离开当前窗口,去任务栏或托盘找图标。这多了一步操作,也容易打断连续工作流。
w17her/dsh-power-control 是一个分类为「客户端」的 DSH 插件,它的核心价值是在 DSH 界面里直接提供「刷新界面 / 重启应用 / 关闭应用」的能力,无需切换到任务栏或托盘,适合习惯在单一窗口内完成所有操作的智能体开发者。
插件定位¶
- 插件名称:w17her/dsh-power-control
- 维护者:w17her
- 分类:客户端
- 核心问题:在 DSH 界面里直接控制桌面应用的生命周期,减少窗口切换和寻找托盘图标的成本
核心功能¶
该插件提供三种操作,均通过侧边栏底部的电源按钮进入菜单:
- 刷新界面:在当前 DSH 界面执行
window.location.reload(),从运行中的 Host 重建 Web UI。该操作在任何 DSH 环境中均可用。 - 重启应用:先刷新会话到磁盘,再重启整个桌面应用(同一个可执行文件、同一个配置文件、同一个工作区)。仅支持 Windows 桌面版,因为应用进程树位于桌面端。
- 关闭应用:先刷新会话到磁盘,再退出整个桌面应用。仅支持 Windows 桌面版。
操作细节:
- 菜单向上展开为全屏 Popover,不会受侧边栏滚动容器的裁剪。
- 关闭类操作会弹出确认对话框,明确说明将中断的内容。
- 执行期间用状态遮罩覆盖窗口,若 9 秒后进程仍存活,显示「重载此窗口」的回退链接。
- 颜色和 UI 支持浅色/深色主题,全部使用 DSH 的主题 token(--dsw-alias-*)。
- 界面语言跟随 DSH 当前 locale,支持中文和英文。
安装与启用¶
该插件为本地 DSH Bundle,不是 npm 包,支持两种安装方式。
方式一:使用发布包
1. 下载 dsh-power-control-1.0.0.zip:Releases 下载链接
2. 解压后,将包含 package.json 的文件夹安装到 DSH 插件管理器:
plugin_manager install_bundle target = <路径到解压后的 dsh-power-control 文件夹>
- 安装后 DSH 会将目录链接到当前配置文件并重新加载 Host,侧边栏底部会出现电源按钮。
方式二:克隆仓库
1. 克隆仓库到稳定位置:
git clone https://github.com/w17her/dsh-power-control.git "$env:USERPROFILE\dsh-power-control"
- 使用 DSH 插件管理器安装该文件夹:
plugin_manager install_bundle target = <路径到 dsh-power-control 文件夹>
- 安装完成后,在 DSH 的「设置 → 插件」中可以看到该条目,点击启用即可。
更新克隆版本时,只需执行 git pull。客户端代码会热重载,Host 相关更改需要关闭再重新启用插件或重启应用。
典型用法¶
在 DSH 桌面应用的任意界面中:
1. 找到侧边栏底部的电源按钮(与「设置」相邻)。
2. 点击打开菜单,选择「刷新界面」「重启应用」或「关闭应用」。
3. 对重启与关闭操作,确认弹窗内容无误后点击确认。
适用场景与注意¶
- 适合习惯在单一 DSH 窗口内完成开发与调试,频繁需要重启或关闭桌面应用的场景。
- 插件以当前 dsh 进程的权限运行,执行重启和关闭操作会中断正在运行的任务,确认对话框会明确提示。
- 安装前建议检查源码与许可证(MIT),确保与本地使用策略一致。
- 该插件不依赖外部网络,没有自己的网络客户端,不向任何地方发送数据。
总结¶
w17her/dsh-power-control 用一个电源按钮和菜单,把「刷新界面 / 重启应用 / 关闭应用」三种操作统一到 DSH 界面中,减少了在任务栏和托盘之间切换的成本,适合需要高频重启或关闭桌面应用的开发者。更多细节可访问插件目录页或 GitHub 仓库。