前言¶

在 DeepSeek Harness（DSH）里做插件开发或改 profile、环境变量时，很多变更只有完整重启桌面进程才会生效。常见做法是关窗口、确认进程退出、再手动打开应用，步骤多，也容易漏。DSH 社区插件 @grapt/dsh-quick-restart 把「退出并重开」收进右下角头像菜单：二次确认后自动关闭并重新拉起应用，失败时会说明卡在哪一步。

这是什么¶

维护者为 GraptK（包作者署名 Grapt），项目在 GitHub 开源：GraptK/dsh-quick-restart。npm 包名为 @grapt/dsh-quick-restart，当前版本 1.0.4，许可证 MIT。插件不替换原有账号菜单，设置、意见反馈、退出登录保持原样，也不修改 DSH 安装目录。

核心功能¶

下面介绍 README 中已说明的能力。

菜单入口¶

在同时出现「设置 + 意见反馈」的账号菜单里，于「意见反馈」之后、「退出登录」之前插入「重启」项，样式与键盘行为对齐宿主菜单项（1.0.4 起调整为此顺序）。

确认与过程状态¶

点击「重启」会弹出二次确认，默认焦点在「取消」，并提示正在生成的内容与终端任务可能中断。重启期间该项禁用，文案变为「正在重启…」，图标旋转。

结果与失败原因¶

成功时显示用时。失败时会区分无权限（401/403）、Web 模式不支持、helper 缺失、等待超时、拉起失败等，并给出阶段、原因与日志路径。

安全边界¶

只接受本机同源请求；重启 API 的 POST 须为 JSON 且带 confirm: true；不暴露文件系统或任意命令。实现上采用受控 DOM 增强，异常时最坏情况是不显示「重启」项，不影响原菜单其它功能。

重启本身是强制结束主进程再拉起，不走 Electron 正常退出清理，未保存编辑内容、进行中的生成与终端任务会被中断。

安装与启用¶

1、在 DSH 插件市场安装 @grapt/dsh-quick-restart。

2、安装后完整退出并重新打开 DSH 桌面版一次，以便 Host 半注册路由。

3、打开右下角头像菜单，在「意见反馈」下方可见「重启」。

首次使用前请先保存正在编辑的内容。

典型用法¶

1、点头像，选择「重启」。

2、在确认框中点「立即重启」。

3、应用在数秒内关闭并自动重开；重开后会显示结果提示。

取消或按 Esc 不影响原菜单与当前工作。

失败时可查看日志与结果文件（Windows 示例如下）：

%USERPROFILE%\.dsh\dsh-quick-restart\
├─ restart.log        # 每次尝试的阶段日志
└─ last-result.json   # running / relaunched / failed

适用场景与注意¶

适合在以下情况使用：

• 安装、升级或停用插件后需要完整重启 DSH。
• 修改 profile、环境变量或 Host 侧代码后需要重新加载。
• 调试桌面版时频繁重启，不想每次找进程或托盘菜单。
• 多窗口同时打开，希望一次全部关闭并重开。

支持范围（以 README 为准）：

• DSH 桌面版 0.2.1-rc.2，Windows 10/11 x64：已实际完成端到端重启。
• macOS / Linux：同一套 helper 逻辑，尚未实测，不承诺可用。
• dsh web：不支持，会明确提示。

社区插件以当前 DSH 进程权限运行，安装前建议阅读仓库源码与 MIT 许可证，确认符合你的环境与安全要求。DSH 插件目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-quick-restart 把「改完配置或插件后要完整重启」收成头像菜单里的一步操作，并带确认、进度与失败说明。目录页：https://www.skillhub.cn/plugins/GraptK/dsh-quick-restart；源码与详细说明：https://github.com/GraptK/dsh-quick-restart。问题反馈可联系作者：graptk87@gmail.com。