前言¶
DeepSeek Harness（DSH）桌面版自带更新指示器，但只在壳处于「有更新活动」的相位时才会在界面里渲染。已经是最新版本、处于空闲（idle）时，侧栏里往往看不到任何可以手动触发检查的入口；设置 → 通用里的「当前版本」只是一行文字，托盘菜单也通常只有「打开应用 / 退出」。若你习惯在侧栏一眼确认版本或主动点一次检查，就需要额外补一个入口。下面介绍社区插件 dsh-desktop-update-entry（维护者 maxwell234smith，分类：客户端），它在侧栏底部提供一个常驻位，与官方更新流程配合，而不替代壳本身的检查与安装逻辑。
这是什么¶
dsh-desktop-update-entry 是给 DSH 桌面版使用的客户端插件：在侧栏底部 sidebar.footer.action 席位（order: 1000，紧挨「设置 / 更多」）增加一个无论有没有更新都可见的「检查更新」相关 UI。官方 DesktopUpdateIndicator 在 phase === 'idle' 时会直接 return null，本插件在空闲时补上入口；有新版本、下载中、出错等相位时，展开侧栏下会与官方指示器互补让位，避免两个相同按钮并排。收起侧栏时，因官方指示器在窄状态（wide: false）不渲染，本入口仍保留状态点或转圈等反馈。
插件不自行下载或改文件：检查、下载、校验、安装仍由桌面壳执行。
核心功能¶
与官方指示器的关系¶
| 壳的相位 | 展开侧栏 | 收起侧栏 | 点击后 |
|---|---|---|---|
| 空闲（已是最新） | 「检查更新」 | 状态点 | 打开官方更新弹窗（壳会做一次检查） |
checking |
让位给官方指示器 | 转圈 | — |
available |
让位（官方显示「新版本 x.y.z」） | 状态点 | — |
downloading |
让位 | 转圈 | — |
verifying / installing |
让位 | 转圈 | — |
ready |
让位（官方显示「安装并重启」） | 状态点 | — |
error |
让位（官方显示「重试更新」） | 状态点 | — |
两条规则来自 README：展开侧栏时与官方 UI 互补；收起侧栏时由本入口兜底显示。
工作原理（简要）¶
桌面壳在页面里注入 globalThis.dshDesktop.updates（协议版本 1）。插件订阅该桥、把状态渲染成按钮，点击时调用 bridge.open() 打开官方更新弹窗：
bridge.status() // Promise<presentation> → { phase, percent?, version? }
bridge.subscribe(listener) // 壳每次推送新相位都会回调
bridge.open() // Promise<void> → 打开官方更新弹窗
在普通浏览器（没有上述全局量）里，插件完全静默，不注册任何 UI。
安装与启用¶
插件以 DSH desktop profile 安装；资料中的版本为 v0.1.0（见仓库 package.json）。安装后需刷新一次页面。零运行时依赖、零构建步骤。
从 GitHub 安装（推荐锁到 tag 或某个提交，见仓库 Releases）：
dsh plugin --profile desktop add github:maxwell234smith/dsh-desktop-update-entry#v0.1.0
本地开发时可直接链接源码目录（路径按本机修改）：
dsh plugin --profile desktop add link:D:\path\to\dsh-desktop-update-entry
也可以在 DSH 网页版 侧边栏 → 插件 → 安装 bundle 里填写：
github:maxwell234smith/dsh-desktop-update-entry
典型用法¶
- 在 DSH 桌面版按上文命令安装并刷新页面。
- 展开侧栏：若当前已是最新且无官方指示器，侧栏底部应出现「检查更新」；点击后打开官方更新弹窗，由壳执行检查。
- 收起侧栏：底部仍可见状态点或转圈（视相位而定），便于在窄侧栏下感知更新状态。
- 当壳进入
available、ready、error等相位且侧栏展开时，以官方指示器为准；本插件在该区域让位，避免重复入口。
维护者在仓库中用 Node 内置测试验证客户端逻辑，开发时可自行运行：
node --test
适用场景与注意¶
适合谁： 长期使用 DSH 桌面版、希望在「已是最新」时也能从侧栏手动打开更新弹窗的用户；需要在收起侧栏时仍能看到更新相关状态的用户。
权限与安全： 插件以当前 DSH 进程权限运行；安装前应阅读 GitHub 仓库 源码与 MIT 许可证。本插件不碰本地文件、不发起独立网络请求，更新行为仍由官方壳完成。
生态说明： DSH 社区插件目录（如 SkillHub 上的条目）为独立站点，与 DeepSeek / 幻方无官方从属关系；安装 bundle 时请以 README 与 Releases 为准。
结尾¶
dsh-desktop-update-entry 解决的是桌面版「空闲时无处点检查更新、窄侧栏无官方指示器」的小缺口：常驻入口 + 与官方 UI 互补，逻辑集中在订阅 dshDesktop.updates 并转发 open()。需要时可从目录页或 GitHub 获取安装说明与版本 tag。
- 目录页：https://www.skillhub.cn/plugins/maxwell234smith/dsh-desktop-update-entry
- GitHub：https://github.com/maxwell234smith/dsh-desktop-update-entry
