前言¶
DeepSeek Harness (DSH) 提供了一套完整的智能体开发能力，包括持久会话、模型适配、工具调用等。在 Cordis 插件体系中，直接引入这些能力通常需要手动处理生命周期和依赖注入。dsh-cordis 的作用是将 DSH 的编码引擎作为一个标准的 Cordis 插件打包，使其能挂载到调用者现有的 Loader 树中，解决集成复杂度问题。
是什么¶
dsh-cordis 是一个将 DeepSeek Harness 编码引擎打包为 Cordis 插件的包。
- 维护者：cordisplugins
- 核心价值：将 DSH 基础组合挂载到调用者的现有 Loader 树，提供开箱即用的 DSH 能力。
- 类型：客户端
核心功能¶
该插件包含以下能力：
- 组合挂载：将 DSH 的基础组合（包括原生代理、持久会话、模型适配器、工具、目标、计划模式、批准和打包的代理预设）挂载到调用者的 Loader 树。
- 原生服务：提供原生 DSH 服务提供者，而不是一个全局单例。
- 服务注入：允许调用者通过注入特定服务（如
sessions、agents或tools）来使用，而非直接导入实现。
安装与启用¶
使用 pnpm 安装依赖：
pnpm add dsh-cordis @deepseek-ai/cordis@4.0.1
典型用法¶
在宿主机的配置文件中，使用一个稳定的 Loader 行来引入插件。telemetry 默认为 false。
- id: dsh-engine
name: dsh-cordis
config:
telemetry: false
架构与注意事项¶
生命周期与归属¶
- 无独立根：该插件不会构建另一个 Cordis 根。
- Fiber 拥有：其 Fiber 拥有包含的 DSH 树。移除 Loader 条目会移除其活动服务，并让消费者进入
PENDING状态，直到另一个提供者可用。 - 依赖倒置：消费者请求
sessions、agents、tools等服务契约，不导入具体的 DSH 提供者。
责任划分¶
- 宿主责任：
DSH_HOME、凭据、模型选择、UI 以及 ACRYL 引擎选择合同的配置由宿主负责。 - Telemetry：默认关闭。
局限性¶
- 不提供 Pi 集成。
- 不提供引擎切换命令。
- 不提供跨引擎会话翻译。
适用场景¶
适合需要在 Cordis 插件体系中复用 DSH 编码引擎能力的开发者。它将 DSH 的复杂内部实现封装在插件内部，对外暴露标准的 Cordis 服务接口，降低了宿主项目的集成成本。
目录与链接¶
- 目录页：SkillHub 插件目录
- GitHub：cordisplugins/dsh-cordis
