Tony250-officeteam/dsh-page-reload ↗★ 0
dsh-page-reload
DSH client plugin: registers the page.reload command (default Ctrl+Shift+R) that reloads the WHOLE app page — a recovery shortcut for a wedged or white-screened UI. Unlike the built-in page.refresh (Ctrl+R), which only refreshes the right sidebar panel.
安裝
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Tony250-officeteam/dsh-page-reload說明文件
閱讀完整 README ↗dsh-page-reload
给 DeepSeek Harness 加一个整页刷新快捷键 —— 前端卡死 / 白屏时的自救键。
内置的 page.refresh(Ctrl+R)只刷新右侧栏面板,不是整页刷新。本插件注册真正的整页重载命令,默认 Ctrl+Shift+R。
English: README.en.md
为什么需要它
- DSH 正式版在 Windows 上没有页面重载入口:应用菜单被替换成两个隐藏 DevTools 项,
reload菜单只在开发模式注册(见app.asarlib/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:/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