DeepSeek Harness

DeepSeek Harness官网网页版入口地址是：www.deepseek.com

DeepSeek Harness 是 DeepSeek 开源的首款 Agent 框架，核心理念是“一切皆插件”。本文帮你搞懂它是什么、四种模式怎么选、适合谁用，以及如何快速跑通第一个任务。

DeepSeek Harness 是什么：给大模型装上“执行神经系统”

DeepSeek Harness 是 DeepSeek 于 2026 年 8 月 13 日开源的智能体框架，采用 MIT 协议，开发者预览版为 v0.1。官方给出的公式非常简洁：Model + Harness = Agent——模型负责推理与理解，Harness 负责调度工具、管理任务状态和执行闭环。

如果把 DeepSeek 基座大模型比作“大脑”，Harness 就是环绕在大脑周围的“执行神经系统”。它把模型连接到文件系统、Shell、代码编辑器、网页和其他 Agent 上，同时记录 Agent 做了什么、限制它不能做什么，并在出错时决定重试、取消还是压缩上下文。

Harness 的底层基于 Cordis 插件系统构建。Cordis 元框架负责插件加载、卸载及依赖关系管理，Agent 中的具体组件则以不同插件形式运行，通过服务与事件进行协作。

核心架构：“一切皆插件”到底意味着什么

“一切皆插件”不是营销口号，而是 DeepSeek Harness 从立项之初、写第一行代码之前就确立的产品基因。具体来说，模型适配器、工具注册表、会话日志、Agent 主循环本身，全部都是可替换的插件。

插件化带来的三个直接好处

• 模块自由替换：可以把 DeepSeek 模型换成其他模型，把本地沙箱换成远程沙箱，不需要改动核心代码
• 插件之间解耦：各模块通过 Service 和 Event 协作，而非硬编码依赖
• 动态挂载与卸载：插件可以随时加入或移除，卸载时相关能力自动清理

这意味着 Harness 不只是一个写死的 Agent，而是一套可以自由拼装 Agent 的基础设施。第三方基准测试中，同一套 DeepSeek 模型权重，用简陋工具只通过 44/89 题，换成完整 Harness 后提升到 64/89。

四种运行模式怎么选：标准、PTC、极简、创造

DeepSeek Harness 针对不同场景提供了四种预设模式，各自加载不同的插件集。

• 标准模式：工具组合最全，包含文件编辑、Shell、搜索、Skills、子 Agent 等 20 多个工具，适合日常写代码和通用任务
• PTC 模式（程序化工具调用）：允许模型生成 TypeScript 代码，将多轮工具调用组合执行，适合步骤多、调用链长的复杂任务，是省 Token 的利器
• 极简模式：只保留一个持续运行的 Shell 工具和一个文件编辑器，环境削到最干净，官方定位是给模型跑基准测试用的
• 创造模式：在完整能力基础上增加 Runtime 检查、插件实验等开发功能，适合开发 Harness 插件或自定义模式的高级用户

选模式的原则很简单：日常开发用标准，复杂长任务用 PTC，测模型能力用极简，改插件用创造。

谁适合用 DeepSeek Harness

Harness 不是 Claude Code 或 Codex 那样的“成品工具”，而是一套“开发者底层工具”——它不打算给你一键可用的终端助手，而是给你一套能自己搭 Agent 技术栈的底座。

它适合以下几类用户：

• 希望自主搭建可控 Agent 执行环境的开发者，不想用闭源黑盒产品
• 需要本地隔离运行、看重数据隐私、不希望业务文件上传第三方服务的团队
• 需要在一致工具环境下做模型基准测试的研究人员
• 愿意折腾、享受自定义和插件生态的 AI 工具爱好者

如果你是追求开箱即用的普通用户，Claude Code 或 WorkBuddy 这类产品可能更适合。但如果你想要完全的控制权和可扩展性，Harness 是目前最开放的选项之一。

安装与上手：从零跑通第一个任务

Harness 的安装门槛不算高，核心依赖只有 Node.js 22 或更新版本。

1. 安装 Node.js 22+，确认版本符合要求
2. 运行 npx @deepseek-ai/dsh web 启动 Web 界面
3. 浏览器打开终端提示的本地地址，默认为 http://127.0.0.1:3080
4. 进入 Settings → Models，填入 DeepSeek 开放平台的 API Key
5. 选择工作区目录，选择模型和运行模式，开始对话

首次使用建议从标准模式开始。Harness 会自动记录每一步的推理轮数、单步耗时和 Token 消耗，状态栏实时显示，整个思考过程完全透明。

需要注意的是，Harness 目前主要提供网页版界面，官方没有提供完整的命令行工具，对习惯终端操作的开发者不太友好。另外，插件的配置有一定学习成本，需要理解 Cordis 的插件机制和 Profile 概念。

优劣势客观分析

Harness 最大的优势在于极致的可定制性和成本透明度。它采用仅追加式会话日志，系统提示、思考过程、工具调用全部永久记录，支持任务回放和分叉调试。缓存命中率实测大多在 99% 左右，长任务中成本控制优势明显。

但现阶段也有明显的不足：配置学习曲线较陡，插件文档不够完善，部分用户反馈 Token 消耗较大。Harness 目前仍处于开发者预览阶段，核心服务层、多租户隔离等方面尚在完善中。

常见问题解答

DeepSeek Harness 和 DeepSeek 模型是什么关系？

Harness 是模型之外的执行框架，负责工具调度、任务管理和执行闭环。模型负责思考，Harness 负责把想法变成实际动作，两者组合才能形成完整的 Agent。

DeepSeek Harness 免费吗？

Harness 本身是 MIT 协议开源软件，可以免费使用和修改。但它需要调用大模型 API，API 按 Token 量计费。实测跑一次 RAID 重组任务约消耗 200–400 万 Token，费用在几元到十几元不等。

没有编程基础能用 DeepSeek Harness 吗？

可以安装并完成基本任务，但 Harness 的插件配置和自定义功能需要一定的技术理解。如果只是想体验 Agent 能力，建议先用标准模式跑通一个简单任务，再逐步探索插件系统。

DeepSeek Harness 支持接入其他厂商的模型吗？

支持。Harness 原生支持 DeepSeek 模型路由，同时兼容其他模型提供方和自定义接口，对企业内部网关、本地模型服务、OpenAI 兼容 API 均可配置。