dsh-restart-yashua
快速跳转：安装 · 三种用法 · 配置 · 启动前体检 · 兼容性 · 遇到问题 · 相关插件
中文 | English
一键重启 DeepSeek Harness —— 侧栏按钮、/restart 指令、harness_restart 工具，三条入口共用同一套实现。重启会中断当前会话，所以每一处都强制先问一次。
安装
# 从 GitHub
dsh plugin --profile desktop add github:yashua233/dsh-restart-yashua
# 从 npm（若已发布）
dsh plugin --profile desktop add dsh-restart-yashua
# 本地目录（开发或自己改的时候）
dsh plugin --profile desktop add link:/path/to/dsh-restart-yashua
desktop 是桌面端默认的 profile 名，web 端通常是 web 或你自定义的名字——用你自己的那个（~/.dsh/profiles/ 下能看到的目录名）。装完重启一次 DeepSeek Harness 生效。
三种用法
| 入口 | 怎么用 | 确认方式 |
|---|
| 侧栏按钮 | 点「重启 Harness」 | 就地展开确认条，点「重启」才动手 |
| 指令 | /restart --yes | 必须带 --yes，不带只提示 |
| 工具 | harness_restart action=restart confirm=true | 必须 confirm: true，否则只返回「需要确认」 |
侧栏按钮是两段式：第一次点击不重启，按钮原地变成「重启会中断当前会话，确定吗？」+［重启］［取消］。这是最容易被误触的入口，所以放在最显眼的位置也加最厚的门。
相关插件
本插件与另外两个都互不依赖，三者可以任意组合；dsh-mail-command 与 dsh-qq-mail-notify 之间的关系见它们各自的 README。
启动前体检
每次 harness_restart action=status、以及每次真正重启之前，插件会把已知会导致「DSH 打不开」的情况查一遍（只读，不改任何文件）：
| 检查项 | 对应真实故障 |
|---|
| profile 配置带 UTF-8 BOM | 启动时 JSON.parse 直接抛错，应用秒崩 |
| 本地登录 cookie 累积过多 | 请求头超过 16KB，握手 431，界面报「认证失败」 |
client.js 模块 id 与包名不一致 | duplicate factory registration，Web 端卡在启动阶段 |
| 目录名与包名不一致 / 入口文件缺失 | 包解析不到，显示「未安装」 |
装了插件却没登记进 bundles | 依赖在但加载不到 |
bundles 里登记了没装的包 | cannot resolve profile bundle |
app.asar 与解包目录并存 | Electron 优先 asar，改了 app 目录不生效 |
| 宿主模块被第三方补丁改过 | 典型的是审批被短路成「一律自动放行」，所有「等你授权」的功能静默失效且不报错 |
发现问题时会在工具返回里直接给出是哪一项、什么后果、怎么修；重启照常执行（重启本身常常就是为了让修复生效），问题只是提前告诉你，免得重启完还是一样打不开。
重启是怎么做到的
按「最干净的先试，不行再往下退」排了三层：
- 桌面运行时服务 —— 如果宿主提供了
desktopRuntime / desktopActions 的 requestRestart，直接交给它，Electron 自己 relaunch。最干净，首选。
- 脱离进程树重来 —— 没有运行时服务时，写一个
wscript 脚本用 detached + unref 的方式起出去，再让脚本自己做三件事：按 ExecutablePath 精确匹配同名进程（DeepSeek Harness.exe / DSH Desktop.exe）全部 taskkill，等它们真的消失；如果 resources\app 已解包而 app.asar 还在，先把 asar 改名让位（否则 Electron 仍优先加载 asar）；最后拉起一个干净的 GUI。
- 都不成立 —— 明确返回失败，让你手动重启，绝不假装成功。
第 2 层有个容易忽略的点：Host 进程本身是 ELECTRON_RUN_AS_NODE 模式跑起来的 DeepSeek Harness.exe，和 GUI 主进程同名同路径。所以重启不能按进程名杀，必须按可执行文件路径精确匹配，否则会误杀同一个 exe 的其它实例。
为什么要写文件再杀进程
杀自己的父进程会连带杀掉自己，所以第 2 层必须先把动作写成一个独立脚本，交给 wscript.exe 以 detached 方式启动——它不在宿主进程树里，宿主被杀时它能活下来继续干活。脚本里同时清掉了 ELECTRON_RUN_AS_NODE 和 DSH_PERMISSION_MODE 两个环境变量，避免新拉起的 GUI 继承了宿主模式变成无界面的哑进程。
HTTP 入口的两道门
侧栏按钮走 POST /dsh-restart/restart，这条路能直接打断整个应用，所以加了两层防护：
- 同源校验：
sec-fetch-site: cross-site 一律 403；Origin 和 Host 不一致也 403（dsh-app://app 是桌面端页面自身的 origin，属于正常情况，放行）。别的网页没法诱导你的浏览器替你重启。
- 强制确认：请求体没有
confirm: true 直接返回 428 needs_confirmation。界面自己会弹确认框，这条是防止有人绕开界面直接打接口。
体检的开关
走配置文件 ~/.dsh/dsh-restart.json，改完即时生效，也可以走「设置 → 重启与体检」：
| 字段 | 默认 | 说明 |
|---|
preflight.crashLogs | true | 是否回看 crash-*.log |
preflight.crashLogDays | 7 | 回看多少天 |
preflight.sessions | true | 是否检查会话文件（只能查明显异常） |
会话文件按解压后的内容判定，不看压缩后多少字节：空会话（只有 session 头、没有消息）是正常的，不会报；解不开、解压后为空、首行不是 session 头才报异常。
日志与排障
每次重启都会写 $DSH_HOME/logs/restart.log，关键几行：
begin exe=...
pids=1234,5678
left=0
asar swap: ok
started
left=0 说明旧进程全清干净了；不是 0 说明有进程杀不掉（通常是权限或另一个用户会话里的实例），脚本会放弃启动，避免出现两个实例。asar swap: skipped (no unpacked app or no asar) 是正常情况——没有解包过就没什么要让位的。- 想确认宿主的重启能力，用
harness_restart action=status，它会返回当前环境、可用的重启路径和延迟。
配置
| 字段 | 默认 | 说明 |
|---|
enabled | true | 总开关；关掉后三条入口都不注册 |
delayMs | 1200 | 从触发到真正动手的缓冲毫秒数，留给工具结果和 HTTP 响应送达客户端 |
写在 profile 的 cordis.patch.yml 里：
- insert:
- id: dsh-restart-yashua
name: 'dsh-restart-yashua'
config:
delayMs: 2000
兼容性
- 只声明实测过的那个版本：
0.2.1-rc.5。package.json 里 dshTarget 和 dsh.compatibility.dsh 都是它，没有范围。
- 为什么不写成
>=x <y：DSH 还在开发者预览，官方明确说会有破坏性变更，跨一个小版本（0.2.1 → 0.2.2）就可能装不上或行为不对。写范围等于替你赌那些版本，我不赌。
- 想装在别的版本上：把
dsh.compatibility.dsh 改成你手上的版本再试。能跑是运气，跑不动是常态——反馈时请带上版本号。
- 桌面端依赖
wscript.exe（Windows 自带）；web 端如果宿主提供了 desktopRuntime 服务，走第 1 层，不需要 wscript。
- 只重启同路径的桌面进程。Linux / macOS 上的第 2 层不适用，会落到第 3 层返回「需要手动重启」。
遇到问题
重启出岔子时，先看它自己的体检——八类已知故障会直接点名：
harness_restart action=status
再加一条身份自查（改过包名、或插件显示「未安装」时必跑）：
& "$env:DSH_HOME\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe" `
scripts\check-identity.mjs
重启日志在 $DSH_HOME/logs/restart.log，末尾几行就够定位：left=0 表示旧进程清干净了，非 0 说明有进程杀不掉（通常是权限，或另一个用户会话里还有实例），脚本会放弃启动以免出现两个宿主。
还是不行就提 issue：https://github.com/yashua233/dsh-restart-yashua/issues。走 issue 而不是私信，后面遇到同样问题的人能搜到。
带上这几样，能省好几轮来回：
- DSH 版本、本插件版本（
package.json 的 version）；
harness_restart action=status 的完整输出；restart.log 的最后十几行；- 你的环境：桌面端还是 web、Windows 版本、DSH 是安装在默认路径还是解包目录。
路径里如果带了用户名，贴之前先打码。
隐私
不联网、不收集任何数据。唯一的副作用是写 $DSH_HOME/logs/restart.log，内容只有进程号、asar 是否让位、启动是否成功这几项，不含任何会话内容。
许可证
MIT，见 LICENSE。
