一句话
花叔橙皮书 = 花叔(AlchainHust,AI 博主)写的一整套开源 AI 编程/工具系列手册——Markdown + PDF 免费发布,到 2026-04 共 10 本(其中 9 本可下载,1 本 Cursor 还没发)。好朋友圈里最常被当作中文 AI 入门读物。
花叔是谁
来源:huasheng-github-orange-books/11-obsidian-ai/README.md 花叔自述段。
- 花叔 (AlchainHust) — AI Native Coder,独立开发者,AI 自媒体博主,30 万+ 粉丝
- 代表作:小猫补光灯(App Store 付费榜 Top 1)
- 渠道:X @AlchainHust / YouTube @Alchain / B站「AI进化论-花生」/ 公众号「花叔」
- 官网:huasheng.ai
- 付费社群:知识星球「AI编程:从入门到精通」
为什么这套书值得被好朋友知道
三个特点:
1. 中文 + 免费 + 持续更新
橙皮书全系列都是 PDF 免费发布,大部分在 GitHub 开源(见下表)。2026-04 这个时点,中文 AI 工具深度手册的供给极少,花叔这套是最完整的。
2. 实战视角,不是 API 翻译
橙皮书不是把 Anthropic 官方 doc 翻译一遍。花叔本人用 Claude Code 写过生产 App(小猫补光灯),书里给的判断和权衡是用过的人写出来的,不是理论堆砌。
3. 系列联动
每本书都引用其他本。读 03 Harness Engineering 会看到 02 源码解析 和 01 入门;读 11 Obsidian-AI 会看到对 Claude Code 架构的反思。单本可读,连读更深。
橙皮书清单(2026-04-18 快照)
来源:huasheng-github-orange-books/_index.md + huasheng-orange-books/pdfs/_manifest.md
已发布(9 本)
| # | 书 | 讲什么 | 页数 | GitHub | R2 PDF |
|---|---|---|---|---|---|
| 01 | Claude Code 从入门到精通 | 入门最全指南 | 102 | claude-code-orange-book ⭐52 | ✅ |
| 02 | 源码解析 | Claude Code 是怎么写出来的 | 72 | claude-code-source-analysis-orange-book ⭐36 | ✅ |
| 03 | Harness Engineering | AI 编程时代的工程方法论(缰绳哲学) | 102 | ❌ GitHub 未发布 | ✅ |
| 04 | Agent Skills | Skill 系统全指南(基于花叔 27 个 skill) | 80 | ❌ GitHub 未发布 | ✅ |
| 05 | OpenClaw | 华人开源 Agent 平台完全手册 | 120 | openclaw-orange-book ⭐29 | ✅ |
| 06 | Hermes Agent | Nous Research 开源 Agent 框架 | 63 | hermes-agent-orange-book ⭐2,703 | ✅ |
| 07 | Cursor ⚠️ | Cursor 编辑器完全指南 | ~50 | ❌ 未发布 | ❌ R2 404 |
| 08 | Gemma 4 完全指南 | Google Gemma 4 使用 | 42 | ❌ | ✅ |
| 09 | Polymarket 指南 | 预测市场 | — | polymarket-orange-book ⭐15 | ✅ |
| 10 | Opus 4.7 System Card 中文 | Anthropic Opus 4.7 官方 system card 翻译 | 232 | ❌ | ✅ |
| 11 | Obsidian-AI ⭐新增 | Obsidian + Claude Code 的第二大脑 | — | obsidian-ai-orange-book ⭐669 | ❌ R2 暂未发 |
⚠️ 07 Cursor 橙皮书:R2 镜像返回 404,GitHub 也没有仓库——这本现在你拿不到。等花叔补。
入口
- 官方落地页:https://www.huasheng.ai/orange-books/
- 花叔 GitHub:https://github.com/alchaincyf
好朋友该怎么读
如果你完全没接触过 AI 工具
- 先读 01 Claude Code 从入门到精通(对应 入门)
如果你想深入 Claude Code
- 读 02 源码解析 + 03 Harness Engineering
- 02 看 Claude Code 里面怎么实现的
- 03 看怎么用 Claude Code 搭出一套工程化流程(CLAUDE.md → Skills → Hooks 的系统化)
如果你要做 Skill / 插件
- 读 04 Agent Skills
- 配合花叔的 Skill 库(nuwa-skill / darwin-skill 等 20 个)一起
如果你关心”知识管理 + AI”
- 读 11 Obsidian-AI——⚠️ 这本直接挑战 AIBuilder 当前架构(见 Obsidian-AI 的反 RAG 观点)
读橙皮书时的”一条路”建议
花叔书深、内容密,但他的视角是”单一作者”——即使他本人很有经验,也是一家之言。好朋友读的时候:
- 看到具体操作(怎么装 / 怎么配 / 怎么跑)→ 可以直接抄
- 看到判断和取舍(为什么这样不那样 / 什么好什么不好)→ 当作花叔的一个视角,不是唯一答案
- 看到”最佳实践/应该/必须”→ 追问”哪里的经验、什么前提、有没有反例”
版本差(R2 vs GitHub)
同一本书可能有版本差异:
01 Claude Code 从入门到精通:GitHub 版 v260411(10.34 MB,最新)> R2 版 8.01 MB(可能略旧)。
一般来说:能从 GitHub 仓库拿就从 GitHub 拿——版本更新、有 README(作者自述),且大多仓库带中英双语 PDF。
怎么开始读(给零基础读者)
第 1 步:先去官方入口拿正版,价格先看清
橙皮书的正式入口就两个:
- 总入口:
https://www.huasheng.ai/orange-books/ - 作者仓库:
https://github.com/alchaincyf
官方落地页写得很直接:“全部免费下载 PDF”。也就是说,对读者来说,价格就是 0 元。
操作上建议这样拿:
- 同一本书 GitHub 和落地页都有 → 优先 GitHub 版(版本号清楚、README 更全)
- GitHub 没单独仓库的书(03 / 04 / 08 / 10)→ 走官方落地页下载
- 看到 07 Cursor 还 404 → 先别浪费时间找盗链,等作者补
第 2 步:零基础别乱跳,按这一条顺序读
如果你真的是从零开始,推荐顺序不是”哪本热门读哪本”,而是:
- 01《Claude Code 从入门到精通》
先把安装、你的第一个项目、核心工作流、
CLAUDE.md这些基本动作跑通。 - 03《Harness Engineering》 再补方法论,知道为什么光会聊天不够,为什么还需要 rules / hooks / orchestration。
- 04《Agent Skills》 当你已经能稳定用 Claude Code,再进入”怎么把经验打包成能力”。
- 02《源码解析》 这本放后面读,收获反而更大。因为你已经有体感,看到源码和架构决策才不会悬空。
- 11《Obsidian-AI》 最后再读这种带世界观冲击的书,不然容易在还没会用工具前就先被方法论吵晕。
第 3 步:每读完一本,立刻对照本 wiki
别把橙皮书当孤立 PDF 读。更稳的读法是”一本书 + 本 wiki 对照”:
- 读完 01 → 对照 入门、CLAUDE.md
- 读完 03 / 04 → 对照 agent、skill、workflow、进阶_hooks_settings_plugins
- 读到工具接入和外部连接 → 对照 MCP
- 读到 11 → 对照 Obsidian-AI 的反 RAG 观点 和 RAG
这样你不是只记作者说了什么,而是顺手把概念、机制、反方观点都挂到自己的知识地图上。
第 4 步:别只读,配一个 30 分钟 mini 项目
最推荐的实验是:读完 01 的起步和核心能力部分后,立刻建一个空 repo,做一个极小工具。
最小动作可以是:
- 建一个新目录并初始化 git
- 写一份最小
CLAUDE.md - 让 Claude 做一个小 CLI、一个 README 生成器,或一个简单的 wiki 页面整理脚本
- 过程中故意用一次
/rewind - 最后补一个 git commit
这个实验的目的不是做出产品,而是把”安装、提需求、回滚、提交”这条闭环跑通一次。只读不做,很快就忘。
第 5 步:如果组读书会,一次只读一章,每人带一个 demo
橙皮书最怕的不是太浅,而是太密。团队一起读时,别搞”一周一本总结会”,那只会变成没人记得细节的高层空谈。
更实用的方式是:一次一章或一个主题,每个人带一个自己跑过的 demo 或失败案例来讲。 这样你们讨论的不是作者说了什么,而是”这套东西在我们手里到底能不能跑起来”。
陈彬视角
这是好朋友社群最应该收藏的中文资料合集——不夸张。现阶段(2026-04),中文圈子里能拿出”一整套、持续更新、实战验证过”的 AI 工具手册的只有花叔。
但建议把橙皮书当”地图”不是”圣经”:
- 地图 = 帮你快速看清”这个领域有哪些大件,它们长什么样”
- 不是圣经 = 每一本书都是花叔个人经验的投射。他的工作方式、技术栈、偏好不一定适合你
我个人对这套书的用法:先快速扫目录,对主题建立心理地图 → 真正要用某个工具时再回来精读那一章节 → 边读边在 Claude Code 里自己跑。不要一本从头读到尾——太慢,记不住。
关联
- 由此展开:入门 · agent · skill · workflow · MCP
- 深度对话:Obsidian-AI 的反 RAG 观点(橙皮书 11 直接对话 AIBuilder 架构)
- 花叔 Skill 生态:
~/AIBuilder/raw/2026-04-18/skill-library/huasheng/20 个 skill 仓库
needs_sources(明确待补)
- 07 Cursor 橙皮书(等花叔)
- 独立读者视角的书评(避免 echo chamber)
- 与英文资源横向对比