重启助手 machine202502/dsh-restart

dsh-restart

从界面或智能体工具重启 DeepSeek Harness，启动后还能继续同一个会话。

功能

| 功能 | 位置 |
| 「重启」按钮 | 侧边栏页脚，账号旁边（电源图标） |
| 确认 | 弹窗，两个按钮，没有多余选项 |
| 智能体工具 | dsh_restart({ fake })，仅用于开发扩展 |
| 继续会话 | 用工具重启会打开会话并写入 [auto.continue] |

重启怎么工作

重启进程不能是应用的子进程：taskkill /T 会把整棵进程树连同它一起杀掉。所以插件：

1. 写入标记文件 %LOCALAPPDATA%\dsh-restart\pending.json；
2. 创建一次性计划任务 DSH-Restart（Windows），附带 helper 脚本；
3. helper 等 1.5 秒，关闭应用的进程树，再等 1.8 秒，启动 .exe，然后删除任务。

macOS/Linux 上改用独立的 sh 进程（kill + open/启动）。

自动继续

启动后，客户端通过本地桥 127.0.0.1:49233 读取标记：

GET /claim → { marker } — 原子操作：只有一个客户端能拿到标记 POST /restart → 写入标记并重启 GET /health → 供看门狗判断宿主是否存活 GET /settings → 当前的覆盖配置 POST /settings → 保存覆盖配置（不重启）

标记只会被一次页面加载取走，所以双重初始化不会产生两条消息。用工具重启会以 [auto.continue] 消息恢复会话：客户端打开同一个会话，等输入框就绪，插入文本，再点发送按钮发出（Enter 是备用方案）。侧边栏页脚的按钮不写标记，也不继续会话。

你的草稿不会丢：如果输入框里已经有文字，先临时存到 localStorage，发出 [auto.continue]，然后把文字放回输入框（不发送）。消息队列是会话状态，插件不读也不改。

工具

这个工具用于开发和调试 DSH 本身：插件、cordis.patch.yml、配置档。它不用于日常使用、「刷新状态」，也不用于那些不改代码或配置、却需要新进程的调用。

dsh_restart { fake: true }
→ Preflight passed; fake restart requested, nothing was restarted.

不带 fake 时，工具会重启应用，并以 [auto.continue] 消息恢复会话。fake 标志会跑完所有检查，但不重启任何东西，用于测试。如果工具被禁用，从旧记忆里发起的调用会失败，报 unknown tool "dsh_restart"。

插件设置

在 Plugins → Restart → Configure 页面：

| 设置 | 默认值 | 作用 |
| 智能体可调用 dsh_restart 命令 | 开启 | 关闭后工具消失；从旧记忆里发起的调用会失败，报 unknown tool "dsh_restart" |
| 看门狗已启用 | 开启 | 关闭时，重启只会关闭并重新打开应用，不回滚配置档 |
| 看门狗等待，秒 | 10 | 回滚前等待「启动成功」信号多久（1–120） |

覆盖项保存在 %LOCALAPPDATA%\dsh-restart\settings.json；cordis.patch.yml 里的值仍是默认值。保存设置不需要重启：工具会即时注册和注销。

工具何时拒绝执行

dsh_restart 只在「安静」模式下对智能体可用——此时重启不会打扰任何人：

| 检查 | 拒绝信息 |
| 由子代理调用 | dsh_restart is only available to the main agent: a subagent cannot restart the app; do not retry, report the need to the parent agent instead |
| 访问模式不是 Full access | dsh_restart requires the Full access permission preset (current: …) |
| 还有其他会话或子代理在工作 | dsh_restart refused: N other session(s) or subagent(s) are still working (…) |
| 有正在运行的后台任务 | dsh_restart refused: N background job(s) are still running (…) |

检查通过 ctx.permissionPresets.current(agent.session)、ctx.agents.list() 和 ctx.jobs.list(agentId) 进行；「工作中」状态指 running，或智能体的输入队列非空。子代理的标志是 exec.agent.options.subagentDepth（外加 exec.parent）。

界面上的按钮不执行这些检查：何时重启由用户自己决定。

限制

- 托盘和原生 Application 菜单里的菜单项无法由插件添加：托盘和菜单运行在 Electron main 进程，而插件运行在子 host 进程；
- 重启通过 Windows 任务计划程序执行；如果策略禁止创建任务，重启不会生效；
- 此刻正在执行一轮对话的工作区会话会被中断（模态框也会这样提示）。

按钮和工具的行为不同

- dsh_restart（智能体）——总是打开会话并写入 [auto.continue]（如果看门狗回滚了配置档，则写入 [auto.continue.failed]）。
- 侧边栏的「Restart DeepSeek Harness」按钮——只是重启应用：不创建标记，不继续会话，不发送自动消息。

Cookie 与「Web authentication failed」

每次启动 Desktop Host 都会占用新端口，并为 127.0.0.1 设置 dsh-auth-<random> cookie。Chromium 按主机而非端口存储 cookie，所以旧 cookie 不会被替换，会越积越多。在真实安装环境实测：约 122 个这类 cookie 会让 Cookie 请求头达到约 17.5 KB，超出限制（16 KB），欢迎请求收到 431，应用随即崩溃并报 desktop welcome: Web authentication failed。另外，这些 cookie 的寿命在配置档里有限制：connection.cookieMaxAgeDays: 7。

每次启动前（杀掉应用之后、Start-Process 之前），helper 会运行 src/cookie-clean.py，只删除 127.0.0.1/localhost 的 dsh-auth-* 行。其他 cookie 不动。
如果应用偏偏在问候语这一步崩溃（崩溃日志里有 Web authentication failed），看门狗不会回滚配置档，也不会禁用插件：它会清掉 cookie，再次启动应用，等待健康启动。

看门狗与重启的绑定

每次重启都会拿到一个 token：

dsh_restart → marker { token, sessionId } + watchdog.json { token }
сторож → перед откатом сверяет токен в watchdog.json
старт → хост удаляет watchdog.json (токен аннулирован)

因此看门狗只对触发它的那次重启生效，碰不到之后启动的应用，也碰不到由其他重启启动的应用。

回滚之前，看门狗会把 package.json、cordis.patch.yml、cordis.yml 的 SHA-256 与请求时保存的值比对。如果文件被手动改过，就不执行回滚——视为人已经接手了这些改动。

配置档文件写入时不带 BOM（WriteAllText + UTF8Encoding(false)），否则宿主读不了 package.json。

已知限制：子代理结束后的任务

如果子代理启动了后台任务，然后结束了本轮，DSH 会连同智能体一起删掉这条任务记录，尽管任务本身还在跑。重启前的检查看不到这种任务，也不会因此拒绝重启。

覆盖情况：

| 工作归属 | 能否拒绝 |
| 自己的后台任务 | 能 |
| 子代理或其他会话仍在运行 | 能 |
| 归属者存活期间它们的任务 | 能 |
| 子代理结束本轮后的任务 | 不能 |

原因：任务注册表 ctx.jobs 按智能体 id 索引，智能体销毁时一并清空；jobs.start 包装只看得见经这条路启动的任务，而子代理启动任务走的是另一条路。靠子进程检测并不可靠：应用的服务进程一直在旁边出现又消失。方案暂缓。

安装

npx --yes github:machine202502/dsh-restart

或手动：

"dsh-restart": "github:machine202502/dsh-restart#main"

再把 dsh-restart 加进 dsh.profile.bundles。

安装后需要重启应用（等按钮出来以后，也可以点按钮）。

检查

node tests/smoke.mjs # 工具、检查、fake、桥
node tests/load-client.mjs client.js # 客户端模块能加载并导出 apply

许可证

MIT