xiaomoBoy/pi-bluebook

What it solves

Pi 学习蓝皮书是一本面向中文初学者的非官方学习手册，帮助完全没有经验的人从零开始掌握 Pi Coding Agent（一个极简终端 Coding Harness）。它解决的核心问题是：官方文档零散、术语多，初学者不知道从哪里入手，也不知道如何验证 Agent 是否真正完成了任务。这本书通过一套真实可操作的学习路线，让读者先完成小任务、独立检查结果，再逐步理解会话、上下文、扩展和长期工作流，而不是只背功能清单。

How it works

全书按“场景 → 概念 → 实操 → 验收”的结构组织，每课都要求读者亲自运行命令并核对输出，不把 Agent 自称“完成了”当作完成。主线以 macOS 为基础，同时为 Windows 用户提供独立的 Git Bash 中文安装路径。内容分为导论、序章、五个模块共 14 课，另有一篇原理串联和 8 个配套案例，覆盖安装、登录、第一次任务、会话与上下文管理、Skill 与 Extension、子 Agent 分工、长任务与安全验收。所有容易变化的版本、认证、模型和命令信息都会标注核验日期，并以 Pi 官方文档和源码为准。仓库本身是一个 VitePress 网站，可本地运行预览，不需要安装 Pi 或模型账号。

Who it’s for

主要面向中文初学者，尤其是第一次接触 Pi Coding Agent、不熟悉终端操作或对 Agent 工作流感到困惑的人。也适合已经能启动 Pi、但希望系统补全会话、上下文、扩展和稳定工作流的读者。即使不会写代码，也可以通过反馈问题或补充实践记录来参与完善这本书。

Highlights

• 真实学习路线：从安装、登录和第一个可验收任务开始，而不是从抽象功能清单开始
• 强调独立验收：每课按“场景 → 概念 → 实操 → 验收”展开，要求亲自核对结果
• 中文友好：同时提供 macOS 与 Windows Git Bash 路径，命令与操作说明分开放置
• 持续核验更新：版本、认证、模型和命令等易变信息标注核验日期，以官方文档和源码为准
• 完整路径：5 个模块 14 课、1 篇原理串联和 8 个配套案例，从入门到安全验收全覆盖
• 社区维护：欢迎指出卡住的位置、失效命令、缺材料或错误链接，贡献者不需要会写代码