DeepSeek Harness Agent Preset：内置预设与自定义切换
2026-08-16 12:27:01阅读 2
Profile 决定"这个 dsh 实例挂什么能力"，而 Agent Preset 决定"会话里的 agent 是什么风格"——挂哪些工具、用什么人格（persona）、带哪些提示词段落。两者是两个层面，理解了这一点，DSH 的配置心智就完整了。
Preset 与 Profile 的区分（一张表讲清）
| Profile | Agent Preset | |
|---|---|---|
| 作用范围 | 整个 dsh 进程 | 单个会话（每个会话一个实例，随会话销毁） |
| 决定什么 | 挂哪些服务、哪些插件、模型路由、沙箱 | 该会话可见的工具、人格、提示词段、压缩策略 |
| 类比 | 机器的硬件配置 | 某个工人的技能与人设 |
| 位置 | $DSH_HOME/profiles/<name>/ | 内置随部署分发；自定义在${DSH_HOME}/.agent-presets/ |
一句话：Profile 是工厂，Preset 是产线上每个工人的上岗配置。 工厂只建一次，工人每个会话换一个。
四个内置预设
| 预设 | 风格 | 适用 |
|---|---|---|
| standard | 默认通用预设 | 大多数日常任务 |
| code | 编码向 | 写代码、改仓库 |
| minimal | 极简工具集 | 轻量、受控场景 |
| cordis | 面向 DSH 自身插件开发的预设 | 开发/维护 DSH 插件（自带 cordis-plugin-development、editing-cordis-compositions 两个技能） |
预设是组合出来的，不是硬编码的：一个 preset 目录 = 一份 agent.cordis.yml（挂哪些插件行）+ 可选的 preset.yml（显示名与描述元数据）。
切换默认预设
settings.yaml 里一行搞定：
agent-presets:
default: standard # 改成 code / minimal / cordis改动对新会话生效。想更细粒度地控制，也可以在 Web UI 的会话设置里选择（不同版本界面入口略有差异）。
什么时候该自建预设
满足其一就可以考虑：
- 固定一组工具——比如只让 agent 用文件工具 + 一个 bash，不给网络搜索（安全向）
- 固定一个人格——比如公司内部统一的编码规范提示词
- 实验新的组合——先复制官方预设再改，别动内置的
自建方法的核心纪律：永远复制再改，不要直接编辑随部署分发的那四个内置预设——升级会覆盖安装目录，改坏了还会影响预设系统本身。
常见问题
| 问题 | 解答 |
|---|---|
| 改了默认预设，当前会话没变化 | Preset 是每会话一份，改动只影响新会话 |
| 想临时换风格但不想改全局默认 | 在会话层面选择，而不是改 settings.yaml |
| 自定义预设看不到显示名 | 缺preset.yml 元数据，界面只显示目录名 |
接下来读什么
- 自建预设的完整步骤 → 创建 Agent Preset：自定义预设教程
- 人格（persona）在系统提示词里如何生效 → 系统提示词：Persona 与变量机制
← 上一篇：2.4 模型配置：provider 与 API 凭据管理 | 下一篇：3.1 Agent 循环：会话、轮次与步骤 →
↑ 返回 教程总目录
