桌面更新与插件管理 desanv01/dsh-plugin-desktop-updates

dsh-plugin-desktop-updates

一个 DeepSeek Harness 插件，用来渲染 Windows 桌面应用的 Updates 界面：设置旁的一行入口、一个 Updates 面板，以及一个 Updates 区块，全部由应用自带的页面桥接驱动。

它显示桌面应用的版本、已安装和已发布的 harness 版本，以及当前 home 运行的插件，并提供这些操作：检查、下载、安装、重启、修复 harness，以及启用、停用、安装或移除插件。

项目状态： 1.3.0，已发布到 npm。已在 Windows 桌面应用内置的 DeepSeek Harness 0.1.5-rc.x 运行时上验证通过。它服务的桌面应用已归档，本插件依赖该应用自带的页面桥接（window.__dshDesktop），而官方 DeepSeek Harness 桌面应用并不提供这个桥接。在官方应用里，插件能加载并渲染，但会提示桥接不可用——因为确实不可用。见 §为什么会有这个插件。

截图

界面出现在内置它的桌面应用里。应用窗口的截图（含 Updates 面板）在应用仓库。

为什么会有这个插件

应用需要一个设置界面——显示应用版本、harness 是否最新、当前 home 运行哪些插件，还要有按钮对这些内容执行操作——同时不想为每次改动都重建一个原生窗口。应用已经在 WebView2 里渲染 harness 的 Web UI，于是这个界面就做成了插件：侧边栏一行、一个面板和一个 Settings 区块，全都落在用户正在看的页面里。

这个决定有一个后果值得说明。事实和操作都在应用里，不在页面里，所以页面需要一条回到应用的通道。应用会向它加载的每个页面注入一个带版本号的桥接 window.__dshDesktop，本插件是它唯一的消费者。

正是这个桥接，让本插件绑定在单一应用上。 官方 DeepSeek Harness 桌面应用自带插件管理器和自己的更新视图，不暴露 __dshDesktop。装到那里，本插件会注册自己的槽位，然后提示无法连接应用——这个提示是准确的，也好过一个看起来在运行、实际什么都不做的面板。

它能做什么

- 侧边栏里设置旁的一行——一个带标签的入口（56 px 窄栏里显示为图标），点击打开 Updates 面板；有更新的应用版本时显示一个圆点。
- 一个面板，全视图，位于应用自己的窗口里：显示各项事实，加上检查、下载、安装、重启和修复操作，以及插件列表，支持启用、停用、安装和移除。
- 一个 Settings 区块，以更窄的形式呈现同样的事实和操作。
- 如实报告 shell 拒绝了什么。 shell 会丢弃它不认可的插槽注册，却不通知任何人，因此一个 UI 从未出现的插件，看起来和一个从未加载的插件一模一样。这个插件会把它注册的内容——以及每一次拒绝——发布到 window.__dshDesktopUpdates 和应用日志里。
- 诚实地降级。 没有桥接时，它会说应用不可用，而不是假装面板能正常工作。

工作原理

它贡献的四个插槽

| 插槽 | 条目 | 渲染内容 |
| sidebar.footer.action | id desktop-updates | 设置旁边一行带标签的条目（56 px 侧栏里显示为图标），点击打开 Updates 面板；有新应用构建时显示一个圆点 |
| sidebar.panellist | id desktop-updates | Updates 面板在侧栏里的行，用与下方主体相同的 id 寻址 |
| main | key desktop-updates | Updates 面板本身：完整视图，位于应用自己的窗口里 |
| settings.section | id desktop-updates | 设置里的精简视图，事实和操作与完整视图一致 |

三个列表插槽需要 id，带键的 main 插槽需要 key；缺少任何一个，shell 都会拒绝这次注册。

打开面板是布局操作，不是桥接调用

插件通过 ctx.layout.selectPanel 选中自己的面板，因此视图会出现在用户正在看的窗口里，打开它也不会因为桥接不可用而失败。当 shell 没有可选的 panel 插槽时，它会回退到应用原生的更新窗口——也就是托盘菜单打开的那个窗口。

注册标记

client.js 在应用时写入 window.__dshDesktopUpdates：它注册的插槽，以及 shell 拒绝的每一项贡献。应用在每次页面加载后读取这个标记并记入日志。Updates 区块会重复显示任何拒绝，因为那是用户唯一能看到它的地方。

版本偏差

当已安装版本比可执行文件内的副本更新时，应用不会动它，因此更新的 npm 发行版不会被下次启动回退。DeepSeekHarness.exe --install-plugin 会有意恢复内置副本。

要求

- 带 layout 服务的 DeepSeek Harness 0.1.x 组合——也就是 Windows 桌面应用内置的运行时。
- @deepseek-ai/dsh-client-ui-layout，在 dsh.client.inject 中声明，由宿主提供。
- 要让任何操作可用：需要桌面应用的 window.__dshDesktop 桥接。

快速开始

从 npm 安装

dsh plugin --profile web add dsh-plugin-desktop-updates

安装到桌面应用

应用会自己把内置副本安装到它拥有的 harness home 里。在应用内，使用 Settings → Updates → the plugin manager，它接受包名、git spec 或本地文件夹。从 npm 安装会用已发布的副本替换内置副本。

从源码构建

无需构建——客户端部分是手写的 module-face bundle：

bash
git clone https://github.com/desanv01/dsh-plugin-desktop-updates.git
cd dsh-plugin-desktop-updates
dsh plugin --profile web add .

冒烟测试

客户端部分可以脱离界面渲染，对着一个假 shell 跑；桌面应用自己的 CI 就是这么检查的，用的是应用仓库里的 tools/client-plugin-smoke.mjs。它会加载真实的 client.js，按真实的槽位规则校验（列表项必须有 id，面板槽位必须有 key），只要有注册被丢弃就报错。

配置

没有。插件不读取任何 Config 值，只渲染桥上报的内容。

用到的槽位

见 §工作原理 里的四槽位表。main 带 key，其余三个按 id 寻址。

各部分的位置

| 部分 | 路径 |
| 宿主部分 | index.js —— 空的 apply，这样这一行才会出现在配置档的 bundle 栈里，加载器才会保留它 |
| 浏览器部分 | client.js —— 模块面 bundle（window.__ModuleLoader__.load({ id, factory })） |
| 加载器行 | cordis.patch.yml —— 插入 desktop-updates 这一行 |
| 注册标记 | window.__dshDesktopUpdates，以及应用的日志 |
| 消费的桥 | window.__dshDesktop，由应用注入 |

故障排查

| 现象 | 原因 | 处理 |
| 侧边栏完全没有这一行 | 配置档里缺 bundle 行，或者客户端部分没被提供 | 检查 cordis.patch.yml 是否已安装，然后在页面里读 window.__dshDesktopUpdates |
| 行出现了，面板说应用不可用 | 没有 window.__dshDesktop —— 在 Windows 桌面应用之外，这是预期结果 | 换用提供桥的应用 |
| 行出现了，面板是空的 | 桥存在，但没上报任何状态 | 查应用日志里每次页面加载后打的标记 |
| 设置区缺失，但面板能用 | shell 拒绝了 settings.section 注册 | 该区会重复拒绝；标记里列出了这些拒绝 |
| 更新的 npm 版本没生效 | 应用保留的已安装版本比它自带的副本新 | 见 §版本偏差 |

当前状态

能用，但只对它所针对的那个应用。

已验证：四个槽位注册，对着一个按真实规则校验的假 shell；布局操作路径和原生窗口回退；标记及其日志；桥缺失时的如实降级。npm 上从 1.0.0 到 1.3.0 均已发布。

未验证：官方 DeepSeek Harness 桌面应用。 那个应用不提供 __dshDesktop 桥，所以就算每个槽位都注册成功，这个插件在它那里的价值也是零。插件作为已归档的 Windows 桌面应用的一部分维护，不是给官方应用用的插件。

路线图

- [x] 侧边栏行、面板和设置区
- [x] 检查、下载、安装、重启和修复应用与 harness
- [x] 插件列表，支持启用、禁用、安装和移除
- [x] 注册标记，让被拒绝的槽位可见，而不是悄无声息
- [x] 没有桥接时也能如实降级
- [ ] 决定是重新对准官方应用自带的插件设置界面，还是直接下线

安全

这个插件是一个界面，负责请求应用执行操作。它自己不做更新、安装或卸载：每个按钮都通过应用的桥接发送消息，实际工作由应用完成，并附带应用自己的校验——下载文件做校验和验证，安装则交给 harness 自带的插件管理器。

它不发起网络请求，不读取凭据，也不写文件。它会通过桥接读取应用和 harness 的版本状态，这些信息并不敏感。

安装任何插件都会在工作区沙箱之外运行宿主代码；这是 harness 本身的特性，不是这个插件带来的。请从 npm 包安装，或从你读过的源码安装。

报告漏洞请走 SECURITY.md 中的流程。

贡献

见 CONTRIBUTING.md。评审标准：被拒绝的注册是否仍然可见？桥接缺失时，插件是否如实表现？

许可与署名

MIT —— 见 LICENSE。

本插件从 desanv01/deepseek-harness-desktop-app 中提取而来，原先随可执行文件分发，也发布在 npm 上。