三家开源 Coding-Agent Harness 深度对比：pi vs DeepSeek Harness vs Codex

开源 coding-agent 赛道在 2026 年分化成三条路线：极简内核、插件操作系统、产品全家桶。pi、DeepSeek Harness、OpenAI Codex，恰好是三条路线的代表。本文用四个维度拆开对比：设计哲学、架构扩展机制、运行形态、成熟度。

先说结论：想要最小约束、什么都自己组装，选 pi；想拥有一个可以深度改造成自己产品的 agent 操作系统，选 DeepSeek Harness；只想快点干活、不想折腾，选 Codex。

第一条线：pi 的极简主义

pi（earendil-works/pi-coding-agent，v0.84.3）定位一句话：能用扩展解决的事，内核坚决不做。它刻意不内置六样东西——不支持 MCP、没有子代理、没有权限弹窗、没有计划模式、没有内置待办、没有后台 bash。

这不是功能缺失，是立场：把选择权完全交给用户。代价是几乎每个能力都要自己动手装；回报是整个工具行为完全可预测，五十多家模型供应商即插即用，同时提供交互/脚本/JSON/RPC 四种运行模式，还能以 SDK 形态直接嵌进自己的应用——不止是终端工具，更像 agent 领域的标准库。

第二条线：DeepSeek Harness 的插件操作系统

DeepSeek Harness（dsh，deepseek-ai/deepseek-harness，MIT）8 月中开源，不到一个月接近 19.8 万 star，今年增长最快的 agent 项目。核心哲学写在标题里：一切皆插件。

底层是 Cordis 框架——插件向共享上下文贡献服务、类型化事件和可逆副作用。模型适配器、工具注册表、会话日志、甚至 agent 主循环本身都是插件，没有需要打补丁的特权内核。配置工程化程度高：profile 定义启动时叠加哪些 bundle，bundle 之上再用 yml 补丁逐行覆盖。

它有一条很强的架构不变量：所有进入模型的内容必须可以从会话日志重建，日志之外没有隐藏状态。扩展点表格列出 18 种能力接缝，每种都是「服务定义/提供者/消费者」三件套——换掉一个文件系统提供者，Bash、终端和 LSP 会跟着换到远程沙箱。目标管理甚至有官方接缝（ctx.goals），还带实验性的多代理团队协作。默认 Web UI，一条 npx 命令启动。注意：开发者预览期，官方明说会有破坏性变更。

第三条线：OpenAI Codex 的产品全家桶

Codex CLI（openai/codex）：Rust 编写、Apache-2.0、2025 年 4 月开源至今 11.9 万 star。形态最全：终端 CLI、编辑器集成、桌面应用、云端 agent 一应俱全。安装一个脚本搞定，登录直接用 ChatGPT 订阅，零配置成本。

扩展走平台化：config.toml + 生命周期钩子定制行为，Skills 封装技能，MCP 接外部工具，2026 年 3 月上线官方插件市场把 Skills 和 MCP 配置打包成一键安装的功能包。安全侧有独立沙箱模式和执行策略文件（execpolicy），企业可用管理层配置锁死边界——三家里唯一把合规做到配置层的。代价：深度绑定 OpenAI 账号与生态。

同一件事，三种做法

给 agent 加一个自定义工具：pi 要写一段 TypeScript 注册进扩展；dsh 是往插件树挂声明式包、改配置行就能替换既有实现；Codex 可能只需要装别人发布好的现成插件。

怎么选

在构建自己的 agent 产品、需要能被彻底改造的底座 → DeepSeek Harness（接受预览期风险）。场景是自己写扩展、深度控制每一步 → pi 的极简内核反而是最高效起点。只想要顺手靠谱的编程助手、愿意住在厂商生态里 → Codex 开箱即用。

本文音频版由本地 Qwen3-TTS 克隆音色生成；信源 1 pi v0.84.3 官方 README/docs 2 deepseek-harness README/architecture.md 3 openai/codex README/config.md 4 IT之家/CSDN 关于 Codex 插件的报道