DeepSeek Harness (DSH) 采用插件化架构，开发者常需要快速查看账户余额或完整关闭 Harness 进程。dsh-system-control 插件将这两个核心功能直接嵌入到左侧边栏中，避免了使用浮层带来的遮挡和干扰。
插件简介¶
这是一个由 lnetrit-alt 维护的 DSH Web 插件，定位为侧边栏组件。它主要解决两个痛点：一是提供实时的 API 余额显示，二是提供优雅的全机关机入口。插件遵循 MIT 许可证。
核心功能¶
1. 侧边栏嵌入¶
插件注册在 sidebar.footer.action，渲染位置位于左侧边栏的设置按钮上方。它不使用卡片样式，直接跟随主题渲染，不会遮挡或被裁剪。
2. 实时余额显示¶
余额数据来源于 https://api.deepseek.com/user/balance。
* 自动刷新：每次模型 API 调用后自动刷新，同时每 25 秒轮询一次。
* 手动刷新：点击余额文本即可触发刷新。
* 容错处理：获取失败时显示 获取失败，点击可重试。
3. 极简关机按钮¶
采用黑色线框风格的电源图标（无填充、无圆圈）。点击后弹出确认对话框，确认流程如下：
1. 调用 sessions.flush 刷新所有会话数据，确保持久化。
2. 调用 appExit(0) 优雅退出 Harness，包括停止 Web UI、终止子进程并销毁进程树。
3. 硬回退机制：如果在 1.5 秒内优雅退出未完成，强制执行 process.exit(0)，确保 Web UI 关闭。
4. 布局适配与清理¶
- 折叠侧边栏支持：在 56px 宽的折叠侧边栏模式下，确认提示会自动收缩为
退出？。 - 视觉清理：激活该插件时，会隐藏官方 Cordis 面板图标，保持侧边栏整洁。
安装与启用¶
目前插件通过 Git 源安装。本地开发同样支持。
dsh plugin --profile web add git+https://github.com/lnetrit-alt/dsh-system-control.git
重启 Harness 或刷新页面后生效。客户端部分支持热重载。
典型用法¶
- 查看余额：在侧边栏底部查看
余额 ¥0.69等信息，货币符号根据 API 返回的 CNY/USD/EUR/GBP 自动映射。 - 手动刷新：点击余额文本，立即获取最新数值。
- 关闭 Harness：点击电源图标，确认后系统将保存会话并退出 Harness 进程。
适用场景与注意¶
该插件属于 UI 表面层，不注册模型可见工具，不会改变 Agent 行为，模型无需感知其存在。
安装使用时需注意以下事项：
* 依赖服务：需要 DSH 启动器提供的 appExit 服务。如果是在非官方 dsh 或 dsh web 环境中嵌入运行，关机可能会报错而无法执行。
* 权限风险：插件以当前 DSH 进程权限运行，请从可信源安装并检查源码。
* 发布状态：NPM 发布待定（需配置账户 2FA），目前仅支持 Git 源安装。
总结¶
dsh-system-control 通过侧边栏嵌入的方式，提供了非侵入式的余额监控和可靠的关机功能。对于需要频繁管理账户状态和进程的 DSH 用户，这是一个提升操作效率的实用工具。
- 项目主页：https://github.com/lnetrit-alt/dsh-system-control
- 目录页：https://www.skillhub.cn/plugins/lnetrit-alt/dsh-system-control
