从一句对话开始，
造出完整桌面 Agent。

包、入口、阅读顺序与调用链索引。

Model、Message、Tool、Agent、Session、Skill 与 Extension。

Agent、Turn、Message、Tool 与 Session 生命周期。

目录、Frontmatter、发现、触发、测试与分发。

注册、事件、工具、Provider、生命周期与错误语义。

JSONL、Header、Entry、Branch、Compaction 与 Custom Entry。

Provider、认证、模型、项目、用户与资源配置。

模型、工具、会话、Skills、Extensions、SDK 与 RPC。

全书关键概念的简明定义与关联。

从一次最小模型调用认识 pi-ai、Provider、Model 与 Context。

理解 AssistantMessageEventStream 与流式事件。

把模型内部状态转换为桌面应用可以展示的数据。

理解 Provider、模型目录、认证和跨 Provider 兼容。

从一个文件查询工具认识 ToolCall 与 ToolResult。

理解模型判断、工具执行与结果反馈形成的循环。

把 Agent 事件映射成清晰的界面状态。

处理并发执行、中止、错误和停止条件。

建立工具权限、审批、信任与沙箱边界。

区分 Agent Message、LLM Message、UI Message 与 Context。

理解 Session、Entry、Repository 与持久化。

认识 Fork、Branch 与从历史节点重新尝试。

理解上下文溢出、切点、摘要与压缩记录。

使用 Steering、Follow-up 和队列控制正在运行的 Agent。

理解动态 Prompt、项目上下文和资源合并。

区分 Skill、Tool、System Prompt 与 Extension。

实现一个可运行的错误日志分析 Skill。

走读目录扫描、Frontmatter 解析与资源冲突诊断。

理解显式调用、自动匹配与渐进式加载。

构建可触发、可执行、可验证并且安全的 Skill。

覆盖测试、包分发、冲突处理和安全治理。

从工具审批需求理解事件驱动扩展。

走读发现、模块加载、Factory 注册和 Runtime 绑定。

理解注册阶段、运行阶段与 AgentSession Bindings。

追踪一次请求经过的观察、修改和阻止事件。

理解 Tool Definition、Wrapper、审批与审计。

为 Prompt、输入、模型、压缩和会话选择扩展点。

扩展模型、认证、Skills、资源、沙箱和外部服务。

处理错误、取消、冲突、重载、并发和版本兼容。

比较 pi-ai、agent-core、Harness、SDK 与 RPC。

使用 AgentSession、Services 和 Runtime 组织应用。

设计桌面进程与 Pi 子进程之间的事件协议。

把对话、流、工具、权限和会话事件映射成 UI 状态。

把对话、工具、记忆、Skills 和 Extensions 接到一起。

从用户输入一直追踪到模型回复、工具执行和会话保存。

完成安全、恢复、评估、诊断、打包和升级检查。