开源课程 · 离线可复现 · 固定 Pi 基线 0.85.1

读懂编码智能体的
Harness 工程

智能来自模型，能力边界全部来自 harness。以 Pi 为蓝本，用可运行的 Python 实验和固定基线源码，讲清编码 Agent 的每一层机制——从最小闭环 agent = LLM + tool use，到记忆、上下文、会话、权限与协议。

开始学习 GitHub

12: 主题章节
12: 离线实验
4: 实战项目
131: 单元测试

Routes四条

按目的进入

按目的选入口，不必从第一页顺着读。

概念

按章节顺序读

从架构总览到实战评测，一条线理解 Pi 的核心设计。

实验

直接跑离线 Lab

python3 -m learn_pi_lab lab agent-loop，先跑起来再补机制。

源码

按 Pi 源码追踪

以源码映射为索引，逐个断言回溯到固定基线位置。

构建

从裸 API 写 Harness

examples/harness 十二步连续编码主线，B01–B06 已完成。

Part 015 章

阶段一 · 架构与核心机制

先建立整体心智模型：谁在循环里，谁在循环外。

架构总览

Pi 的分层、最小 Agent 闭环与 Planning/Memory 的承担者。

Agent Loop

循环如何驱动模型工作：Trace 与 Turn、终止条件。

工具系统

schema + executor、注册表分发、软约束与硬闸门。

消息与记忆

对话历史如何组织与传递，工具结果成对回填。

系统提示词

五段拼装、customPrompt 与默认路径、三级回退链。

Part 023 章

阶段二 · 状态与边界

状态存在哪一层？出错时边界画在哪里？

会话管理

JSONL v3、append-only 的会话树、认父不认子。

事件驱动与扩展

事件即契约：subscribe 与 pi.on 的分水岭。

上下文压缩

窗口即预算：压缩是让模型总结它自己。

Part 034 章

阶段三 · 集成与实践

把前面所有边界接起来，做成能跑、能测的东西。

Provider 与模型

元数据、协议、认证三者分离与 models.json。

可靠性

先分类再重试、指数退避必封顶、错误隔离。

协议与集成

stdout 是协议：JSONL 分帧、粘包与半包。

实战与评测

四个离线 mini-project 与同一条质量链。

Part 043 章

附录

回查用的参考资料。

术语表

Pi 基线、当前 Pi 行为、Python 教学模型等关键术语。

核心代码导览

九个核心机制的精选片段与逐段解读，对应 Pi 源码符号。

Pi 源码映射

固定基线 0.85.1 的源码入口与常见误解对照。

先跑起来，再补机制

全部实验只依赖 Python 标准库：不访问网络、不调用模型、不执行你提供的 shell 命令。

python3 -m learn_pi_lab lab agent-loop

读懂编码智能体的Harness 工程