插件开发指南
学习如何开发 DeepSeek Harness 插件。下面的路线图带你逐章走完官方 Cordis 教程——每个阶段都指向对应的官方章节，资料区收拢了精选参考，避免你去各处找失效链接。
第一阶段 — 快速上手
01 · 你的第一个插件
插件就是一个函数，由 loader 挂载。构建第一个可运行的插件，掌握最小骨架。
第二阶段 — 核心概念
02 · 生命周期与副作用
由 Cordis 管理的注册会在插件卸载时自动撤销。理解清理与自动拆卸。
03 · 服务（Services）
在 ctx 上暴露能力，并用 inject 依赖它。
04 · 事件（Events）
类型化事件、广播派发与瀑布短路。
第三阶段 — 配置与工作流
05 · 配置（Configuration）
从 cordis.yml 读取校验配置，输入错误时大声失败。
06 · 组合与热重载（Composition & HMR）
把配置文件当作插件树、热重载，以及诊断一个从不加载的插件。
第四阶段 — 深入 Harness
07 · 进入 Harness
把可被模型调用的工具注册到真实的 harness 服务。
精选外部资料
- • 官方 DeepSeek Harness 仓库 —— 源码、Issue 与文档目录。
- • Cordis 教程（目录） —— 完整的实操与 TypeScript 笔记。
- • Cordis 入门速查 —— 精简概念参考。
- • Cordis 核心 API（context） —— 详尽 API 参考。
- • 架构文档 —— 理解“一切皆插件”如何组合。
- • 你的第一个 Harness 插件 —— 用于在 Web UI 中按
cordis.yml加载的插件，而不只是命令行。 - • 社区讨论 —— 向社区提问。
想找示范这些模式的真实插件，可在插件注册表搜索 dev、cli、api 等关键词，学习现实示例。
来源：官方 DeepSeek Harness 文档（公开）· 由 dsh.so 维护 · 最后更新