Liu-fu-gui/dsh-desktop-upgrade

dsh-desktop-upgrade

给 DSH Desktop 补上一个它自己缺的「升级 DSH」入口。不改任何内核文件。

为什么需要它

- DSH Desktop 的 Web 设置页没有检查更新按钮：client.js 里 api.checkForUpdates() 和中文文案「检查更新」都定义了，但那个组件从来没渲染它。本插件把这块补上了：设置 → DSH 升级。
- 官方入口只藏在系统托盘「检查更新…」（后台也会每 6 小时自动查一次并发系统通知）。
- 桌面版内核在 \resources\app\node_modules\@deepseek-ai\dsh，profile 里看到的 ~/.dsh/profiles/node_modules/@deepseek-ai/ 全是指向它的 Junction。所以任何"npm/pnpm 一键升级 dsh 本体"的第三方插件在这里都改不动内核，真正的升级只能靠官方安装包。

本插件做的就是把官方那条链路补到可点的地方，并让模型也能调用：

1. Web 设置页新增「DSH 升级」分区（client.js）：显示当前版本 / 官方最新 / 更新通道，一个「检查更新」按钮，一个「下载并安装」按钮（有新版且当前平台可下载时才出现）。点下载仍会弹官方原生确认框，确认后走同一条安装包通道。
2. 托盘菜单新增「升级 DSH…」：查官方版本服务 → 有新版时弹原生确认框（下载 / 稍后）→ 下载官方安装包并打开。用的是桌面版自己的 desktopRuntime.updates 适配器，和官方托盘项完全同一条路径。
3. 模型工具 dsh_upgrade：status（只报版本，不弹窗）/ check（只检查）/ upgrade（确认后下载安装包）。

结构

| 文件 | 角色 |
|---|---|
| index.js | Host 半侧：Cordis 插件本体（托盘项、dsh_upgrade 工具、桥接装配） |
| bridge.js | Host 半侧纯逻辑：版本检查、升级流程、两条浏览器桥接路由 |
| client.js | 浏览器半侧 bundle：settings.section 分区 UI |
| cordis.patch.yml | bundle patch：往 profile 里插一行 desktop-upgrade |

浏览器半侧按 dsh-client-modules 的约定声明：package.json 里 dsh.client.platform = "web"、exports["./client"]，bundle 用
window.__ModuleLoader__.load({ id: "dsh-desktop-upgrade", factory }) 的惰性 CJS 形状，由宿主在 /plugins/dsh-desktop-upgrade/client.js 提供。
patch 行的 name 必须等于包名，扫描才能把两者对上。

桥接路由（同源，仅接受 loopback / web runtime 的 trustedHosts，并拒绝浏览器跨站标记）：

GET  /dsh-desktop-upgrade/status   -> { ok, result: { status, currentVersion, latestVersion, channel, canDownload, manualUrl } }
POST /dsh-desktop-upgrade/upgrade  -> { ok, result: { ...同上, accepted } }

upgrade 不会自己装东西：它调用桌面版的 updates.confirmDownload() 弹原生确认框，确认后才把官方安装包交给系统下载并打开。

它放在哪

三层的职责不同，别混：

| 层 | 位置 | 谁管 |
|---|---|---|
| 桌面版本体（含内核） | D:\ruanjian\DSH Desktop\（resources\app） | 官方安装包 / 桌面版自带更新通道 |
| 插件包安装位置 | C:\Users\Administrator\.dsh\profiles\desktop\node_modules\dsh-desktop-upgrade | dsh plugin（= 在 profile 目录跑 pnpm） |
| 插件登记位置 | C:\Users\Administrator\.dsh\profiles\desktop\package.json 的 dependencies + dsh.profile.bundles | 同上，装完自动登记 |

也就是说：源码放哪都行（现在在 D:\trea\tmp\dsh-desktop-upgrade），真正生效的位置是 profile 的 node_modules + package.json。别手动拷进 profile，用官方命令装，它会顺带把 dsh.profile.bundles 对平。

安装

仓库已发布：（带 dsh-plugin topic，会被插件市场扫到）

在 DSH 终端（设置 → 打开 DSH 终端）或任何 PATH 里有桌面版 dsh 的终端里执行：

方式一：从 GitHub 安装（推荐）
dsh plugin add github:Liu-fu-gui/dsh-desktop-upgrade

方式二：本地开发态安装，改完代码重启即生效
dsh plugin add link:D:\trea\tmp\dsh-desktop-upgrade

装完确认
dsh plugin list

npm 目前没有发布：本机 npm whoami 未登录，且默认源是只读镜像 registry.npmmirror.com。
想走 npm 需要先 npm login（或配 //registry.npmjs.org/:_authToken），再用
npm publish --registry https://registry.npmjs.org；届时把 package.json 里的 "private": true 去掉即可。

dsh plugin 会自动补上 --profile desktop（桌面版 shim 的行为），实际就是在该 profile 目录跑 pnpm、然后把依赖对平进 dsh.profile.bundles。
建议先备份 profile：
Copy-Item C:\Users\Administrator\.dsh\profiles\desktop\package.json C:\Users\Administrator\.dsh\profiles\desktop\package.json.bak-dsh-desktop-upgrade
（以及 pnpm-lock.yaml）。目录里已有的 package.json.bak- 说明这套流程以前用过。

装完必须重启 DSH Desktop（profile 组合变化和 client bundle 都不会热生效；托盘项与设置页分区都是启动时装配的）。重启会中断当前会话 —— 从托盘菜单退出再开，或设置里「重启」。

使用

- 设置 → 「DSH 升级」：进页面自动查一次官方版本；有新版时出现「下载并安装」，确认后下载官方安装包并自动打开，跑完安装向导即完成升级。
- 托盘图标右键 → 「升级 DSH…」：同上，入口在托盘。
- 对话里让 agent 调 dsh_upgrade：例如"查一下 DSH 有没有新版本"（status / check），或"升级 DSH"（upgrade，同样会在屏幕上弹确认框，需要你点同意）。

开发与测试

node --check index.js; node --check bridge.js; node --check client.js
node --test test/bridge.test.mjs test/client.test.mjs

test/bridge.test.mjs 覆盖 SemVer 预发布规则、版本检查、升级流程（绝不绕过原生确认框）、以及桥接路由的 403 / 404 / 405 / 500 分支；
test/client.test.mjs 用替身 window.__ModuleLoader__ 装载 bundle，校验注册形状，并在桌面版自带的 React 18 上跑一次自带 hook dispatcher 的渲染冒烟。

卸载

dsh plugin remove dsh-desktop-upgrade

然后重启 DSH Desktop。

验证过的行为（本机 2026 实测）

- dsh-plugin-desktop@2.0.10 / stable 通道：官方最新 = 2.0.10 → 返回 up-to-date。
- beta 通道：官方最新 = 2.0.10-beta.1，按 SemVer 比较低于稳定版 2.0.10 → 也判为 up-to-date（不会把你劝去降级）。
- dsh-plugin-desktop@2.0.11 发布后：设置页显示「当前 2.0.10 / 官方最新 2.0.11」，点「下载并安装」弹官方原生确认框。
- node --test test/bridge.test.mjs test/client.test.mjs：15 个用例全绿。

已知边界

- 只在 DSH Desktop 发行版里可用：desktopRuntime 服务不存在时，插件不注册托盘项，工具与桥接都返回 unavailable。
- 非打包模式（isPackaged === false）不注册托盘项；桥接路由仍在，但返回 unavailable。
- 它不做应用内静默自更新，也不替换 resources\app 里的内核 —— 那属于改安装目录，会被下次官方更新覆盖。它只驱动官方安装包通道。
- 它不改动、也不依赖任何内核文件；只用公开的 Cordis 服务（tools、desktopRuntime、webServer）与官方版本 / 下载端点。