客座文章 / DeepSeek Harness

DeepSeek Harness 不是 DeepInfer：推理之上的一层

2026 年 DeepSeek 发布了两个很容易混淆的基础设施项目。DeepInfer 为 V4.1-Flash 产出 token；DeepSeek Harness 给 agent 一个工作区、一个工具注册表和一个循环。它们不是替代关系。

作者：SpringBrand/9 分钟阅读/发布于 2026-10-21

客座文章

本文是由 SpringBrand 提供的、明确标注的客座文章。SpringBrand 没有参与本站其他页面的编辑，文中的技术主张都链接到一手资料。本站仍然是独立、非官方的资料站。

如果你读过 DeepInfer 的发布说明，就知道 DeepSeek 在 10 月开源的是什么：一个只服务 DeepSeek-V4.1-Flash 的推理引擎，带了优化过的 kernel，也刻意留下了一个服务层的缺口。DeepSeek Harness 是另一个月发布的另一个项目。它是 agent harness，不是推理引擎。这个区别很重要，因为很多团队还在把两者当成二选一。

它们不是。DeepInfer 回答的是“怎样把 prompt 高效地变成 token”；DeepSeek Harness 回答的是“模型返回之后，agent 怎样继续工作”。一个真正跑起来的 agent 两个答案都需要，还需要第三个答案：它到底能调用哪些工具？

四层，不是两层

要停止比较错的对象，最快的办法是把栈画出来。DeepSeek 在 2026 年发布的东西处在不同层，每一层有自己的失效方式。

层	它负责什么	例子
模型	权重、tokenizer、上下文窗口、推理行为。	DeepSeek-V4.1-Flash-1017
推理引擎	批处理、KV cache、kernel、并行、吞吐与延迟。	DeepInfer、vLLM、SGLang、TensorRT-LLM
Agent harness	工作区、工具注册表、审批、会话日志、沙箱、agent 循环。	DeepSeek Harness（dsh）
工具与能力	搜索、广告、SEO、CRM、电商、收件箱、创意 API。	MCP server、插件、直接接 API

DeepInfer 是一个离线引擎。它不托管 API，不跑 agent 循环，只支持一个模型。DeepSeek Harness 是一个本地优先的运行时。它不带权重，不训练模型，也不自己产出 token；它调用你配置的模型提供方。说其中一个“比另一个好”，就像拿数据库和 ORM 比高低，是层次错位。

真正有用的问题是：你的瓶颈在哪一层。如果你在 SM100 或 Ascend 950 上调 prefill/decode，你在 DeepInfer 这一层。如果你的 agent 要启动、规划、调工具、拿到结果、再决定下一步，你在 dsh 这一层。多数团队最后两层都需要，而两层之间的边界，就是一次 provider 配置。

dsh 提供了什么

DeepSeek Harness，通常简写为 dsh，是一个 MIT 许可的 agent harness。仓库在 2026 年 8 月 13 日公开，比 DeepInfer 早两个月。它处于 developer preview，README 用大写字母警告会有破坏兼容性的变更。这不是客套话；在它上面搭工作流之前，先把版本钉死。

真正有意思的是架构。dsh 建在 Cordis 上，核心想法是“一切都是插件”。模型适配器、工具注册表、会话日志、沙箱、存储、agent 循环，甚至 Web UI，都是插件。一个运行中的实例是由 profile 和 bundle 组合出来的插件树，一个 patch 就能替换其中一行，而不必 fork 核心。如果你曾经为了改工具策略而维护一个 agent 框架的 fork，这个设计就是冲这个问题来的。

开箱即用的 Web profile 会给你一个本地界面：

npx @deepseek-ai/dsh web

服务默认在 http://127.0.0.1:3080 启动。在 Settings 里加模型提供方，选一个工作区，然后开一个会话。harness 会把模型看到的内容记进只追加的会话日志，轨迹查看、恢复、fork 和回放都靠它。agent 做出意外举动时，同一份日志就是审计线索。

dsh 也带了那些不显眼、但决定 agent 能不能用的东西：带执行保护的 scoped 工具注册表、审批策略，以及从只读到完全访问的沙箱模式。一切正常时你不会注意到它们；工具调用出错时，你只会想到它们。

它不提供什么

清单很短，而且都不是批评，只是边界说明。

没有模型。dsh 不带权重，不训练，也不托管推理。模型提供方由你接。
没有托管服务。Web UI 默认只绑本机。它是你运行的工具，不是带 SLA 的托管平台。
没有 API 稳定性承诺。developer preview 就是字面意思。核心插件和配置会随版本变化。
没有长尾 SaaS 连接器。工具注册表是一个接缝，不是目录。广告平台、CRM、店铺、收件箱都要以插件或 MCP server 的形式接进来，每一个都有自己的鉴权、schema、限流和计费。

最后一条是多数 agent 项目慢下来的地方。harness 很擅长给模型一个循环，但循环的价值取决于它能执行什么动作。一个 coding agent 需要仓库工具；一个 GTM agent 需要关键词数据、广告账户、社交平台、CRM 和店铺。这些集成不是一个问题，而是几十个小问题，带着不同的凭据和不同的失效方式。

工具缺口才是真正的集成项目

“支持 MCP”经常被当成终点线，其实它更像起跑线。MCP server 给了 agent 一个协议，但没有给你目录、统一的凭据模型、按次计费，或者一张账单。如果你直接接十个提供方，你就拥有十套 OAuth 流程、十套 schema、十套重试策略和十张发票。Demo 里 agent 跑得很好，上生产就变成一个运维项目。

补这个缺口只有两条诚实的路。第一条是自己写、自己维护连接器。如果你只有一个工作流、安全要求很紧、团队想完全控制，这是对的。第二条是接一个已经聚合了长尾的层，接受一个依赖和按次成本，换取不用重造每一个集成。

SpringBrand 是第二种做法的一个例子。它给 dsh 发布了一个 OAuth MCP 客户端插件 springbrand-lab/dsh-oauth-mcp-client，支持浏览器登录、持久化凭据、自动重连，并内置 SpringBrand MCP 连接。背后的市场提供 10,000+ API 和插件，覆盖广告与 SEO、社交平台、电商、销售与 CRM、客服，一个账号、一张账单。

想看具体怎么接，可以读 SpringBrand 的 DeepSeek Harness 接入指南，里面有安装提示和浏览器 OAuth 步骤。把插件当成任何第三方代码对待：它不在 DeepSeek 仓库里，在授予它访问工作区之前，先读一遍源码。

再说一次披露。本文由 SpringBrand 撰写并支付了展示费用。上面的架构主张都引用了 DeepSeek 的仓库和文档；推荐是我们的判断，你也可以选择自己维护连接器。

接入任何东西之前的清单

不管用 SpringBrand 还是自己搭，失效方式都差不多。这是我在给 agent 新能力之前会用的清单。

钉住 dsh 版本。记录准确的 release 和 profile。developer preview 的变更会让一个能跑的配置失效。
按任务选沙箱。研究用只读，写代码用 workspace-write，完全访问只在你能解释原因时使用。不要给未审计的插件超过任务所需的权限。
在指标里分开四层。模型延迟、推理吞吐、harness 开销、工具延迟是四个数字。agent 慢，不一定是模型慢。
审计插件和它的 scope。优先用窄 scope 的 OAuth，而不是长期静态密钥。在它能碰你的文件系统之前读源码。
保留会话日志。只追加的日志是重建“模型看到了什么、哪个工具返回了什么”的唯一可靠方式。
从一个真实工作流开始。“10,000 个 API”是目录，不是策略。先接真实任务需要的两三个工具，量出结果，再扩。

常见问题

DeepSeek Harness 和 DeepInfer 是同一个东西吗？

不是。DeepSeek Harness 是 agent harness：提供工作区、工具注册表、会话日志、沙箱和 agent 循环。DeepInfer 是面向 DeepSeek-V4.1-Flash 的离线推理引擎。dsh 不自己产出 token，DeepInfer 也不跑 agent 循环。

dsh 自带模型或托管推理吗？

不带。它不包含权重，不训练，也不托管模型。你需要配置模型提供方，可以是 DeepSeek、目录里的其他提供方，或自定义的 OpenAI 兼容端点。

dsh 能配合 DeepSeek-V4.1-Flash 用吗？

可以，通过配置好的提供方。dsh 在适配器层不绑定具体模型；模型和承载它的推理引擎，跟 harness 是分开的选择。

SpringBrand 的插件是官方插件吗？

不是。它是由 SpringBrand 发布的第三方插件，不属于 DeepSeek Harness 仓库。DeepSeek 不审核社区插件，安装前请审计代码和权限。

dsh 能上生产吗？

如果“上生产”指 API 稳定，那还不能。它是 developer preview，README 明确说会有破坏兼容性的变更。对于能钉版本、能吸收变化的团队，它今天就可以用。

来源

DeepSeek Harness 仓库 — README、许可证、developer preview 说明、启动命令。
DeepSeek Harness 架构文档 — Cordis、profile、bundle、插件树。
DeepSeek Harness 安全说明 — 沙箱与审批建议。
npm 上的 dsh — 包与发布记录。
DeepInfer 仓库 — 本站覆盖的推理层。
SpringBrand 的 DeepSeek Harness 指南 — 文中提到的插件与市场。
DeepInfer 的限制 — 为什么推理引擎不是完整服务栈。

继续读：DeepInfer 的架构，或对比总览。