Harness 到底是什么？

最近我对 Pi Agent 情有独钟

很多朋友问：Harness 到底是什么？

刚刷到 Pi 开发者团队的一篇博客《What is a Harness?》，写的非常清晰，分享给大家

Harness 这个词，剑桥词典给了两个义项

• 名词：一套由带子和皮带组成的装备，用来控制或固定人、动物、物体

• 动词：控制某样东西，通常是为了利用它的力量

作者说他对 Harness 的第一反应是中学时爬学校墙壁前套上的那套带子，还自嘲顶多算个平庸的攀岩者

为什么爬山要套安全带？原文拆了四层，与 Harness 的架构一一对应：

• 它托住你，保证你的安全

• 通过它连上锁扣和绳索，防坠落、控节奏、管路线

• 上面还能挂粉袋、岩塞钩、快挂

• 换山、换线路，安全带你带着走，按地形改装挂什么

有人把 Harness 简化成一道公式（DeepSeek团队也是这么定义的）：Agent = 模型 + Harness

Harness 是一套软件，为 AI 模型提供一个运行环境，和大多数 AI 模型不同，作为终端用户，你可以拥有自己的 Harness

不管什么界面（TUI/WebUI），Harness 干的都是这四件事：

组成

在 pi 上对应

系统提示词

--system-prompt

整套替掉， --append-system-prompt 往后追加（可多次）

工具

--tools

白名单、 --exclude-tools 黑名单、 --no-builtin-tools 只留扩展工具

框架 / Agentic Loop

装在 Harness 内部，命令行上看不到它，只能从 --thinking 、会话续跑这些开关侧面碰到

翻译层

--provider

/ --model ， --models 支持通配（ anthropic/* 、 *sonnet* ），Ctrl+P 在多个模型之间循环

一、系统提示词

大部分模型自带一套训练过程里定下来的规则，最出名的是 Claude Opus 4.5 的 soul document，它告诉模型自己是什么、该怎么行事

Harness 里的系统提示词跟它很像，只是没有与模型本身如此亲密，更像新员工入职第一天拿到的说明书，它没内化这些东西，但知道干这份活的时候得照着做

这份 soul document 我扒过全文，Anthropic 的思路是跳过简化条文，直接让模型彻底理解它的目标、处境和推理方式，理解到能自己推导出任何规则的程度

系统提示词会跟着每一次 prompt 一起注进对话，这也是为什么一动 Harness 的提示词，效果立竿见影

二、工具

工具是一组用代码写好的能力，模型可以「调用」它们，Harness 既描述工具，也提供工具本体，比如联网搜索、写代码并执行、写一封邮件

这里有一条最容易被忽略：Harness 通常不规定模型什么时候用、怎么用工具，它只把工具摆出来、描述清楚，剩下的判断交给模型自己

太多人往 Agent 里塞一堆 if-else，想把模型管死，最后管出来一个流程引擎，这活儿本来该模型自己干

三、Agentic Loop

举个例子，一个走邮件 Harness，手里三把工具（WebSearch、WriteCode、ComposeEmail），用户发来一封邮件，让它比较本地几所小学的排名和考试成绩，给出推荐

它是这么干活的：

1. 先理解需求，靠预训练搞明白「小学」是什么、「本地」指哪儿、用户在意哪种排名

2. 构造搜索词，抓最新数据

3. 拿到结果对着最初的需求自己复查—— 如果它认为第一轮没搜对、或者搜得不够，它会自己决定再搜一次

4. 数据够了，调 WriteCode 做一张表格（表格本来就是代码），顺手把计算和格式做掉

5. 拿表格再对一遍需求，不满意就回去继续搜

6. 觉得够了，调 ComposeEmail，结论写成正文，表格作为附件

7. 复查最终产出，判定活干完了，循环闭合

几秒钟后，用户邮箱里躺着一封带附件的邮件

这套流程我也画成了一张图，两个橙色虚线箭头才是重点：

Agentic Loop 流程：七步里的两个回头箭头

模型基于自己的评估、决定再调一次工具，这才是 loop

一条固定的 pipeline 也会连着调三次工具，但它不会因为「我觉得这数据不对」而回头

四、翻译层

翻译层让同一个 Harness 能接不同的模型，因为不同模型擅长的事情本来就不一样，同一个 agentic loop 里可以换模型

翻译层不是免费的午餐

同一套系统提示词、同一批工具，换到另一个模型上，表现能差出一截：工具调用的稳定性、长上下文的实际可用长度、指令跟随的严格程度，全都得重新试

换模型的动作只要改个配置，把效果调回来是另一回事，省下来的钱是真的，调优花掉的时间也是真的

让 Harness 变成你自己的

Pi 是这批 Harness 里最薄的那个：系统提示词短，工具少

用户拿到之后自己往上加东西：改系统提示词，写一个贴合自己工作流的扩展，然后互相分享， Pi 用户之间已经分享了超过 5000 个扩展

我去它的扩展目录翻了一圈，最能说明「薄 Harness + 厚扩展」这条路线的是 pi-web-access：

pi install npm:pi-web-access

一个包解决联网搜索、抓网页、克隆 GitHub 仓库、抽 PDF、理解 YouTube 视频和本地视频，后端能挂 OpenAI、Brave、Parallel、TinyFish、Tavily、Firecrawl、Jina 一大排搜索服务

5000 个扩展里，你真正需要的可能就是你自己创造的那三五个

我发现从扩张仓库找来的扩展使用频率远远没有我自己的写的那几个用的多，因为那些其实并不是强需求

总结

Harness 是给模型准备的一间工作室：一份入职说明（系统提示词）、一柜子工具、一套让它自己转起来的规矩（agentic loop），加一个随时能换模型的插座（翻译层）模型你只能租，Harness 才是你能拥有的那部分

能在自己电脑上拥有并运行自己的 Harness，就保住了自己的能动性，保住了把工具改成自己的自由，也保住了那些会话记录，这些记录长期积累下来，就是个人财富