DeepSeek V4 Pro 正式版发布后，预告已久的 DeepSeek 自家 Agent 项目也一同亮相，它就是 DeepSeek Harness。这个项目的理念很直接：一切皆插件。
DeepSeek Harness 发布并强调一切皆插件
截至原稿写完时，DeepSeek Harness 在 GitHub 上已经获得 3.7 万 Star，增长速度非常快。
DeepSeek Harness GitHub Star 数量
体验产品、读完开发者文档并试用部分插件后，我觉得它注定是一款争议很大的产品。喜欢的人会认为它代表未来，不喜欢的人会觉得它太粗糙、使用门槛太高。下面就从原理讲起，再一步步完成安装、配置、模式选择和插件扩展。
想同时体验 Codex 等成熟 Agent 工具，可使用支付宝或微信开通 ChatGPT Plus/Pro
相关教程： 如果你更想在成熟的 Codex 桌面端里调用 DeepSeek，可以先看 Codex 接入 DeepSeek 安装与配置教程。
DeepSeek Harness 是什么：Agent = Model + Harness
DeepSeek 在官网上给出了一条重要公式：
Agent = Model + Harness
DeepSeek 官网展示 Agent 等于模型加 Harness
这个公式此前也被 LangChain 用来解释 Agent Harness。一个完整 Agent 由模型和 Harness 共同构成。想进一步理解这个概念，可以阅读原作者此前的科普文章：一文看懂 Harness Engineering。
Harness Engineering 原理介绍
Claude Code、Codex、Workbuddy 这类产品本质上都是 Harness，需要和 Claude Fable 5、GPT 5.6-Sol 等模型配合使用。Harness 包含工具、Skills 系统、会话、沙箱、存储、Agent 循环、调度、子 Agent 和工作流等组成部分。
Codex 等 Agent 产品中的 Harness 组成
过去，这些能力通常封装在一个完整软件里。普通用户主要自定义 Skill、MCP 等少量扩展，其余能力由产品预先做好。DeepSeek Harness 的区别在于，它把几乎所有能力都包装成插件，让开发者可以自行替换和组合。
Cordis 内核负责什么
DeepSeek Harness 真正的核心是 Cordis 内核。Cordis 的作者加入了 DeepSeek，团队还为这套机制发布了一篇 88 页的论文。
DeepSeek Harness Cordis 内核论文
Cordis 内核本身非常克制，只负责插件的加载、卸载和依赖管理，其他事情都交给插件。更特别的是，Agent 运行过程中也能更换插件，同时保持运行状态不崩溃。
它依赖两个核心特性：
- Temporal composability（时间可组合性）：插件卸载后，之前产生的副作用能否完整撤销。
- Spatial composability（空间可组合性）：插件依赖的其他插件出现、消失或改变时，能否动态重新处理依赖。
这套机制让 Agent 可以在运行中为自己开发、安装和卸载插件，持续添加或删除能力，形成某种意义上的自进化。
DeepSeek Harness 一切皆插件理念
因此，与其把 DeepSeek Harness 当成一个已经打磨成熟的 Agent 产品，不如把它理解成一套 Harness 基础设施，以及用于展示 Cordis 内核的 100 多个第一方插件。这也解释了它为什么叫 Harness，而不是 Code 或 Build，以及首个版本为什么标为开发者预览版。
DeepSeek Harness 开发者预览版
DeepSeek Harness 怎么安装与配置 API
DeepSeek Harness 的官方网址是：https://www.deepseek.com/harness/。
DeepSeek Harness 官方网站
运行 DeepSeek Harness 安装命令
打开终端，运行：
npx @deepseek-ai/dsh web
如果看不懂命令，也可以把它交给任意一款本地 Agent 产品，让 Agent 帮你完成安装。安装启动后，终端会显示一个本地网址。
DeepSeek Harness 启动后的本地网址
把网址复制到浏览器中打开即可。
填写 DeepSeek API Key
第一次运行时，页面会要求填写 DeepSeek API Key。前往 DeepSeek 开放平台 创建 API Key，并先给账户充值一点余额。
DeepSeek Harness 首次运行填写 API Key
填好后即可进入首页。默认是一个标准 Web UI，而且这个界面本身也是 UI 插件，因此也可以替换和修改。
DeepSeek Harness 默认 Web UI 首页
例如，群友 @黑哥小黑子（blake）就制作了一个皮肤插件。
DeepSeek Harness 第三方皮肤插件界面
DeepSeek Harness 模型、思考强度与价格设置
默认模型可以选择 Flash 和 Pro。
DeepSeek Harness 选择 Flash 和 Pro 模型
同时还可以调整思考强度。
DeepSeek Harness 设置模型思考强度
DeepSeek V4 Pro API 价格变化
使用模型时需要注意，DeepSeek 已正式宣布涨价。
DeepSeek 官方宣布 API 价格变化
其中，V4 Pro 的缓存命中价格上涨 12 倍，高峰期输出价格达到 27 元。与作者原先预测的约 2 倍涨幅相比，实际高峰期价格从 3 倍起步，涨幅明显更高。
DeepSeek V4 Pro 不同时段 API 价格
把价格和其他主流模型放在一起看，DeepSeek V4 Pro 与 GLM、Qwen 3.8 Max 已经很难拉开明显差距。原稿还判断 GLM-5.3 可能很快发布，价格大概率不变，并可能继续保持开源 SOTA 能力，因此 DeepSeek V4 Pro 单看 API 性价比，可能不如 GLM。
DeepSeek 与其他主流模型 API 价格对比
添加其他模型提供方
DeepSeek Harness 并没有把用户锁定在 DeepSeek 模型上。设置中既可以选择目录里的模型提供方，也可以自定义提供方、Base URL、协议和模型列表，因此以后也能把 GLM 等其他模型接入 Harness。
DeepSeek Harness 自定义模型提供方设置
DeepSeek Harness 四种模式怎么选
回到首页，点击“选择工作区”，添加一个项目目录。这个目录就是 Agent 可以操作的项目文件范围。
DeepSeek Harness 选择项目工作区
接下来会看到标准、PTC、极简和创造四种模式。
DeepSeek Harness 标准 PTC 极简和创造四种模式
知道 Cordis 的底层机制后，就不要再把这四项理解成 DeepSeek Harness 不可更改的固定模式。它们本质上只是官方提供的四套插件模板，目的是让用户开箱即用。
标准模式：新手直接选择
如果是第一次使用，或者还不了解底层机制，直接选标准模式即可。它预设了完整的代码 Agent 能力，包括文件读取与编辑、Shell、文件搜索、网页搜索、Skills、计划、目标、后台任务、子 Agent 和工作流等插件。
DeepSeek Harness 标准模式预设插件
PTC 模式：用 TypeScript 组合工具调用
PTC 模式拥有标准模式的全部能力，区别在于工具的呈现方式。
标准模式通常由模型发起一次工具调用，拿到结果后再决定下一步。PTC 模式会提供一套 Code Mode SDK，让模型编写 TypeScript 程序，在一次 run_code 中组合多个工具操作。
原本需要五次模型往返的读取、搜索、筛选、并行调用和结果整理，有机会压缩进一次程序执行。这能减少模型与工具的来回对话，更适合结构化、多步骤、可并行的任务，也更节省 Token。
不过，它要求模型具备足够稳定的代码规划能力，调试难度也较高。新手先使用标准模式，等遇到大量重复工具往返，或者想测试模型的程序化工具调用能力时，再切换到 PTC。
极简模式：用于模型基准测试
极简模式只给模型两个核心工具：一个持久 Bash 和一个文件编辑器。
它还会把系统提示词固定成一句非常简单的“你是一个有帮助的软件工程助手”，同时去掉上下文压缩和大量额外能力。这个模式适合在最小环境下比较两个模型的裸 Agent 能力，不适合日常使用。
创造模式：让 Agent 改造自己
创造模式最能体现 DeepSeek Harness 的特点。它拥有标准模式的完整能力，还能检查正在运行的 Cordis 环境、在内存中试验插件，并帮助用户创建新的 Agent 和插件。
你可以这样下达需求：
帮我做一个只允许读代码、不允许改文件，专门负责安全审计的模式。
也可以这样描述：
帮我做一个接入公司内部搜索、固定使用某个模型、拥有三种专属 Skills 的研究 Agent。
甚至可以先让 Agent 检查自身已有插件和能力，缺少某种能力时现场创建插件，再挂到正在运行的流程中。打个比方：Agent 发现自己没有扳手，于是现场造出一把扳手，装到自己手上，然后继续工作。
DeepSeek Harness 会话日志与插件机制
DeepSeek Harness 还有一项对开发者非常友好的设计：会话是一份只追加的事件日志。
模型看到的系统提示词、用户消息、推理内容、工具调用和结果、权限变化、上下文注入、压缩、子 Agent 调度，都会成为日志中的事件。下一轮模型看到的历史，也会从这份日志重新推导出来。
DeepSeek Harness 会话事件日志与轨迹视图
很多 Agent 失败后，用户只能看到任务失败或无限循环，却不知道从哪一步开始跑偏。DeepSeek Harness 的轨迹视图可以按来源查看每一次运行，对开发者来说，这意味着过程可观测、可审计、可复现，尤其适合研究场景。
官方第一方插件可以在设置页的“插件”中查看。如果缺少某种能力，也可以用创造模式自己制作。与 DeepSeek Harness 同时上线的还有社区插件入口，里面已经有不少第三方插件。
DeepSeek Harness 社区插件入口
DeepSeek Harness 插件推荐：5 个实用扩展
下面这 5 个社区插件可以改善文件引用、界面渲染、自动化、工作台和视觉理解体验。
dsh-at-file：输入框直接引用文件
安装后可以在输入框中直接用 @ 调用文件，引用项目内容会更方便。
dsh-at-file 使用 @ 引用文件
dsh-genui：在回复中渲染交互界面
项目地址：omdsh-dev/dsh-genui
它允许模型在回复中直接渲染图表、表格、表单、Diff、Mermaid 和交互面板等内容。
dsh-genui 在回复中渲染图表和面板
dsh-automation：补充自动化能力
项目地址：titanwings/dsh-automation
这个插件为 DeepSeek Harness 补充自动化能力，属于刚需类型，不过原稿作者认为它的交互体验还有改进空间。
dsh-automation 自动化插件界面
DSH-better-sidebar：增加 VS Code 风格工作台
项目地址：omdsh-dev/DSH-better-sidebar
它会为 DSH 增加一套类似 VS Code 的工作台，把文件管理、代码编辑、真实终端、Git、Diff、内嵌浏览器、后台任务和子 Agent 状态放进侧边栏，让功能更完整。
DSH-better-sidebar 的 VS Code 风格侧边栏
ModLens：为纯文本模型增加视觉能力
项目地址：liustack/modlens
ModLens 可以为纯文本 DeepSeek 模型补充视觉能力。配置视觉通道后，直接在对话中粘贴图片，模型就能读取图片内容。
ModLens 为 DeepSeek Harness 增加图片理解能力
DeepSeek Harness 适合哪些用户
DeepSeek Harness 是一个很有趣的系统，插件动态插拔和 Agent 自我改造的概念也很有想象力。但从产品角度看，它目前对普通用户仍不友好：开发者术语多、使用门槛高、功能和用户体验也有明显不足。
如果你只想开箱即用地完成编码任务，标准模式最容易上手；如果你想研究模型的程序化工具调用，可以尝试 PTC；如果要做模型基准测试，使用极简模式；如果你希望探索插件系统和 Agent 自进化，创造模式才是最值得体验的部分。
DeepSeek 可能本来就是一个更注重科研与探索的团队。正如它的 Slogan：探索未至之境。
相关教程推荐：