【DeepSeek Harness 插件开发入门】从一行

DeepSeek Harness 插件开发，核心就一条：只认接口，不绑实现。

两种形态：函数插件和服务插件。它们只能二选一，混用会出问题。

怎么干活：函数插件靠 apply 执行，inject 声明依赖。想扩展功能，得往“能力接缝”里塞。接缝就是服务定义，只定契约。提供方给具体实现，消费者把它变成工具。这样换掉底层实现，上面的工具不用动。

生命周期：注册监听器会返回清理函数。卸载时自动回收，这是热替换的基础。瀑布监听必须调 next()，不然链条就断了。

工程规矩：类型单独放 types.ts，测试放包里的 tests。配置项不能写死，全靠 cordis.yml 传进去。缺了关键引用必须大声报错，绝不静默跳过。

四步走：先声明身份，再写 apply 逻辑。接着在配置文件里挂载，最后做真实组合测试。发布后打上 dsh-plugin 标签方便别人找。

记住一句：模型能看到什么变了，就得记下什么变了。