Shane-Jay/dsh-self-update

dsh-self-update

DeepSeek Harness git 源码安装版的应用内自更新插件——附可选的原生 macOS 外壳。

npm version
License: MIT
DSH core

这是什么？

如果你是以 git 源码方式跑 DeepSeek Harness（git clone + pnpm dsh web）——自部署用户几乎都是这样——那么它没有任何内置的更新途径。每出一个新版本，都要手动 git pull、pnpm install、pnpm build、重启服务；一旦更坏了，还得自己翻旧提交回退。

dsh-self-update 把这整个循环变成一个按钮。 它是一个 harness 插件：

- 后台静默检查（默认 6 小时一轮），也可随时手动检查——设置页或 macOS 菜单栏都行；
- 有新版本时侧栏浮出一行「新版本 x.y.z ›」，点开是更新页：版本对照 + 将要执行的命令，明明白白；
- 一键安装：git pull --ff-only → pnpm install → pnpm clean → pnpm build:official（官方品牌构建），逐步实时进度——clean 一步清掉 gitignore 的旧构建产物，跨大版本升级不再被残留毒化（旧版 harness 没有 clean script 时自动跳过）；
- 工作区有未提交改动时拒绝更新——绝不替你丢改动；
- 本地分叉不再是死路：更新页列出本地独有的提交，一键「备份并对齐远端」——先把你的提交存成 local-backup- 分支，再硬对齐远端继续更新（工作区脏时拒绝执行）；
- 失败时一键回滚（UI 挂掉时还有命令行兜底）；
- 认得出「进程已过期」：进程起来时就记下检出的 HEAD，之后磁盘上的代码一往前走——自己装的、你手动 git pull 的、别的工具改的都算——界面直接报「需重启」，而不是悄悄用新前端配旧宿主；
- 重启闭环：进程以退出码 75 退出（"请重启我"），交给 systemd / PM2 / 自带 macOS 外壳拉起；一个 supervisor 都没有时，macOS/Linux 上它会自己派生副本接管——裸终端里的 pnpm dsh web 也能「立即重启」。

不适用于你，如果你是 npm i -g @deepseek-ai/dsh 全局安装的：没有 git 工作副本可更新，本插件会整体自动隐藏。请改用 npm 系更新器（如 dsh-update-checker）。

安装（任何平台）

cd
pnpm dsh plugin --profile web add dsh-self-update

重启一次 dsh 服务即生效。零配置——插件以进程工作目录为 harness 检出（不一致时用插件 config repoRoot 覆盖）。

让「立即重启」闭环

「立即重启」按钮会让进程以退出码 75 退出。让你的 supervisor 认识它：

| 运行方式 | 配置 |
|---|---|
| systemd | RestartForceExitStatus=75 |
| PM2 | autorestart: true（默认即可） |
| macOS 外壳（见下） | 内置 |
| 裸终端 / 没有 supervisor | 内置（macOS/Linux 自拉起；Windows 手动） |

没探到 supervisor 时，插件会先派生一个分离的 /bin/sh 助手：等旧 pid 真的死掉（端口释放）后，用完全相同的 node 命令行 exec 一份自己——裸终端跑的 pnpm dsh web、乃至孤儿进程，都能自己起回来。Windows 没有这条路：按钮改叫「停止服务」，之后请手动再跑一次 pnpm dsh web。更新页会写明这三种里将发生哪一种。

探测顺序：先看 DSH_SELF_UPDATE_SUPERVISOR，再认 systemd 的 INVOCATION_ID，再认 PM2 的 pm_id/PM2_HOME。如果你的 supervisor 本来就认退出码 75，请把 DSH_SELF_UPDATE_SUPERVISOR 设成任意值（如 custom）——否则插件会背着它自拉起。none/0/false 表示相反的意思：没人会拉起我。

macOS 外壳（可选）

原生 Swift + WKWebView（非 Electron）的 DSH.app，托管 dsh 服务：点图标即界面，关窗不停服务，⌘Q 才停。菜单栏有 「检查更新…」，直接弹出应用内更新页；服务以 75 退出时自动拉起并重载页面（拉起时设 DSH_SELF_UPDATE_SUPERVISOR=macapp，插件据此把重启交给外壳）。对接管来的服务（端口上已在监听、并非外壳启动的那种）现在也守着：它一旦消失，外壳先等 45 秒看它是否自己回来（自拉起的情形），否则就起一份自己的并接管。已适配 harness 0.1.2 引入的 web 鉴权：外壳自动抓取服务启动时打印的带 token URL，内嵌页面无需手动登录。

node macapp/build-mac-app.mjs        # 需要 Xcode 命令行工具
输出 ~/Applications/DSH.app

首次打开需右键 → 打开（ad-hoc 签名，未做 Apple 公证）。

与同类项目的区别

| | 更新对象 | 平台 | 自动重启 |
|---|---|---|---|
| dsh-update-checker | npm 包 | 重启仅 Windows | ✅（Win） |
| dsh-update-copilot | 插件为主，core 只报告 | 全平台 | ❌ |
| dsh-self-update | harness git 工作副本本体 | 全平台（重启含 macOS/Linux） | ✅（退出码 75；macOS/Linux 无需 supervisor） |

退出码 75 的重启契约正是社区一直在向 harness core 呼吁的东西（见上游讨论 #1231、#2717）——本插件是它的一个可用实现。

接口契约

- HTTP — /self-update/api/update/{status,check,install,realign,rollback,restart}；写路由要求 Content-Type: application/json + 本机 Origin（CSRF 防线）。
- 弹层事件 — 在 window 上派发 dsh-self-update:open（detail: { check: true } = 打开即检查）。macOS 菜单项就是通过 evaluateJavaScript 派发它。
- 运行时 — GET /update/status 带 runtime: { pid, startedAt, sha, shortSha, stale, supervisor, restartMode }。stale = 磁盘上的 HEAD 已不是本进程启动时那个（界面按「已装好、待重启」处理）；supervisor ∈ macapp | systemd | pm2 | custom | none；restartMode ∈ supervisor | self-respawn | manual。
- 重启 — POST /update/restart 先答 { ok, mode, exitCode }，约 300ms 后才退出；mode 即上面的 restartMode。退出码 75 = 请求重启，其他一律按崩溃处理。之后浏览器轮询 status，只有换了 pid 才刷新（最多等 120 秒）。
- 状态 — 落盘 ~/.dsh-self-update/update-state.json；自拉起助手的输出在 ~/.dsh-self-update/respawn.log。

UI 挂掉时的兜底

更新后 dsh 起不来（插件与新版本接缝不兼容）时，Web UI 连同回滚按钮一起没了。从命令行退：

node scripts/rollback-harness.mjs          # 目标取状态文件里的 previousSha
node scripts/rollback-harness.mjs --sha    # 或自己指定提交

更新器每次安装前都会先记下 previousSha，就是为了这一刻。

开发

Sibling 布局（与 dsh 插件生态同款）：本仓库必须与 deepseek-harness 检出为同级目录——@deepseek-ai/* 开发依赖是 link:../deepseek-harness/...。

pnpm install
pnpm typecheck && pnpm test && pnpm build

updater 测试跑在真实（离线）git 仓库上，只有 install/build 两步换成了空跑命令。

License

MIT

[](https://github.com/deepseek-ai/deepseek-harness)