整页重载快捷键 caly250/dsh-page-reload

dsh-page-reload

给 DeepSeek Harness 加一个整页刷新快捷键 —— 前端卡死 / 白屏时的自救键。

内置的 page.refresh（Ctrl+R）只刷新右侧栏面板，不是整页刷新。本插件注册真正的整页重载命令，默认 Ctrl+Shift+R。

English: README.en.md

为什么需要它

- DSH 正式版在 Windows 上没有页面重载入口：应用菜单被替换成两个隐藏 DevTools 项，reload 菜单只在开发模式注册（见 app.asar lib/main.js 的 ...development ? [...] : []）。
- 内置的 page.refresh（Ctrl+R）只刷新右侧栏面板，不是整页刷新（实现在 dsh-client-ui-sidebar-right 的 registerSidebarShortcuts）。
- 白屏的常见真凶是渲染进程 OOM 退出（userData\logs\crash-*-renderer.log 实证：Desktop renderer exited: oom）；页面 JS 层卡死时同样需要整页重载。

它做什么

通过 DSH 自带的快捷键服务（@deepseek-ai/dsh-client-shortcuts）注册命令 page.reload：

- 默认键位：Ctrl+Shift+R（Windows/Linux 桌面与 Web），macOS 为 Cmd+Shift+R。
- 命令会出现在 设置 → 快捷键（Ctrl+/）里，可自由改键或清空绑定。
- 第二层保护：另装一个 capture 阶段的原生 keydown 兜底监听（与快捷键服务重复触发时以 defaultPrevented 让路），双保险。

安装

从 GitHub 安装
dsh plugin --profile desktop add github:<your-user>/dsh-page-reload

或从本地目录
dsh plugin --profile desktop add link:/path/to/dsh-page-reload

然后重启 DSH（托盘 → 退出 → 重开）。

插件是 client-only、零运行时依赖。Host 半侧刻意什么都不做，因此永远不会让桌面壳的插件激活失败。

边界说明（诚实版）

- 快捷键跑在渲染进程里：如果渲染进程已整个崩溃退出，页面内按键无法生效。那种情况 Electron 会弹「应用无法启动/致命错误」对话框，点重新启动；或托盘图标 → 退出 → 重开。
- 若前端只是 JS 卡死但渲染进程还活着，Ctrl+Shift+R 即可恢复。
- 绝不要为了刷新强杀进程（会截断会话日志）；走托盘退出。

探针

执行情况写入 localStorage["dsh-page-reload-probe"]（phase: registered / raw-listener-installed / command-run / raw-listener-run / error …）。从磁盘读取：

$ud = Join-Path $env:APPDATA '@deepseek-ai\dsh-desktop\Local Storage\leveldb'
Get-ChildItem $ud -File | ForEach-Object { Select-String -Path $_.FullName -Pattern 'dsh-page-reload-probe' }

卸载

从 profile 的 package.json 中移除该条目（dependencies 与 dsh.profile.bundles），删掉 node_modules 里的链接，重启即可。绑定偏好（Desktop 存 userData/keybindings.json）会保留但无害。

License

MIT