小墨@xiaomovps 在他学了两个月 Pi 之后，把整段学习过程整理成了一本开源中文教材——《Pi 学习蓝皮书》，挺不错的，推荐给大家学习，

我想先把关于Pi最容易误会的一点说清楚：这里的 Pi 不是树莓派，也不是 Pi 币。

它是一款跑在电脑终端里的开源 AI 编程助手，有点像更瘦、更克制的 Claude Code / Codex。

作者是做 libGDX 游戏引擎的 Mario Zechner。

设计很极端：核心默认只会读文件、写文件、改文件、跑命令；子代理、计划模式、浏览器这些能力，一律不往内核里塞，要用就自己用插件（Extension）、技能（Skill）往上加。官网是 http://pi.dev。

小墨自己学 Pi 也才两个月，边学边发推，看的人越来越多，有人问：能不能把你整个学习过程汇总出来？他就没停在想法上，直接动手做成了这个教程，

适合给谁看：中文初学者。

怎么学：先做一件能亲手验收的小事，再一层层搭出自己的 Pi。

方法就四个字循环——场景 → 概念 → 实操 → 验收。每课都要留下一个你自己能检查的结果，不让 Agent 自己给自己打分。

里面大致有这些： •5 个模块、14 课：安装跑通 → 完成真实任务 → 管长任务和上下文 → 按需扩展 → 搭能恢复、能核对的工作流 •一组配套实操（比如把会议记录整理成行动清单、写第一个 Skill） •从他两个月约 98 条推文里蒸馏出的 10 条经验 •插件推荐（按需求、来源和风险选，不推「一键全家桶」） •10 篇拿到官方授权的中文译文 目录不是这条帖的重点。更值得拆的是：他怎么把一堆学习笔记做成一本书。

第一步不是先写大纲，他先把两个月所有相关推文收在一起。

那堆推文就是蓝皮书的起点——代表真实走过的路，不是事后编的完美教程。从里面抽出 10 条经得起后续实践的经验，再整理一批插件，并回头看整条学习思路。

然后推倒重来了两次，
第一版只是把推文和知识点打包成册，读起来像说明书、操作手册，不像一本书，于是整本重写。

界面也推倒过：一开始模仿 Pi 官网，后来发现那是产品页气质，和「蓝皮书」不搭，又改成「从哪开始、下一课是什么」的学习路线。

版权这块他没有图省事，收集资料时看到官方很好的文章，没有直接翻译就贴上去，而是写信联系 Earendil。

对方合伙人兼 CEO Colin 回信授权中文改编，要求保留原标题、作者、日期和原文链接，并按 CC BY 4.0 署名。帖子里第一张图就是这封授权邮件。

他最后想说的，其实不是「我写了一本很全的书」，而是这件事本身： 开源不一定马上有很多人看，但把学习过程整理出来，本身就是一次复习和成长。

有意义的事先做，结果以后再说，也希望别人学完一个东西之后，能沉淀出属于自己的蓝皮书。

如果你也想动手：已经会装 Pi 的人，网站上可以从第二模块直接进真实任务；

想看他怎么从笔记做成网站，点开原帖引用的那篇长文；

想自己也做一本类似的开源笔记，去 GitHub 看仓库就行。