Pi vs DeepSeek Harness：同一个词，两条相反的 Agent 路线

先看结论：这两东西不是竞品，是 Agent 工程化在「向上封装」和「向下拆解」两个方向的分水岭。

---

事情是这样的。

8 月 13 号深夜，DeepSeek 扔出了一个叫 deepseek-harness 的项目，CLI 叫 dsh。24 小时不到，7 万 star。到上周日我查的时候，已经 14 万了。

你看这个增速——不是”火”，是”炸”。GitHub trending 上那条线几乎是垂直的。

与此同时，另一个项目 pi，由 libGDX 作者 Mario Zechner 在一年前开始做，靠着 5600 多次提交和 9 万 star，一直是社区最稳的编码 Agent 之一。

两个项目都被叫做”harness”，都做模型外面的那层壳——工具调用、会话管理、Agent Loop、UI。都是 MIT、TypeScript，干的活看起来差不多。

但你要真把两个仓库的源码翻一遍，会发现它们走的是完全相反的路子。

我花了两天，把 pi 的源码（588915e）和 dsh（47f9438）都翻了一遍，又跑了几个实际场景，算是把这两兄弟的底裤看明白了。

---

先搞清楚，什么是”Harness”？

过去两年大家习惯说”模型 = 智能体的智商”。2026 年这个共识已经变了。

Model + Harness = Agent。

模型负责能不能想出来，Harness 负责能不能干成。它是一套包在大模型外面的完整控制与编排系统——工具调用、上下文管理、任务循环、文件操作、终端交互，全是 Harness 的活。

模型是大脑，Harness 是四肢和躯干。再聪明的模型，如果套在一个糟糕的 Harness 里，也会”四肢不协调”。

而 pi 和 dsh，正是当前这个赛道里两种最具代表性的产品哲学。

---

Pi：极简主义的”手术刀”

Pi 的核心判断其实很朴素：主流前沿模型已经很熟悉编码 Agent 的工作方式了，不需要你再用一整套产品规则把它喂饱。

它默认只给模型四件工具：读文件、写文件、改文件、执行命令。就这四样。系统提示词短到以百 token 计。什么计划模式、子 Agent、Git 检查点，统统不是默认项，通过扩展按需安装。

作者对功能叠加的态度很明确：功能越多，越像一艘没人能完全理解的太空飞船，用户真正用的可能只有 5%。

这种极简也体现在安全上。Pi 的文档说得很直白：它不内置权限系统和沙箱，进程以启动它的用户权限运行，真实隔离必须来自操作系统或容器。仓库为此专门写了容器化与沙箱模式文档，把”如何隔离”留给用户自己决定。

代价也很明显——门槛。没有开箱即用的全套体验，社区里最常见的评价就是”太简陋，什么都要自己动手”。对这个风格不适用的人，会觉得非常费劲。

但正是这种极简，让 Pi 和 DeepSeek 的缓存机制成了绝配。

Pi 的工具少、提示词稳定、会话内容持续向后追加，DeepSeek 只需处理末尾新增的信息，缓存命中率能到 99.93%。根据 Composio 团队的实测，Pi 接 DeepSeek V4 Flash 跑一次成功任务大约 0.028 美元，同样条件下 Claude Code 约 0.195 美元——差了 7 倍。

我知道有人会杠：Claude Code 贵不代表它差，它本就是围绕 Claude 模型深度优化的，套上 DeepSeek 后吃不到针对 Claude 生态的优化红利。这是事实。但从”DeepSeek 配哪个 Harness 最省钱”这个角度看，Pi 当下就是性价比之王。

---

DeepSeek Harness：一切皆插件的”乐高帝国”

DSH 的判断则完全相反。

它认为模型那一层同样不是重点，但选择把”壳”本身做成一个平台。

架构文档开头就写了：模型适配器、工具注册表、会话日志、甚至 Agent Loop 本身，全都是插件。没有需要打补丁的特权内核——内核本身也只是众多插件之一，任何一层都可以从配置替换。

底层框架是 Cordis，一个把”插件向共享上下文贡献服务、类型化事件、可逆副作用”作为核心范式的元框架，设计依据是一篇正经论文。

这不是一个轻量项目。dsh 仓库包含 50 多个包、约 8600 个文件，覆盖沙箱、权限审批、目标管理、计划、Skill、子 Agent、文件系统、终端、调度、工作流。运行中的 dsh 是一棵由 profile、bundle、patch 分层组装出来的插件树，Web UI 默认跑在本地 3080 端口。

而且它不锁死 DeepSeek 自家模型，官方文档明确支持 Anthropic、OpenAI 及任意 OpenAI 兼容端点。自家模型只做了缓存优化，不搞排他。

插件生态是这场发布最显眼的信号。截至我查的时候，GitHub 上打着 dsh-plugin 话题的仓库已有约 6000 个，从实用的多 Agent 团队、浏览器、长期记忆，到电子宠物、小游戏、皮肤这种整活插件，全在发布后的几天内涌出来。

代价也很明显：50 多个包、分层 patch 的配置模型，初学者的学习曲线相当陡峭。开发者预览版意味着接口随时可能变。整活插件多也说明：平台火起来了，但”好用”还在路上。

---

两条路线共享的判断：模型已不是竞争核心

把两个项目放在一起，最值得注意的是它们共同接受了同一个前提：模型是可替换的后端，决定体验差异的是 Harness。

Pi 的 pi-ai 统一对接 OpenAI、Anthropic、Google 等多家提供商，模型可以随时换。dsh 同样模型无关，官方文档明确支持多生态，只在自家模型上做了缓存优化。两家都不把宝押在”只用自家模型”上。

在 Harness 内部，它们的取舍方向相反：Pi 把”你能掌控多少”当价值，把扩展机制做成最薄的接口，剩下靠你自己；dsh 把”你能替换多少”当价值，把扩展点铺满整个运行时，让社区来填。

前者像一把手术刀，后者像一个插件市场。

---

同源对比：上下文压缩怎么解

长程 Agent 跑着跑着上下文就满了——满了对 Agent 是死局。

你说巧不巧，Pi 和 dsh 给出的解法高度同构：留近舍远 + 模型摘要 + 结构化 + 触发式，且都和”长期记忆”正交。压缩管会话内续命，memory 管跨会话持久化，边界划分得非常清楚。

差异只在于工程深度：

Pi 把压缩做成”可换模型的能力”——独立上下文摘要助手、可换便宜模型、纯文本简报可跨会话移植、显式承担 prompt cache 打穿代价。它更像一个”人能接管”的方案：压缩出来的东西你读得懂、拷得走，甚至能手动改。

dsh 把它做成”可换后端的插件”——每步精确测压（阈值 0.8）、溢出即强压、tool-result 规则裁剪、回放安全的 surface 替换。它更偏向”系统能扩展”：压缩逻辑藏在插件里，框架自己决定什么时候压、怎么压，你不需要关心细节。

一句话：Pi 偏「人能接管」，dsh 偏「系统能扩展」。

两种方案没有优劣，分工不同。

---

插件退出：谁清理谁埋单

给 Agent 加一个插件，通常不算难。

真正让人头疼的，往往是插件离开以后。

配置里明明已经删掉了，文件监听器还在跑；Provider 换成新的，某个工具却仍握着旧对象；新旧实现都没报错，只是偶尔各自出来工作一下。这种”幽灵状态”很有工程气质——平时安安静静，一到排查时就开始考验记忆力。

Pi 的处理方式很直接：宿主把门关上再打开，屋里有什么东西，由住在里面的人自己清点。扩展不多、会话重载成本可接受时，这种分工很省心。问题可以沿着生命周期事件和扩展代码一路查下去。Pi 不需要知道每条连接、每个缓存之间是什么关系，也少了一套运行时图需要解释。

dsh 借 Cordis 做了不同的选择。它记下资源属于谁、插件依赖谁、又有哪些插件正在依赖它。关系发生变化，系统便知道该停谁、该清理什么、以及何时重新启动。

Cordis 最终维护的是一张会随运行状态变化的能力关系图。插件创建资源时留下撤销动作，依赖其他插件时把关系说出来。变化以后，运行时可以据此安排退出和重启，不必把所有顺序都留给人工约定。

Pi 把退出边界交给扩展作者；dsh 借助 Cordis，把一部分跨插件关系交给运行时管理。

---

所以选谁？

这个问题其实没有标准答案，因为这两东西瞄准的根本就不是同一拨人。

如果你是普通开发者，只是想用 AI 写代码，优先选 Pi。

绝大多数人的真实诉求，就是本地写业务代码、重构项目、排 bug。这种场景，Pi 开箱即用、轻量省钱的优势被放大。dsh 强大的插件能力对你是额外负担，你要花大量时间去挑选、调试插件，收益感知不强。

如果你要做 Agent 二次开发、自研工作流、多 Agent 编排，dsh 才是正确选择。

如果你想研究 Agent 底层、自定义工作流、做评测、想把 Agent 嵌入自己系统、希望热插拔组件、完整事件追踪，那 Pi 的架构会处处受限。dsh 就是为这类”造轮子的人”准备的底座。

但不要被”理念先进”绑架。

dsh 现在还处在开发者预览阶段，README 白纸黑字写着”THERE WILL BE COMPATIBILITY-BREAKING CHANGES”。插件生态、文档、稳定性还在建设。理念很漂亮，如果直接拿来做业务，会踩版本变动、插件不足、坑多的现实问题。

其实两者完全可以组合使用。

日常本地编码干活，继续用 Pi，享受它开箱即用、低开销的体验；在 dsh 里面，把 Pi 包装成子 Agent 插件，用来做任务编排、多 Agent 实验。一个用来干活，一个用来研究和编排，扬长避短。

---

写在最后

2026 年，Agent 行业的范式已经从”卷模型”转向了卷”Harness”。

Pi 和 dsh 一起宣告了一件事：模型已经不是竞争核心了，决定体验差异的是 Harness。当两个影响力最大的开源 harness 一个把少做到极致、一个把替换做到极致时，模型本身反而成了最不需要争论的部分。

Pi 帮我把复杂的事情变简单，dsh 帮我把复杂的事情变得可组合。它们不是在同一个赛道上赛跑——它们是在定义 Agent 基础设施的两种基准形态。

我自己的选择很简单：两个都装了。写代码用 Pi，研究底层架构用 dsh。工具从来不是单选题。

---