### [DeepSeek Harness开源：把Agent Loop、工具与工作流全部变成插件](https://www.zuoshipin.com/article/20886)

**Published:** 2026-08-13T23:58:54

**Author:** 天才交易员

**Excerpt:** DeepSeek开源Harness开发者预览版，以“一切皆插件”为核心，将模型适配、文件系统、Shell、LSP、子智能体、工作流、会话日志和安全策略组合成可扩展Agent框架。

![DeepSeek Harness官方README与开发者预览提示](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-01.webp)

DeepSeek Harness官方README与开发者预览提示

DeepSeek这次开源的不是一个新模型，也不只是又一层API封装，而是一套可以真正承载编码Agent的应用框架：**DeepSeek Harness**。它把模型连接、文件系统、Shell、LSP、子智能体、工作流、界面、权限和Agent Loop都拆成插件，再通过Cordis微内核组合起来。

项目目前仍是**开发者预览版**，官方明确提醒后续会出现破坏兼容性的改动。想先了解DeepSeek模型与入口，可以查看[https://www.zuoshipin.com/link/873.html](https://www.zuoshipin.com/link/873.html)；准备接入生产流程前，则应锁定版本并在隔离环境测试。

![DeepSeek Harness开源消息与开发者讨论](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-02.webp)

DeepSeek Harness开源消息与开发者讨论

![DeepSeek Harness项目标识](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-03.webp)

DeepSeek Harness项目标识

## 一、先看实测：它已经能连续完成复杂生成任务

在文章记录的一次测试里，DeepSeek Harness连接DeepSeek-V4-Flash后，用三十多分钟完成了一个第一人称僵尸射击游戏。测试过程中没有人工接管，Agent自行创建项目、编写代码、调用工具并持续修正结果。

![使用DeepSeek Harness生成第一人称僵尸射击游戏的实测画面](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-04.webp)

使用DeepSeek Harness生成第一人称僵尸射击游戏的实测画面

随后又用“一句话生成华强买瓜3D动画”的方式做了对比。Harness能够给出完整场景、人物、镜头和对白节奏，并继续迭代可运行结果。文章同时展示了其他Agent在相同题材上的输出，用来观察执行链路与成片差异。

![DeepSeek Harness生成的华强买瓜三维动画画面](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-05.webp)

DeepSeek Harness生成的华强买瓜三维动画画面

![同一任务下另一款Agent生成的华强买瓜动画画面](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-06.webp)

同一任务下另一款Agent生成的华强买瓜动画画面

![DeepSeek Harness生成动画的另一处镜头](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-07.webp)

DeepSeek Harness生成动画的另一处镜头

这些结果属于单次体验记录，并非统一硬件、统一模型、统一预算下的控制变量基准。尤其与Codex等产品比较时，更值得关注的是工具编排、失败恢复和过程可追溯性，而不是只看一张最终截图。相关产品介绍可查看[https://www.zuoshipin.com/link/1474.html](https://www.zuoshipin.com/link/1474.html)。

## 二、Harness到底是什么：SDK、运行时和应用框架的组合

Harness可以连接DeepSeek及其他模型，让模型读取和修改文件、运行命令、调用开发工具，并通过任务、子智能体和工作流完成长链路执行。它同时提供Web UI、终端TUI、Headless模式以及自动化协议，因此同一套核心能力可以进入本地开发、CI任务或外部系统。

![DeepSeek Harness仓库目录与模块布局](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-08.webp)

DeepSeek Harness仓库目录与模块布局

仓库并不是一个小型演示项目。代码分布在packages、apps、examples、python、native、vendor和website等目录中，核心能力与界面实现被拆成大量独立工作区。这样的组织方式说明它的目标不是做一个固定聊天窗口，而是成为可二次开发的Agent底座。

![Web界面中的模型与配置选择](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-09.webp)

Web界面中的模型与配置选择

![DeepSeek Harness中文项目说明](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-10.webp)

DeepSeek Harness中文项目说明

## 三、“一切皆插件”，甚至Agent Loop也是插件

Harness运行时本质上是一个Cordis Context。插件可以在Context中注册服务、事件和能力，其他插件再通过明确接口消费它们。核心包负责Session、System Prompt、Tools、Agent和Agent Loop；外围包再补上模型适配、Shell、文件系统、LSP、Web、Skill、Subagent和Workflow。

![Harness运行时工具调用与事件记录界面](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-11.webp)

Harness运行时工具调用与事件记录界面

### 接口、实现、消费者分开

以Bash工具为例：上层先定义工具接口，本地进程插件负责执行，模型侧只看到整理后的工具Schema。如果团队要把本地Shell替换为容器、远程渲染节点或受控执行服务，可以保留调用接口，只替换底层实现。

### 用cordis.yml声明式组合

插件拥有稳定ID和参数，cordis.yml负责决定加载哪些插件、传入什么配置。相同代码可以组合成TUI、Web、Headless、ACP或JSON-RPC应用。配置覆盖采用整段替换而非深度合并，凭据建议通过DEEPSEEK\_API\_KEY或独立凭据文件注入，不应直接写进仓库。

从工程角度看，插件化的真正价值不是“扩展数量多”，而是把模型、工具、安全边界和交互界面拆开。这样升级模型或更换执行环境时，不必重写整个Agent。

## 四、Agent Loop如何运转：Turn、Step与完整事件流

一次任务由Turn和Step推进。模型输出的文本片段、消息、工具调用、工具结果以及结束原因都会进入事件流。工具调用还要经过前置策略、单调安全守卫、实际执行、后处理、内容清理和通知。可并行的只读工具可以同时运行，会改变状态的调用则成为屏障，避免并发写入把项目推向不可控状态。

运行中新增的用户指令可以排队到下一轮，也可以注入当前上下文或作为Steering立即改变执行方向。回执会记录模型究竟在哪一步看到了新指令，这对排查“为什么Agent没有按最新要求执行”非常重要。

## 五、Session Log不是聊天记录，而是权威事件源

Harness将Session Log设计为只追加的权威记录。环境信息、模型请求、内容分片、工具调用与结果、压缩、权限、取消等都会被保存，因此系统可以重建模型当时真正看见的上下文，而不是只留下整理过的对话文本。

日志支持JSONL和SQLite后端，可用于Resume和Fork；SQLite还提供全文检索。对于长时间运行的工程任务，这意味着失败后可以从边界恢复，也能从已完成节点分叉出另一条方案，而不必把全部背景重新塞给模型。

## 六、子智能体与工作流：把长任务拆开，但保留边界

![subagent子智能体能力族与调用方式](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-12.webp)

subagent子智能体能力族与调用方式

子智能体可以从新上下文启动，也可以从已完成边界分叉，或通过ACP连接外部进程。每个子智能体能够拥有独立的上下文、工具和系统提示词，避免所有任务共享一个不断膨胀的对话。目标、计划、Todo和后台任务也被区分处理。

![多个子智能体并行执行任务的过程记录](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-13.webp)

多个子智能体并行执行任务的过程记录

![workflow动态工作流能力族](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-14.webp)

workflow动态工作流能力族

Workflow用于定义更稳定的多步流程，适合把调研、编码、测试和交付串成可复用管线。子智能体擅长分工，工作流负责顺序与依赖；两者结合后，Agent不再只是边聊边写代码，而是接近可观测的任务系统。

## 七、四种预设与多种界面

![DeepSeek Harness Web工作台界面](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-15.webp)

DeepSeek Harness Web工作台界面

Web UI默认运行在127.0.0.1:3080，并提供Standard、PTC、Minimal和Creative四类预设。Standard覆盖常用编码工具；PTC通过Code Mode SDK和TypeScript run\_code编排多步工具；Minimal只保留持久Bash与编辑器；Creative允许检查Cordis运行时并动态挂载临时插件。

![不同Agent预设与工具组合](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-16.webp)

不同Agent预设与工具组合

![Agent配置与系统提示词编辑界面](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-17.webp)

Agent配置与系统提示词编辑界面

![长任务执行、文件修改与过程记录界面](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-18.webp)

长任务执行、文件修改与过程记录界面

终端用户可以使用TUI，CI或一次性任务可用Headless；需要与编辑器、自动化平台或Python程序整合时，则可以选择ACP、JSON-RPC或Python SDK。界面不是核心能力的唯一入口，而是同一运行时上的不同消费者。

![DeepSeek Harness终端TUI运行界面](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-19.webp)

DeepSeek Harness终端TUI运行界面

## 八、Cordis微内核：让插件在时间和空间上可组合

![Cordis入门文档与微内核工作模式](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-20.webp)

Cordis入门文档与微内核工作模式

Cordis强调服务、作用域、事件和生命周期的组合。插件可以在特定上下文中出现，也可以随着任务阶段挂载或卸载。这解释了Creative模式为何能让Agent检查运行时、生成临时插件并动态加载能力。

![Cordis时空可组合编程范式论文](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-21.webp)

Cordis时空可组合编程范式论文

对开发者而言，这种设计把传统“启动时固定全部依赖”的应用，变成可以随任务上下文变化的系统。代价也很明确：生命周期、插件依赖、事件顺序和兼容性更复杂，开发者预览阶段尤其需要严格锁版本与测试。

## 九、安全边界：能运行命令，就必须把权限当成产品能力

![DeepSeek Harness工作区权限与访问范围设置](https://admin.zuoshipin.com/wp-content/uploads/2026/08/deepseek-harness-22.webp)

DeepSeek Harness工作区权限与访问范围设置

默认workspace-write只允许在工作区和批准的临时目录写入，并在敏感操作前请求确认；danger-full-access则需要明确开启。文件系统、Bash和子进程共享同一沙箱边界，如果无法确认隔离有效，系统应当失败关闭，而不是悄悄退化为无保护执行。

Creative模式和danger-full-access适合高信任实验，不适合直接放在存有客户素材、项目母版和生产凭据的主工作站。建议在项目副本、容器或独立账号中运行，启用版本控制与备份，并把删除、覆盖、发布和费用调用设为人工审批。

## 十、对CG与后期团队意味着什么

对于CG、视效和视频后期团队，Harness最有价值的不是代替艺术家做审美决定，而是把脚本、素材检查、日志分析和重复操作纳入可审计流程。例如Agent可以检查工程目录和命名、分析转码或渲染失败日志、修改管线脚本、生成代理文件任务、整理镜头元数据，并把每次工具调用留在Session Log中。

-   把本地Shell插件替换为容器、渲染农场或受控任务队列，减少Agent直接触碰主工作站。
-   用LSP与文件系统插件维护Python、TypeScript或DCC管线代码，同时保留修改和测试记录。
-   让子智能体分别处理入库、代理文件、元数据、QC和交付检查，但把写入冲突与不可逆操作设为屏障。
-   用Session Log复盘Agent看见了什么、执行了什么，方便团队审核自动化流程，而不是只验收最终文件。

## 十一、快速启动与现阶段判断

官方给出的最短启动方式是先安装Node.js，然后运行`npx @deepseek-ai/dsh web`。启动后默认在本机3080端口打开Web UI。若从源码运行，则需要克隆仓库、安装pnpm依赖并完成构建。

DeepSeek Harness采用MIT许可，但目前仍会快速迭代并发生不兼容改动。更适合开发者试验架构、制作插件和验证工作流，暂时不宜在没有版本锁定、隔离、监控与回滚方案的情况下承担关键生产任务。

## 结语

DeepSeek Harness最值得关注的地方，不是它又做了一个“像Codex的界面”，而是把模型、工具、Agent Loop、会话日志、子智能体、安全策略和交互入口都变成可替换部件。对于希望把AI真正接进工程系统的团队，这种可组合、可审计的底层能力，往往比一次漂亮Demo更重要。

**Tags:** Agent会话日志, Cordis微内核, DeepSeek Harness, 多智能体工作流, 插件化Agent

**Categories:** AI资讯

---