DeepSeek Harness 是 DeepSeek 在 2026 年 8 月面向开发者放出的 Agent 运行层开源项目（开发者预览），仓库见 deepseek-ai/deepseek-harness，协议为 MIT。它解决的不是「再发一个聊天模型」，而是：模型已经会想，如何稳定地拆任务、调工具、改文件、跑命令、记日志、失败后恢复——也就是社区常说的 Model + Harness = Agent。
本站是 Clash Verge Rev 资料站。你若在国内本机跑 Harness，Shell 与出站工具很容易踩到「系统代理绿灯、终端仍直连」。概念看本文；落地代理看Harness + Clash Verge。同类编码 Agent 对照：Claude Code、Codex CLI。
先分清：模型权重 vs Harness 运行层
打开新闻里的「DeepSeek 又开源了」，要先问开源的是哪一层。模型权重决定推理能力与价格；Harness 决定模型能不能在真实仓库里连续干活。没有 Harness，你多半停在对话框；有了 Harness，模型才能在受控边界里调用 Shell、读写文件、调度子任务，并把过程落成可回放的会话日志。
| 层级 | 典型产物 | 你在排什么错 |
|---|---|---|
| 模型 | API / 权重 | 密钥、额度、延迟、内容策略 |
| Harness | 框架、插件、Web UI、Agent Loop | 工具权限、会话恢复、插件冲突、本机网络 |
| 客户端代理 | Clash Verge 等 | 终端是否进隧道、节点地区、DNS |
把「API 超时」和「插件没装上」混成一句「Harness 不能用」，会同时改密钥、重装 Node、乱开 Global，最后仍不知道哪一层坏了。
一切皆插件：为什么开发者在意
公开材料强调 Harness 建在插件化内核上（报道与文档多提到 Cordis）：模型适配器、工具集、会话存储、界面，甚至 Agent 循环本身都可以作为插件加载或替换。目标是：扩展能力时改配置、加插件，而不是把业务逻辑写进框架主干后永远分叉。
对使用者的直接后果是：同一套 Harness 可以换模型后端、裁剪工具面（例如极简模式只留 Shell 与文件编辑做评测），或在创造模式里试验新插件组合。具体模式名称与开关以当前仓库 README 为准——预览版会改名、会砍接口，文章里的模式列表只能当地图，不能当死合同。
怎么试跑（以官方说明为准）
环境侧通常需要较新的 Node.js 工具链。仓库文档给出的快速路径是用 npx 拉起 Web UI，常见写法：
- 安装 Node.js（版本要求看 README）。
- 执行
npx @deepseek-ai/dsh web（若官方改了包名，以仓库为准）。 - 按界面或文档配置 DeepSeek（或其他已适配）API Key。
- 用一个最小任务验收：例如列出当前目录、读一个小文件，而不是一上来「重构整个 monorepo」。
逐步图解见npx 一键启动。也可以 git clone https://github.com/deepseek-ai/deepseek-harness.git 后按源码安装，适合要写插件或跟主线的人——见源码安装。MIT 允许商用与修改，但上线前仍要自己评估预览版稳定性与许可证合规。
和 Claude Code / Codex 怎么对照看
三者都在「让模型碰代码与终端」这条路上，产品切口不同：
- Claude Code / Codex：厂商封装好的入口，路径固定，排错也相对固定（见本站 Claude / Codex 专文）。
- DeepSeek Harness：强调可组合运行层，默认贴 DeepSeek 模型，也可扩到其它适配器；你要为插件与配置负责。
若你的目标只是「今天把仓库里一个脚本改通」，现成 CLI 往往更快；若你要沉淀自己的工具白名单、审计日志与多模型切换，Harness 这类框架更对口。不要用「哪个更强」一句话选型——先看你要不要拥有运行层。
网络层：何时才轮到 Clash Verge
DeepSeek API 在不少国内网络可直连；但 Agent 一旦 npm install、拉 GitHub、访问海外文档或调用必须出站的工具，失败会表现为工具超时、空日志、半截任务。浏览器能开网页，不代表跑 npx 的那个 shell 进了代理。总策略见Tun 与 AI；逐步配置见Harness 代理专文。安装包走下载中心。
用两条命令把「直连 vs 走代理」分开看：
curl -sI https://api.deepseek.com
curl -sI https://github.com -x http://127.0.0.1:7897第一条多数国内网络可直连并返回响应头；第二条不走 -x 时若超时，说明 GitHub 侧需要代理。这只是快速判断，真正跑 Agent 时以连接页记录为准。
验收与止损
概念验收：能用自己的话区分「模型挂了」和「Harness/工具层挂了」。试跑验收：Web UI 起来、Key 配上、最小读文件或列目录成功。网络验收：需要出站时，Clash 连接页能看到对应域名或进程流量。预览版大改配置前先备份会话与插件列表；连续失败时一次只动一层（Key → 工具权限 → 代理），不要同时升 Node、换模型、开 Global。