DeepSeek Harness (DSH) 采用了插件化架构。在开发或调试过程中，调整配置、重载插件或重启 Harness 进程是常见需求。如果依赖命令行操作，不仅中断当前会话，还可能丢失部分上下文。本文介绍的 dsh-power-xc 插件旨在解决这一问题，为 DSH 提供了优雅的重启、关机及页面刷新功能，支持通过 Web UI 一键操作。
插件定位¶
dsh-power-xc 是 DeepSeek Harness 的电源管理插件，由开发者 xchannel1987 维护，采用 MIT 许可证。它通过在侧边栏集成电源按钮，配合独立的重启引擎，实现了对 DSH 进程的安全控制。
核心功能¶
该插件主要提供以下能力：
- 页面刷新：刷新当前浏览器页面。与重启不同，刷新不会重载插件和配置，仅刷新页面。适用于页面状态异常时的快速恢复。
- 侧边栏电源按钮：集成在侧边栏底部，与设置按钮并列。按钮样式会自动适配当前的主题风格。
- 重启功能：具备 Windows 风格的全屏过渡动画。重启完成后页面会自动刷新，且会重载插件和配置。插件内置了独立的重启引擎，不依赖外部工具（如 PowerShell 或 taskkill）。
- 关机功能：提供确认对话框，默认焦点在取消按钮，防止误操作。关机过程会显示全屏进度，并确保资源正确释放。
- 斜杠命令支持：支持
/restart重启 DSH 和/shutdown关闭 DSH。 - 模型工具支持：提供了
restart_harness工具，可以在对话中请求模型调用以重启 Harness。 - 日志清理：自动清理 7 天前的
restart-helper日志，避免文件堆积。
安装与启用¶
确保你的 DSH 版本满足要求（DSH ≥ 0.2.0-rc.1）。0.2.0 版本起，插件依赖 @deepseek-ai/cordis 提供的 Context，因此安装前请检查宿主版本。
使用官方 CLI 进行安装：
dsh plugin --profile web add dsh-power-xc
安装完成后重启 DSH，侧边栏底部将出现电源按钮。
典型用法¶
插件提供了三种操作方式：
-
Web UI 操作
点击侧边栏底部的电源按钮，选择「刷新」、「重启」或「关机」，并确认操作。 -
斜杠命令
在输入框中直接输入/restart重启 DSH，或输入/shutdown关闭 DSH。 -
模型工具
在对话中请求模型重启 DSH，模型会调用restart_harness工具执行操作。
适用场景与注意事项¶
- 刷新 vs 重启：当页面出现显示异常或响应迟缓时，可使用刷新功能快速恢复；当需要重载插件或配置时，必须使用重启功能。
- 进程权限：插件以当前 DSH 进程的权限运行，这意味着它无法执行需要更高权限的系统操作。
- 安全设计：重启过程采用独立 helper 进程，设置了 30 秒超时机制和健康检查，支持优雅退出。
- 源码审查：虽然插件采用 MIT 许可证，但在安装前建议检查其源码，确保符合你的安全与合规要求。
总结¶
dsh-power-xc 为 DeepSeek Harness 提供了一套轻量且安全的电源管理方案。通过 Web UI 和命令行的结合，它简化了开发过程中的重启与关机流程，提升了工具的使用体验。
