Agent.Space 博客

Agent.Space 上的 DeepSeek Harness:它是什么,应该怎样评估

了解 DeepSeek Harness 的工作方式、插件架构为何重要,以及在 Agent.Space 中选择它之前应该确认什么。

DeepSeek Harness 是 DeepSeek AI 推出的开源 Agent harness。它最鲜明的设计是:模型、工具、Skills、Session、Sandbox、存储、循环、调度和界面等 Agent 能力,都可以通过插件组合。

这让 DeepSeek Harness 很适合希望理解或定制“模型之外运行层”的开发者。同时,它也带来一个重要前提:插件组合不同,最终使用体验也可能不同。

如果你想通过 Agent.Space 评估 DeepSeek Harness,应该先用 DeepSeek 官方资料理解上游项目,再以 Agent.Space 当前产品界面和产品资料确认实际提供的内容。DeepSeek Harness Agent 页面是产品入口;本文不会假设官方项目里的每一种模式和能力,都已经出现在托管体验中。

DeepSeek Harness 是什么

DeepSeek Harness 是帮助模型作为 Agent 运行的软件层。DeepSeek 用下面这条公式概括两者关系:

text
Agent = 模型 + Harness

模型负责生成和推理;harness 负责外围运行循环,让 Agent 能理解环境、使用工具、维护 Session 状态、连续完成多个步骤,并把结果呈现给用户。

选择 Agent 时必须分清这两个层级。DeepSeek Harness 和 DeepSeek 模型属于相关产品,但不是同一层。Harness 可以通过不同方式连接模型,而某个产品里实际有哪些模型可选,取决于该产品当前展示的兼容关系和可用范围。

如果需要一个“更换模型层、但不把模型当成 harness”的具体例子,可以查看如何把 DeepSeek V4 Pro 作为 Codex 的模型后端

如果你想进一步理解这组概念,可以阅读 Agent harness 与模型有什么区别

为什么“一切皆插件”很重要

DeepSeek Harness 基于 Cordis 插件系统构建。根据官方项目页面,插件提供的主要 Agent 能力包括:

  • 模型;
  • 工具和 Skills;
  • Session 和存储;
  • Sandbox;
  • Agent 循环和调度;
  • 用户界面。

这种设计把很多编码 Agent 中原本捆绑在一起的能力拆开。开发者可以通过配置选择、替换或扩展某项能力,而不必重写整个 harness。

它的优势是可组合性。团队可以针对编码、测试、Benchmark 或 Agent 行为实验,组合出不同的运行方式。相应的取舍是:一个组合中出现的功能,不代表其他组合中也一定存在;真正的体验取决于当前启用的插件组合。

项目仍处于 Developer Preview 阶段,这条边界尤其重要。DeepSeek Harness 官方 GitHub 仓库明确说明项目正在快速迭代,并提醒开发者预期兼容性破坏。准备依赖某项工作流前,应重新查看最新官方文档。

截至 2026 年 9 月 11 日,最新上游预发布版本是 9 月 10 日发布的 dsh-v0.1.5-rc.2。0.1.5 的主要变化集中在 RC1,包括 Session V3、默认工具变化、更完整的文件工作流,以及 SDK/插件迁移;RC2 只增加两项小型 UX 改进。DeepSeek Harness 0.1.5 Release 指南整理了升级检查。这一上游版本不能证明 Agent.Space 当前开放了哪个版本或哪些能力。

“运行有迹可循”是什么意思?

DeepSeek 还把可追踪性作为核心设计。官方介绍显示,模型看到的信息会写入仅追加设计的 Session 日志,其中包括 Prompt、推理、工具调用与结果、子 Agent 调度和上下文注入。

官方体验中的 Trajectory 视图用于检查这条事件流;恢复、分叉、检索和回放也围绕同一份 Session 历史工作。

当你不仅要看最终答案,还想理解 Agent 如何得到结果时,这类记录会很有价值。例如,开发者可以检查调用过哪些工具、上下文从哪里进入 Session,以及任务在执行过程中怎样发生变化。

这些是 DeepSeek Harness 上游项目公开介绍的能力。使用任何托管实现时,仍应以当前产品界面实际提供的控制项和视图为准。

官方提供哪些运行模式?

DeepSeek Harness 官方介绍展示了几种面向不同任务的运行模式:

模式上游项目中的用途
标准模式完整的编码 Agent 配置,包括文件编辑、Shell、检索、Skills、计划、子 Agent 和工作流
Code/PTC 模式让模型通过生成代码组合多轮工具操作
极简模式用于模型 Benchmark;0.1.5 RC1 的 Web minimal 默认只有持久 Shell,str_replace_editor 需显式启用
创造模式检查运行时、试验插件并创建自定义 Agent preset

这些模式体现了插件架构的价值:同一个 harness 可以围绕不同目标重新组合。但它们不能被理解为“任何使用 DeepSeek Harness 的产品都会提供全部模式”。

Developer Preview 阶段的模式名称和细节也可能变化,使用前应以当前官方介绍为准。

怎样尝试官方上游项目?

DeepSeek 提供了两条官方起步路径:

  1. 安装 Node.js,然后运行 npx @deepseek-ai/dsh web 启动 Web UI。
  2. Clone DeepSeek Harness 官方仓库,再按照其中的源码安装说明操作。

Web UI 默认在本地启动。填写凭证或授予工具权限前,应先阅读当前安装说明,并决定 harness 可以访问哪些文件、命令和外部服务。

由于项目仍处于 Developer Preview,第一次最好选择范围小、容易撤销的任务:限制工作目录,写清输出目标,并在扩大使用范围前检查实际改动。

怎样在 Agent.Space 中评估 DeepSeek Harness?

Agent.Space 会把 Agent harness 和模型作为两个不同选择。评估 DeepSeek Harness 时,可以按下面的顺序操作:

  1. 打开当前的 Agent.Space Agents 页面和产品界面。
  2. 确认 DeepSeek Harness 是否对你的账号和 Workspace 显示为可用。
  3. 查看界面中实际展示的模型、控制项、工具和限制。
  4. 先运行一个输出容易检查的小任务。
  5. 把当前产品界面和产品资料作为托管体验的依据。

不要仅根据上游项目推断 Agent.Space 中的可用能力。某项上游功能、模式或集成可能需要额外的产品支持,才会出现在 Agent.Space 中;兼容哪些模型也应在当前产品界面中确认,不能只根据 harness 名称推测。

Agent.Space Workspace 介绍可以帮助你理解外围工作空间。DeepSeek Harness 的具体行为,仍应以当前产品体验中显示的选项和说明为准。

DeepSeek Harness 不等于 DeepSeek 模型

Harness 与模型共享 DeepSeek 品牌,但属于不同层级。

DeepSeek Harness 提供循环、插件、工具、状态与接口;模型提供生成与推理。Agent.Space 可以把 Agent 和模型作为分开的选择,当前产品界面会显示哪些选择可以搭配使用。

因此,下面两种说法都不安全:

  • “DeepSeek Harness 永远使用 DeepSeek 模型。”
  • “Agent.Space 上的 DeepSeek Harness 可以使用任何模型。”

第一种忽略了可配置的模型连接,第二种忽略了真实兼容约束。只能把当前产品界面实际显示的组合作为可用组合。

第一个任务应该怎样选?

第一次评估时,建议选择具备这些条件的任务:

  • 只有一个清楚目标;
  • 只涉及少量文件;
  • 输出格式明确;
  • 有一项你能理解的验证步骤;
  • 不包含破坏性操作;
  • 接受结果前可以人工检查。

例如,“解释一个小模块并提出测试建议”比“重新设计整个应用”更容易判断。边界清楚的任务能让你观察推理、工具使用和输出质量,同时降低实验风险。

DeepSeek Harness 实用工作流会把这份清单进一步整理成可重复执行的准备、委派、验证与保存流程。

谁适合现在尝试,谁应该等待

如果你符合以下情况,DeepSeek Harness 值得关注:

  • 想研究现代的插件组合式 Agent 架构;
  • 重视检查 Agent 的运行过程;
  • 希望不同任务可以使用不同的运行组合;
  • 能接受 Developer Preview 软件仍会变化。

如果你需要长期兼容保证、必须固定使用一种工作流,或者无法接受 Preview 阶段行为变化,更成熟的选择可能更合适。

升级 Preview 环境前,应先查看 DeepSeek Harness 0.1.5 Release 与迁移检查,尤其是 Session V3、默认工具变化、自定义插件合同,以及仍然适用的安全边界。

结论

DeepSeek Harness 不只是另一个模型,而是一个由插件和可追踪 Session 构成的 Agent 运行层。可组合性是它最重要的特点;Developer Preview 状态则意味着用户需要持续核验官方资料,并从边界清楚的任务开始。

对于 Agent.Space,判断规则很简单:用 DeepSeek 官方来源理解上游概念,但以 Agent.Space 当前产品界面和产品资料判断托管版本是否可用、具体怎样运行。如果你的 Workspace 中已经显示 DeepSeek Harness,可以先查看可用 Agents,再从一个能完整检查结果的小任务开始。