dsh-page-refresh

dsh-page-refresh · 为 DeepSeek Harness 官方桌面版设计的会话头工具按钮

给 DeepSeek Harness（下称 DSH）的 Web 界面加两个会话头按钮：一个 ↻ 刷新、一个电源菜单（重启 / 关闭 DSH）。

面向桌面版（Electron 壳）设计：桌面版里 F5 常被网页浏览区域吃掉或与应用快捷键冲突，页面卡住时想刷新只能绕路；想退出应用又得去右下角托盘翻菜单。这两个按钮把它们放回会话头右上角，一次点击直达。Web 网页版同样可用（电源按钮在网页版下没有意义，见下文平台限制）。

特性

• 刷新按钮：↻ 一点即重载页面，等价 F5，不丢会话数据
• 电源菜单：点电源图标拉出两个选项 —— 重启 DeepSeek Harness / 关闭 DeepSeek Harness
• 位置固定：会话头右侧工具区（utilities 槽位），电源在左、刷新在右（order: 998 / 999）
• 零 token：不注册任何 model tool，每轮对话成本为 0
• 零依赖：不启引擎、不写状态文件；host 半边只在收到点击时才动
• 样式随主题：菜单为半透明毛玻璃，继承当前主题文字色

电源菜单怎么工作的

写这个功能的两个硬约束：关掉之后不能被看门狗拉回来，以及重启要保留原来的启动参数。

关闭：先尽力往 DSH 的 update-journal 追加一条 {"event":"quit-requested"}（这是应用自身托盘「退出」走的同一机制，装了看门狗就会认得它），再 taskkill 杀进程。

journal 是 opt-in 的：DSH 主进程读 DSH_DESKTOP_UPDATE_JOURNAL_DIR 环境变量，没设时它根本不建 journal。插件在这种情况下记录失败不拦着关闭 —— 因为没有 journal 的机器同样不会有读它的看门狗，直接杀就行。journal 目录按 DSH_DESKTOP_UPDATE_JOURNAL_DIR → ~/.dsh/logs/update-journal 两级定位。

重启：分两条路，优先本机定制、否则通用。

• 若 ~/.dsh/freeze-restart-hidden.vbs 存在（定制重启链），走它，并传 fast 跳过链内的等待
• 否则调用本插件自带的 lib/dsh-power.ps1：读完当前主进程的完整命令行再杀，然后用同样的 exe、参数、工作目录重拉，所以 --user-data-dir 之类的启动参数不会丢

主进程的判据是父进程不在同名的这批进程里（Electron 入口进程的特征）。只用「命令行不含 --type=」筛选是不够的 —— 实测在一台机器上会剩下 3 个候选（crashpad_handler 等旁支也没有 --type=），有可能抓错进程、用错的 exe 路径去重拉。

点下去的瞬间界面就消失：渲染进程拿不到 Electron 的 app 对象（contextIsolation），调不了 app.quit()；DSH 的 26 个 DESKTOP_IPC 通道里也没有退出通道（已翻过 app.asar 确认）。所以走的是「点击的同一个 tick 里全屏盖黑 + 后台杀进程」——感知上是零延迟，进程其实在约 200 毫秒后死。

平台限制

电源菜单目前是 Windows 专用。

• 关闭用 taskkill、通用重启用 PowerShell + WMI 读进程信息 —— 都是 Windows 命令
• 在 macOS / Linux 上，两个按钮会明确报失败（不会静默无反应）；刷新按钮不受影响

验证范围：本插件在一台 Windows 11 机器上实测通过（刷新、拉起菜单、重启、关闭、以及通用重启路径的 probe 模式）。通用路径（dsh-power.ps1）的读参部分已用只读 probe 验证能取到正确的 exe 与参数，但尚未在第二台机器上端到端跑过。 如果你在别的机器上遇到问题，请带 ~/.dsh/logs/ 里的相关输出提 issue。

安装

npm（已发布 dsh-page-refresh）：

npx @deepseek-ai/dsh plugin --profile web add dsh-page-refresh

或从源码（本仓库插件在 plugins/dsh-page-refresh/）：

npx @deepseek-ai/dsh plugin --profile web add "<本仓库路径>\plugins\dsh-page-refresh"

桌面版注意：桌面版宿主运行的是 desktop profile，而 plugin add CLI 拒绝管理它（"managed exclusively by the Electron application"）。此时需手动登记三处，缺一不可：

1. ~\.dsh\profiles\desktop\package.json → dependencies 加 "dsh-page-refresh": "link:<插件路径>"
2. 同文件 dsh.profile.bundles 数组加 "dsh-page-refresh"
3. 在 ~\.dsh\profiles\desktop\ 下执行 pnpm install（落 symlink）

全部完成后重启 DSH 生效。

卸载

npx @deepseek-ai/dsh plugin --profile web remove dsh-page-refresh
# 桌面版手动装的：把上面三处登记原样撤掉，再重启

改造

plugins/dsh-page-refresh/client.js 里：

• 换位置：调 order（越小越靠左）
• 换图标：IconPower / IconRestart 是内联 SVG，改 d 属性即可
• 换行为：改 fire() 里的 fetch('/api/power/…')

改客户端代码不需要重启 DSH，保存后刷新页面即生效（宿主按文件内容哈希发版）。 改 lib/ 下的 host 半边（含 dsh-power.ps1）需要重启 DSH。

文件结构

plugins/dsh-page-refresh/
├── package.json        # dsh.bundle.patch + dsh.client 声明
├── cordis.patch.yml    # bundle patch：插入插件行
├── screenshots.json    # 插件市场截图声明
├── assets/             # 截图
├── lib/
│   ├── index.js        # host 半边：/api/power/{status,restart,close} 三条本地路由
│   └── dsh-power.ps1   # 通用重启/关闭脚本（读原命令行后重拉）
└── client.js           # 客户端半边：注册 utilities 槽位两个按钮

lib/*.ps1 必须是纯 ASCII：Windows PowerShell 把无 BOM 的 .ps1 当 ANSI 读，非 ASCII 注释会破坏解析。

已验证环境

• DSH 0.2.1-rc.2（官方桌面版）
• Windows 11 + Edge/Chromium 内核
• 需要 package.json 带 "type": "module"（宿主按 ESM 解析 host 半边，缺了会静默跳过整个 bundle）

License

MIT