前言¶

DSH 生态强调「一切皆插件」。社区插件目录是独立站点，与 DeepSeek / 幻方无官方从属关系，也不是官方应用商店。

对使用 DSH 的开发者来说，插件装完并不是运维工作的结束。安全重启、版本升级、健康检查、备份恢复、供应商额度查询、Linux 文件权限维护，这些问题都需要一个能反复操作、能留痕、能避免误操作的入口。下面介绍 gehennawu/dsh-service，它是面向 DSH Web 的运维面板。

这是什么¶

• 插件名：gehennawu/dsh-service
• 维护者：gehennawu
• 许可证：MIT
• 定位：DSH Web 运维面板：安全重启、健康监控、备份和 Linux 权限维护。
• 环境要求：Node.js >=22

简单说，它把 DSH Web 日常运维中高频发生的操作集中到一个面板里：先看状态，再执行重启、备份、额度查询、技能与子代理配置，最后处理会话与插件健康。

核心功能¶

安全重启¶

dsh-service 提供安全重启能力。重启前会检查当前是否存在活跃 Agent、后台任务或终端类工作；如果检测到运行中工作，会自动拒绝重启。

也可以在对话中直接输入 /restart 触发安全重启：

/restart

这个动作不是简单结束进程，而是把「现在能不能重启」作为前置判断。

版本管理与一键升级¶

版本与更新部分会检查 npm 的 latest 和 next 双 tag：

latest
next

当检测到新版本时，会行内展开版本对比；执行一键升级后会自动重启。

健康诊断¶

健康诊断用于查看当前 DSH 的运行状态，包括：

• 运行时间
• 内存
• 会话数
• 活跃 Agent
• 后台任务

此外，还可以执行文件权限深检与修复。如果当前环境疑似手动启动，健康诊断会提示重启无保障；退出后不会自动拉起。

额度查询¶

额度查询用于查看供应商窗口使用情况，包括：

• 供应商窗口百分比
• 独立进度条
• 重置时间
• 强制刷新

查询结果会缓存 60 秒。失败时按 30 秒 ×2 指数退避，封顶 15 分钟。未适配供应商不会发起请求。

凭据写入 DSH 凭据库：

$DSH_HOME/.credentials.yaml

API key 只在宿主进程内解析，浏览器仅收到归一化窗口数据。

备份管理¶

备份管理支持创建 .tar.gz 归档，并进行导出下载、导入上传、删除操作。

导入或恢复前会执行完整性检查：

• 校验 gzip/tar
• 校验路径
• 校验条目类型

只接受：

sessions
三份允许配置
profiles/<name>/package.json

并拒绝：

• 越界路径
• 链接
• 特殊文件
• 未知内容
• 损坏归档
• 非法 profile 清单

恢复预检还会校验归档 SHA-256 与当前目标指纹。如果发生漂移，会拒绝执行。

技能管理¶

技能管理按三档状态组织本地技能：

• 自动加载
• 仅手动调用
• 完全停用

双开关可以直接改写 SKILL.md frontmatter，用于调整技能调用方式。

子代理模型¶

子代理模型支持三种模式：

• 初始
• 跟随主模型
• 自定义

还可以配置回退模型与思考等级。

路由配置写入：

$DSH_HOME/dsh-service-subagent-route.json

写入时使用原子写入，并设置 0600 权限。配置完成后可以一键重置。

任务通知¶

任务通知用于在关键事件发生时提醒使用者，包括：

• 总开关
• 任务完成
• 授权与提问
• 输入框铃铛显隐

会话管理¶

会话管理支持在以下视图之间筛选：

• 全部
• 仅归档
• 已删除

可以批量选择会话，并执行：

• 导出
• 归档
• 删除

插件健康检查与兼容性扫描¶

插件健康检查会检查插件异常状态。手动停用的插件一律不算异常。

插件兼容性扫描为纯本地扫描，结果缓存，零网络。

移动端适配与探活¶

dsh-service 提供移动端适配，并提供 /healthz 探活能力：

/healthz

安装与启用¶

先检查本机 Node 版本：

node --version

要求满足：

>=22

已核实资料未提供官方安装命令，因此本文不拼接安装命令。安装前请查看 GitHub 仓库当前说明，并确认本机 DSH 插件机制。

安装或启用后，可以在插件配置中开启需要的能力。关闭对应插件配置开关时，会隐藏界面、停止轮询，并让宿主拒绝对应能力；概览与重启固定保留。

典型用法¶

1、触发安全重启¶

在对话中输入：

/restart

如果检测到运行中工作，会自动拒绝。

2、检查版本并升级¶

进入版本与更新区域，检查 npm 的 latest 和 next tag。有新版本时，行内展开对比，确认后执行一键升级，升级后自动重启。

3、执行健康诊断¶

进入健康诊断，查看运行时间、内存、会话数、活跃 Agent 与后台任务。需要时执行文件权限深检与修复。

4、查询供应商额度¶

进入额度查询，查看供应商窗口百分比、独立进度条和重置时间。需要时点击强制刷新。

5、创建备份¶

进入备份管理，创建 .tar.gz 归档。可以导出下载、导入上传或删除备份。恢复前会执行完整性检查与恢复预检。

6、管理技能¶

进入技能管理，将本地技能设置为自动加载、仅手动调用或完全停用。双开关直接改写 SKILL.md frontmatter。

7、配置子代理模型¶

进入子代理模型，选择初始、跟随主模型或自定义模式。需要时配置回退模型与思考等级。

8、处理会话¶

进入会话管理，在全部、仅归档、已删除之间筛选，批量选择后执行导出、归档或删除。

适用场景与注意¶

适合以下场景：

• 需要经常重启 DSH Web 服务
• 需要查看服务健康状态
• 需要管理备份与恢复
• 需要查询供应商额度
• 需要维护 Linux 文件权限
• 需要管理技能、子代理与会话

需要注意的是，dsh-service 会操作本机 DSH 状态，包括凭据、备份、配置、权限和插件健康。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

链接¶

• GitHub：https://github.com/gehennawu/dsh-service
• 目录页线索（已核实资料中标注为线索，未出现在已抓取资料中）：https://www.skillhub.cn/plugins/gehennawu/dsh-service