dsh-restart-button：DeepSeek Harness 一键重启插件

前言¶

DeepSeek Harness 采用插件化架构，在开发或长时间运行过程中，客户端可能需要重启以加载新代码、释放内存或应用配置变更。手动重启操作较为繁琐，且容易中断当前任务。

dsh-restart-button 是为此场景设计的插件，它通过在界面中增加一个直观的重启入口，实现了一键安全重启整个客户端的功能，并支持会话状态的恢复。

该插件由开发者 PPsz-qqq 维护，开源协议为 MIT。

核心功能是在 DeepSeek Harness 会话标题栏的右上角添加一个重启按钮（↻）。点击该按钮后，客户端会按照既定策略安全地重启，支持 Windows 桌面版和 Web 模式。

界面集成：在会话标题栏右侧工具区最右端（conversation.session.header.utilities，order 1000）添加按钮。
一键重启：无任务运行时，点击按钮即可重启客户端。
跑完自动重启：当有会话或后台作业正在运行时，重启确认框中会出现“跑完后重启”选项。选择后按钮变蓝并闪烁，所有任务结束后自动重启。
状态恢复：重启前会记录当前打开的会话和中断的会话。重启完成后自动恢复会话状态，并弹出提示卡片。点击“全部继续”可向所有会话发送“继续”指令。
插件更新提醒：当插件原地更新（升级或重装）且需要重启才能生效时，按钮上会出现橙色小点，提示“插件更新待生效”。
状态查看：鼠标悬停在按钮上，可查看 Host 运行时长、内存占用、正在运行的会话数、已安排的重启状态及待生效的插件更新。
跨平台支持：
- 桌面版（Windows）：重启 Electron 外壳和后台 Host，参数保持一致。
- Web 模式：重启服务进程，页面自动刷新，服务在后台运行且不占用原终端。

在 DeepSeek Harness 的「插件」页面点击「安装」，在搜索框中输入 dsh-restart-button，选择作者 PPsz-qqq 进行一键安装。

安装完成后，可以在 profile 目录下的 cordis.patch.yml 文件中调整确认策略：

- id: restart-button
  config:
    confirm: when-busy   # 默认策略：有任务运行时确认 | always：总是确认 | never：从不确认

点击重启：在会话标题栏右上角找到重启按钮，点击即可触发重启流程。
配置策略：根据实际需求，在 cordis.patch.yml 中修改 confirm 参数，决定是否需要确认或自动处理。
API 调用：支持通过接口控制，例如调用 POST api/restart-button.restart 接口。请求体可包含 { when: 'now' | 'idle', activeSessionId?: string }。

桌面版限制：桌面版的一键重启功能目前仅支持 Windows，macOS / Linux 桌面版上按钮会自动隐藏。
会话可见性：未打开任何会话（新建会话页）时，按钮不显示。
恢复时效：重启后的会话恢复信息仅 10 分钟内有效。
Web 模式行为：Web 模式下重启服务不占用原终端窗口，日志写入 ~/.dsh/logs/restart-button-web-server.log。
更新生效：插件升级后需要重启一次才能加载新代码，界面会先更新，Host 部分需重启。

dsh-restart-button 为 DeepSeek Harness 用户提供了便捷的客户端重启能力，结合会话恢复机制，有效降低了维护成本。安装后即可在右上角使用，无需额外配置。