🔥 dsh-hotswap — 从此告别重启！
> DSH 插件的「即插即用」革命 > 安装、卸载、启用、禁用插件，全部无需重启 DSH。 > 就像 USB 热插拔一样自然，一样优雅。
<p align="center"> <img src="https://img.shields.io/github/stars/jarvan642/dsh-hotswap?style=social" alt="stars"> <img src="https://img.shields.io/badge/dsh-plugin-blue?style=flat-square&logo=deepseek" alt="dsh-plugin"> <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="license"> </p>
---
✨ 为什么你需要它？
传统的 DSH 插件工作流：
安装插件 → 重启 DSH → 试一下 → 不好用 → 卸载 → 再重启 DSH → 崩溃有了 dsh-hotswap：
pnpm add 某插件 → 立刻生效 🎉 不满意 → pnpm remove → 瞬间消失零等待、零中断、零重启。
---
🚀 一分钟上手
🤖 AI 时代玩法（推荐）
直接把 GitHub 链接甩给你的 AI：
https://github.com/jarvan642/dsh-hotswapAI 会自动读源码、自动帮你装好，你只需要说一句"帮我安装这个插件"。
🧑💻 手动安装
1. 安装 dsh-hotswap（仅需重启一次）
cd ~/.dsh/profiles/web pnpm add github:jarvan642/dsh-hotswap
2. 手动注册到 cordis.patch.yml（用 cat 代替 echo 确保格式正确）
cat >> cordis.patch.yml << 'EOF'
- insert:
- id: dsh-hotswap name: 'dsh-hotswap' EOF
3. 重启 DSH（仅此一次！）
按 Ctrl+C 停掉 DSH，然后重新启动
4. 从此以后——所有插件都是热插拔！
pnpm add @linxin666/dsh-pet # 装个桌面宠物？即刻生效 🐾 pnpm add @deepseek-ai/dsh-tools # 装个工具包？即装即用 🔧 pnpm remove dsh-pet # 不喜欢了？瞬间卸载 💨
> ⚡ **实测验证**：安装 `@linxin666/dsh-pet` 宠物插件，无需重启，立即可见！
---
## 🎯 核心能力
| 操作 | 传统 DSH | 有了 dsh-hotswap |
|------|---------|-----------------|
| 安装插件 | ⏳ 重启等待 | ⚡ **即刻生效** |
| 卸载插件 | ⏳ 重启等待 | ⚡ **瞬间消失** |
| 启用/禁用 | ⏳ 重启等待 | ⚡ **一键切换** |
| 更新插件 | ⏳ 重启等待 | ⚡ **热重载** |
| 调试开发 | 😫 改一行重启一次 | 😎 **改完即用** |
---
## 🔬 工作原理
dsh-hotswap 深度集成 DSH 底层的 Cordis 框架，通过三项核心技术实现真·热插拔：
┌─────────────────────────────────────────────┐ │ dsh-hotswap 🔥 │ │ │ │ 📡 ProfileWatcher ⚡ Cordis Loader API │ │ ───────────────── ─────────────────── │ │ 监听 package.json │ 运行时创建/销毁 │ │ 自动发现变更 │ Loader Entry │ │ 防抖批量处理 │ 完整生命周期管理 │ │ │ │ 🔗 PluginRegistry 🛡️ 依赖追踪 │ │ ──────────────── ────────────────── │ │ 记录所有插件状态 │ 防止卸载被依赖插件 │ │ 维护依赖关系图 │ 安全回滚机制 │ └─────────────────────────────────────────────┘
**一句话**：你装插件，它自动加载；你卸插件，它自动清理。全程不需要碰 DSH 的重启按钮。
---
## 📦 安装
前置条件：DSH >= 0.1.0-rc.5, Node.js >= 22.19
cd ~/.dsh/profiles/web pnpm add dsh-hotswap
手动注册（后续版本将支持一键注册）
echo "- insert:" >> cordis.patch.yml echo " - id: dsh-hotswap" >> cordis.patch.yml echo " name: 'dsh-hotswap'" >> cordis.patch.yml
重启 DSH（仅首次需要）
---
## 📖 详细用法
### 热安装一个插件
从 npm 安装
pnpm add 某插件
dsh-hotswap 自动检测 → 自动加载 → 即时生效！
无需任何额外操作 🎯
### 热卸载一个插件
pnpm remove 某插件
自动卸载 → 清理资源 → 瞬间完成 💨
### 查看热插拔状态
通过 DSH 插件列表查看
dsh plugin list
或者在 Web UI 的设置页面查看
---
## 🏗️ 适用场景
| 场景 | 效果 | 体验 |
|-----|------|------|
| 🧪 插件开发调试 | 改代码 → 重装 → 立即生效 | 😎 爽 |
| 🔌 试用新插件 | `pnpm add` → 马上用 | ⚡ 快 |
| 🧹 清理不需要的插件 | `pnpm remove` → 立刻消失 | 🧼 干净 |
| 🔄 批量更新插件 | 一个个装/卸，零中断 | 🚀 丝滑 |
| 🐛 插件出问题 | 秒卸，不影响正在进行的对话 | 🛡️ 安全 |
---
## ⚠️ 已知限制
- **带前端 UI 的插件**（桌面宠物、主题皮肤等）：首次安装后需刷新页面才能看到 UI
- **核心服务插件**（修改 LLM 路由、session 持久化等）：仍需重启
- **dsh-hotswap 自身**：第一个安装时需要重启一次（之后所有插件都不需要了）
---
## 🧑💻 开发者说
> "装个插件还要重启？那是上个时代的事了。"
> —— dsh-hotswap，为 DSH 生态带来真正的即插即用体验。
---
## ⭐ 支持项目
如果 dsh-hotswap 帮到了你，请给个 Star ⭐ 让更多人知道！
- [提交 Issue](https://github.com/jarvan642/dsh-hotswap/issues)
- [在 DSH 社区讨论](https://github.com/deepseek-ai/deepseek-harness/discussions)
---
## 📄 许可证
MIT © [Jarvan](https://github.com/jarvan642)