前言¶
在 DeepSeek Harness Desktop 里做日常开发或排障时,刷新当前 Web UI 页面是常见操作。浏览器里按 F5 或 Ctrl+R 即可重载,但生产版 DSH Desktop 的窗口菜单默认不提供「Reload Page」(该入口仅在 development 构建中启用)。同时,应用内置快捷键系统不接受「无修饰键」的绑定,因此裸 F5 在生产环境下通常无效,Ctrl+R 也未默认绑定。
如果你习惯用键盘刷新页面,又不想每次从菜单里找入口,需要一个在 client 端补上刷新快捷键的插件。下面介绍社区维护的 dsh-refresh-plugin(维护者 Phoeky,分类:客户端)。
这是什么¶
dsh-refresh-plugin 是面向 DeepSeek Harness Desktop 的刷新插件:在页面 client 端注册捕获阶段的按键监听,把 F5、Ctrl+R 等组合映射为软刷新或带缓存绕过的硬刷新。npm 包名为 dsh-refresh-plugin(GitHub 仓库同名;npm 上的 dsh-refresh 已被其他用户占用)。当前资料中的版本为 1.0.1,许可证为 MIT。
核心功能¶
插件通过 client 端 keydown 监听恢复刷新快捷键,行为如下(与 README 一致):
| 按键 | 行为 |
|---|---|
F5 |
软刷新(reload) |
F5 + 任意修饰键(Ctrl / Shift / Alt) |
硬刷新(加 _dsh_refresh 时间戳参数绕过缓存) |
Ctrl+R |
软刷新 |
Ctrl+Shift+R |
硬刷新(cache-busted) |
实现上,Host 端(lib/index.js)为空 apply,逻辑全部在 client 端(lib/client.js)。捕获阶段监听会在内置快捷键系统之后、DOM 之前处理未被系统认领的键,因此不与现有快捷键冲突,也能补上无法通过快捷键系统注册的裸 F5。
安装与启用¶
方式一:从 npm registry 安装(推荐)
dsh plugin --profile desktop add dsh-refresh-plugin
方式二:本地路径安装(开发调试时)
dsh plugin --profile desktop add F:\code\dsh-desktop-refresh\dsh-refresh
安装后需要完全退出并重新打开应用。资料说明:应用运行时会监听 profile 的 bundles 列表变化并自动重组 loader,但当前已加载的页面不会包含新监听器,因此热装后仍须重启才能生效。
典型用法¶
- 按上述命令为 desktop profile 安装插件并重启 DSH Desktop。
- 在应用内聚焦 Web UI 后,按
F5或Ctrl+R做软刷新。 - 需要绕过缓存时,使用
F5加任意修饰键,或Ctrl+Shift+R。
卸载:在应用内「插件」页面移除 dsh-refresh 即可。
适用场景与注意¶
适合经常在 DSH Desktop 生产构建下调试界面、改插件或排障的开发者;依赖标准 DSH bundle(dsh.bundle.patch 声明 loader 挂载,dsh.client 声明 client 端),通过官方 dsh plugin CLI 写入 profile。
安装前建议自行查看仓库源码与 MIT 许可证;插件以当前 DSH 进程权限运行,与所有 DSH 插件一样,只安装你信任的来源。DeepSeek Harness 生态强调「一切皆插件」;社区目录站点为独立收录,与 DeepSeek / 幻方无官方从属关系,本文介绍的是社区插件 phoeky/dsh-refresh-plugin,非官方内置能力。
链接¶
- 社区目录:https://www.skillhub.cn/plugins/Phoeky/dsh-refresh-plugin
- GitHub:https://github.com/Phoeky/dsh-refresh-plugin
- npm:https://www.npmjs.com/package/dsh-refresh-plugin
经过上面的步骤,你可以在默认无法使用 F5 的生产版 Desktop 上,用熟悉的快捷键重新加载页面。