GodCC6/dsh-updater

dsh-updater

CI
License: MIT
Node

DeepSeek Harness (DSH) 的自动更新插件 —— 让 git checkout 或 npm 全局安装的 dsh 及其 integration 仓库保持最新，仅快进式拉取、自动回滚，绝不意外重启。

自动更新 dsh 的插件：同时支持 git checkout 与 npm 全局两种安装形态，并覆盖 ~/.dsh/integrations/ 下的 integration 仓库（兼容 / 与 /repo/ 两种布局）。

功能

- 状态检查 dsh_update_status：安装形态探测（git / npm / 未知）、harness 本体与各 integration 仓的 behind 比对、进行中/最近一次更新任务的进度与结果。
- 手动更新 dsh_update_run：后台 job 执行更新。git 形态为 git pull --ff-only → pnpm install --frozen-lockfile → pnpm build；integration 仓逐仓 ff-only、互不影响。
- 取消更新 dsh_update_cancel：随时取消进行中的更新，自动回滚已完成的部分步骤，后台 job 结算为 killed。
- 自动模式（可选，autoApply: true）：定时检查发现新版且系统空闲（无运行 job 且会话静默 ≥ idleQuietMs）时自动应用；diverged / dirty 的目标只报告不动；同一版本失败后不重复尝试。
- Web 面板 Settings → Updater：状态胶囊、检查/一键更新/取消按钮、pendingRestart 重启横幅（零构建；老宿主自动禁用，Host 侧 agent 工具不受影响）。

安全模型

- 检查与更新分离：默认只提示「有新版」，执行更新需显式调用 dsh_update_run；自动模式默认关闭。
- 只快进不合并：pull 仅 --ff-only，本地分叉（diverged）直接报告，绝不自动 merge/rebase。
- 失败即回滚：install/build 任一步失败自动 git reset --hard 回到更新前 commit，绝不留半更新状态。
- 绝不代重启：更新完成后仅置 pendingRestart 提示，重启 dsh 的动作永远在你手里。
- 零特权、零依赖：无 sudo，只写用户目录；纯 Node 内置模块，无任何第三方依赖。

安装

从 GitHub 安装
dsh plugin --profile web add github:GodCC6/dsh-updater

或本地路径安装
dsh plugin --profile web add ~/Projects/dsh-updater

配置

默认值定义在 cordis.patch.yml 的 patch 行中：

| 字段 | 默认值 | 说明 |
| --- | --- | --- |
| checkOnStart | true | 插件启动时是否立即检查更新 |
| checkIntervalMinutes | 30 | 定时检查间隔（分钟） |
| autoApply | false | 检测到更新后是否自动应用 |
| idleQuietMs | 120000 | 空闲静默阈值（毫秒） |
| npmDistTag | latest | npm 形态更新所用的 dist-tag |
| integrationsDir | ~/.dsh/integrations | integrations 目录路径 |

Roadmap

- [ ] npm 形态自动更新（stage → 退出后原子替换 → 失败回滚）

开发

npm test   # node --test,零第三方依赖,Node >= 20

设计文档见 docs/superpowers/specs/，各里程碑实现计划见 docs/superpowers/plans/。

License

MIT