主题
AI 时代的编程指南 · 总纲
一套写给我们自己的书：从看懂地图，到造出真东西。
规划：Charles Tao × Claude · v1.2 · 2026 年 7 月
这套书是什么
一套共五册的阶梯：难度从 ★ 到 ★★★★★，从"看懂 AI 在做什么"一路走到"用 AI 的方式做工程"。读者就是我们自己——两个用 AI 造真东西、但没受过正规程序员训练的人。所以全套书遵守四条铁律：
- 读得懂优先。每个概念先回答"它解决什么问题"，再谈定义。
- 一切例子来自我们自己。技术栈以 EchoForge 为准（Cloudflare + Vercel + Supabase + DO），工作方式以我们的真实习惯为准（VS Code 里的 Claude 插件 + Claude Code 网页版，终端只是要看得懂的配角）。
- 每晚一章，每章十分钟以内，结尾必有"关键领悟"和一个能立刻在自己项目里做的"试一试"。
- 重叠是故意的。各册之间约有一成内容重复出现——间隔重复是把知识钉牢的最好办法，遇到"这个讲过了"请当作复习，不是啰嗦。
术语表统一放在第一册附录 A，它是活的；之后每册只在末尾附"本册新词"，看完自己并进总表。
五册阶梯
| 册 | 书名 | 难度 | 一句话 | 状态 |
|---|---|---|---|---|
| 01 | 看懂地图 | ★ | 软件世界的构造、工具与心法总览 | ✅ v1.1 已完成 |
| 02 | 上手工具 | ★★ | VS Code、Claude 双形态、命令行、Git 与 GitHub 全流程实操 | ✅ v1.0 已完成 |
| 03 | 读懂语言 | ★★★ | HTML / CSS / JS / TS / MDX 等语言各自的脾气，目标是读懂 AI 写的每一个文件 | ✅ v1.0 已完成 |
| 04 | 深入系统 | ★★★★ | Cloudflare、DO 服务器、数据库进阶、API 设计——四大件从"会用"到"懂它" | ✅ v1.0 本次交付 |
| 05 | AI 工程心法 | ★★★★★ | 规格驱动、给 AI 立法、测试与 CI/CD、不可逆系统工程学 | 🗺 大纲如下 |
第一册《看懂地图》★（已完成）
三部分十六章：地图（请求与响应、前后端、数据库、API、服务器与 Serverless、DNS）、工具（终端、Git、环境变量、依赖、部署）、心法（导演角色、提需求、验证调试、安全五底线、学习飞轮）。附录：术语表、解剖我们自己的项目、红线卡。
第二册《上手工具》★★（已完成）
从"知道是什么"到"亲手做一遍"。十二章：
- 你的驾驶舱：把 VS Code 认全
- 贴身搭档：VS Code 里的 Claude 插件工作流
- 云端分身：Claude Code 网页版怎么用
- 命令行生存包：组合技与肌肉记忆
- Git 核心循环：工作区、暂存区与四步操作
- GitHub 实战：建仓、上传、修改一个仓库
- 分支与 PR：正式的协作流程
- 时光倒流：四种深度的撤销
- 冲突不可怕：亲手拆一次"炸弹"
- 认识一个仓库：拿到新项目先看什么
- 给 AI 立规矩：CLAUDE.md 与技能
- 综合演练：从空文件夹到上线网址
第三册《读懂语言》★★★（已完成）
目标不是"会写"，是读懂 AI 写的每一个文件、能指出问题、能亲手小改。规划十章：
- 总论：AI 时代怎么"学"一门语言——读得懂、改得动、认得出问题
- HTML：骨架语言——标签、嵌套成树、属性
- CSS：样式语言——选择器、盒模型，以及为什么我们的项目里满屏是 Tailwind 的 class
- JavaScript：动作语言——变量、函数、对象与数组、事件；浏览器里的 JS 和 Node.js 是同一门语言的两个住处
- TypeScript：带"形状检查"的 JS——为什么 AI 偏爱它，怎么读类型标注
- JSON 与配置文件家族：json / yaml / env，一眼认脸
- Markdown 与 MDX：文档语言——我们未来的 docs 网站就靠它
- SQL 再进一步：读懂一条真正的查询
- 我们栈里的其他面孔：Python（树莓派上的 ForgeCard）、Aiken（链上合约）、bash 脚本——认识即可
- 实战：挑一个真实文件，和 AI 一起逐行读通
第四册《深入系统》★★★★（本次交付）
四大件从"会用"到"懂它"。规划十章：
- Cloudflare 全解：DNS 实战、CDN、缓存、防护——门口那位保安到底在干什么
- 登上我们的 DO：SSH、密钥、在一台裸服务器上认路
- 让程序永远醒着：进程、后台服务、开机自启（树莓派同款原理）
- 端口与反向代理：为什么是 443，Nginx 在门口排班
- 把表设计好：关系、外键、索引——数据库建模
- RLS 策略实战：亲手写"谁能看哪一行"
- 自己开窗口：设计一个像样的 API（端点、鉴权、版本）
- 缓存与性能：快，是设计出来的
- 日志、监控与告警：出事之前先知道
- 云账单怎么读：成本也是架构的一部分
第五册《AI 工程心法》★★★★★（下一册，大纲已定）
把我们摸索出来的方法论体系化。规划十章：
- 规格驱动开发：先写清楚，再让 AI 动手
- 给 AI 立法（进阶）：宪法、技能、护栏的完整体系
- 测试：让机器检查机器
- CI/CD 实战：GitHub Actions 流水线
- 像攻击者一样思考：安全进阶
- 技术选型：怎么决定用什么、自建还是购买
- 不可逆系统工程学：链上开发的完整方法——那次"链上考古"的最终答案
- 从项目到产品：发布、域名、数据、反馈
- 开源与协作：许可证、贡献、社区
- 毕业课：AI 时代的学习者——这套书教你的其实是同一件事
使用与迭代规则
每册独立成文件（编号 00–05），未来 docs 网站按册分区、按章分页，结构已经留好。每册读完一遍后，最有价值的动作是回到自己的项目里把"试一试"全部补做。大纲不是圣旨：写到哪一册时觉得该增删章节，随时改这份总纲——它和我们的项目一样，持续迭代。
总纲 v1.2 · 完