第 2 课：插件能做什么？

一句话版：从「给模型加一个能查 CSV 的工具」到「把整个界面换成 QQ2006 皮肤」再到「让 dsh 跑在安卓手机上」——只要是 DSH 的一部分，就能被插件改。这一课用生态里 275 个真实插件，带你看清这套机制的实际边界。

---

1. 先看一眼盘子有多大

截至 2026 年 8 月，dsh-external 组织里有 275 个已收录的插件仓库（本站「插件超市」页就是这份清单）。按标签统计，最集中的方向是：

看得出来一个规律：改界面的最多。因为 DSH 的 Web 界面本身就是几十个 UI 插件拼的，往里加一块、换一块的成本极低。

下面按「你想改哪儿」分七类，每类都是真实存在的仓库。

---

2. 七类改造，配真实例子

2.1 给模型加一双手：新工具

模型本来只会读写文件、跑命令、搜网页。你可以给它加任何新本事：

这是最常见也最容易上手的一类——第 3 课就带你写一个。

2.2 改你看到的界面

DSH 的 Web 界面是几十个 ui-* 插件拼出来的，所以往里塞东西特别容易：

2.3 改模型怎么想、怎么协作

不只是"换个模型"，而是改变模型工作的方式：

2.4 改记忆与会话

2.5 换个地方用它

DSH 不一定非得在你的终端里：

2.6 纯粹为了好玩

这一类占了 15 个，说明这个机制的门槛是真的低：

2.7 换掉底层零件

这一类最能体现「没有内核」——直接替换系统的执行底座：

• 换命令执行后端（本地 / 沙箱 / PowerShell / 远程沙箱）
• 换会话存储（JSONL / SQLite / 关系数据库）
• 换沙箱实现（bwrap / Landlock / Seatbelt / microsandbox）
• 换子智能体驱动（进程内 / ACP / Codex / Claude Code）

这些官方仓库里就有现成的，配置里改一行就能切。

---

3. 那什么是做不到的？

讲清边界比吹能力更有用。

① 插件改不了"物理规律"。 协议常量、外部 API 的规范、安全不变量是固定的——比如你不能让一个被沙箱拒绝的文件操作"绕过去"，沙箱拒绝是策略结果，不是 bug。

② 有些能力是显式选择才开的（opt-in）。 最典型的是自指工具 tool-cordis——它让模型能在运行中给自己挂载新插件。官方的态度很明确：

这套工具需要显式启用，慎重程度应该和授予 bash 工具一样。

原因很直白：模型写的插件代码会真的进入你正在跑的进程。默认不装，是对的。

③ 插件之间不是完全隔离的。 多个插件抢同一个位置会冲突——比如两个插件都想当唯一的会话标题生成器。DSH 的做法是加载时就报错，而不是悄悄让后者覆盖前者。这叫「配置错误要吵闹」，是好事：早失败好过在运行到一半时表现诡异。

④ 不是所有东西都值得做成插件。 官方有条规矩叫「优先用维护良好的依赖，而不是手搓」——如果一个成熟的库能真正删掉你自己的代码和测试，就该用库。

---

4. 怎么找、怎么装

找：

• 本站的插件超市——275 个仓库按分类可筛
• dsh-hub / dsh-plus——社区维护的精选清单
• marisa（也叫 dshx）——外部插件管理器，按 GitHub topic 自动发现

装：多数插件的 README 都会给一行命令。官方的方式是往 profile 里加：

dsh plugin --profile web add <包名或本地路径>

装完在 cordis.yml 里就能看到它的条目，不想要了删掉那一行就行——回到第 1 课那条规矩：装得上，就卸得掉。

💡 一个实用建议：先从「给模型加个工具」这类插件试起（比如 dsh-toolkit 里的六个零依赖小工具）。它们不改界面、不碰底层，出问题影响面最小。

---

关键点回顾

1. 275 个真实插件，最集中的是界面改造（76）、模型工具（35）、技能（18）。
2. 七个改造方向：加工具、改界面、改模型协作方式、改记忆会话、换使用场所、纯好玩、换底层零件。
3. 界面类最多，因为 Web 界面本身就是几十个 UI 插件拼的，边际成本极低。
4. 边界是真实存在的：协议与安全不变量固定；自指工具默认不开；冲突在加载时就报错。
5. 装卸都是改配置，删掉 cordis.yml 里那一行就回到原样。

🚀 下一课：动手写一个。三步，二十行代码。