前言¶
在 DSH 里折腾插件、改配置或装 bundle 之后，宿主进程往往要重启一次改动才会生效。常见做法是找系统托盘退出，再手动双击打开应用，步骤分散，打断调试节奏。下面介绍 @cxk9911/dsh-quick-restart：在侧边栏设置按钮上方增加「重启 DSH」，点一次、确认一次，由插件在 Windows 桌面版上关闭当前 DSH 并重新拉起同一可执行文件。
这是什么¶
维护者为 CXK991，npm 包名 @cxk9911/dsh-quick-restart（当前版本 1.0.1，许可证 MIT）。分类属于 DSH 客户端插件：在界面里挂按钮和确认浮层，同时在宿主侧提供重启 API。一句话定位：把「改完东西要重启 DSH」从托盘操作收成侧边栏里的一次确认。
GitHub 仓库：CXK991/dsh-quick-restart。SkillHub 目录页：dsh-quick-restart。
核心功能¶
已核实的能力如下。
- 侧边栏入口：左下角、设置按钮正上方显示「重启 DSH」。侧边栏在 Windows 桌面版收起时，底部区域会被 shell 隐藏，按钮需展开侧边栏才可见；Web / macOS 收起态会显示为单个图标（自动重启仍以 Windows 桌面版为主路径）。
- 确认后重启：确认框点「立即重启」后，DSH 关闭；助手等待约 1.2 秒，按进程名结束 DSH，再启动同一个 exe，桌面窗口自行恢复。新进程
bootId会变。 - 协议握手：前端在
POST前先GET /dsh-quick-restart/api/restart，核对protocol（当前为 2）；版本不一致则拒绝触发并提示先手动重开，避免旧版插件代码导致「关了不回来」。 - 安全与节流：接口仅对本机已登录页面放行（fail-closed）；20 秒冷却，防止连点。
非 Windows 平台会返回明确错误，不会静默失败。dsh web 命令行侧留有按 node 重新拉起的兜底逻辑，README 注明该路径未做同机实测。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证。安装命令须使用资料中的包名，不要凭仓库名自行拼接 github:owner/repo。
方式一：命令行（npm，推荐）
桌面版 profile 通常为 desktop：
dsh plugin --profile desktop add @cxk9911/dsh-quick-restart
DSH Web：
dsh plugin --profile web add @cxk9911/dsh-quick-restart
也可在 设置 → 插件 → 安装 中填写包名 @cxk9911/dsh-quick-restart。
方式二：Discover 索引源
README 说明该插件尚未收录进 dsh-market 社区目录，市场搜索可能找不到。若使用 Discover，需先打开 Plugins → Experimental plugins → More 中的 Custom plugin markets，在 Discover → Add index source 粘贴任一地址：
https://cdn.jsdelivr.net/npm/@cxk9911/dsh-quick-restart/index.json
https://raw.githubusercontent.com/CXK991/dsh-quick-restart/main/index.json
方式三：本机 link 试用
dsh plugin --profile desktop add "link:/path/to/dsh-quick-restart"
装完后需重启一次 DSH（或由插件管理器触发 profile 重载），侧边栏底部才会出现按钮。
典型用法¶
- 展开侧边栏（Windows 桌面版收起时按钮不显示）。
- 点 「重启 DSH」，在确认框点 「立即重启」。
- 等待应用关闭并自动重新打开；若插件刚更新过，先手动重开一次 DSH 再使用按钮，以便加载新版宿主逻辑。
出问题时可在 %TEMP%\dsh-quick-restart.log 查看助手记录的 --- / targets= / killed / launched 等步骤。
适用场景与注意¶
适合：频繁改插件或配置、装 bundle 后需要重启宿主，且主要使用 Windows 桌面版 DSH 的开发者。
限制（来自 README）：
- 自动重启仅在 Windows 桌面版 完整支持。
- 进行中的任务会被中断；会话记录会落盘。按进程名结束 DSH 时，非同名子进程（如 MCP server、PTY 里的 bash）不会被杀掉，可能成为孤儿进程，重启后可能重复启动。
- 桌面宿主使用
--port 0随机端口，重启后端口变化；若用浏览器标签连旧地址，需回到桌面窗口。 - 重新拉起时不带自定义启动参数。
- 星标等社区数据以各站点展示为准；SkillHub 线索为 0 star，不影响 npm 安装。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-quick-restart 把重启宿主收进侧边栏一次确认，面向 Windows 桌面版改插件、改配置后的常见流程。详情与实现说明见 GitHub README，安装与索引见上文命令与 SkillHub 目录页。
