mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
fee12f1af0
The native adapter's route was named deepseek, colliding with pi-ai's catalog provider of the same name, so the two DeepSeek paths could never be mounted side by side. The web settings page needs both configurable at once. Compositions, fixtures, goldens, scaffolding defaults, and docs all move together (pre-release, no shim); TUI/session-query-spill/ missing-credential goldens re-recorded through their keyless refresh modes because provider-name length shifts box padding and spill truncation points.
2.4 KiB
2.4 KiB
配置文件
English | 中文
Harness 使用 cordis.yml 描述 Agent 加载哪些插件以及每个插件的参数。配置文件负责组合能力；每个包真正支持的字段和默认值由源码生成的配置目录负责记录，避免两份手写表格逐渐不一致。
从真实配置开始
仓库中的示例就是可以运行的配置，也是新项目最可靠的起点：
- tui-agent 组合 DeepSeek 模型、Bash、文件系统、压缩、子代理、工作流和交互式 TUI。
- headless-agent 以单次任务形式暴露 coding 组装。
- acp-agent 向程序化 ACP（Agent Client Protocol）客户端提供全新会话。
最小配置由一组插件条目组成：
- id: llm-deepseek
name: '@deepseek-ai/dsh-llm-deepseek'
config:
apiKey: !!js process.env.DEEPSEEK_API_KEY
models:
- deepseek-v4-flash
- id: bash
name: '@deepseek-ai/dsh-bash-local'
- id: tui-agent
name: '@deepseek-ai/dsh-tui-demo'
config:
provider: deepseek-official
model: deepseek-v4-flash
workspaceContext: false
插件条目
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。
精确配置参考
每个插件当前支持的字段、类型和默认值见自动生成的插件配置目录。理解插件如何组合可继续阅读架构说明和能力接口；要创建自己的配置，优先复制并修改示例目录说明中最接近的例子。