DeepSeek Harness 配置参考：settings.yaml 字段详解

DSH 的配置分三处：profile 组合（dsh.profile + cordis.patch.yml）、home 级配置、以及这份 settings.yaml——存你的个人设置。这一篇逐字段讲清 settings.yaml 里常见的几块。

文件位置

~/.dsh/settings.yaml

（$DSH_HOME 默认 ~/.dsh，目录全貌见安装详解）。不同版本字段略有增减，以 --dump-config 输出为准。

常见字段

# 界面引导状态（首次使用的欢迎提示版本号）
ui-onboarding:
  welcomeNoticeVersion: 2026-08-13.1

# 默认 Agent Preset：新会话用哪个预设
agent-presets:
  default: standard          # standard / code / minimal / cordis / 自定义

# 默认模型路由：新会话默认用哪个模型
agent-default-model:
  provider: deepseek-official
  model: deepseek-v4-flash
  reasoningEffort: high

agent-presets.default

新会话的默认预设（预设机制见 Agent Preset）。改动只影响之后创建的新会话。

agent-default-model

新会话的默认模型三要素：

字段	说明
`provider`	提供方 ID（配置方法见模型与凭据）
`model`	模型名
`reasoningEffort`	推理力度（low/medium/high），影响模型思考深度与耗时

与另外两份配置的关系

文件	管什么	谁写
`settings.yaml`	个人设置（默认预设、默认模型）	界面操作自动写入，也可手改
`profile 的cordis.patch.yml`	该 profile 的能力组合	你手动写（见配置层与 patch）
`$DSH_HOME/cordis.patch.yml`	全局能力定制	你手动写

个人偏好写 settings，能力组合写 patch——别混。

修改建议

改完用 dsh --dump-config 验证最终生效值（见 CLI 命令参考）
手改 YAML 注意缩进：两空格，别用 Tab
拿不准的字段别猜——dump 出默认值，照着改

常见问题

问题	解答
改了默认模型，老会话没变？	会话记自己的模型，默认值只影响新会话（机制见模型与凭据）
字段名变了？	开发者预览期配置可能演进，以 dump 输出为准
改坏了怎么办？	删掉 settings.yaml 里对应块，恢复默认；整体重来可备份后删除文件