如何创建 DSH 插件

创建 DSH 插件时，应围绕一个明确能力、Cordis 入口、可说明的配置和可测试的安装路径展开。

先定义单一插件边界

写集成代码前，明确能力、所需权限、外部数据流、配置和失败行为。

按 DeepSeek Harness 文档的入口模式暴露插件，并把副作用限制在注册的生命周期内。

写清 package 或本地路径、目标 profile、前置条件、最小示例和移除路径。

来源用于核对当前事实，不代表来源方认可本站结论。

创建 DSH 插件需要准备什么？

Node、一个包管理器，以及一个 Cordis 能加载的入口。直接照着一个能跑的插件的结构改，比从空目录开始快得多。

创建 DSH 插件必须先搞懂 Cordis 吗？

至少要懂到能注册插件并在销毁时清理干净。Cordis 是负责加载插件、管理生命周期的运行时，所以副作用要放在注册的生命周期里，而不是放在 import 阶段。

第一个版本应该做多小？

只做一件事。只做一件事的插件只有一种失败模式、一处配置面、一件要写进文档的东西，这才让别人有可能 review 它。

插件里的凭据怎么处理？

从环境变量或宿主提供的密钥机制里读，绝不写进会提交的文件，也不要设默认值。不要打日志，错误信息里也不要回显。

README 里必须写什么？

安装命令、目标 profile、前置条件、一个能跑通的示例，以及怎么卸载。插件文档里缺得最多的就是卸载说明。