附录 A：推荐阅读路径
不同读者带着不同问题来。下表按目标组织本系列与源码的对应阅读顺序，不只是目录重排。
想快速理解架构（30 分钟）
- 第 1 章：定位与总体架构——建立 KVCache 中心化的心智模型。
- 第 2 章：仓库地图——知道东西在哪。
- 官方设计文档
docs/source/design/transfer-engine/index.md与docs/source/design/store/mooncake-store.md。
想理解核心贡献（传输引擎，半天）
- 第 3 章：拓扑、元数据与段模型
- 第 4 章：一次传输的完整路径——读时对照
multi_transport.cpp:623（selectTransport）与rdma_transport.cpp:856（submitTransferTask）。 - 进阶：
docs/source/design/tent/（新一代实现的 deadline 调度、QoS、failover）。
想理解核心贡献（分布式缓存，半天）
- 第 5 章：Store 客户端读写黄金路径
- 第 6 章：Master 服务——对照
replica_allocator.h:88与五种放置策略。 - 第 7 章：存储后端与生命周期
想做集成开发（连接器 / 二次开发）
- 第 8 章：Python 绑定与集成
- 源码：
mooncake-integration/transfer_engine/transfer_engine_py.cpp（API 面）与mooncake-integration/store/store_py.cpp（张量 API）。 - 参考 vLLM 的 Mooncake Connector 实现方式（在上游仓库），或仓库内
mooncake-transfer-engine/example/的 C++ 示例。
想做生产运维
- 第 9 章：部署、可观测性与 HA
- 第 6 章的租约语义与 第 7 章的淘汰机制——故障排查时最常牵涉的两块。
monitoring/下的 Prometheus 抓取配置与 Grafana dashboard。