dsh-refresh-restart

给 DeepSeek Harness 桌面界面左上角加两个小按钮：刷新界面 和 重启应用。位置跟随「收起侧边栏」按钮，展开 / 收起侧栏、改窗口大小、全屏都不会跑偏。

An unofficial DSH plugin that puts reload and restart buttons next to the sidebar toggle in the top-left corner of the DeepSeek Harness desktop UI.

兼容性

运行方式	刷新界面	重启应用
macOS 桌面版	✅	✅
Windows 桌面版	✅	✅（`CloseMainWindow` 退出 + 重开 exe）
Linux 桌面版	✅	✅（`SIGTERM` 退出 + 重开 AppImage / 可执行文件）
浏览器（`dsh web`）	✅	⛔ 只能手动重启

「刷新」是纯页面操作，在任何能跑 DSH 界面的环境都成立。「重启」需要从操作系统层重开整个应用：插件会生成一个脱离宿主的小助手，先请应用自己退出，等进程真的消失（必要时升级到强杀），再把同一个应用重新打开。三个桌面平台的退出 / 重开命令不同，都已实现；识别不到应用路径时按钮会给出明确提示，不会静默失败。

为什么需要它

改插件（client.js 这类界面代码）后要刷新页面才能看到效果，而 ⌘R 在焦点落在输入框时不一定生效，也不方便。
新增 / 删除插件必须重启整个应用（插件清单只在启动时读取），菜单里的「重启应用与 Host」藏得比较深。

两个动作各给一个按钮，重启还带二次确认，避免误点丢掉没发出去的输入。

安装

方式零：一行命令（已发布 Release 后可用）

# 直接装预打包的 tgz（不需要 Node 构建，不会触发 allowBuilds 询问）
dsh plugin add https://github.com/hulibuld/dsh-refresh-restart/releases/download/v0.2.0/dsh-refresh-restart-0.2.0.tgz

装完重启 DSH，左上角就出现两个按钮。

方式一：插件市场 / 插件管理器

如果 DSH 装了插件市场，搜索 dsh-refresh-restart 安装即可。

方式二：手动装到 profile

git clone https://github.com/hulibuld/dsh-refresh-restart.git
cd dsh-refresh-restart

然后装进某个 profile（下面用 <profile> 代指，比如 desktop）：

建软链：把仓库目录链到 <DSH_HOME>/profiles/<profile>/node_modules/dsh-refresh-restart。
在 <DSH_HOME>/profiles/<profile>/package.json 的 dependencies 里加 "dsh-refresh-restart": "link:<仓库绝对路径>"。
在同一个文件的 dsh.profile.bundles（数组）里加上 "dsh-refresh-restart"。
重启 DSH。按钮出现在左上角；没出现就刷一次新页面。

不要在这里跑 pnpm add <本插件> 或 pnpm install：它们会重解析整棵依赖树。手动加软链 + 上面三行声明最稳。

卸载：删掉第 1–3 步加的东西，重启 DSH。

使用

刷新（↻）：等于按一次 ⌘R。只重新加载界面那一层，宿主里的生成任务照常跑，正在生成的回答不会中断；插件改动能立刻生效。会丢的是输入框里还没发送的草稿、滚动位置。
重启（⏻）：弹确认框 → 窗口关闭 → 几秒后自动重新打开。会话、工作区都在，等同于菜单里的「重启应用与 Host」。

操作	宿主（后台生成）	界面
刷新	不受影响	重载，重新接上会话
重启	结束并重新启动	关闭再打开
关窗口	视配置而定	消失

真正会打断回答的只有重启、点「停止」、宿主崩溃；刷新不会。

配置

cordis.patch.yml 里可调（也可以写在 profile 的插件配置里）：

键	默认	含义
`quitTimeoutMs`	`20000`	等应用自己退出的上限，超时后开始发信号
`openDelayMs`	`800`	确认进程消失后，隔多久重新打开
`appPath`	空	留空自动推断：macOS 找 `.app`，Windows 用 exe 路径，Linux 优先 `APPIMAGE`；换过安装位置或绿色版时填绝对路径

实现方式

纯本地、零运行时依赖、无构建步骤：

index.js           宿主半边：导出 Config + apply，注册 status / restart 两个路由
client.js          浏览器半边：手写 __ModuleLoader__ 模块，注册 shell.overlay 槽组件
lib/platform.js    平台识别：判断能不能重启，生成「退出 + 重开」计划与助手脚本源码
lib/restart.js     重启服务：持有 token、把助手写进临时目录并 detached 拉起
lib/routes.js      路由封装：方法校验、仅 loopback、action token、JSON 响应
cordis.patch.yml   bundle 补丁：把插件插进宿主
test/              node --test 回归测试（纯函数 + 路由守卫）

重启为什么这么绕：桌面版是 Electron 应用，宿主只是它的子进程。只杀宿主，窗口还在但没人管，界面就废了。所以必须由脱离宿主的助手先请应用退出，等进程真的消失（必要时升级到强杀），再把同一个应用重新打开：

平台	退出	重开
macOS	`osascript … quit`（走正常 `before-quit`）	`open -a 应用.app`
Windows	PowerShell `CloseMainWindow`，兜底 `taskkill /F /T`	直接拉起 exe
Linux	`SIGTERM`，兜底 `SIGKILL`	重开 `APPIMAGE` 或可执行文件

助手是一段 CommonJS，用 process.execPath + ELECTRON_RUN_AS_NODE=1 执行——借 Electron 自带的 Node，用户不用另装 Node。进程匹配在 macOS 上限定在当前 .app 的 Contents/ 前缀内，Windows 上按映像名，不会误杀别的进程。

重开时会把 ELECTRON_*、NODE_OPTIONS、NODE_PATH 从环境里摘掉。 这不是洁癖：助手自己带着 ELECTRON_RUN_AS_NODE=1（否则它跑不起来），而 macOS 的 open 会把调用者的环境原样交给新启动的应用。带着这个开关，Electron 会按纯 Node 模式启动——进程列表里看得到，窗口永远不出来，用户看到的就是「关掉了、再也没打开」。这正是 0.1.1 修掉的真实 bug。重开之后助手还会确认渲染进程（--type=renderer）真的出现，否则按 bundle id 再 open 一次，并在日志里写明。

按钮不往页面 DOM 里塞节点，而是在 shell.overlay 槽里用 position: fixed 画出来，每次挂载、窗口尺寸变化、点击、transitionend 都重新量一次「收起侧边栏」按钮的坐标。鼠标悬停时按钮下方出现「刷新」「重启」两个小提示框。

安全与隐私

只注册 127.0.0.1 上的路由；校验 Host 头，挡住 DNS rebinding。
重启是 POST，必须带 status 响应里的随机 token（x-dsh-refresh-restart-key 头），跨站 Origin 一律拒绝。
助手脚本写在临时目录，权限 0700，只做「退出、等待、必要时强杀、重开」。
不联网、不收集任何数据、不读会话内容；插件只用 process.execPath、process.platform 这些运行时事实。

开发

node --test test/        # 或 npm test

测试覆盖：配置收敛、三平台的应用识别与重启计划（含 Windows 绿色版、Linux AppImage 分支）、助手脚本的语法与内嵌计划、环境变量不泄漏到新应用（端到端：真跑一遍助手，检查子进程 env）、loopback/DNS-rebinding 判定、token 比较、路由的方法校验 / 403 / 409 / 501 分支、注销只释放一次。

macOS 分支已在本机实测（真实点过按钮重启）；Windows / Linux 分支是同一套助手换平台参数，有单元测试覆盖，但还没在真机上点过。

排障

按钮没出现：插件清单只在启动时读取。确认 profile package.json 的 dsh.profile.bundles 里有 dsh-refresh-restart，然后重启应用。
窗口关了没回来：助手日志在系统临时目录，文件名 dsh-refresh-restart-<时间>.log（macOS 在 $TMPDIR，Windows 在 %TEMP%）。里面按顺序记了退出、等待、信号、重开每一步。0.1.1 之前的版本会因为 ELECTRON_RUN_AS_NODE 泄漏而重开出「没有窗口的空壳」，日志表现为 launched=true 但应用不出现——升级后日志会写 应用已重新打开 或 进程已启动但没有窗口。
提示「没找到应用位置」：自动推断失败，把 appPath 配上绝对路径（macOS 填 .app，Windows 填 exe，Linux 填 AppImage）。

Roadmap

浏览器 / CLI 模式重启（脱离进程重跑 process.argv，需要处理端口与页面重连）
英文界面（当前文案内联中文，TEXT / ERROR_TEXT 两处即可抽出）
自定义位置与紧凑模式

欢迎 PR。改 lib/ 后跑一遍 npm test；改 client.js 后刷新页面即可看到效果。

License

MIT

dsh-refresh-restart

An unofficial DSH plugin that puts reload and restart buttons next to the sidebar toggle in the top-left corner of the DeepSeek Harness desktop UI.

兼容性

运行方式	刷新界面	重启应用
macOS 桌面版	✅	✅
Windows 桌面版	✅	✅（`CloseMainWindow` 退出 + 重开 exe）
Linux 桌面版	✅	✅（`SIGTERM` 退出 + 重开 AppImage / 可执行文件）
浏览器（`dsh web`）	✅	⛔ 只能手动重启

为什么需要它

改插件（client.js 这类界面代码）后要刷新页面才能看到效果，而 ⌘R 在焦点落在输入框时不一定生效，也不方便。
新增 / 删除插件必须重启整个应用（插件清单只在启动时读取），菜单里的「重启应用与 Host」藏得比较深。

两个动作各给一个按钮，重启还带二次确认，避免误点丢掉没发出去的输入。

安装

方式零：一行命令（已发布 Release 后可用）

# 直接装预打包的 tgz（不需要 Node 构建，不会触发 allowBuilds 询问）
dsh plugin add https://github.com/hulibuld/dsh-refresh-restart/releases/download/v0.2.0/dsh-refresh-restart-0.2.0.tgz

装完重启 DSH，左上角就出现两个按钮。

方式一：插件市场 / 插件管理器

如果 DSH 装了插件市场，搜索 dsh-refresh-restart 安装即可。

方式二：手动装到 profile

git clone https://github.com/hulibuld/dsh-refresh-restart.git
cd dsh-refresh-restart

然后装进某个 profile（下面用 <profile> 代指，比如 desktop）：

建软链：把仓库目录链到 <DSH_HOME>/profiles/<profile>/node_modules/dsh-refresh-restart。
在 <DSH_HOME>/profiles/<profile>/package.json 的 dependencies 里加 "dsh-refresh-restart": "link:<仓库绝对路径>"。
在同一个文件的 dsh.profile.bundles（数组）里加上 "dsh-refresh-restart"。
重启 DSH。按钮出现在左上角；没出现就刷一次新页面。

不要在这里跑 pnpm add <本插件> 或 pnpm install：它们会重解析整棵依赖树。手动加软链 + 上面三行声明最稳。

卸载：删掉第 1–3 步加的东西，重启 DSH。

使用

刷新（↻）：等于按一次 ⌘R。只重新加载界面那一层，宿主里的生成任务照常跑，正在生成的回答不会中断；插件改动能立刻生效。会丢的是输入框里还没发送的草稿、滚动位置。
重启（⏻）：弹确认框 → 窗口关闭 → 几秒后自动重新打开。会话、工作区都在，等同于菜单里的「重启应用与 Host」。

操作	宿主（后台生成）	界面
刷新	不受影响	重载，重新接上会话
重启	结束并重新启动	关闭再打开
关窗口	视配置而定	消失

真正会打断回答的只有重启、点「停止」、宿主崩溃；刷新不会。

配置

cordis.patch.yml 里可调（也可以写在 profile 的插件配置里）：

键	默认	含义
`quitTimeoutMs`	`20000`	等应用自己退出的上限，超时后开始发信号
`openDelayMs`	`800`	确认进程消失后，隔多久重新打开
`appPath`	空	留空自动推断：macOS 找 `.app`，Windows 用 exe 路径，Linux 优先 `APPIMAGE`；换过安装位置或绿色版时填绝对路径

实现方式

纯本地、零运行时依赖、无构建步骤：

index.js           宿主半边：导出 Config + apply，注册 status / restart 两个路由
client.js          浏览器半边：手写 __ModuleLoader__ 模块，注册 shell.overlay 槽组件
lib/platform.js    平台识别：判断能不能重启，生成「退出 + 重开」计划与助手脚本源码
lib/restart.js     重启服务：持有 token、把助手写进临时目录并 detached 拉起
lib/routes.js      路由封装：方法校验、仅 loopback、action token、JSON 响应
cordis.patch.yml   bundle 补丁：把插件插进宿主
test/              node --test 回归测试（纯函数 + 路由守卫）

平台	退出	重开
macOS	`osascript … quit`（走正常 `before-quit`）	`open -a 应用.app`
Windows	PowerShell `CloseMainWindow`，兜底 `taskkill /F /T`	直接拉起 exe
Linux	`SIGTERM`，兜底 `SIGKILL`	重开 `APPIMAGE` 或可执行文件

安全与隐私

只注册 127.0.0.1 上的路由；校验 Host 头，挡住 DNS rebinding。
重启是 POST，必须带 status 响应里的随机 token（x-dsh-refresh-restart-key 头），跨站 Origin 一律拒绝。
助手脚本写在临时目录，权限 0700，只做「退出、等待、必要时强杀、重开」。
不联网、不收集任何数据、不读会话内容；插件只用 process.execPath、process.platform 这些运行时事实。

开发

node --test test/        # 或 npm test

macOS 分支已在本机实测（真实点过按钮重启）；Windows / Linux 分支是同一套助手换平台参数，有单元测试覆盖，但还没在真机上点过。

排障

按钮没出现：插件清单只在启动时读取。确认 profile package.json 的 dsh.profile.bundles 里有 dsh-refresh-restart，然后重启应用。
窗口关了没回来：助手日志在系统临时目录，文件名 dsh-refresh-restart-<时间>.log（macOS 在 $TMPDIR，Windows 在 %TEMP%）。里面按顺序记了退出、等待、信号、重开每一步。0.1.1 之前的版本会因为 ELECTRON_RUN_AS_NODE 泄漏而重开出「没有窗口的空壳」，日志表现为 launched=true 但应用不出现——升级后日志会写 应用已重新打开 或 进程已启动但没有窗口。
提示「没找到应用位置」：自动推断失败，把 appPath 配上绝对路径（macOS 填 .app，Windows 填 exe，Linux 填 AppImage）。

Roadmap

浏览器 / CLI 模式重启（脱离进程重跑 process.argv，需要处理端口与页面重连）
英文界面（当前文案内联中文，TEXT / ERROR_TEXT 两处即可抽出）
自定义位置与紧凑模式

欢迎 PR。改 lib/ 后跑一遍 npm test；改 client.js 后刷新页面即可看到效果。

License

MIT

hulibuld/dsh-refresh-restart

dsh-refresh-restart

兼容性

为什么需要它

安装

方式零：一行命令（已发布 Release 后可用）

方式一：插件市场 / 插件管理器

方式二：手动装到 profile

使用

配置

实现方式

安全与隐私

开发

排障

Roadmap

License

Community comments

hulibuld/dsh-refresh-restart

dsh-refresh-restart

兼容性

为什么需要它

安装

方式零：一行命令（已发布 Release 后可用）

方式一：插件市场 / 插件管理器

方式二：手动装到 profile

使用

配置

实现方式

安全与隐私

开发

排障

Roadmap

License

Community comments