DeepSeek Harness 插件能配哪些项？DSH plugin 的 config 目录与 cordis.yml

DeepSeek Harness 的插件配置目录（config-catalog）由脚本从源码生成，按每个可加载的 harness 包原样列出它的 config 声明；每个 config: 块都能由 cordis.yml 条目设置，每个条目还用 inject、refs、source 三个标识标注（来源）。 这篇讲清它是谁、怎么读、以及哪些字段能配、哪些不能。

DeepSeek Harness 的 config 目录是什么：按包列出 config 声明

config-catalog 是一份以部署为轴的参考文档：针对每个可加载的 harness 包，它原样列出其 apply 函数或服务构造函数接收的配置声明（含 JSDoc），并附上所有引用类型（来源）。 几个要点：

1. 它由源码生成 — 文件由 scripts/gen-config-catalog.ts 生成，并用 pnpm run verify-config-catalog 校验新鲜度。预期：你只需查阅，不要手工编辑。
2. 配置入口统一是 cordis.yml — 每个 config: 块都可以由 cordis.yml 条目设置。预期：找到包名，再到对应 profile 的配置里写 config:。
3. 范围限于 harness 层 — 目录范围限定在 packages/；配置树还可能加载 vendored cordis 插件（如控制台日志记录器）。预期：查不到某个 vendored 插件的配置时，去它的上游文档找。
4. 三份参考各司其职 — 面向模型的工具 schema 看工具目录，插件作者的连接方式看各子系统页面的 cordis-surface 区，本目录只看配置声明。预期：别把三者的用途搞混。

读懂一条：inject、refs 与 source

每个包的条目用三个标识符标注，读懂了这三项，就知道这个插件依赖谁、还需要去哪查类型（来源）。 逐个看：

1. inject — 列出插件注入的服务键。预期：它提醒你，该插件的 cordis.yml 树还必须加载这些服务对应的提供者，否则插件起不来。
2. refs — 列出声明引用、但没有粘贴在此处的类型。预期：需要看完整定义时顺着它去查。
3. source — 链接到声明这份配置的源文件。预期：想确认字段语义或默认值时，直接读源码最准。

DSH plugin 能配哪些字段、哪些不能配

粘贴的内容是插件声明的完整配置类型——运行时 schema 有意排除的字段是仅供运行时使用的 seam（其 JSDoc 会说明），不能通过 cordis.yml 设置（来源）。 判断方法：

1. 先看它是不是运行时 seam — 被 schema 排除的字段会自带说明。预期：这类字段写进 cordis.yml 也不会生效。
2. 再用真实字段落地 — 以 DeepSeek 会话日志为例，可在 profile patch 里写 session-log-deepseek.enabled: false 来关闭它（来源）。预期：字段名对得上目录与源码，配置才生效。
3. 改完按 profile 验证 — 确认写在了当前实际使用的 profile 里。预期：换 profile 试一次即可排除「写错层」。

想找现成插件、看社区都在配什么，可以先进 DSH Plugin Hub，再到本目录核对它暴露的配置字段。

注意事项与常见问题

1. 别手改生成文件：config-catalog 是生成物，改动会被校验判定为过期。
2. inject 不满足会启动失败：服务提供者没在同一个配置树里加载时，插件无法注入。
3. schema 排除的字段配不了：不要试图用 cordis.yml 绕过运行时 seam。
4. 字段级目录 ≠ 覆盖规则：想知道多个 patch 怎么合并、谁覆盖谁，见《DeepSeek Harness 插件配置怎么改》。
5. 想知道配置文件在哪：见《dsh 配置文件在哪》。

来源：插件配置目录（官方文档）、Python SDK 入门（官方文档）