返回教程列表
DeepSeek Harness 开发者预览版深度介绍：一切皆插件的开源 Agent 框架

DeepSeek Harness 开发者预览版深度介绍：一切皆插件的开源 Agent 框架

AI瑶·2026-08-15教程

DeepSeek Harness 开发者预览版深度介绍：一切皆插件的开源 Agent 框架

资料整理：2026-08-15 ｜ 来源：DeepSeek 官方页面 / GitHub / IT之家 / 开发者体验文章

一、背景：Harness 是什么？为什么值得关注？

2026 年 8 月 13 日，DeepSeek 在开源 DeepSeek-V4-Pro-0813 的同时，推出了其 开源（MIT 协议）代码智能体框架 DeepSeek Harness v0.1 开发者预览版（基于 Cordis 插件系统），被业界视为对标 Claude Cowork 的国产开源方案。

早在 7 月底 DeepSeek-V4-Flash 正式版发布时，官方就预告了「DeepSeek Harness 即将公布」——其正式版基准测试正是用 Harness 极简模式跑出的。如今它终于公开亮相：

Harness 让 Agent 在真实场景中持续工作。模型是 Agent 的灵魂，Harness 给予 Agent 理解环境、使用工具，并在真实场景中持续工作的能力。 Agent = Model + Harness

DeepSeek Harness 架构：一切皆插件
DeepSeek Harness 架构：一切皆插件

二、核心设计：「一切皆插件」

DeepSeek Harness 最核心的设计理念是一切皆插件——模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件提供，并通过 Cordis 服务与事件彼此协作。

三层架构

  1. Cordis 内核：只负责插件的加载、卸载和依赖关系，不承载 Agent 的具体能力（没有需要打补丁的「特权内核」）
  2. 插件提供能力：每一项能力注册都是可逆副作用，插件卸载时自动撤销——运行时不存在补丁
  3. 配置层自由组合：开发者无需改动源码，即可在配置层选择、替换或扩展任一能力

底层由开源插件系统 Cordis 驱动，其设计思想对应论文《A Programming Paradigm for Spatiotemporal Composability》。扩展 dsh 的方式就是「把新插件挂载到其他插件旁边」。

运行时有迹可循

模型看到的一切都会写入仅追加（append-only）设计的会话日志，包括：系统提示词、思维链、工具调用与结果、子 Agent 调度，以及每一次上下文注入。在 Trajectory 视图中可按来源查看这些信息；恢复、分叉、检索与回放共享同一份事件流——Agent 的每一步都可追溯、可复现。

Trajectory 轨迹视图（官方界面截图）
Trajectory 轨迹视图（官方界面截图）

三、四种运行模式

开箱即提供四种模式，覆盖从完整编码 Agent 到最小化基准测试的全谱系：

模式定位能力构成
标准模式功能完整的编码 Agent文件编辑、Shell、文件与网页检索、Skills、计划、目标、子代理（subagent）与工作流
PTC 模式代码组合工具调用具备标准模式全部能力，并通过 Code Mode SDK 呈现工具——让模型用一个 TypeScript 程序组合多步操作
极简模式最小化基准测试仅保留持久 bash 与 str_replace_editor 两个工具，用于最小化环境下的模型评测（官方 V4-Flash 基准即用此模式）
创造模式自定义 Agent preset具备标准模式全部能力，并提供运行时检查、插件实验与 preset 创作指导——组合出属于你的新模式

四、快速上手（5 分钟跑起来）

方式一：npx 一键启动（推荐）

安装 Node.js 后，一行命令启动 Web UI：

npx @deepseek-ai/dsh web

Web UI 默认地址：http://127.0.0.1:3080

方式二：源码安装

git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Web UI 使用只需三步

步骤操作说明
1配置模型打开「设置 → 模型」，填入 DeepSeek API 密钥并保存，模型路由立即可用、无需重启
2选择工作区添加启动 dsh 时所在的项目目录并选中（选中前会话输入框不可用）
3运行任务发送如 "Summarize this repository"——agent 读写文件、运行命令、委派子代理；超出权限策略的操作会先征求你的审批

也支持其他提供方与自定义 OpenAI 兼容端点（参考开发者文档 providers 指南），模型路由无需重启服务器。

五、SDK 与生态

  • Python SDK：pip install deepseek-harness-sdk（自带运行时、无需系统 Node.js），把 Agent 嵌入任何工作流
  • TypeScript SDK：面向 JS/TS 生态
  • CLI / Headless 模式：headless 一次性运行任务、打印最终答案并退出，适合脚本与 CI
  • 社区插件：GitHub dsh-plugin 话题下持续涌现社区插件
  • 配置管理：通过 Profile、组合包（Bundle）与 patch 分层叠加配置；--dump-config 可随时审查整棵配置树——「你的 Agent 是什么样，你说了算」

六、真实体验与对比（来自开发者实战）

一位开发者的实际体验（官方页面外的实践分享）：

  • 惊喜：大约 2 小时就得到了一款能够运行的原生 macOS 应用——界面简洁，但任务、轨迹、上下文和工具调用足够透明，让人第一次清楚地感受到 Agent「不只是聊天框里回复，而是在一个工作环境中推进任务」
  • 过程透明：用户能在界面中看到 Agent 正在拆任务、调用工具、消耗上下文、尝试完成验证——Harness 把「工作过程」主动展示出来
  • 与 Codex 的对比：体验中 Harness 帮助快速建立了产品主体，Codex 在后续局部迭代中表现出更快的收敛速度。作者强调不会简单排名——两者暴露出的能力不同
  • 思考：当 Coding Agent 都能快速生成 Demo，下一场竞争也许从「谁做得更快」转向「谁能在持续修改中更稳定地抵达结果」

七、对开发者的意义与展望

  1. 不绑定单一模型：如果模型、工具、技能、会话、沙箱、存储、循环、调度和 UI 都能自由替换，Harness 就不必绑定在一种模型或一种开发方式上——不同团队可根据任务组合能力
  2. 驾驭工程的完整产品化：不追求更强的模型，而是把模型运行所需的约束、反馈、工具、记忆、可观测性全部做成可组合的插件基础设施，让每个团队都能按自己的方式驾驭 AI
  3. 开源可复用：MIT 协议、v0.1 开发者预览版，核心插件和基础 API 持续迭代中——参与社区插件开发是很好的切入点

参考链接

  • 官方页面（一切皆插件）：https://www.deepseek.com/harness/
  • GitHub 仓库（Star 104k+）：https://github.com/deepseek-ai/deepseek-harness
  • 开发者文档（快速上手）：https://deepseek-harness.github.io/deepseek-harness/guide/quickstart
  • 社区插件：https://github.com/topics/dsh-plugin
  • Cordis 论文：https://github.com/cordiverse/paper
  • IT之家报道（对标 Claude Cowork）：https://www.ithome.com/0/989/446.htm