AI惊叹号 | DeepSeek Harness 与 OpenAI Codex Harness 架构对比

00引言

为什么需要了解这两套智能体框架？

很多人以为，一个强大的 AI Agent = 好模型 + 好 Prompt。但事实并非如此。一个真正能在业务中跑起来的智能体，需要一套完整的底层执行系统——它负责理解任务、维持记忆、调用工具、处理失败、请求人类审批、返回结果。这个"执行系统"就是 Harness。

当前业界最受关注的两套 Agent Harness 框架，一个是 DeepSeek 开源的 DeepSeek Harness，另一个是 OpenAI 开源的 Codex Harness。它们的设计理念和架构风格截然不同，本文从技术架构角度帮你理清两者差异。

01什么是 Harness

智能体框架的核心职责

Harness（智能体框架）是让 AI 模型在真实环境中持续工作的底层系统。用公式表达：Agent = Model + Harness。模型是智能体的"灵魂"，Harness 则让智能体能够：

感知环境：理解任务上下文，读取文件、数据库、API 等外部信息
使用工具：调用 shell、代码执行、搜索、文件编辑等工具完成操作
维持记忆：在长对话中保持上下文，记录历史操作
错误处理：崩溃后恢复，失败后重试，遇到关键决策暂停等待人类审批
可追溯：记录每一步操作，支持回放、搜索和分支

好的 Harness 设计甚至能让模型脱胎换骨——OpenAI 的数据显示，仅调整两项 Harness 参数，GPT-5.6 Sol 在 ARC-AGI-3 基准上的得分从 13.3% 飙升至 38.3%，同时 Token 消耗减少 6 倍。

02DeepSeek Harness

全插件化架构，基于 Cordis 内核

DeepSeek

DeepSeek Harness (DSH)

DeepSeek Harness 目前处于 Developer Preview 阶段，已完全开源。核心理念：Everything is a plugin（一切皆插件）。

内核Cordis 内核（插件挂载/卸载/依赖管理）

开源协议源码完全开放

快速启动npx @deepseek-ai/dsh web

GitHubgithub.com/deepseek-ai/deepseek-harness

核心架构特征

Cordis 插件内核：所有能力（模型、工具、技能、会话、沙箱、存储、循环、调度、UI）都是可插拔的插件。Cordis 负责插件的挂载、卸载和依赖管理，插件之间通过服务和事件协作
配置驱动组合：开发者可以在配置文件中选择、替换或扩展任何能力，无需修改 DSH 源码
全链路可追溯：模型看到的一切（系统提示、推理、工具调用及结果、子代理调度、上下文注入）都记录在只追加的会话日志中。Trajectory 视图可按来源检视，支持恢复、分叉、搜索和回放
四种运行模式：Standard（完整工具集）、Code（模型生成代码编排多步工具调用）、Minimal（仅 shell + 文件编辑器，用于基准测试）、Creator（运行时检视、插件实验、预设编排）

设计哲学

DeepSeek Harness 的核心理念是"一切皆插件，每次运行可追溯"——通过 Cordis 插件系统实现能力的自由组合，通过会话日志实现全链路可观测，让开发者用配置而非代码来定制智能体。

03OpenAI Codex Harness

三组件架构，将智能体嵌入任何产品

OpenAI

Codex Harness

OpenAI 于 2026 年 8 月正式开源 Codex 底层核心框架，采用 Apache-2.0 许可，允许任何人修改和商用。核心理念：前端业务归你，底层 Agent 循环归 OpenAI。

开源协议Apache-2.0（可商用）

通信协议JSON-RPC 客户端协议

SDK 语言TypeScript / Python

GitHubgithub.com/openai/codex

三大开源组件

codex exec（CLI 工具）：运行自动化流水线，适合 CI 任务和后台一次性任务。提供有边界的 Agent 工作流，返回结构化输出
Codex SDK（编程接口）：TypeScript/Python SDK，用代码启动、恢复或流式传输 Codex 任务，精确控制线程与任务的生命周期
app-server（嵌入引擎）：通过 JSON-RPC 协议让你的应用连接到本地 Codex 进程。支持持久对话状态、流式事件传输、中途打断、暴露应用工具给 AI、以及 Human-in-the-loop 审批

设计哲学

OpenAI Codex Harness 的核心理念是"反套壳革命"——不再强迫用户适应聊天框，而是把智能体循环无缝嵌入你自己的产品。界面、数据、权限审批都是你的，AI 只负责在底层执行。将前端审批界面与底层执行循环分离，让 Agent 嵌入业务仪表盘变得前所未有的简单。

04架构对比

两套框架的关键技术差异

对比维度	DeepSeek Harness	OpenAI Codex Harness
核心架构	Cordis 插件内核，一切皆插件	三组件分离：CLI + SDK + app-server
扩展方式	配置驱动，选/换/扩插件	SDK 编程接口 + JSON-RPC 协议
能力组合	插件挂载/卸载，服务+事件协作	三大组件按场景独立使用
运行模式	Standard/Code/Minimal/Creator	CLI 自动化 / SDK 编程式 / app-server 嵌入式
可追溯性	只追加会话日志，Trajectory 视图	流式事件传输，持久对话状态
人机协作	子代理调度，配置驱动	Human-in-the-loop 审批机制
工具集成	插件提供工具能力	MCP 工具集成，应用暴露自有工具
开源许可	源码开放（Developer Preview）	Apache-2.0（可商用）
技术栈	TypeScript / Node.js	TypeScript / Python + JSON-RPC

简单来说：DeepSeek Harness 是"插件架构型"，追求用配置组合一切能力，强调全链路可追溯；OpenAI Codex Harness 是"组件分离型"，追求把 Agent 循环嵌入任何产品，强调前端与执行的解耦。

05应用场景

什么情况下该用哪个？

🔧

DeepSeek Harness 适用场景

高度定制智能体：需要自由组合模型、工具、会话、沙箱等能力，用配置而非代码定制
插件生态开发：想为社区贡献或使用 dsh-plugin 生态中的插件
基准测试与研究：Minimal 模式仅保留 shell + 编辑器，适合在最小环境中测试模型能力
运行时实验：Creator 模式支持运行时检视、内存中测试插件、组合新运行模式
全链路审计：需要 Trajectory 视图追溯每一步推理和工具调用

🚀

OpenAI Codex Harness 适用场景

嵌入自有产品：把智能体循环嵌入你的仪表盘、编辑器、业务系统，告别"套壳"聊天框
CI/CD 自动化：用 codex exec CLI 运行自动化流水线和后台任务
编程式控制：用 SDK 精确控制任务生命周期，适合需要深度集成的应用
企业级安全场景：需要 Human-in-the-loop 审批，危险操作必须人工放行
MCP 工具集成：将公司内部 API、机密文档通过 MCP 服务开放给 Agent

选择建议

如果你需要高度可组合的插件化架构，追求运行时灵活实验和全链路追溯 → 选 DeepSeek Harness；如果你需要把Agent 嵌入自有产品，强调界面控制权和企业级安全审批 → 选 OpenAI Codex Harness。两者也可以互补：用 OpenCodex 的 app-server 做产品嵌入，用 DeepSeek 的插件系统做能力扩展。

06总结

核心要点回顾

DeepSeek Harness 和 OpenAI Codex Harness 都是让 AI 智能体在真实环境中持续工作的底层框架，但架构路线截然不同：

DeepSeek Harness = 插件架构型，基于 Cordis 内核，一切皆插件，配置驱动组合，全链路可追溯，适合需要高度定制和实验的场景
OpenAI Codex Harness = 组件分离型，CLI + SDK + app-server 三大组件，JSON-RPC 通信，Human-in-the-loop 审批，适合将 Agent 嵌入自有产品和企业级场景

理解它们的架构差异，能帮助你在合适的场景选择合适的框架。对于大多数开发者：需要嵌入产品选 OpenAI，需要插件化定制选 DeepSeek，是一个简单的决策原则。