自升级助手 snow930/dsh-self-upgrade

dsh-self-upgrade

DSH（DeepSeek Harness）自升级插件：在 Web GUI 设置页添加「系统更新」区块，一键检查版本并执行升级。

功能

- 版本检查：自动对比运行中的 DSH 宿主版本与 npm registry 最新版
- 一键升级：点击按钮执行 npm install -g @deepseek-ai/dsh@latest
- 实时进度：SSE 流式推送安装日志，无需刷新即可看到每行输出
- 自动重启：安装完成后自动停止旧实例、等待端口释放、后台拉起新实例、刷新页面
- 安全回滚：npm 安装失败时旧实例不受影响，天然回滚

安装

推荐：从 npm 安装：

dsh plugin --profile web add dsh-self-upgrade

或手动编辑 profiles/web/package.json：dependencies 增加 "dsh-self-upgrade": "^0.1.0"、dsh.profile.bundles 追加 "dsh-self-upgrade"，然后在 profiles/web 下 pnpm install。

本地开发（维护者迭代）：link 到本地检出，修改源码后重启 DSH Web 即生效，无需重新发布 npm：

dsh plugin --profile web add link:~/git/dsh-self-upgrade

工作原理

服务端（lib/index.js）

Cordis 插件，注册 4 个 loopback-only HTTP 端点：

| 端点 | 方法 | 功能 |
| /api/self-upgrade/check | GET | 返回 {current, latest, hasUpdate} |
| /api/self-upgrade/run | POST | 生成升级脚本并以 detached 进程执行 |
| /api/self-upgrade/status | GET | 返回阶段推断 + 日志尾部（轮询用） |
| /api/self-upgrade/stream | GET | SSE 实时流式推送日志（安装阶段用） |

升级脚本流程：npm install -g → kill 旧进程 → 等端口释放 → setsid nohup dsh web。

客户端（lib/client.js）

通过 settings.section slot 注册设置页一级区块「系统更新」。安装阶段用 EventSource 接收 SSE 实时日志；重启阶段（旧进程已死）自动 fallback 到轮询。

安全

- 所有端点仅接受 loopback（127.0.0.1 / ::1）请求
- 升级脚本内容由服务端固定生成，不接受任意命令注入
- 目标版本白名单校验（仅 semver 格式）
- npm 安装失败 = 旧进程不动，零影响

文件结构

dsh-self-upgrade/
├── package.json # 插件清单 + dsh.client 声明 ├── cordis.patch.yml # loader entry 注册 ├── lib/ │ ├── index.js # 服务端 cordis 插件 │ └── client.js # 客户端 settings.section UI └── README.md

卸载

从 profile package.json 删除 dsh-self-upgrade 依赖和 bundles 条目，pnpm install 即可。