dsh-self-update
English | 简体中文
DeepSeek Harness git 源码安装版的应用内自更新插件——附可选的原生 macOS 外壳。
这是什么？
如果你是以 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 <你的 deepseek-harness 检出目录>
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 两步换成了空跑命令。
