deepseek-harness/docs/user/guide/index.zh.md

介绍

English | 中文

DeepSeek Harness 是一个插件化的 Agent 开发框架，基于 Cordis 微内核构建。它的核心理念是：一切皆插件。

它是什么

Harness 将一个 AI Agent（智能体） 所需要的所有能力——LLM 调用、工具执行、会话管理、子任务分配——全部构建为可组合的插件。你通过一个 cordis.yml 配置文件来声明加载哪些插件、使用什么参数，就能组装出一个完整的 Agent。

# Select the LLM backend
- name: '@deepseek-ai/dsh-llm-deepseek'
  config:
    apiKey: !!js process.env.DEEPSEEK_API_KEY

# Select the one-shot application
- id: cli-agent
  name: '@deepseek-ai/dsh-cli-demo'
  config:
    provider: deepseek-official
    model: deepseek-v4-flash
    workspaceContext: false

适合谁

应用使用者

如果你只是想用一个现成的 Agent 应用（如编程助手、对话代理），你需要的全部操作就是：

1. 复制一个 example 模板
2. 填写 API key
3. 运行

不需要写任何代码。详见 快速开始。

插件开发者

如果你想为 Agent 添加新能力——一个自定义 tool、一个新的 LLM 适配器、一个新的执行后端——你需要编写一个插件。Harness 提供了清晰的扩展接口和类型安全的开发体验。详见 开发。

核心特性

• 只需要配置 — cordis.yml 决定能力集合，换模型、加工具只需改一行
• 随时替换 (HMR) — 开发时修改插件代码，无需重启进程

技术栈

• 运行时: Node.js ^22.19 或 >= 24
• 语言: TypeScript (ESM)
• 框架: Cordis
• 包管理: pnpm workspaces（仓库固定使用 pnpm 11）