deepseek-ai/deepseek-harness 仓库于 2026 年 6 月 10 日公开上线，带着一个需要时间消化的前提：一切皆插件。运行时、CLI、Web UI，甚至 agent skills——全部通过同一个插件接口加载。如果你一直在试图理解 deepseek harness 插件架构，这就是该从哪个心智模型开始。
中心的 dsh 运行时
dsh 运行时是加载并执行插件的进程。它定义生命周期——发现、加载、验证、运行——并执行 dsh.bundle 契约。插件在 bundle 中声明入口点；运行时解析依赖并在平台允许处做沙箱化执行。
Cordis Core 作为内核
运行时下面是 Cordis core，继承自 Cordis 框架的依赖注入内核。它装配服务、管理上下文，给插件一个可预测的彼此通信环境。理解 Cordis 很重要，因为插件配置、上下文隔离与服务覆写都流经它。
面向插件作者的 Python SDK
大多数插件基于官方 Python SDK 编写，它把运行时契约包装成熟悉的 Python：一个类、几个装饰器、一个 bundle manifest。SDK 隐藏了大部分机制——但知道它存在有助排查，因为插件出问题时，错误几乎总能追溯到 SDK 试图平滑处理的契约违规。
架构对安装者为何重要
- 一切皆插件意味着你安装的每一段代码获得相同的运行时权限——以及相同的风险画像。
- dsh.bundle 声明是运行时检查的唯一契约；缺失是合理警告。
- Cordis 隔离的强度只取决于底层沙箱（参见我们的 Landlock 深度解读）。
一旦把架构看作一个底层有内核的插件接口，生态就不再混乱。同时也很清楚为什么对单个插件的质量评分与安全扫描如此重要。