dsh-power-xc
中文 | English
DSH 电源管理插件 —— 为 DeepSeek Harness 提供优雅的重启和关机功能，支持 Web UI 一键操作。
本插件基于 dsh-power-button 开发，在其基础上进行了改进和优化。
✨ 核心特性
🔄 刷新功能
- 页面刷新：刷新当前浏览器页面，不重启 DSH 进程
- 快速恢复：当页面状态异常时，可通过刷新快速恢复
- 轻量操作：与重启不同，刷新不会重载插件和配置，仅刷新浏览器页面
🔘 侧边栏电源按钮
- 集成位置：位于侧边栏底部，与设置按钮并列
- 主题感知：自动适配当前主题风格
- 一键访问：无需命令行，点击即可操作
🔄 重启功能
- 平滑过渡：Windows 风格全屏过渡动画
- 自动重连：重启完成后页面自动刷新
- 会话保持：优雅处理会话刷新，避免数据丢失
- 独立引擎：内置重启引擎，无外部依赖
⏻ 关机功能
- 确认对话框：防止误操作，默认焦点在取消按钮
- 进度展示：全屏显示关机进度
- 安全退出：确保所有资源正确释放
🛠️ 重启引擎设计
- 自包含：无需 PowerShell、无需 taskkill
- 独立进程：派生分离的 .cjs helper 进程
- 端口等待：等待旧进程退出并释放端口
- 命令保留：保持原 execPath/execArgv/argv/cwd
📣 命令支持
- 模型工具：
restart_harness 工具，可在对话中调用
- 斜杠命令：
/restart 和 /shutdown 命令
- 兼容性：自动跳过已被其他插件注册的命令
🌐 国际化
- 中英文支持：跟随 profile 的
locale.preference
- 本地化通知：重启/关机状态提示
🧹 自动清理
- 日志清理：自动清理 7 天前的 restart-helper 日志
- 资源管理：避免日志文件堆积
📦 安装
# 使用 DSH CLI
dsh plugin --profile web add dsh-power-xc
# 或使用 npm
npm install dsh-power-xc
安装后重启 DSH，侧边栏底部将出现电源按钮。
🎮 使用方式
方式一：Web UI
- 点击侧边栏底部的电源按钮
- 选择「刷新」「重启」或「关机」
- 确认操作
方式二：斜杠命令
- 输入
/restart 重启 DSH
- 输入
/shutdown 关闭 DSH
方式三：模型工具
在对话中请求模型重启 DSH，模型会调用 restart_harness 工具。
🔄 刷新 vs 重启
| 操作 | 刷新 | 重启 |
|---|
| 重载插件 | ❌ | ✅ |
| 重载配置 | ❌ | ✅ |
| 进程重启 | ❌ | ✅ |
| 页面刷新 | ✅ | ✅ |
| 适用场景 | 页面状态异常 | 配置/插件变更 |
为什么需要刷新功能？
- 当页面出现显示异常或响应迟缓时，刷新可以快速恢复
- 修改 DSH 设置后，刷新可以立即看到效果（部分设置需要重启）
- 相比重启，刷新是轻量级操作，不会中断当前的 agent 任务
⚙️ 工作原理
用户点击重启
↓
显示过渡动画
↓
启动独立 helper 进程
↓
等待旧进程退出
↓
释放端口
↓
以原命令行重新拉起
↓
页面自动重连
🔒 安全设计
- 分离进程：helper 独立于主进程运行
- 超时保护：30 秒超时机制
- 状态监控：健康检查端点
- 优雅退出：会话刷新不会阻塞重启
📄 许可证
MIT
🔗 链接
