dsh-web-restart — DSH Web 一键重启插件对

为 DeepSeek Harness（DSH）Web GUI 提供一键重启服务的能力，由两个插件组成：

包	角色	作用
dsh-web-restart	host 插件	注册 POST /api/dsh-restart，以 detached 方式执行 ~/.dsh/restart-dsh-web.sh 重启 GUI 进程（仅接受本机回环请求）
dsh-web-restart-client	client 插件	在浏览器注入一个可拖拽的「重启服务」悬浮按钮；拖拽位置自动记忆（localStorage）

特性

• 🖱️ 可拖拽按钮：按住拖动即可改变位置，自动避开聊天输入框的发送按钮；位置跨刷新/重启记忆
• 🔒 安全：POST /api/dsh-restart 仅接受 127.0.0.1 / ::1 回环请求，非本机返回 403；单实例保护，同一时间只允许一次重启
• 🧩 零配置挂载：host 包通过 dsh.bundle.patch（cordis.patch.yml）自动挂载客户端插件，无需手动改 cordis 配置
• ⚡ 重启脚本不存在时返回明确错误（500），避免静默失败
• 🔍 纯本地：不向云端发送任何数据，无 API Key，无外部依赖

架构

浏览器(DSH Web GUI)
  └─ dsh-web-restart-client  ── 悬浮按钮(可拖拽)
        │ 点击 → POST /api/dsh-restart
        ▼
  dsh-web-restart (host, 注入 webServer)
        │ spawn("bash", ["~/.dsh/restart-dsh-web.sh"], { detached: true })
        ▼
  ~/.dsh/restart-dsh-web.sh
        │ 杀旧进程(端口 3080) → 以原方式拉起 `dsh web` → 健康检查(≤90s)
        ▼
  DSH Web 重启完成 → 浏览器刷新页面即可

安装

方式一：DSH 插件市场（推荐）

仓库已打 dsh-plugin topic，被 DSH 插件市场 自动收录后，在 Web GUI 设置 → DSH插件市场 搜索 dsh-web-restart 一键安装。

也可用 dsh CLI 直接安装：

dsh plugin --profile web install Xiaojing-511/dsh-web-restart

方式二：手动安装（无需发布 npm）

git clone https://github.com/Xiaojing-511/dsh-web-restart.git /tmp/dsh-web-restart
cd ~/.dsh/profiles/web          # 换成你要挂载的 profile
npm i /tmp/dsh-web-restart/dsh-web-restart

然后把 dsh-web-restart 加入 profile 的 bundles（~/.dsh/profiles/web/package.json）：

{
  "dependencies": {
    "dsh-web-restart": "file:/tmp/dsh-web-restart/dsh-web-restart"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-web-restart"   // ← 加入
      ]
    }
  }
}

重启 DSH Web 后生效。host 包会自动把客户端插件（dsh-web-restart-client）一并挂载。

前提：需要 ~/.dsh/restart-dsh-web.sh 存在（见下方「重启脚本」），否则接口返回 500。

只使用客户端按钮

cd ~/.dsh/profiles/web
npm i /tmp/dsh-web-restart/dsh-web-restart-client

并在 bundles 中加入 dsh-web-restart-client。此时需要你自己提供一个 POST /api/dsh-restart 接口。

重启脚本

host 插件依赖 ~/.dsh/restart-dsh-web.sh。仓库提供了通用模板：

cp scripts/restart-dsh-web.sh.example ~/.dsh/restart-dsh-web.sh
# 然后编辑脚本，把 NODE / DSH_BIN / PORT 改成你机器上的实际值
chmod +x ~/.dsh/restart-dsh-web.sh

脚本职责：杀掉占用端口的旧进程 → 以与原进程等价的方式重新启动 dsh web → 健康检查（最多 90 秒）→ 日志写入 ~/.dsh/web-restart.log。

使用

1. 打开 DSH Web GUI（如 http://127.0.0.1:3080），左下角出现「重启服务」按钮（默认位置，可拖走）
2. 拖动按钮到任意位置（位置自动保存）；点击触发重启
3. 确认后调用 POST /api/dsh-restart，页面显示「已触发,即将断开…」→「请刷新页面」
4. 重启会中断运行中的会话/任务；会话历史持久化在 ~/.dsh/sessions，刷新后可在历史中恢复

API

POST /api/dsh-restart（仅本机回环可访问）

状态码	含义
200	已触发重启（{ ok: true, message, script }）
403	非本机回环请求
405	非 POST 方法
409	已有一次重启在进行中
500	重启脚本缺失或 spawn 失败（{ error }）

安全与数据披露

• 云端依赖：无（cloud: false）。插件纯本地运行，不向任何外部服务器发送数据
• 网络：仅监听本机回环（127.0.0.1 / ::1），无出站连接
• 凭据：不读取、不存储任何 API Key / Token
• 文件系统：读取 ~/.dsh/restart-dsh-web.sh（不存在时返回 500）；重启脚本按你的配置写日志
• 数据保留：无服务端数据；客户端仅把按钮位置存入浏览器 localStorage
• 完整披露字段见两个包的 package.json → disclosure（DISCLOSURE v0.2 契约）

开发

# 客户端插件
cd dsh-web-restart-client && npm i
# host 插件（依赖客户端，file: 方式本地关联）
cd dsh-web-restart && npm i

License

MIT