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

配置文件

English | 中文

Harness 使用 cordis.yml 描述 Agent 加载哪些插件以及每个插件的参数。配置文件负责组合能力；每个包真正支持的字段和默认值由源码生成的配置目录负责记录，避免两份手写表格逐渐不一致。

从真实配置开始

仓库中的示例就是可以运行的配置，也是新项目最可靠的起点：

• echo-agent 使用本地 mock 模型，不需要 API key。
• coding-agent 组合 DeepSeek 模型、Bash、文件系统、压缩、子代理和工作流。
• acp-agent 通过 ACP 接入编辑器客户端。

最小配置由一组插件条目组成：

- id: llm-deepseek
  name: '@deepseek-ai/dsh-llm-deepseek'
  config:
    apiKey: !!js process.env.DEEPSEEK_API_KEY
    models:
      - deepseek-v4-flash

- id: stdio-agent
  name: '@deepseek-ai/dsh-stdio-agent'
  config:
    model: deepseek-v4-flash

插件条目

name 指定 npm 包或相对于 cordis.yml 的本地模块，id 为插件实例提供稳定标识，config 传入插件自己的配置。需要临时跳过某个条目时可设置 disabled: true。

- id: local-tool
  name: './src/my-tool.ts'
  disabled: false
  config:
    toolName: my_tool

插件按文件中的顺序加载。依赖其他服务的插件应该排在提供这些服务的应用或能力插件之后；引用不存在的模型、工具或插件会尽早报错，而不是被静默忽略。

JavaScript 值和环境变量

Cordis loader 使用 !!js 标签读取运行时表达式。API key 等凭据应放在仓库根目录、已被 Git 忽略的 .env 中，不能提交到配置文件。

config:
  apiKey: !!js process.env.DEEPSEEK_API_KEY
  cwd: !!js process.cwd()

标签是 !!js，不是 !js。

精确配置参考

每个插件当前支持的字段、类型和默认值见自动生成的插件配置目录。理解插件如何组合可继续阅读架构说明和能力接口；要创建自己的配置，优先复制并修改示例目录说明中最接近的例子。