dsh-hotswap

DSH 插件的「即插即用」革命
安装、卸载、启用、禁用插件，全部无需重启 DSH。
就像 USB 热插拔一样自然，一样优雅。

---

✨ 为什么你需要它？

传统的 DSH 插件工作流：

安装插件 → 重启 DSH → 试一下 → 不好用 → 卸载 → 再重启 DSH → 崩溃

有了 dsh-hotswap：

pnpm add 某插件 → 立刻生效 🎉 不满意 → pnpm remove → 瞬间消失

零等待、零中断、零重启。

---

🚀 一分钟上手

🤖 AI 时代玩法（推荐）

直接把 GitHub 链接甩给你的 AI：

https://github.com/jarvan642/dsh-hotswap

AI 会自动读源码、自动帮你装好，你只需要说一句"帮我安装这个插件"。

🧑‍💻 手动安装

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 的重启按钮。

---

## 📦 安装

```bash
# 前置条件：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
• 在 DSH 社区讨论

---

📄 许可证

MIT © Jarvan