开发者指南
开发者指南
用 Cordis 插件扩展 DeepSeek Harness:架构概览、动态插件、Host 服务与事件、Slot UI 与工具注册
欢迎来到开发者指南。这一节面向想扩展 Harness 本身的开发者:Harness 的每一项能力——工具、模型适配器、会话日志、界面区块乃至 agent loop(智能体循环)本身——都是插件,因此你几乎可以替换或新增任何东西。
一切皆插件
Harness 建立在 vendored 的 Cordis 插件框架之上。没有需要打补丁的特权内核:扩展 Harness 就是把插件挂载到其他插件旁边。
从哪一页开始
Cordis 入门
插件、ctx、服务、事件与可逆副作用——编写插件前需要掌握的组合模型
架构概览
一切皆插件、profile 与 bundle、核心包地图、事件与能力 seam
动态插件
运行时动态插件模型:Host/Client 两半、不可变版本、生命周期与审批
Host 服务与事件
用 ctx.get 读服务、用 inject 声明依赖、监听事件、提供服务
Client UI 与 Slot
在浏览器侧注册 Slot UI、使用 theme token、用 React.createElement 编写界面
注册模型工具
用 defineTool 定义工具 schema 与执行逻辑,注册到 ctx.tools
实操手册
动手做:添加一个包、添加一个工具、接入一个 LLM 适配器
推荐顺序
- 先读 Cordis 入门,掌握插件组合模型。
- 再读 架构概览,理解各能力属于哪里、新行为该挂到哪个扩展点。
- 按你要做的事选择:动态插件、Host 服务与事件、Client UI 与 Slot 或 注册模型工具。
- 需要完整例子时查 实操手册。
开发者预览
Harness 目前处于开发者预览阶段,正在快速迭代,未来可能出现破坏兼容性的变更。开发插件时请以上游仓库为准。