z.
zhiqiang
.
阅读
工具
作品
开始对话
↗
阅读空间
搜索笔记的标题、摘要和标签
书架
按主题阅读
按主题阅读
架构与阅读
模型与通信
运行与上下文
配置与扩展
工具与执行
应用与接入
设计与边界
书架
1 本
设计艺术
pi
张汉东 著
阅读笔记
读书笔记 · 33 章
pi 的设计艺术
从核心循环到工具执行,理解一个 Coding Agent 的架构与取舍。
原著:张汉东
开始阅读
目录
本站整理的阅读笔记,每篇保留来源与版本说明。
阅读原书
pi 的设计艺术
目录
全书导览
前言与版本基线
附录与类型索引
架构与阅读
01—03
01
不是又一个 LLM 包装器
02
包不是项目
03
怎样高效阅读这个仓库
模型与通信
04—07
04
Provider 不是 Adapter
05
消息变换 — 跨模型交接的隐藏复杂度
06
统一事件流设计
07
认证是一等子系统
运行与上下文
08—12
08
agentLoop — 发动机只管转
09
工具执行不是插件调用
10
Agent — 循环之上的有状态壳
11
会话树 — 比“聊天记录”更好的数据模型
12
Compaction — 把无限对话装进有限窗口
配置与扩展
13—18
13
三级配置覆盖
14
System Prompt 是一套装配流程
15
Extension 系统 — 让产品长出新器官
16
Skill 机制 — 用文档替代代码
17
Resource Loader — 一切外部资源的统一入口
18
Model Registry — 模型不只是一个 ID
工具与执行
19—23
19
工具设计原则 — 约束即保护
20
edit 的设计 — 为什么不能直接写文件
21
read 的设计 — 为什么不是简单的 cat
22
bash 与外部世界的边界
23
find 和 grep — 结构化搜索替代万能 bash
应用与接入
24—30
24
pi-tui — 在终端里做应用
25
编辑器组件 — 交互复杂度的集中地
26
RPC 模式 — pi 作为后端服务
27
SDK — 把 pi 当库用
28
pi-web-ui — 浏览器里的复用
29
mom — Slack 里的 Coding Agent
30
pods — 为什么这个仓库还要管 GPU
设计与边界
31—33
31
极简核心,能力外置
32
反主流选择背后的判断
33
这套架构的适用边界