前言
上篇文章梳理了 DeepSeek Harness 的设计理念，并完成了安装部署，还通过一个 3D 赛车游戏实战案例，亲眼见证了它一次性成功生成可运行代码的高效表现。
不过，安装和跑通 demo 只是起点。DeepSeek Harness 真正的灵活性，藏在那密密麻麻的配置项和 Agent 预设里。很多朋友第一次打开设置面板时，面对各种参数难免一头雾水：这些开关到底控制什么？预设角色之间有什么区别？怎样调整才能让 AI 更贴合自己的实际需求？
本篇文章，笔者将带大家深入 DeepSeek Harness 的通用设置与 Agent 预设机制，逐一讲清每个配置项背后的作用，并给出不同场景下的推荐方案。读懂这些设置，大家离“驾驭DeepSeek Harness”将更近一步。
一、通用设置
DeepSeek Harness 的通用配置面板涵盖五个核心维度：Agent 预设、权限策略、界面语言、外观主题以及繁忙时的 Enter 键交互行为。以下逐项展开说明。
Agent预设选项提供四套预定义的 Agent 行为模板，分别面向不同开发场景，内部封装了系统指令、工具调用策略与上下文管理参数的差异。笔者会在下文详细举例讲解。
权限分为三个递增级别，用于限定 Agent 对文件系统和终端命令的操作能力
- Read Only： 仅可读取工作区文件，无法修改文件、执行终端命令，安全性最高。
- Workspace Write： 允许读写当前工作目录内文件，可在工作目录执行命令(执行命令需要用户审批)，无法访问工作目录以外文件，日常开发推荐使用。
- Full access： 拥有完整文件系统访问权限，可读写任意路径文件、无需审批执行各类终端指令，存在较高安全风险。
语言、外观这两个选项非常直观就不介绍了。
繁忙时Enter键行为提供了排队发送、插话发送两个选项。
- 排队发送：不打断当前回合，消息进队列（FIFO），忙完再处理，默认模式。
- 插话发送：立即打断正在进行的回合，消息马上优先处理，用于紧急纠正或改方向；若打断窗口已过，会自动降级为排队，不会丢消息。
注意： "插话发送"本质是"协作式打断"，不是"抢占式强杀"——它是否立刻生效，由宿主端 AgentLoop 决定，而它只在安全的窗口里接受插话（有时候插话发送可能会等到之前的工具调用或模型思考执行完成，如果想立即停止可以点击终止对话按钮后再发送消息）。
二、模型
DeepSeek Harness 的模型层采用可插拔的适配器架构，原生支持 DeepSeek 官方 API 端点，同时兼容第三方模型服务。这意味着大家可以在 Harness 中无缝切换不同厂商的大语言模型。
点击DeepSeek Harness设置按钮，选择模型，点击添加提供方：
这里我选择智谱的coding-plan套餐，填入智谱的api key
保存配置后，模型提供方即注册至 Harness 运行时。大家可以在对话窗口顶部的模型选择器中看到已添加的模型实例（GLM-5.3等），并在会话中进行替换。
对于企业自组网环境或本地私有化部署的模型（如 vLLM、LocalAI 或 TGI 服务），Harness 提供了 “自定义提供方（Custom Provider）” 选项，支持手动指定 OpenAI 兼容接口的元数据，这些配置项与日常常用的chatbox和cherrystudio等软件无异，这里不再赘述。
三、插件
DeepSeek Harness 的核心架构遵循 “Everything is a Plugin” 的设计哲学。这一理念意味着 Harness 的绝大多数功能模块——包括但不限于模型适配器（Model Adapter）、工具注册表（Tool Registry）、会话日志（Session Logger）、乃至智能体循环（Agent Loop）本身——均以插件的形式注册到运行时容器中，由核心框架统一管理其生命周期与依赖关系。更进一步说，当前我们使用的 Harness Web 应用本身，正是由一系列内置插件组合而成的功能集合。
3.1 查看已启用插件列表
通过 设置 → 插件 → 插件列表（Plugins List） 入口，大家可以查看当前实例加载的所有插件。以当前最新版本为例，Harness 预置了 165 个 功能插件，它们协同构成了 Web 应用的全部基础能力——从 UI 渲染、消息流管理，到模型调用、工具执行、文件系统操作等，每一层职责均由对应插件承担。
插件列表展示了每个插件的名称、版本、状态（启用/禁用）以及简要描述。此视图可用于快速审计当前运行环境的能力范围，便于排查功能缺失或版本冲突问题。
3.2 插件参数配置
部分插件暴露了可调的运行时参数，允许开发者根据实际需求调整其行为。通过 插件配置（Plugin Configuration） 面板，大家可以查看并修改这些参数：
- 终端插件（Terminal Plugin） ：提供
命令超时（Command Timeout）参数，单位为秒。该值限定了单条 shell 命令的最大运行时长，超时后 Harness 将自动终止该进程，防止因死循环或阻塞式命令拖垮 Agent 响应。 - Agent Loop 插件：暴露
并发工具调用数（Parallel Tool Calls）参数，用于控制 Agent 在单次推理周期内可同时调用的工具数量上限。合理调高该值可加速多工具协作任务（如同时读取多个文件），但需注意下游 API 的速率限制。 - 网页搜索插件（Web Search Plugin） ：允许配置第三方搜索服务的 API 端点与认证凭据（如 Bing Search API 或 Google Custom Search JSON API），使 Agent 具备实时信息检索能力。
插件系统是 Harness 最具扩展性的特性之一，它奠定了整个平台的模块化基础。入门篇后续内容笔者也会讲解如何将各种各样的社区插件集成到DeepSeek Harness中赋予它各种各样的能力。开发篇也会讲解DeepSeek Harness插件的核心原理以及如何开发DeepSeek Harness插件，大家感兴趣可以关注笔者的专栏 《DeepSeek Harness从入门到进阶》。
四、Agent预设
Agent 预设是 DeepSeek Harness 中决定智能体行为模式的核心配置单元。它本质上是一组完整的环境参数集合，涵盖工具集（Tool Set）、系统指令（System Prompt）、上下文窗口策略以及任务编排逻辑。通过切换不同预设，智能体将在同一套底层框架下表现出截然不同的工作风格与能力边界。
Harness 内置了四种预设模式，分别对应标准、极简、PTC 和创造四种运行态。大家既可以在对话框上方的模式切换器中快速切换，也可以在设置面板中统一管理。
选择恰当的 Agent 预设对任务成败有直接影响。编码开发、测试验证、缺陷修复等不同场景对工具链和推理路径的需求差异显著，误用预设可能导致效率下降甚至结果偏差。下面笔者逐一剖析四种内置模式的设计意图与适用边界。
4.1 标准模式
Deepeek Harness默认的选项就是标准模式。它加载了一个通用智能体应有的全部能力，包括文件读写、终端命令、联网搜索、任务规划、Skills技能、子Agent、待办管理等等，工具总数约 20 余项。
在功能覆盖面上，标准模式与 CodeX 等编程辅助工具定位相似——它具备完整的项目上下文感知能力，能够胜任从需求理解到代码交付的全链路开发任务。上一篇文章中演示的 3D 赛车游戏案例，正是在标准模式下完成的。
然而，标准模式的丰富能力也带来了明显的上下文开销。由于每次推理请求都需要将全部 20 余个工具的定义编码到系统提示词中，即使是最简单的问候对话，也会消耗接近 1万tokens 的上下文窗口容量。
大家可以通过点击 轨迹（Trace） 按钮查看标准模式下的完整系统提示词和上下文快照，其中工具定义的冗长描述和详细的引导规则清晰可见。
4.2 极简模式
极简模式顾名思义，系统提示词和工具都是最小化的配置。
官方只保留了两个工具，一个能持续运行的终端和一个文件编辑器，其他工具全部移除。
在此配置下，同样的问候对话仅消耗约 1.2K tokens，上下文压力显著降低。系统提示词精简为一句 "You are a helpful software engineer assistant."，工具列表仅包含上述两个必要项。
极简模式下的智能体行为极其直接：它不会主动进行任务分解、进度汇报或多路径探索，而是像一台专注的执行引擎，接收指令后立即通过终端和编辑器进行“思考-行动”闭环。DeepSeek 官方对极简模式的定位为 模型基准测试的标准环境——DeepSeek V4 Pro 的公开跑分成绩即在此模式下产生。
4.3 PTC模式
PTC 即“程序化工具调用”，其设计思路与传统智能体的逐步工具调用模式截然不同。在常规模式下，智能体按顺序依次执行工具，每一步等待结果后再决定下一步。PTC 模式则将一系列重复性、可并行化的操作封装为批处理代码，通过一次 run_code 工具调用一次性串联执行多个子任务。这使得 PTC 特别适用于批量文件重命名、数据集预处理、自动化测试套件执行等“步骤明确、逻辑线性”的任务。
该模式的典型特征是 仅暴露一个 run_code 工具，但本质上它通过代码中调用内部 API 接口的方式，间接具备标准模式的全部工具能力（文件操作、网络请求、系统命令等）。
4.4 三种模式，选哪个模式好？
看到这里大家不难发现以上三种模式的区别本质上就是当前会话加载了哪些工具和配置的不同组合。极简模式只留两个工具，标准模式配齐全套能力，PTC 模式换了一种工具调用方式。那这些模式到底选哪个比较好？
笔者这里通过鱼皮大佬分享的一个3D设计游戏的任务来看看这几个模式的效果。
首先是标准模式的成品效果：
再看看极简模式下的效果，具体玩法差别不大，但角色模型、材质贴图等表现力明显简化，整体视觉品质偏低。
最后再看看PTC模式的效果，这个成品效果与标准模式的成品效果类似。
再来看看时间方面的对比，标准模式跑了33分钟，极简模式跑了23分钟，PTC模式跑了27分钟。相比较标准模式，极简模式非常快，但成品的质量比较低。PTC模式比标准模式略快，Tokens 消耗也低了不少，输入只用了 150 万，不到标准模式 520 万的三分之一。
总结下来，大家如果对生成速度敏感、任务逻辑简单的场景可以用极简模式，追求稳定性和通用性可以用标准模式，对于任务步骤多、逻辑清晰且具备批量/自动化特征的任务，比如批量重命名文件、跑一整套自动化流程可以用PTC模式。
4.5 创造模式
创造模式是 Harness 预设体系中最为特殊的一类。它在标准模式全部能力的基础上，额外注入了一套 用于操作 Harness 底层 Cordis 插件系统 的元工具（Meta-Tools）。这些工具允许智能体在运行时查询当前已加载的插件列表、动态试验新的插件组合，甚至生成全新的预设配置文件。
创造模式使DeepSeek Harness具备了自我改造的能力——它可以读取现有预设、理解其结构、并通过修改配置文件来定义新的预设。这使得用户无需手动编写 YAML 或 JSON 配置，仅通过自然语言指令即可创建符合特定工作流的专属 Agent。
下面同样通过鱼皮大佬举过的一个示例说明如何通过创造模式打造与自己工作任务相关的专属Agent预设：
笔者希望复刻 Cursor IDE 的 Debug 模式，该模式要求智能体在收到错误报告后，依次执行：运行测试 → 分析日志 → 插入诊断日志 → 复现问题 → 根据日志数据定位根因。这一流程在 Cursor 中被封装为标准化调试协议。
在创造模式下，只需向 Harness 提交如下提示词
基于标准模式创建一个自定义 Agent 预设，名称为「Debug 模式」。
要求复刻 Cursor IDE 的 Debug 模式工作方式。
必须参考 Cursor 官方文档来设计：https://cursor.com/docs/agent/debug-mode
提交任务前，为了保证任务的执行顺利，建议将模型设置为DeepSeek-V4-Pro， 推理能力为MAX，保证复杂代码编写的准确度。同时权限设置为full access, 使 Harness 有权限写入全局配置目录。
任务执行过程中，Harness 自动加载了“编辑预设”的技能，通过终端抓取 Cursor 官方文档页面，提取出 Debug 模式的核心工作流定义，并据此生成新的预设配置。
执行完毕后，Harness 生成了任务总结，其中显示修改了两个关键文件：
agent.cordis.yml：定义了新预设的工具集合、系统角色人设以及 Debug 模式的工作流规则（如日志插入→复现→根因分析的标准顺序）。preset.yml：控制 UI 层展示的新预设名称与描述信息。
新建的「Debug 模式」会出现在后续新对话的模式选择器中，大家开启一个新对话，就可以在模式选择器中选择新建的Debug模式。
以后遇到有难以排查的Bug，就可以用这个模式实现类似Curor的效果。借助创造模式，大家可以将团队内部的最佳实践（如代码审查流程、安全扫描规范、性能调优步骤）沉淀为可复用的 Agent 预设，这类似于通过 AGENTS.md 或 CLAUDE.md 约束智能体行为，但粒度更细、自动化程度更高，且无需手动维护结构化文档。
以上即为 DeepSeek Harness 内置及自定义 Agent 预设的全景解析。掌握这些预设的差异与使用技巧，是充分发挥 Harness 效能的关键一步。
五、总结
本文全面解析了 DeepSeek Harness 的通用配置与 Agent 预设机制。通用设置涵盖权限策略、模型接入及插件系统。
在 Agent 预设部分，详细对比了四种内置模式：标准模式功能完备但上下文开销大；极简模式轻量快速，适合基准测试；PTC 模式通过批量化代码调用提升效率；创造模式赋予智能体自我改造能力，可通过自然语言创建专属预设（如复刻 Cursor 的 Debug 模式）。掌握这些预设的差异，是高效使用 Harness 的关键。
下一章将进阶讲解如何接入MCP工具与Skill 系统，构建贴合业务场景的自动化助手。如果大家觉得有收获，欢迎点赞、收藏，关注我的专栏《DeepSeek Harness 从入门到进阶》，后续更新不错过。下篇见！更多精彩内容，如果大家感兴趣，欢迎关注笔者的掘金账号与专栏，也可关注笔者的同名微信公众号大模型真好玩，每期分享涉及的代码均可在公众号私信。
