跳转至

第一编：欢迎来到源码的世界

打开黑箱之前，先建立好奇心和方向感。

本编不写一行源码分析——我们先回答三个前置问题：我们在看什么、怎么确认它可信、从哪里开始读。

本编总览

flowchart LR
    subgraph 第一编["🌍 欢迎来到源码的世界"]
        direction TB
        C1["第1章<br/>打开黑箱<br/><i>AI编程助手的秘密</i>"]
        C2["第2章<br/>背景知识<br/><i>TypeScript/React/Bun</i>"]
        C3["第3章<br/>双生代码库<br/><i>还原层 vs 补全层</i>"]
        C4["第4章<br/>全景地图<br/><i>1884个文件的导航</i>"]
    end

    C1 -->|建立好奇心| C2
    C2 -->|认识零件| C3
    C3 -->|确认边界| C4
    C4 -->|"准备出发 🚀"| 后续编

    style 第一编 fill:#1a1a2e,stroke:#7c4dff,color:#fff
    style C1 fill:#16213e,stroke:#e94560,color:#fff
    style C2 fill:#16213e,stroke:#0f3460,color:#fff
    style C3 fill:#16213e,stroke:#533483,color:#fff
    style C4 fill:#16213e,stroke:#e94560,color:#fff

本编四章速览

章 标题 核心问题 生活类比
1 打开黑箱 你在终端输入一句话，AI 帮你改了代码——中间到底发生了什么？ 拆开收音机
2 背景知识 TypeScript、React、CLI 是什么？为什么选它们？ 学开车前先认识仪表盘
3 双生代码库 59.8MB 的文件泄露了源码——但看到的都可信吗？ 考古现场的两份拼图
4 全景地图 面对 1884 个文件，从哪里开始？怎么不迷路？ 第一次走进大城市

设计思想主线

本编建立的认知基础

  1. Claude Code 不是聊天壳——它是一个能读写文件、执行命令的任务执行器
  2. 源码来自 两套逆向代码库——必须区分"原始还原"和"社区补全"
  3. 可信度分级（A/B/C 三级）是后续所有分析的基础
  4. 掌握 六大架构层次，后面怎么深入都不会迷路

推荐路径

四章全读，重点看生活类比和核心问题。不需要理解所有技术细节，建立直觉即可。

第1章快速浏览，第2章按需跳过已熟悉的技术，第3-4章仔细读。

第1-2章跳过，直接从第3章开始——证据边界是一切分析的前提。第4章的深水区值得细读。

代码库数字画像

pie title Claude Code v2.1.88 文件分布
    "工具实现 (tools/)" : 54
    "命令系统 (commands/)" : 88
    "UI组件 (components/)" : 148
    "工具函数 (utils/)" : 294
    "React Hooks (hooks/)" : 87
    "服务模块 (services/)" : 40
    "其他" : 1173

两套代码库对比

维度 sourcemap 还原层 OpenClaudeCode 补全层
文件数 1,884 1,989 (+105)
可运行 否 是
Shim 无 7 个
可信度 A 级为主 A/B/C 混合