6.3 Agent 预设
本节目标
理解 Agent 预设是什么,学会在预设之间切换,并知道怎么创建一个自定义预设。
预设决定"agent 是什么样"
同样一个 dsh,agent 可以有不同的"形态":有的功能全、有的精简、有的可以自己扩展。Agent 预设就是这些形态的出厂配置,它决定一个新会话一次独立的对话记录,有自己的上下文,互不干扰。里的 agent 是什么样。
设置面板点 Agent 预设 tab,就能看到所有预设:

内置的四个预设
dsh 内置了四个预设,从上到下能力从全到简:
| 预设 | 能力 | 适合 |
|---|---|---|
| 标准模式 | 功能完整的编码 Agent:文件编辑、Shell、文件与网页检索、技能告诉 agent 如何完成某类任务的说明书,在会话里用斜杠命令调用。、计划、目标、子代理由主智能体委派出去执行子任务的子智能体,可并行工作、结果汇总回主会话。、工作流把多步任务编排成脚本,可自动启动子代理,一次跑完整个流程。 | 日常默认(推荐) |
| PTC 模式 | 与标准模式几乎相同,但默认不提供 工作流把多步任务编排成脚本,可自动启动子代理,一次跑完整个流程。 工具;其他工具通过 Code Mode SDK 呈现,模型提供智能的大模型服务,dsh 负责调度它来思考与生成。用 TypeScript 程序组合多步操作 | 喜欢程序化控制、暂时不需要 workflow 的玩家 |
| 极简模式 | 只保留一个工具:持久 bash。0.1.5-alpha.1 起不再包含 str_replace_editor,避免和当前的"读后再写"两步流重复 | 极简环境、专注跑命令 |
| 创造模式 | 以标准模式为蓝本,用于创作自定义预设 | 用来制作自定义预设 |
标准模式是大多数人的日常选择,也是默认预设。它是"功能完整的编码 Agent",前面几章讲的所有能力它都具备。
四个预设怎么选:场景与例子
光看能力表不好想象,配几个真实场景就清楚了:
标准模式:日常开发全都要
- 适合:改代码、加功能、跑测试、查资料、写文档,什么活都有
- 例子:打开你的项目会话,说"给登录接口加上参数校验,然后跑一遍测试",标准模式能一气呵成(读代码 → 改文件 → 跑测试 → 汇报)
PTC 模式:喜欢程序化、要稳定复现
- 适合:多步操作想"一次写死、重复执行",或想用 TypeScript 程序精准控制每一步;注意 PTC 模式默认不加载 工作流把多步任务编排成脚本,可自动启动子代理,一次跑完整个流程。 工具,想跑工作流请切标准模式或自定义预设
- 例子:说"写一段程序依次完成:读取配置文件 → 替换版本号 → 检查文件是否更新",agent 用 Code Mode SDK 把每一步编排成程序执行,结果更可控、更容易复现
极简模式:只跑命令,别的都不要
- 适合:只需要终端操作的场景,比如服务器维护、批量命令、日志排查,希望 agent 不碰文件编辑
- 例子:说"批量把 logs 目录下 7 天前的 .log 文件压缩成 .gz",极简模式只用持久 bash 一条命令搞定,不引入多余操作
创造模式:想定制自己的 agent
- 适合:对 agent 行为有特殊要求,想基于现有预设改造一份
- 例子:你觉得标准模式太"话多",想做一个"少解释、直接干活"的版本,就切到创造模式,复制标准模式再改配置
一句话:日常选标准,程序化选 PTC,纯命令选极简,要定制用创造。
怎么切换预设
设置 → Agent 预设 → 点选目标预设即可。切换后:
- 新会话使用新预设
- 已存在的会话保持开始时的预设不变
主界面底部输入框上方也会显示当前会话一次独立的对话记录,有自己的上下文,互不干扰。用的预设,比如标准模式。
每个内置预设卡片上有一个查看配置按钮,点开是它的模式指南:这个模式是什么、适合什么场景、怎么用好,还带可以一键拷贝的用法示例。拿不准选哪个时,先翻翻指南再决定,比瞎猜快得多。想让某个预设成为新会话的默认值,用设为新任务默认把它钉死。
选择器可关
新建会话界面的「Agent 预设」选择器可以关:0.1.7-rc.2 起它由通用设置里的代码工作工具开关统一控制(此前是独立的新任务可选择模式开关),开关关闭之后新任务统一使用应用配置的默认预设,选择器隐藏(用户保存的 default 不动),再次打开依然能恢复,已有任务不受影响。运行中与历史会话的预设是会话标题旁的只读标签,不参与这次切换。
创建自定义预设
内置预设不够用?两条路创建自定义预设:
- 先切到创造模式
- 通过复制现有预设创建你的副本(浏览器端只做复制,不直接写配置)
- 编辑预设的配置文件,调整 agent 的组成和行为
- 保存后,新会话就可以选你的自定义预设
0.1.7-alpha.1 起,预设页还提供了一个更省事的入口:让 Agent 帮我创建预设模式,说清楚你想要的行为,agent 按创造模式的流程帮你起草一份,再手动微调即可。
自定义预设适合对 agent 行为有特殊要求的场景,属于进阶玩法,先知道有这条路就行。
常见问题
问:预设之间差别大吗?
主要差别在能力范围。标准模式什么都有,极简模式只留核心。日常用标准模式不用纠结。
问:换了预设,会话里之前的配置会丢吗?
不会。预设只管新会话,旧会话还是原来的样子。
小结
- Agent 预设决定新会话 agent 的形态,设置面板可切换
- 四个内置预设:标准(默认,日常全能)、PTC(程序化控制)、极简(纯命令)、创造(制作自定义)
- 创造模式可制作自定义预设,进阶玩法
预设名和权限标签会随语言显示
内置预设(标准模式、PTC 模式、极简模式、创造模式)的名称,以及 4.4 节里权限预设(工作区内修改、完全访问等)的标签,都会跟随你界面设置的语言显示。你看到的中文名称就是本地化后的结果;在英文界面下它们会对应 "Standard mode" / "PTC mode" / "Minimal mode" / "Creator mode" 等。用户自己写的自定义预设元数据不会被翻译,保持你写时的原文。
预设选好了,最后一节把界面调成你看着舒服的样子:主题。