DeepSeek Harness 当前 Web UI 内置四种 Agent 预设:
- 标准模式
- PTC 模式
- 极简模式
- 创造模式
如果你第一次使用、不知道选哪个:
这篇只解决一个问题:四种 Agent 预设到底有什么区别,我现在应该选哪个?
先搞清楚:Agent 预设是什么?
当前官方中文界面对 Agent 预设的解释是:「预设即一个会话的智能体所运行的插件组装——它的工具、提示词与能力。」
所以 Agent 预设不是:
- 模型
- 工作区
- 权限
- profile
可以先这样理解四个维度的分工:
模型
→ 谁负责推理
工作区
→ 在哪里工作
Agent 预设
→ 这个会话里的 Agent 拥有哪些工具、提示词和能力
权限
→ 这些能力执行时允许到什么程度
因此:同一个模型,在不同 Agent 预设下,能做的事情可以不同。
四种模式先看一张表
| Agent 预设 | 当前官方定位 | 主要特点 | DSHOPC 建议 |
|---|---|---|---|
| 标准模式 | 功能完整的编码智能体 | 文件、Shell、检索、技能、计划、目标、子代理、工作流等 | 第一次使用优先 |
| PTC 模式 | 标准模式 + Code Mode SDK | 模型可以用 TypeScript 程序组合多步工具操作 | 熟悉标准模式后再体验 |
| 极简模式 | 双工具编码智能体 | 持久 Shell + str_replace_editor | 需要简化能力集合时 |
| 创造模式 | 自定义 Agent 预设创作模式 | 标准模式能力 + 运行时检查、插件实验、预设创作 | 只在明确理解风险时使用 |
标准模式
当前官方中文界面对标准模式的描述是:「功能完整的编码智能体,支持文件编辑、Shell、文件与网页检索、技能、计划、目标、子代理和工作流。」它对应的内置预设 ID 是 standard,正常使用时不需要记这个 ID。
标准模式有哪些主要能力?
当前组合中包括:
- Shell(命令行外壳,可执行真实系统操作)
- 文件读取和编辑
- 文件搜索
- 网页检索
- 技能
- 目标
- 计划模式
- 后台任务
- 子代理
- 工作流
- 上下文压缩等
所以标准模式可以理解成:DeepSeek Harness 当前默认意义上的完整通用编码智能体。
什么场景适合标准模式?
第一次接触 DSH:因为它最适合建立「正常情况下智能体应该拥有哪些主要能力」这个基线。
日常代码与项目任务,例如:
- 理解仓库
- 修改代码
- 搜索文件
- 运行测试
- 调查 Bug
- 编写文档
- 分解计划
你不确定是否需要特殊模式时:如果任务没有明确要求 Code Mode、极简工具集合或运行时创作能力,先用标准模式通常更容易判断问题来自哪里。
标准模式是不是「最安全」?
不能这样说。标准模式拥有文件编辑、Shell、外部检索和其他工具能力,因此它本身仍然具有真实操作能力。实际能执行到什么程度,还取决于:
- 当前权限
- 审批
- 沙箱
- 工作区
- 具体任务
PTC 模式
当前官方中文界面使用的名称是「PTC 模式」,对应的内置预设 ID 是 code。官方当前描述是:「具备标准模式的全部能力,并通过 Code Mode SDK 呈现工具,让模型用一个 TypeScript 程序组合多步操作。」其中 TypeScript(一种编程语言)配合 Code Mode SDK(软件开发工具包),指的是模型可以用写程序的方式调用工具。
最重要的一点是:PTC 模式没有把标准模式的大部分能力拿掉。它是在标准模式的能力基础上,改变模型如何看到和组织工具。
PTC 模式和标准模式核心差别是什么?
标准模式更接近这样的循环:
模型
→ 调一个工具
→ 得到结果
→ 再请求模型
→ 再调工具
PTC 模式则可以让模型编写一个 TypeScript 程序,通过 Code Mode SDK 在一次程序执行中组合多个工具操作。例如一个任务原本需要:
- 搜文件
- 读多个文件
- 处理结果
- 再写文件
在适合的情况下,PTC 模式可以把其中多步工具操作编排在一个程序里。当前官方预设源码甚至直接解释:「原本需要多次模型与工具往返的操作序列,可以被组合为一次程序执行。」
PTC 是什么意思?
在当前 DSH 用户层面,你真正需要记住的是:PTC 模式等于「使用 Code Mode SDK 让模型通过程序组合工具操作」。至于它的工具呈现、执行运行时、缓存和内部调度机制,属于 Architecture 板块的范畴,不需要在 Learn 里展开。
PTC 模式一定更快吗?
不能直接这么下结论。从当前机制上可以确认的是:它能够减少某些多步工具序列中的「模型—工具」往返次数。但实际表现还取决于具体任务和模型:
- 总耗时
- token 消耗
- 成功率
- 模型适配程度
- 复杂任务表现
所以 Learn 只能说:PTC 改变了多步工具操作的组织方式。至于「到底快多少、什么时候更省、什么模型表现最好」,应该放到 Lab 做 Benchmark(基准测试)。
什么场景可以尝试 PTC 模式?
已经熟悉标准模式:先知道普通工具调用是什么样,再使用 PTC,才更容易理解两者执行方式的区别。
多步骤工具操作场景,例如:
- 多文件调查
- 连续读取和处理
- 需要程序化组合多个操作
想研究 DSH 的 Code Mode:PTC 本身也是非常适合进入 Architecture 研究的入口。
极简模式
当前官方中文界面的名称是「极简模式」,对应内置预设 ID minimal。官方当前描述是:「仅提供持久 bash 与 str_replace_editor 的双工具编码智能体。」在 Windows 下,对应的持久 Shell 会使用 PowerShell。
极简模式到底「少」在哪里?
当前极简模式和标准模式差别很大。它当前主要保留两样东西:持久 Shell 和 str_replace_editor(文本替换编辑工具),并使用一套固定、简化的系统提示词。
当前组合中也没有标准模式那套完整的能力组合:
- 技能工具
- 网页检索
- 计划
- 目标
- 子代理
- 工作流
- 上下文压缩
因此它不是「标准模式但少几个按钮」,而是一套明显更精简的智能体组合。
极简模式适合什么?
适合的场景例如:
- 想观察模型在少量工具下怎样完成任务
- 做能力对照实验
- 研究智能体对工具集合的依赖
- 某个任务本身只需要 Shell 和文本编辑
极简模式是不是更安全?
不能直接这样说。「工具少」不等于风险自动消失:极简模式仍然包含持久 Shell,而 Shell 本身就可以执行大量真实操作。所以能力集合更少不等于自动更安全。实际风险仍然取决于:
- Shell 权限
- 工作目录
- 当前操作
- 沙箱配置
极简模式是不是更稳定、更省 token?
也不能提前这样说。理论上,工具和提示内容减少会改变上下文和工具定义规模,但最终的 token 用量、成功率、任务轮数和完成时间都需要实际任务测试。这些结论交给 Lab。
创造模式
当前官方中文界面的名称是「创造模式」,对应内置预设 ID cordis。官方当前描述是:「用于创建自定义智能体 preset:具备标准模式的全部能力,并提供运行时检查、插件实验和 preset 创作指导。」它不是普通「代码模式」的另一个名字。
创造模式的核心是:让智能体研究、实验和修改智能体组合本身。
创造模式为什么风险更高?
当前官方 cordis 预设源码明确写出了它的信任边界:其中的 cordis_mount 能力可以将模型生成的 JavaScript(脚本编程语言)作用于当前运行时。
什么情况下才应该使用创造模式?
更适合的场景包括:
- 创建自定义 Agent 预设
- 检查当前运行时
- 实验插件组合
- 研究 Cordis
- 调试智能体 composition(组合结构)
- 让智能体辅助编写新的预设
不建议普通聊天、普通代码任务为了「能力更多」直接使用创造模式,因为标准模式本身已经拥有大量日常能力。
创造模式会直接修改官方内置预设吗?
当前官方设计并不鼓励这样做。
如果要修改,正确做法是先复制一个内置预设,再编辑自己的副本。原因是:
- 内置内容可能被升级覆盖
- 改坏创造模式本身可能让该模式无法继续工作
- 用户自定义内容应该放在自己的预设目录
四种模式怎么选?
可以先用这棵简单的决策树对号入座:
| 你的情况 | 建议选择 |
|---|---|
| 第一次使用 DSH | 选标准模式 |
| 需要完整智能体能力做普通项目任务 | 选标准模式 |
| 已经熟悉普通工具调用,想让模型程序化组合多步工具操作 | 尝试 PTC 模式 |
| 只想保留极少工具做编码任务或实验 | 考虑极简模式 |
| 要创建或研究 Agent 预设、插件组合和 Harness 运行时 | 考虑创造模式,同时把它当作高信任环境 |
一个更简单的记法
标准模式
→ 日常完整 Agent
PTC 模式
→ 完整 Agent + 程序化组合工具
极简模式
→ 少量工具的精简 Agent
创造模式
→ 修改和创造 Agent 本身
这比记内部 ID(standard / code / minimal / cordis)更适合普通用户。内部 ID 主要出现在配置、源码和 Architecture 里。
Agent 预设与模型、权限
Agent 预设与模型、权限是不同的维度。例如下面几种组合都可能存在:
DeepSeek 模型 + 标准模式
OpenAI 模型 + 标准模式
DeepSeek 模型 + PTC 模式
所以:模型决定推理者,Agent 预设决定这次会话的工具、提示词和能力组合。如果同一个预设换模型后表现不同,不一定说明 Agent 预设发生了变化。
Agent 预设和权限怎么配合?
仍然沿用前一篇的关系:Agent 预设决定「有什么能力」,权限决定「这些能力能执行到什么程度」。例如标准模式拥有 Shell,但实际 Shell 操作仍然受到当前权限、审批和沙箱影响。不要把「标准模式有 Shell」理解成「所有 Shell 命令都会无条件执行」。
Agent 预设的生命周期与自定义预设
当前官方 UI 明确写道:「本会话运行的 Agent 预设,开始时即固定。」原因从用户层面很好理解:一个已经运行的会话,它的历史是在原来的工具和能力集合下产生的;如果运行中突然替换整套智能体组合,历史和当前能力可能不再一致。所以当前的设计是:会话开始后锁定 Agent 预设。
设置里的 Agent 预设为什么能改?
因为设置里的值控制的是以后新建会话的默认 Agent 预设。当前中文 UI 直接写明:「对此后新建的会话生效。运行中的会话保持它开始时的预设。」所以设置默认值变化不等于当前会话立刻变化。
新会话开始前可以选吗?
可以。Web UI 在新会话阶段提供 Agent 预设选择,这时你还没有真正开始任务历史,可以决定这次新会话用哪个预设。一旦开始,就会固定下来。
自定义 Agent 预设是什么?
除了四种内置预设,当前 Web UI 还支持自定义 Agent 预设。当前的管理方式主要是:
- 复制一个已有预设
- 给副本设置新的标识符
- 在自己的预设文件中修改
- 后续新会话使用它
内置预设可以查看。自定义预设可以复制、删除、设置默认、打开或查看预设文件位置。
删除自定义预设会让已有会话坏掉吗?
不会。当前官方说明:已经使用该预设运行的会话仍然可以继续工作;删除后的主要影响是新会话不能再选择这个预设。这也是因为智能体组合在会话开始时已经挂载。
什么情况下不应该切模式排错?
如果你遇到「智能体读不到文件」这类问题,不要第一步就在标准 → PTC → 极简 → 创造之间来回切换,先依次检查:
- 工作区
- 模型
- 当前预设是否具备对应能力
- 权限
- 工具调用错误
验证与对照实验
这篇不要求为了验证去使用创造模式。基础验收只需要能够判断下面四个场景:
| 场景 | 应该选择 |
|---|---|
| 第一次安装 DSH,想先正常做代码任务 | 标准模式 |
| 已经熟悉标准模式,想观察模型用 TypeScript 程序组合多个工具操作 | 可以尝试 PTC 模式 |
| 只想保留持久 Shell 和文本编辑工具做对照实验 | 考虑极简模式 |
| 想让智能体帮你创建新的 Agent 预设,并研究当前 Harness 运行时 | 考虑创造模式,同时知道这是高风险场景,应按 Shell 级信任边界看待 |
可选实验:标准模式 vs PTC 模式
如果你已经完成《第一次使用》,可以用同一个安全、只读任务分别创建两个新会话:会话 A 使用标准模式,会话 B 使用 PTC 模式。给两个会话同样的任务,例如:「找出当前测试项目中的所有 Markdown 文件,并汇总每个文件的一级标题。不要修改任何文件。」
然后只观察三件事:
- 工具调用组织方式
- 是否出现 Code Mode 程序执行
- 总步骤结构
不要仅做一次就得出「哪个模式更快、更省 token、更稳定」。这些结论需要多次任务、固定模型、固定工作区、固定输入、记录耗时与 token、重复测试之后,才能进入 Lab 结论。
下一步
现在你已经学完 Learn 入门与日常使用阶段的主路径:新手入门 → 安装 → 第一次使用 → 模型 → Web UI → Agent 预设。
接下来不要直接默认「我要学插件」。先进入《扩展能力选择指南》(/deepseek-harness/plugin-skills-mcp/),判断自己的需求到底属于技能、MCP 还是插件,然后再走对应路线。
如果当前 Agent 预设出现无法选择、加载失败、会话开始后无法切换、自定义预设异常等情况,进入《常见问题与报错排查》(/deepseek-harness/troubleshooting/)。