一句话

花叔橙皮书 = 花叔(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 本)

#讲什么页数GitHubR2 PDF
01Claude Code 从入门到精通入门最全指南102claude-code-orange-book ⭐52
02源码解析Claude Code 是怎么写出来的72claude-code-source-analysis-orange-book ⭐36
03Harness EngineeringAI 编程时代的工程方法论(缰绳哲学)102❌ GitHub 未发布
04Agent SkillsSkill 系统全指南(基于花叔 27 个 skill)80❌ GitHub 未发布
05OpenClaw华人开源 Agent 平台完全手册120openclaw-orange-book ⭐29
06Hermes AgentNous Research 开源 Agent 框架63hermes-agent-orange-book2,703
07Cursor ⚠️Cursor 编辑器完全指南~50❌ 未发布R2 404
08Gemma 4 完全指南Google Gemma 4 使用42
09Polymarket 指南预测市场polymarket-orange-book ⭐15
10Opus 4.7 System Card 中文Anthropic Opus 4.7 官方 system card 翻译232
11Obsidian-AI ⭐新增Obsidian + Claude Code 的第二大脑obsidian-ai-orange-book669❌ R2 暂未发

⚠️ 07 Cursor 橙皮书:R2 镜像返回 404,GitHub 也没有仓库——这本现在你拿不到。等花叔补。

入口

好朋友该怎么读

如果你完全没接触过 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”

读橙皮书时的”一条路”建议

花叔书深、内容密,但他的视角是”单一作者”——即使他本人很有经验,也是一家之言。好朋友读的时候:

  • 看到具体操作(怎么装 / 怎么配 / 怎么跑)→ 可以直接抄
  • 看到判断和取舍(为什么这样不那样 / 什么好什么不好)→ 当作花叔的一个视角,不是唯一答案
  • 看到”最佳实践/应该/必须”→ 追问”哪里的经验、什么前提、有没有反例”

版本差(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 步:零基础别乱跳,按这一条顺序读

如果你真的是从零开始,推荐顺序不是”哪本热门读哪本”,而是:

  1. 01《Claude Code 从入门到精通》 先把安装、你的第一个项目、核心工作流、CLAUDE.md 这些基本动作跑通。
  2. 03《Harness Engineering》 再补方法论,知道为什么光会聊天不够,为什么还需要 rules / hooks / orchestration。
  3. 04《Agent Skills》 当你已经能稳定用 Claude Code,再进入”怎么把经验打包成能力”。
  4. 02《源码解析》 这本放后面读,收获反而更大。因为你已经有体感,看到源码和架构决策才不会悬空。
  5. 11《Obsidian-AI》 最后再读这种带世界观冲击的书,不然容易在还没会用工具前就先被方法论吵晕。

第 3 步:每读完一本,立刻对照本 wiki

别把橙皮书当孤立 PDF 读。更稳的读法是”一本书 + 本 wiki 对照”:

这样你不是只记作者说了什么,而是顺手把概念、机制、反方观点都挂到自己的知识地图上。

第 4 步:别只读,配一个 30 分钟 mini 项目

最推荐的实验是:读完 01 的起步和核心能力部分后,立刻建一个空 repo,做一个极小工具。

最小动作可以是:

  1. 建一个新目录并初始化 git
  2. 写一份最小 CLAUDE.md
  3. 让 Claude 做一个小 CLI、一个 README 生成器,或一个简单的 wiki 页面整理脚本
  4. 过程中故意用一次 /rewind
  5. 最后补一个 git commit

这个实验的目的不是做出产品,而是把”安装、提需求、回滚、提交”这条闭环跑通一次。只读不做,很快就忘。

第 5 步:如果组读书会,一次只读一章,每人带一个 demo

橙皮书最怕的不是太浅,而是太密。团队一起读时,别搞”一周一本总结会”,那只会变成没人记得细节的高层空谈。
更实用的方式是:一次一章或一个主题,每个人带一个自己跑过的 demo 或失败案例来讲。 这样你们讨论的不是作者说了什么,而是”这套东西在我们手里到底能不能跑起来”。

陈彬视角

这是好朋友社群最应该收藏的中文资料合集——不夸张。现阶段(2026-04),中文圈子里能拿出”一整套、持续更新、实战验证过”的 AI 工具手册的只有花叔。

但建议把橙皮书当”地图”不是”圣经”

  • 地图 = 帮你快速看清”这个领域有哪些大件,它们长什么样”
  • 不是圣经 = 每一本书都是花叔个人经验的投射。他的工作方式、技术栈、偏好不一定适合你

我个人对这套书的用法:先快速扫目录,对主题建立心理地图 → 真正要用某个工具时再回来精读那一章节 → 边读边在 Claude Code 里自己跑不要一本从头读到尾——太慢,记不住。

关联

needs_sources(明确待补)

  • 07 Cursor 橙皮书(等花叔)
  • 独立读者视角的书评(避免 echo chamber)
  • 与英文资源横向对比