dsh-version-autoupdate

DSH（DeepSeek Harness）双面 Cordis 插件：Web UI 版本胶囊 + 同源自动更新（npm 或 GitHub checkout，严格隔离）。

0.3.61：兼容与更新结果

不绑定 DSH 的精确版本或源码 SHA。沿用 Cordis 4.x 与注入服务接口，声明宽版本范围，并包含目前 0.2.0 / 0.2.1 的预发布版本。DSH 版本号改变不会触发运行时白名单拒绝；接口发生实质变化时仍可能需要适配，不承诺任意未来版本。

• npm 安装前核对包管理器全局目录与正在运行的 DSH；安装后从同一目录读取版本并核对目标。
• 要求重启时，状态保持 restarting，由独立 helper 的健康检查结果决定成功或失败；不重启时明确表示仅安装完成。
• GitHub 重启保留 host、port、trusted-host、profile、patch 等原 CLI 参数。
• GitHub 手动回滚在宿主退出后恢复旧 Git ref、构建产物并重建依赖链接，健康检查通过后才报告 rolled_back；保留原操作备份用于定位。

Host 运行时以 lib/*.js 为维护源；src/dsh-restart.mjs 与 src/offline-install.mjs 通过 npm run build 同步。无需为了旧 TypeScript 树重新生成运行时。

功能概览

能力	说明
版本胶囊	会话头部显示运行/已装/最新版本、安装来源、检测通道、错误信息
同源检测	自动识别 npm / github / unknown；GitHub 安装只查 GitHub，npm 安装只查 npm
镜像 + 官方	默认 auto：优先镜像；网络/限流失败时回退官方源；认证失败不回退（重新询问密码或选官方）；完整性错误不回退
MCP 更新	dsh_update_check / dsh_update / dsh_update_status / dsh_update_watch / dsh_update_rollback
GitHub staging	下载 → 校验 → staging 构建 → promote 到 live（含 pnpm rebuild 原生模块）→ 版本变化时默认重启。若桌面 Watchdog（watch-dsh-web）在跑，插件只退出并写 outcome，由 Watchdog 拉起，避免抢占 3080
npm 更新	全局 npm install -g @deepseek-ai/dsh@<version>（走官方 registry，不弹镜像密码）

UI 不再提供安装/重启按钮；写入类 HTTP 端点（/install、/start-update、/restart）返回 410 Gone，提示使用 dsh_update 工具。

HTTP API（只读）

路径	方法	说明
/dsh-version-updater/status	GET	同源 status（含 source / transport / updateAvailable）
/dsh-version-updater/check	POST	纯检测，不安装、不重启、不询问密码
/dsh-version-updater/install	*	410 — 请用 dsh_update
/dsh-version-updater/start-update	*	410
/dsh-version-updater/restart	*	410

MCP 工具

工具	作用
dsh_update_check	同源只读检测
dsh_update	启动同源更新；restart / force；镜像密码由工具代码读取，缺失则弹出 userQuestions UI
dsh_update_status	即时快照（用户追问时）
dsh_update_watch	默认进度循环：阻塞到启动 / 1 分 / 5 分 / 每 10 分 / 终态，再让 Agent 用 summary 汇报
dsh_update_rollback	npm 回滚到 backup 版本；GitHub 回滚到记录的 live root

约束： 不接受 caller 指定的 source；检测类调用不触发密码交互；镜像密码存于 $DSH_HOME/version-autoupdate/credentials.json。

自然语言怎么用

插件会向 Agent 注入指引。新开对话后可直接说：

检查一下 DSH 有没有更新

有更新的话就更新 DSH，先不要重启；告诉我进度

更新 DSH 并重启

强制重新安装当前最新版（force=true）并重启，然后用 dsh_update_status 报告进度

回滚刚才的 DSH 更新

Agent 应自动调用 dsh_update_check → dsh_update → 循环 dsh_update_watch（直到 done）。用户追问进度时用 dsh_update_status。若模型没点到工具，可点名：调用 dsh_update，参数 force=true，restart=true。

配置（cordis.patch.yml）

字段	默认	说明
updatePolicy	platform	Windows 可装可重启；Linux/macOS 仅检测。full / detect-only 可覆盖
channel	preview	stable 只追正式版
packageManager / packageManagerPath	npm	npm 更新用的包管理器
installTimeoutMs	1200000	npm 全局安装超时（毫秒）
autoRestart	false	旧向导用；MCP 显式 restart: true 时强制重启
force	false	/status 绕过 registry 缓存

本地开发（Windows）

插件源码目录：D:\0HAN\Work\dsh-plugins\dsh-version-autoupdate

npm install --legacy-peer-deps
npm test
D:\0HAN\Work\dsh-plugins\sync-to-dsh.ps1

然后 关闭 Watchdog → 双击「DSH Web」 重启 DSH（不要用插件仓库 UI 的 detached 重启）。

验证

npm test
npm run build
npm pack --dry-run
git diff --check

许可

MIT