SuCriss/dsh-version-update

README 摘要

dsh-version-update English 中文 DeepSeek Harness Web GUI 的「版本更新」设置菜单：在设置面板左侧多出一个一级菜单，显示当前安装的 @deepseek-ai/dsh 版本，读取 npm registry 上的发布通道，一键更新到所选版本，并在安装完成后自动重启宿主进程、重新载入页面。 功能 - 设置面板一级菜单「版本更新」（ settings.section 槽位，order 140），左侧带更新图标。 - 显示当前安装版本与安装目录；打开页面即自动检查一次，也可手动「检查更新」。 - 列出 npm dist-tag 通道（ latest 稳定版 / next 预发布）及各自版本，并标注是否比本机版本新。 - 列出全部已发布版本，可任选一个作为更新目标。 - 一键更新：宿主进程后台执行 npm install -g @deepseek-ai/dsh@ ，页面每 1.5 秒轮询任务状态并展示实时安装日志。 - 安装成功后自动重启：5 秒倒计时（可取消）后交接端口拉起新进程，页面等新进程应答再 location.reload() 。 为什么必须重启，而不是只刷新 npm install -g 覆盖的正是运行中 dsh web 用来提供前端资源的那个包目录： - 已打开的页面持有 /assets/index- .js 这类内容寻址的 URL。新版本的 hash 不同，旧文件在磁盘上已不存在，而 SPA 兜底会把这些请求当作路由 miss、回 200 + text/html 。浏览器按 JS 模块解析一份 HTML，直接失败。 - 宿主的 bundle watcher 会发现几十个 client bundle 内容变了，通过 /plugins/events 发出 rebuilt 帧，浏览器侧的热替换链把这些插件 fiber 逐个拆掉重建——其中包括定义全部 --dsw- 令牌的 theme 插件和负责绘制 React 组件的 renderer。 - 于是页面白屏，而宿主进程仍在执行旧版本代码：单纯刷新页面能拿回新资源，但运行中的服务还是旧版本。 因此插件在 host 侧记录「进程启动时加载的版本」（ running ）与「磁盘上现在的版本」（ installed ），两者不一致即 stale: true ，这也正是页面资源已失效的状态。 组成 三个半区在同一个包里： - Host 半区（ lib/index.js ，exports . ）注册四条路由： - GET /api/dsh-version-update/check — 安装版本 + registry 通道 + 全部版本 + 任务视图（含 running / stale / restartable ）。 - POST /api/dsh-version-upda…

分类