Digital Garden - 数字花园
纸上得来终觉浅，绝知此事要躬行。
更新于 2026-08-07
解读 Google Open Knowledge Format（OKF）的目录、文档、溯源、信任、生命周期和可证明计算协议，并讨论其在 AI Native 系统中建设知识生产、检索、执行与治理闭环的实现方式。
重新通读了 Anthropic 工程博客全部 25 篇文章，按八个阶段完整梳理 Claude 从「Building Effective Agents」到「Managed Agents」的工程化演进路径，抽象出可复用的方法论，并结合我自己的 Harness Engineering 实践给出对照思考。
对比 Pi agent-core harness 与 Claude Code 如何保存会话记录、恢复运行时状态、构造模型上下文、压缩历史和处理工具输出，说明两套 Agent Runtime 在状态与资源管理上的实现差异。
Graph Engineering 将 Agent 的任务执行、验证、权限和长期评估显式组织为图。它解释了何时应从单个闭环升级到多节点编排，以及未来的重点为何会落在运行时治理上。
分析 pi-ai 的多 provider 适配层：约 10 个 API 协议实现覆盖 37 家 provider，compat 标志矩阵处理 OpenAI 兼容服务差异，带 issue 编号的正则规则判定重试，上下文溢出通过三条路径检测，模型 catalog 在构建期生成并支持手工 override。
分析 pi-tui 如何将组件输出约束为字符串行数组，比较相邻两帧以重绘变化区间，并处理滚动区、终端尺寸、内联图片和 IME 光标等差分渲染的正确性条件。
分析 pi 正在进行的客户端/服务端拆分：SessionRepository 如何定义会话存储职责，CBOR 协议如何支持多种传输，客户端如何以会话快照更新状态，以及 legacy 路径与新接口并存的过渡实现。
拆 pi 的会话与上下文层：为什么会话建模成 entry 树而不是消息数组，模型切换和 compaction 如何成为持久化的一等条目，树结构如何支持分支导航与分支摘要，compaction 的安全切割点、文件账本与缓存隔离怎么做。
拆 pi 的 agent 主循环：为什么 StreamFn 契约禁止抛异常、失败如何编码成 stopReason=error 的 assistant 消息进入会话历史、截断的 tool call 为什么整批拒绝执行、并行工具调度如何保证 transcript 确定性，以及工具输出截断的工程细节。
