# Pi Agent vs DeepSeek Harness：两种 Agent Harness 架构深度对比，附选型速查表

- 原文：[https://news.qiniu.com/archives/1787109667224](https://news.qiniu.com/archives/1787109667224)
- 发布时间：2026-08-19
- 分类：选型与价格
- 标签：Agent Harness、DeepSeek Harness

Agent Harness（智能体运行时框架）是一类介于"裸 API 调用"与"完整编程 Agent 产品"之间的基础设施层，负责处理工具注册、模型对话循环、会话管理和上下文控制，让开发者专注于业务逻辑而非底层编排。2026 年这一赛道出现了两个截然不同的里程碑：Pi Agent（earendil-works/pi，93,248 ⭐）以"4 个工具 + 极简系统提示 + 自我修改"的极简主义路线，成为 OpenClaw 等下游产品的底层 SDK；DeepSeek Harness（deepseek-ai/deepseek-harness，161,578 ⭐）于 2026 年 8 月 13 日发布开发者预览版，以"Everything is a Plugin"（万物皆插件）为核心设计哲学，48 小时内突破 95,000 星，创下开发者工具类项目 GitHub 增速纪录之一。两者都面向开发者开源，都支持多模型接入，但架构哲学与适用场景存在根本差异——本文从架构原理、扩展机制、场景适配三个维度进行深度对比，帮助 Agent 开发者在选型时做出有依据的判断。

![](https://news-static.qiniu.com/legacy/images/73/73ca89d2a99d6e0006943efa7442194a6e676fb07e908c578b96989b8a657134.jpg)

* * *

## 什么是 Agent Harness？

Agent Harness 是 AI 编程 Agent 的"骨架层"，具体负责：

- **模型循环**：维护 system prompt、对话历史、token 预算，驱动 LLM 持续推理
- **工具注册与调用**：声明工具的签名与执行函数，将 LLM 输出的工具调用转为实际操作
- **会话管理**：持久化对话状态、支持中断恢复、隔离多任务上下文
- **可观测性**：记录每一次推理步骤、工具调用结果和上下文注入

与完整 Agent 产品（Cursor、Claude Code、Devin）不同，Harness 不包含 UI、不预置工作流，给开发者最大自由度来定义"这个 Agent 应该做什么"。与 LangChain 等编排框架相比，Harness 更贴近运行时而非流程描述语言。

* * *

## Pi Agent vs DeepSeek Harness：核心对比

| 维度 | Pi Agent | DeepSeek Harness |
|---|---|---|
| **发布时间** | 2025 年 8 月 | 2026 年 8 月 13 日 |
| **GitHub ⭐** | 93,248 | 161,578（6 天） |
| **开源协议** | MIT | MIT |
| **核心哲学** | 极简 4 工具 + 自我修改 | 万物皆插件 |
| **底层框架** | 自研 TypeScript | Cordis 元框架 |
| **模型支持** | 15+ Provider | 任意模型（插件化） |
| **扩展机制** | Agent 自己写扩展 | 配置文件热插拔 |
| **运行模式** | Interactive / Print / RPC / SDK | Standard / Code / Minimal / Creator |
| **会话结构** | 树形（支持分支回溯） | 追加式事件日志 |
| **知名下游** | OpenClaw | — |
| **成熟度** | 稳定可用 | 开发者预览（有 breaking changes） |
| **本地离线** | ✅ | ✅（配合 Ollama） |

* * *

## Pi Agent：软件如黏土的极简哲学

Pi 由 Mario Zechner（Earendil Inc.）开发，核心设计信念是：**LLM 本身就擅长生成和执行代码，那就将这个能力发挥到极致，而不是在外部搭建复杂的编排层**。

### 最小可行 Harness

Pi 的整个核心只有四个工具：`Read`、`Write`、`Edit`、`Bash`。系统提示刻意保持极短。没有 MCP 集成，没有社区技能市场，没有内置子代理——这些都被视为"可以自己扩展的功能"，而非 Harness 应该预置的内容。

这不是功能缺失，而是设计决策：核心越小，用户对 Agent 行为的理解和控制越完整。

### 自我修改（Self-Extension）

Pi 最受关注的特性是让 Agent 自己扩展自己：

> "你不需要去下载扩展或技能包——你直接让 Agent 来扩展它自己。" — Mario Zechner，Pi 设计文档

具体机制是，开发者描述需要的能力（如"给我加一个 Git 工具"），Pi 会生成 TypeScript 扩展模块并热加载，整个过程包含自测试和文档生成。扩展可以持久化到磁盘，形成一个随项目演进的个人工具库。

Pi 将此描述为"软件如黏土"（malleable like clay）——工具形态可以随用户需求动态塑造，而非从固定功能池中选择。

### 会话树与上下文隔离

Pi 的 Session 是树形结构，支持分支和回溯。当需要执行一个"可能损坏状态"的操作时（如调试破损工具），可以在支线 Session 中完成，将摘要合并回主线，而不污染主上下文。这一设计对于复杂多任务 Agent 工程特别实用。

### 四种运行模式

- **Interactive**：完整 TUI 交互，日常编码辅助
- **Print / JSON**：脚本模式（`pi -p "query"`），便于 CI 集成
- **RPC**：stdin/stdout JSON 协议，适合非 Node 环境调用
- **SDK**：嵌入上层产品，OpenClaw 即通过此模式将 Pi 作为 Harness 层使用

* * *

## DeepSeek Harness：万物皆插件的可组合运行时

DeepSeek Harness 于 2026 年 8 月 13 日 11:56 UTC 发布，MIT 开源，当日获得约 27,500 颗星，48 小时后突破 95,000，截至本文发布已达 161,578 颗星，Fork 数 16,984。

### "Everything is a Plugin" 的架构含义

DeepSeek Harness 基于 **Cordis 元框架**（cordiverse/cordis），后者实现了两个关键属性：

- **时间可组合性**：插件卸载时，其产生的所有副作用（事件监听、服务注册、状态修改）会被完整回滚，系统可干净地恢复到插件加载前的状态。
- **空间可组合性**：插件以声明式方式管理彼此的依赖关系，运行时自动处理装载顺序。

在此基础上，Harness 将以下每一个组件都抽象为可替换插件：

| 组件 | 默认实现 | 可替换为 |
|---|---|---|
| 模型适配器 | DeepSeek 官方 | Anthropic / OpenAI / Ollama 本地模型 |
| 工具集 | 文件系统 + Shell | 任意自定义工具插件 |
| 沙箱 | 本地进程 | Docker / E2B / 远程沙箱 |
| 会话日志 | 本地追加式 | 云存储 / 数据库 |
| Agent 循环 | 标准 ReAct | 自定义推理策略 |
| UI 层 | Web（端口 3080） | 自定义 |

快速启动命令：`npx @deepseek-ai/dsh web`

### 完全可审计的 Session Log

Harness 的 Session Log 是"追加只写"的事件流，每次 system prompt 修改、工具调用、推理步骤、上下文注入都被完整记录。"model-visible means logged"——LLM 能看到的所有信息都有日志，确保 Agent 行为可复现、可调试。

Trajectory View 功能让开发者可以回放任意一次 Agent 执行的完整决策路径。

### 当前限制

DeepSeek Harness 处于开发者预览阶段，官方明确警告存在 breaking changes。以下功能尚不完整：

- 托管后台 Agent（需要常驻服务器运行的长任务）
- GitHub PR 工作流深度集成
- 生产级稳定性保证

* * *

![](https://news-static.qiniu.com/legacy/images/33/33a640c3d9ed63601a925127ea779291e04b4739b72e8d081fc2d69d8ea52b97.jpg)

## 如何选型？

### 选 Pi Agent，如果你需要：

- 在产品中嵌入 Agent 能力（SDK/RPC 模式），OpenClaw 是典型参考
- 对 Agent 上下文有精细控制需求，不能接受黑盒行为
- 让 Agent 自己管理和扩展工具集，适应长期演进的项目
- 统一接入 15+ 模型提供商而不锁定单一厂商

### 选 DeepSeek Harness，如果你需要：

- 构建可以随时替换任意组件的 Agent 基础设施，包括沙箱和模型
- 完全可审计的 Agent 执行日志，用于调试复杂多步任务
- 本地或私有部署（air-gapped 环境），对接 Ollama 本地模型
- 关注架构前沿，愿意接受开发者预览阶段的不稳定性

### 不建议现阶段选 DeepSeek Harness，如果你：

- 需要生产级稳定性，不能接受 breaking changes
- 依赖托管后台 Agent 或成熟的 GitHub 工作流集成
- 团队缺乏维护早期开源项目所需的工程资源

* * *

## 开发者资源

两款工具都采用模型无关架构，需要开发者自行配置 API 接入。对于需要同时测试多家模型表现的团队，按用量计费的多模型 API 接入方案可以显著降低切换成本——七牛云 Token Plan（qiniu.com/ai/plan）提供统一 API Key 接入国内可直接访问的多款主流大模型，适合在 Pi 或 DeepSeek Harness 中频繁切换模型进行对比评测的场景。

七牛云也整理了 [**AI 编程工具的配置集成指南**](https://developer.qiniu.com/aitokenapi/13417/tools-AI-Coding-api)，覆盖主流 IDE 和 Agent 工具接入方式，适合快速上手。

* * *

![](https://news-static.qiniu.com/legacy/images/33/335ad17d454351c28afc80148079ad4f4309e8a9810f4c36e1ab59927887a5e5.jpg)

## FAQ

**Q：Pi Agent 和 Claude Code 有什么本质区别？** Claude Code 是面向个人开发者的完整产品，内置工具、界面和工作流，开箱即用但上下文行为部分不透明。Pi Agent 是 Harness 层，没有预置 UI 和工作流，给开发者完整的控制权——你可以把 Pi 理解为"构建自己 Agent 产品的基础砖块"，OpenClaw 就是这样用它的。

**Q：DeepSeek Harness 的 161K GitHub Stars 是什么水平？** 根据 flowtivity.ai 的分析，DeepSeek Harness 在发布 6 天内达到 161,578 颗星，被描述为"GitHub 开发者工具史上增速最快之一"。作为对比，Pi Agent 从 2025 年 8 月建仓至今约一年积累了 93,248 颗星。需要注意的是，高星数反映关注度而非成熟度，DeepSeek Harness 仍处于开发者预览阶段。

**Q：Pi Agent 的"自我修改"能力安全吗？** Pi 的扩展在沙箱外运行，理论上可以访问文件系统和网络——这与其"4 个工具完全可控"的哲学一致，但也意味着安全边界由开发者自己划定。Pi 官方建议在理解每一个扩展行为后再投入生产使用，尤其是涉及 Bash 工具的操作。

**Q：两者能配合使用吗？** 理论上可以。Pi 的 RPC 模式可以作为 DeepSeek Harness 的子代理被调用——DeepSeek Harness 的插件架构支持将任意外部工具注册为插件。但目前两者的互操作性没有官方文档，需要开发者自行实现适配层。

**Q：Agent Harness 和 MCP（Model Context Protocol）的关系是什么？** MCP 是工具调用的标准化协议，解决"如何描述工具、如何传递结果"的问题。Agent Harness 是完整的运行时框架，解决"如何驱动 LLM 持续工作、如何管理会话和上下文"的问题。二者并不互斥，但 Pi 的极简哲学刻意不内置 MCP，而是将 MCP 支持留作可选扩展。

* * *

## 结语

Pi Agent 与 DeepSeek Harness 代表了 2026 年 Agent Harness 领域的两种演化方向：一个以极简为美、让 Agent 自己管理自己的工具集；另一个以可组合为纲、让每一个组件都能被替换和审计。前者已在 OpenClaw 等产品中得到真实验证，后者以惊人速度吸引了全球开发者关注，但生产级考验仍需时间。对于今天在选型的开发者，最务实的建议是：用 Pi 作为嵌入式 Harness 层构建产品，同时关注 DeepSeek Harness 的演进——它所代表的"完全可组合 Agent 运行时"方向，很可能是下一代严肃 Agent 基础设施的样子。

本文数据来源：GitHub API 实时数据（2026-08-19）；pi.dev 官网、explainx.ai Pi 解析（2026 年 1 月）；deepseek.com/harness、flowtivity.ai DeepSeek Harness 报告（2026 年 8 月 15 日）；lucumr.pocoo.org Mario Zechner 技术博客（2026 年 1 月）；newsletter.pragmaticengineer.com Pi 深度报道。

* * *

## 延伸阅读

- Pi Agent 官网：[https://pi.dev](https://pi.dev)
- Pi GitHub：[https://github.com/earendil-works/pi](https://github.com/earendil-works/pi)
- DeepSeek Harness 官网：[https://deepseek.com/harness/en](https://deepseek.com/harness/en)
- DeepSeek Harness GitHub：[https://github.com/deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)
- Mario Zechner 技术博客（Pi 设计哲学）：[https://lucumr.pocoo.org/2026/1/31/pi/](https://lucumr.pocoo.org/2026/1/31/pi/)
- [**七牛云 AI 编程工具配置指南**](https://developer.qiniu.com/aitokenapi/13417/tools-AI-Coding-api)
- 七牛云 Token Plan：[https://www.qiniu.com/ai/plan](https://www.qiniu.com/ai/plan)
