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

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