DeepSeek Harness 四种模式详解：轨迹透明、PTC 提速与自定义 Agent

DeepSeek Harness 跑起来后的直观感受是响应快、过程清楚。它不只关注模型最终生成了什么，还会展示中间执行轨迹，让开发者知道工具何时被调用、文件如何被修改、命令为何执行。

更值得关注的是，Harness 提供标准、PTC、极简和创造四种模式。它们并非简单的性能档位，而是针对不同开发任务设计的能力组合。选对模式，可以减少无效往返，也能控制工具权限和运行风险。

核心亮点：执行轨迹清晰可查

传统代码智能体常像一个“黑箱”：开发者提出需求，模型执行若干操作，然后直接返回结果。一旦中间步骤出错，定位问题并不轻松。

DeepSeek Harness 会展示任务执行轨迹，常见信息包括：

• 模型对当前任务的拆分过程；
• 调用了哪些工具以及调用顺序；
• 执行了哪些终端命令；
• 修改了哪些文件和代码片段；
• 某一步失败后采取了什么修正措施。

清晰的轨迹不仅方便排错，也适合检查智能体是否偏离任务目标。对于涉及仓库修改、批量操作或自动执行脚本的工作，这种可观察性十分重要。

四种模式分别适合什么场景

1. 标准模式：日常开发的通用选择

标准模式提供较完整的工具能力，适合编写代码、理解项目、修改仓库和运行测试。第一次接触 Harness，建议先从该模式开始。

典型用途包括：

• 修复明确的程序错误；
• 新增接口、页面或配置项；
• 阅读仓库并解释模块关系；
• 修改代码后执行测试与检查；
• 完成跨文件的小型重构。

它的优势是能力均衡，不需要提前设计复杂的调用流程。缺点是遇到多步骤重复任务时，模型与工具之间可能产生较多往返。

2. PTC 模式：把多次工具调用压缩到一步

PTC模式中的 PTC 指 Programmatic Tool Calling。模型不再逐个发起工具请求，而是编写一段 TypeScript，通过 Code Mode SDK 组织多个操作，再交由 run_code 执行。

其基本思路可以概括为：

// 示意代码：在一次执行中组织多个工具步骤
const files = await searchFiles("src/**/*.ts");
const targets = await filterMatches(files, "deprecatedApi");
const results = await updateAndCheck(targets);
return results;

原本需要多轮完成的“搜索文件—筛选结果—修改内容—检查状态”，有机会被组合为一次程序化调用。这样能减少模型与工具之间的来回交互，尤其适合步骤明确、重复度较高的任务。

PTC 模式更适合：

• 批量扫描和处理文件；
• 串联多个查询、转换及校验步骤；
• 执行规则清楚的仓库维护任务；
• 降低频繁工具往返带来的等待时间。

需要注意的是，调用次数减少不代表所有任务都会更快。若流程本身存在较多不确定性，分步执行反而更方便观察和纠错。

3. 极简模式：只保留终端与文件编辑

极简模式强调最小工具集，主要保留两项能力：

• 持久化 Bash 终端；
• 按绝对路径修改文件的 str_replace_editor。

这种模式的优点是边界清楚、行为容易理解。模型主要通过终端获取信息，再对指定文件进行修改，不依赖复杂的工具体系。

它适合脚本维护、配置调整、小范围补丁，以及希望严格控制可用工具的场景。如果任务需要丰富的插件或多种专用能力，极简模式可能会增加操作步骤。

4. 创造模式：定制自己的 Agent 预设

创造模式面向需要扩展 Harness 的开发者。它在标准能力之外，还允许检查运行时、试用插件、修改 Harness，并创建新的 Agent 预设。

自定义预设会保存到：

~/.dsh/.agent-presets/

该模式可以用来固定团队工作流，例如预设代码检查步骤、限定工具组合，或为特定仓库建立专用智能体。不过，它能够接触更深层的运行环境，使用前应认真审查脚本和插件来源。

尤其需要留意 cordis_mount：它可能在活动运行时中执行模型生成的 JavaScript。因此，不建议在保存敏感凭据或重要数据的环境里直接尝试未经检查的代码。

四种模式怎么选

可以按照任务复杂度和权限需求快速判断：

1. 普通编码与仓库修改：优先选择标准模式；
2. 多步骤、可程序化的批量任务：尝试 PTC 模式；
3. 只需要终端和精确改文件：选择极简模式；
4. 需要插件、运行时调试或专用 Agent：使用创造模式。

如果不确定，最稳妥的顺序是先用标准模式验证任务，再根据执行轨迹判断是否需要切换。工具往返过多时可尝试 PTC；权限范围需要收紧时则可切到极简模式。

使用前的实用建议 🔧

先在隔离环境中运行

建议使用测试仓库、容器或独立工作目录，避免智能体误改重要文件。执行任务前先提交 Git 变更，以便随时对比和回滚。

高风险命令必须人工确认

对于删除目录、覆盖配置、安装未知依赖、上传数据等操作，应先检查执行轨迹和具体命令。速度再快，也不能代替必要的代码审查。

用小任务验证预设

自定义 Agent预设 后，不要立即交付大型任务。可以先测试读取文件、修改单个函数和运行一次测试，确认工具权限与输出符合预期后再扩大范围。

总结

DeepSeek Harness 的价值不只是“运行快”，更在于它将执行过程展示出来，并用四种模式覆盖不同开发场景。标准模式追求通用，PTC 模式减少多步调用往返，极简模式控制工具边界，创造模式则提供更高的扩展自由度。

实际使用时，建议把轨迹透明度、任务效率和运行安全放在一起考虑。先选择最简单且足够完成任务的模式，再逐步增加能力，通常比一开始开放全部权限更稳妥。