前言¶

在本地运行 DeepSeek Harness（DSH）时，Host 进程有时会卡死，导致会话、插件状态和工具子进程无法恢复。手动关闭窗口通常只能结束主进程，留下多个 DeepSeek Harness.exe 子进程，需要逐个结束或重启系统才能清理干净。

这个插件在 DSH 桌面应用的侧边栏底部提供一个重启按钮。点击一次即可从应用内部停止所有进程（Electron shell、Host、渲染器和工具子进程），然后重新启动应用，页面会在应用恢复后自动刷新。

插件定位¶

• 名称：dsh-restart-app
• 维护者：7AAAAAH
• 分类：客户端（仅适用于 Windows 桌面应用）
• 许可证：MIT

插件通过 /dsh-restart-app/restart 接口触发重启流程，帮助在 Host 卡死时快速恢复工作环境，而不是依赖手动关闭窗口或重启系统。

核心功能¶

一键重启整个桌面应用

• 点击侧边栏底部的按钮，停止所有应用进程
• 重新启动应用，并在页面恢复后自动刷新
• 仅在 Windows 桌面应用中可见；在 dsh web、dsh tui 或普通 Node 进程中隐藏（因为这些场景没有可重启的终端会话）

重启流程

1. 侧边栏按钮发送 POST /dsh-restart-app/restart 请求，Host 立即返回 202 状态码。
2. Host 在 %TEMP%\dsh-restart-app\<时间戳>\ 下写入两个 PowerShell 脚本，并启动 stage 脚本。
3. stage 脚本调用 Start-Process 启动 helper，然后退出，使 helper 不再属于任何应用进程树。
4. helper 等待 900 毫秒（确保 HTTP 响应刷新），然后停止所有进程名与主程序相同或位于应用目录下的进程。
5. 等待进程表清空后，用 Start-Process 重新启动应用可执行文件。
6. 5 秒后记录新应用是否存活，然后退出。
7. 页面每秒轮询自身 origin，当服务器再次响应时刷新页面。

日志位置

当重启失败时，可以查看 helper 日志：

%TEMP%\dsh-restart-app\<时间戳>\helper.log

日志示例：

2026-10-23T17:59:01.7560041+08:00 helper start pid=21416
2026-10-23T17:59:03.0707319+08:00 stopping 1 application process(es): 25428
2026-10-23T17:59:03.3103882+08:00 application processes are gone
2026-10-23T17:59:03.8181757+08:00 relaunching C:\Program Files\DeepSeek Harness\DeepSeek Harness.exe
2026-10-23T17:59:03.9243984+08:00 relaunched pid=24200
2026-10-23T17:59:08.9546037+08:00 relaunched application is alive after 5s (pid=24200)
2026-10-23T17:59:08.9556013+08:00 helper done

安装与启用¶

插件通过 DSH 插件管理器安装。

从 GitHub 仓库安装

dsh plugin --profile desktop add github:7AAAAAH/dsh-restart-app

从本地 checkout 安装

dsh plugin --profile desktop add link:C:\path\to\dsh-restart-app

安装后需要重启一次应用，使 profile 加载插件。重启后，侧边栏底部会出现重启按钮，位于设置齿轮旁边。

卸载

dsh plugin --profile desktop remove dsh-restart-app

典型用法¶

1. 确保运行的是 Windows 10/11 上的 DeepSeek Harness 桌面应用。
2. 在侧边栏底部找到重启按钮。
3. 点击按钮，等待应用重启并页面刷新。
4. 如果重启失败，检查 %TEMP%\dsh-restart-app\<时间戳>\helper.log 日志。

适用场景与注意¶

适用场景

• Host 进程卡死，会话无法恢复
• 需要快速重启整个桌面应用，避免手动清理残留进程
• 需要在不离开桌面应用的情况下恢复环境

注意

• 插件仅适用于 Windows 桌面应用；在 dsh web、dsh tui 或普通 Node 进程中不会显示按钮。
• 插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
• 需要满足以下环境要求：
• Windows 10/11
• PowerShell 5.1
• Node 20+（用于 Host 侧）

小结¶

当 Host 卡死时，手动重启应用容易留下子进程。这个插件通过内部接口触发重启流程，确保所有进程被正确清理和重新启动，帮助快速恢复工作环境。

• 插件目录：https://www.skillhub.cn/plugins/7AAAAAH/dsh-restart-app
• GitHub：https://github.com/7AAAAAH/dsh-restart-app