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 个线缆协议实现如何覆盖 37 家 provider，compat 标志矩阵如何抹平 OpenAI 兼容生态，重试判定为什么是带 issue 编号的正则库，上下文溢出的三种检测路径，以及模型 catalog 为什么走构建期生成与手工 override。
分析 pi-tui 如何将组件输出约束为字符串行数组，比较相邻两帧以重绘变化区间，并处理滚动区、终端尺寸、内联图片和 IME 光标等差分渲染的正确性条件。
拆 pi 正在进行的客户端/服务端拆分：为什么先重构出 repository 接缝再沿接缝拆进程，CBOR 协议为什么传输中立且快照权威，attach 与会话租约如何建模多前端共享，以及双栈并存的过渡工程。
拆 pi 的会话与上下文层：为什么会话建模成 entry 树而不是消息数组，模型切换和 compaction 如何成为持久化的一等条目，树结构如何支持分支导航与分支摘要，compaction 的安全切割点、文件账本与缓存隔离怎么做。
拆 pi 的 agent 主循环：为什么 StreamFn 契约禁止抛异常、失败如何编码成 stopReason=error 的 assistant 消息进入会话历史、截断的 tool call 为什么整批拒绝执行、并行工具调度如何保证 transcript 确定性，以及工具输出截断的工程细节。
