一切都是插件：依赖、注册、卸载

?先猜：哪些是插件？

1一个插件只写两样

回到开头的问题：每个部件都能单独装、单独换，是怎么做到的？第一步，先看一个插件长什么样。例子是 DSH 真实的 bash 工具。

export const name = 'tool-bash'
export const inject = ['tools', 'shell', 'systemPrompt', …]  // 依赖
 
export function apply(ctx) {                // 启动函数：依赖齐了，Cordis 才调用它
  ctx.systemPrompt.section({ name: 'tool:bash', order: …, text: '…' })  // 注册①：一段用法说明（order 是排序号，第 06 章讲）
  ctx.tools.register(bashTool)              // 注册②：一个叫 bash 的工具
}

inject 里写的 tools、shell、systemPrompt，也都是插件，只是专门给别的插件用，这类插件叫服务。注意同一个服务有两种写法：插件名用短横线（system-prompt），代码里的服务名用驼峰（systemPrompt），说的是同一个东西。但服务名不一定能从插件名推出来：同一个服务可以由不同的插件提供，比如 shell 这个服务，可以由 bash-local 或 bash-sandbox 提供（第 07 章）。插件通过 ctx.名字 用它们，上一章循环里的 ctx.llm 就是这么来的。启动时发生的事，用对话来说是这样：

不只是工具。下面四个插件，平常被叫成不同的“种类”，其实长得一样：依赖加启动函数。差别只在启动函数里用 ctx 做了哪几件事：

// shell 服务的规定（shell 插件）：一个类，构造时报上名字export abstract class ShellExecutor extends Service {  constructor(ctx) { super(ctx, 'shell') }   // 服务名就在这里定  abstract resolve(…)                         // 实现必须提供的方法  abstract execute(…)} // 一个实现（bash-local 插件）：继承它，导出这个类export default class LocalBashExecutor extends ShellExecutor { … }

2依赖缺一个，插件会怎样？

第二步：插件只写了依赖，没写“谁先启动”。那启动顺序由谁定？由 Cordis 定：依赖不齐的插件不会启动，齐了才启动。互相没有依赖的插件，谁先谁后不保证。

自己试一试：现在 system-prompt 没装，好几个插件是 PENDING。把它打开，看谁会自己启动。

写进 inject 的是必需的依赖：缺一个，插件就等着。还有一种可选的依赖：不写进 inject，插件照常启动，等真要用的时候再问一句 ctx.get('名字')。有就用；拿到的是 undefined，就由插件自己决定怎么办。比如 bash 用审批服务就是这样（第 05 章）。

3卸载插件，注册的东西跟着撤掉

第三步：能装，还得能卸，才谈得上“单独换掉”。像 ctx.tools.register、ctx.systemPrompt.section 这样注册的东西，插件不用自己写清理代码。

怎么做到的？这些注册接口里面都做两件事：把东西放进去；同时把“怎么撤掉”交给 Cordis，记在这个插件名下。卸载时，Cordis 按交来的倒序，把这些撤销一个个执行。简化后大致是：

ctx.effect(() => {
  工具表.add(bashTool)                  // 做这件事
  return () => 工具表.delete(bashTool)  // 交回“怎么撤掉”，Cordis 记在插件名下
})

所以，只有把“怎么撤掉”交给了 Cordis 的事，卸载时才会被撤掉。插件自己开的定时器、网络连接、子进程，Cordis 不知道；要让它们在卸载时停下，就用同一个办法自己交给它。个别注册接口只把撤销函数还给你、自己不交，也照这样用 ctx.effect 包一层：

ctx.effect(() => {
  const 定时器 = setInterval(检查, 60000)
  return () => clearInterval(定时器)    // 卸载时 Cordis 会调用它
})

新建的文件是另一回事：那是用户要的成果，卸载插件本来就不该删它。

✓三道小题