dsh-restart-button

在 DeepSeek Harness 会话标题栏的右上角加一个「重启」按钮（↻），点一下就能安全地重启整个客户端。

Adds a restart button (↻) to the top-right of the DeepSeek Harness session header. One click restarts the whole client safely.

功能

位置：会话标题栏右侧工具区的最右端（conversation.session.header.utilities，order 1000），紧挨右侧边栏开关。
一键重启：没有任务在运行时直接重启。
跑完后再重启：有会话正在运行或后台作业未结束时，确认框里多一个「跑完后重启」。选它之后按钮变成蓝色并带一个闪烁的小点，所有任务结束后自动重启；再点按钮可以「取消安排」或「立即重启」。
重启后接着干：重启前会记下你当前打开的会话和被中断的会话。重启完成后自动回到原来的会话，并弹出卡片「重启前有 N 个会话正在运行」，点「全部继续」就向这些会话发送"继续"，也可以逐个点开。
插件更新提醒：插件被原地更新（升级或重装）后，新代码要重启才会加载。插件会发现这种情况，在按钮上显示一个橙色小点，并弹出卡片「插件更新待生效：名称旧版本 → 新版本」，可以「立即重启」或「稍后」。
悬停查看运行状态：鼠标放在按钮上会显示 Host 已运行多久、占用多少内存、几个会话正在运行、是否已安排重启、有几个插件更新等待生效。
桌面版（Windows）：重启 Electron 外壳和后台 Host，新窗口自动打开，参数与原来一致。
dsh web：重启服务进程，页面在服务恢复后自动刷新。
失败时弹窗说明原因，并给出日志路径 ~/.dsh/logs/restart-button.log。

工作原理（桌面版）

DeepSeek Harness 桌面版由 Electron 主进程启动一个 Node 模式的 Host 子进程（它跑插件、会话和 Web 服务）。点击按钮后：

浏览器端向 POST api/restart-button.restart 发请求（走 DSH 自带的 Host/Origin 校验和浏览器鉴权）。
Host 把当前会话和正在运行的会话写进 ~/.dsh/restart-button/last-restart.json，供重启后的 Host 读取。
Host 启动一个脱离进程树的辅助程序（detach.mjs → restart-desktop.ps1），由它核对 Electron 主进程和 Host 的身份（可执行文件路径、父子关系）。
辅助程序挂起 Electron 主进程，使它察觉不到 Host 退出（不会弹出崩溃对话框、不会写崩溃报告）。
Host 断开与主进程的 IPC，走的正是桌面版退出时的同一条优雅关闭路径：会话落盘、插件逐个释放。
Host 退出后，辅助程序结束被冻结的主进程及其残留子进程，等端口 19387 释放后，用原来的参数重新启动 DeepSeek Harness.exe。

任何一步出错都会记录到日志；若在挂起后失败，辅助程序会恢复主进程，不会留下卡死的窗口。

「跑完后重启」由 Host 每秒检查一次：连续 3 秒没有运行中的 Agent 回合、排队消息或后台作业，就按上面的流程重启（会先留 1.5 秒让页面显示"正在重启"）。

「插件更新提醒」的判断方法：Host 记下本进程加载过的每个插件的版本和来源。Node 会缓存已加载的模块，所以之后磁盘上的版本或来源一旦变化（原地更新，或先移除再安装），都算待生效；本进程从未加载过的新插件会直接热加载，不算。

配置

可在 profile 的 cordis.patch.yml 中调整确认策略：

- id: restart-button
  config:
    confirm: when-busy   # when-busy（默认，仅在有任务运行时确认）| always（总是确认）| never（从不确认）

安装

在 DeepSeek Harness 的「插件」页面点「安装」，填入下面任意一种来源（也可以让 Agent 用 plugin_manager install_bundle 安装同样的来源）：

来源	填写内容
插件市场 dshmarket	搜索 `dsh-restart-button`（作者 PPsz-qqq），一键安装
GitHub Release 打包文件（推荐）	最新版：`https://github.com/PPsz-qqq/dsh-restart-button/releases/latest/download/dsh-restart-button.tgz`；指定版本：`https://github.com/PPsz-qqq/dsh-restart-button/releases/download/v0.2.0/dsh-restart-button-0.2.0.tgz`
GitHub 仓库	`github:PPsz-qqq/dsh-restart-button#v0.2.0`
本地打包文件	`.tgz` 的绝对路径，例如 `C:\Users\<you>\.dsh\plugins\dsh-restart-button-0.2.0.tgz`

第一次安装立即生效，无需重启。

升级需要重启一次：Node 会在整个进程生命周期内缓存已加载的模块，所以已加载过的插件，无论是原地安装新版本，还是先移除再安装，后台 Host 部分都要重启后才会换成新代码（界面部分会先更新）。安装新版本后按钮会出现橙色小点和「插件更新待生效」卡片，点「立即重启」即可。从本地 .tgz 安装的，升级前不要删除旧的 .tgz 文件。

自己打包：在仓库根目录运行 pnpm pack（或 npm pack），生成 dsh-restart-button-<version>.tgz。

接口

所有 POST 都要求 content-type: application/json。

路由	方法	说明
`api/restart-button.status`	GET	运行模式、是否支持、确认策略、运行时长与内存（`runtime`）、正在运行的会话（`busySessions`）、当前重启状态、已安排的重启（`scheduled`）、待生效的插件更新（`pendingPlugins`）、重启后的恢复信息（`resume`）、日志路径
`api/restart-button.restart`	POST `{ when?: 'now' \| 'idle', activeSessionId?: string }`	立即重启（202）；`when: 'idle'` 且有任务运行时改为安排重启（202，`scheduled: true`）
`api/restart-button.cancel`	POST `{}`	取消已安排的重启
`api/restart-button.resume-ack`	POST `{ id, action? }`	标记重启后的恢复信息已处理

限制

桌面版一键重启目前只支持 Windows；macOS / Linux 桌面版上按钮自动隐藏。
dsh web 模式下，重启后的服务在后台运行，输出追加到 ~/.dsh/logs/restart-button-web-server.log，不再占用原来的终端。
按钮在会话标题栏中，未打开任何会话（新建会话页）时不显示；提示卡片在任何页面都会出现。
恢复信息只在重启后 10 分钟内有效；「全部继续」发送的是普通用户消息"继续"（英文界面为 "Continue"）。
「已安排的重启」保存在当前 Host 进程里，插件被重新加载或客户端被手动关闭后会失效。

开发与测试

test/ 里的测试都不依赖真实客户端，也不会打包进插件：

文件	内容	运行
`host.test.mjs`	Host 端全部路由：活动判定、跑完后重启、取消、恢复记录、插件更新检测、失败回滚	`node test/host.test.mjs`
`client.test.cjs`	用真实 React 18 + jsdom 渲染按钮和卡片，对接模拟的 Host	先在任意目录 `pnpm add react@18 react-dom@18 jsdom`，再 `RB_CLIENT_DEPS=<该目录> node test/client.test.cjs`
`dummy-main.mjs` + `dummy-host.mjs`	用两个 Node 进程模拟 Electron 主进程和 Host，完整演练桌面版重启：核对 → 挂起 → Host 优雅退出 → 结束主进程 → 用原参数重启	见下
`dummy-web.mjs`	模拟 `dsh web` 服务的重启	见下

$env:RB_TEST_DIR = "$env:TEMP\rb-test"; New-Item -ItemType Directory $env:RB_TEST_DIR -Force | Out-Null
$env:RB_TEST_PORT = '19399'
Start-Process node -ArgumentList "$PWD\test\dummy-main.mjs" -WindowStyle Hidden   # 或 test\dummy-web.mjs
# 几秒后查看 $env:RB_TEST_DIR\events.log 与 restart.log（UTF-8）；每次演练前清空 RB_TEST_DIR

发布清单

更新 package.json 的版本号和 CHANGELOG.md，跑一遍上面的测试。
pnpm pack 生成 dsh-restart-button-<version>.tgz。
打标签 v<version> 并推送，创建同名 GitHub Release，上传两个资产：dsh-restart-button-<version>.tgz，以及同一文件的无版本号副本 dsh-restart-button.tgz。插件市场条目里的 releases/latest/download/dsh-restart-button.tgz 依赖后者。

License

MIT

dsh-restart-button

설치

README