$ cat ~/map/pi-bluebook.md

pi-bluebook (Pi 学习蓝皮书)

免费的非官方中文学习路线：带 Pi 初学者从安装一路学到 Skill、Extension 与长期工作流。

tutorials✓ 9月13日

事实速查

安装

npm ci && npm run docs:dev（克隆仓库后本地运行 VitePress 站点）

## 速览

面向 Pi 编码代理的非官方中文学习手册——五个模块、14 课、8 个配套案例，带初学者从安装一路学到会话、上下文、Skill、Extension 与长期工作流。

## 要点

$每课按「场景 → 概念 → 实操 → 验收」展开，以独立验收为完成标准——代理自述「完成了」不算完成。
$覆盖完整入门路线：安装与登录、第一个可验收任务、文件与会话、上下文与压缩、Skill / Extension / Package、子代理，以及 VPS 上的长期任务；主线基于 macOS，Windows 用户有独立的 Git Bash 安装路径。
$版本、认证、模型、命令等易变化信息都标注核验日期，以 pi.dev/docs/latest 官方文档与 GitHub 官方源码为准。
$序章沿完整时间线介绍 Pi 作者 Mario Zechner（libGDX、RoboVM、Pi 与 Earendil 的关联），另设经 Earendil 授权发布的十一篇译文专区，内容覆盖 Pi、Harness、会话机制、代码质量与公司愿景。
$可在 pi.xiaomovps.com 在线阅读；源码在 GitHub，并有从简体同步的繁体中文版。

## 常见问题

Q 这是官方教程吗？

不是——这是一本非官方学习手册；译文专区经 Earendil 授权，但手册本身由社区撰写，并以官方文档为准绳。

Q 阅读它需要先安装 Pi 吗？

不需要——网站本身是 VitePress 站点，npm ci 后 npm run docs:dev 即可本地预览，无需安装 Pi、持有模型账号或 API Key。

## 参考链接

## 相关条目

## 教程

最后更新: 2026年9月13日