DeepSeek Harness (DSH) 是一个用于智能体开发的框架。在开发过程中，重启服务或检查版本更新是常见需求。下面介绍 dsh-admin，一个提供这些功能的 Web GUI 插件。
这是什么¶
dsh-admin 是一个 DeepSeek Harness Web GUI 管理插件。由 xiaokang6 维护。它旨在解决手动重启和自动版本检查的问题，通过嵌入 UI 集成到 Web 界面中。
核心功能¶
手动重启¶
在会话头部（会话日志旁边）提供一个按钮。点击后，它会执行 systemd-run + dsh-plugin-op restart，按照本地惯例脚本停止 systemd、清理 :3080 的孤儿实例、启动服务并进行健康检查。
自动版本检查¶
插件会自动比较已安装的 @deepseek-ai/dsh 与 npm latest 标签。检查在加载时进行，随后每 6 小时进行一次。面板显示当前/最新/上次检查的版本，以及一个状态点（绿色=最新，黄色=有更新，红色=检查失败）。
一键更新¶
当有新版本可用时，会出现一个蓝色的“更新到最新”按钮。它运行 npm install -g @deepseek-ai/dsh@latest（使用 --allow-scripts 以处理原生依赖），然后自动重启服务。
嵌入式 UI¶
插件没有独立的页面：
- 顶部右侧的头部按钮 🟢 0.1.1（会话头部工具槽）-> 点击打开悬浮面板（z-index 9999）：版本状态、检查按钮、更新按钮（如果可用）、服务信息和重启按钮。
- 设置 -> DSH Admin 全页视图。
安装与启用¶
使用插件管理器安装：
dsh plugin --profile web add xiaokang6/dsh-admin
安装后，确保 ~/.dsh/profiles/web/cordis.patch.yml 包含 dsh-admin 插入，以便插件加载。
典型用法¶
- 通过 UI 检查： 点击头部按钮
🟢 0.1.1打开悬浮面板并检查状态。 - 通过设置： 导航到设置 -> DSH Admin 查看完整页面视图。
- 通过 API： 使用
POST /plugin/dshadmin/update配合 body{"confirm":true}进行更新。
适用场景与注意¶
- 依赖： 需要 DeepSeek Harness (
@deepseek-ai/dsh) 通过 npm 安装以及 Linux + systemd。 - 重启优先级：
systemd-run+dsh-plugin-op restart（隔离 cgroup）- 普通
dsh-plugin-op restart systemctl --no-block restart dsh- socket-pid kill + 重新启动
- 热重载： 客户端更改通过 HMR 自动拾取；主机更改需要服务重启。
- 权限： 插件以当前 dsh 进程权限运行。安装前请检查源码与许可证。
总结¶
dsh-admin 通过手动重启、自动版本检查和一键更新简化了 DSH 的维护。相关目录和源代码可在 GitHub 上找到。
