DeepSeek Harness

DeepSeek Harness Agent 预设模式选择教程

DeepSeek Harness Agent 预设决定每个会话可用的工具、提示词、Skills 与协作能力。本篇对比标准、PTC、极简和创造模式,讲清新会话如何选择、为什么已有内容后不能切换,以及复制预设、创建专用 Agent 和区分 Profile 的方法,帮助你按任务复杂度选对运行组合,避开常见误区。

效率提升 进阶

📚 系列导航:上一篇 DeepSeek Harness 模型与 API 配置教程 已经准备好可用模型;本篇按任务选择 Agent 预设;下一篇 DeepSeek Harness 内置工具与 Code Mode 教程 会继续解释预设中的工具怎样执行。

DeepSeek Harness Agent 预设可以理解为一个 Agent 的“岗位说明书加工具箱”:它决定当前会话加载哪些工具、系统提示词、Skills、计划能力、子 Agent 和工作流。 选模型只是换“大脑”,选预设才是在决定这个 Agent 以什么方式工作。

DeepSeek Harness Web UI 中的标准、PTC、极简和创造模式选择器

ℹ️ 本文截图来自开发者预览阶段,按钮位置和界面文案可能继续变化;模式名称与能力边界以当前安装版本和官方仓库配置为准。

DeepSeek Harness Agent 预设是什么

一个 Agent Preset 是按会话挂载的 Cordis 插件组合。标准模式能同时提供文件编辑、Shell、搜索、Skills、计划、目标、子 Agent 与工作流;极简模式则只留下持久 Bash 和 str_replace_editor。两者可以使用同一个模型,但模型能看到的工具和规则并不相同。

这和 Skill 不是一回事。Skill 更像按需打开的操作手册,告诉 Agent 某类任务应该怎么做;Preset 决定这名 Agent 有没有对应工具、是否能加载 Skill,以及整个会话的固定工作方式。

DeepSeek Harness 设置页展示不同 Agent 预设的能力说明

标准、PTC、极简和创造模式怎么选

官方当前随附四种只读预设。第一次使用优先选标准模式,只有任务特点明确时再换其他模式。

Agent 预设主要能力适合任务使用提醒
标准模式原生工具、搜索、Skills、计划、目标、子 Agent、工作流日常编程、修复 Bug、分析项目功能最完整,适合作为默认选择
PTC 模式标准模式能力,通过 Code Mode SDK 呈现工具批量搜索、并行读取、多步处理模型用 TypeScript 程序组合工具,排错方式与原生调用不同
极简模式持久 Bash、str_replace_editor基准测试、教学、验证最小工具环境没有标准模式的大部分提示词和模型侧插件
创造模式标准能力、运行时检查、插件试验、预设创作指导创建或验证自定义预设能修改运行组合,应只在受信任工作区使用

DeepSeek Harness 标准模式适合什么任务

如果任务需要“读代码 → 改文件 → 跑测试 → 根据结果继续”,标准模式最省心。它把常用能力直接呈现为原生工具,执行记录也更容易逐步查看。

DeepSeek Harness PTC 模式适合什么任务

如果任务要对很多文件执行相似操作,或者需要循环、条件和并发,PTC 模式更合适。它不是更强的模型,而是把工具换成程序化调用方式;具体执行边界见下一篇 DeepSeek Harness Code Mode 使用教程

DeepSeek Harness 极简模式适合什么任务

极简模式适合排除复杂插件干扰,或观察模型只拿到终端和文本编辑器时怎样完成任务。它不是“低权限模式”,安全范围仍由沙箱和审批策略决定,不能把工具少等同于绝对安全。

新建会话时如何选择 Agent 预设

在 Web UI 创建会话前,打开输入区附近的 Agent 预设选择器,先选择模式,再发送第一条消息。建议同时确认工作区、模型和权限预设,避免把模式问题误判成模型或目录问题。

  1. 选择一个专门准备的工作区。
  2. 选择模型与推理等级。
  3. 打开 Agent 预设菜单。
  4. 第一次任务选择“标准模式”。
  5. 发送只读任务,检查实际出现的工具调用。

DeepSeek Harness 新会话输入区中的 Agent 预设菜单

会话已经产生内容后,不要再尝试原地换模式。预设决定工具集合和提示词,旧日志里可能包含新预设无法解释的工具调用;需要换模式时,新建会话并重新给出目标与必要上下文,结果更容易复现。

如何复制并创建自定义 Agent 预设

随附预设是只读模板。你可以从接近目标的预设复制一份,再编辑用户自己的副本;创造模式也可以根据需求起草、挂载和验证组合。

先把要求写成清晰边界,例如:

基于标准模式创建“只读代码审查”预设:
- 可以读取文件、搜索代码、查询 LSP;
- 不允许修改文件和执行安装命令;
- 输出必须包含文件路径、问题证据和修复建议;
- 创建后先用一个测试仓库验证工具清单。

这个提示比“帮我做个审查 Agent”更容易验收,因为它明确了来源预设、允许能力、禁止动作和输出格式。创造模式能试验插件代码和修改预设文件,执行前仍要看清审批目标。

DeepSeek Harness 自定义 Agent 预设的配置文档示例

Agent Preset、Profile 和 Patch 有什么区别

Agent Preset 管一个会话里的 Agent;Profile 管整个 dsh 进程怎样启动,例如是否包含 Web 应用;Patch 是叠加到组合树上的配置覆盖层。可以把 Profile 看成办公楼,Preset 看成其中某个岗位,Patch 则是对楼层或岗位配置的具体改动。

同一个 Web Profile 可以提供多个 Agent Preset。创建写作、编码和研究预设,不代表要启动三套 Web 服务;它们可以在同一个进程里使用不同的工具与指令组合。

DeepSeek Harness 自定义写作预设目录中的配置与 Skills 文件

验证自定义 Agent 预设是否生效

不要只看预设出现在菜单里。新建空白会话后,先问它能做什么,再安排一个小任务,并从工具记录核对三件事:预期工具是否出现、禁止工具是否真的不可用、系统规则是否改变了输出。

如果预设能加载却没有贡献能力,检查插件行是否挂载到 Agent 作用域、依赖服务是否存在,以及最终组合是否被后层 Patch 覆盖。调试进程级组合时可以运行:

dsh --profile web --dump-config

它输出最终合并配置,适合排查“文件写了但插件没生效”;会话级预设还要结合 Web UI 的实际选择和会话日志一起确认。

常见问题

Agent 预设可以在会话中途切换吗?

应在空白会话发送第一条消息前选择。已有内容后需要更换预设时,新建会话,避免旧工具记录与新组合冲突。

极简模式是不是更安全?

不一定。它的模型侧工具更少,但实际文件边界仍由沙箱、工作区和审批策略共同决定。

创造模式会直接修改官方预设吗?

随附预设是只读的。常见流程是复制一个副本,再编辑、挂载和验证用户预设。

选好预设后,继续阅读 DeepSeek Harness 内置工具与 Code Mode 教程,把“选哪套能力”落到具体执行过程上。