附录 A · 阅读地图：这套 Skill 里有什么，接下来读哪篇

读完这篇你能回答：官方文档一共多少篇、哪些必须精读、按我的目标下一步读什么。 读者前提：读完前 7 篇任意一半即可。这份附录是"合上笔记之后"的工具，不是入门读物。

证据：本文所有数字都来自 2026-09-21 对 @hypit/hypit v0.2.9 的一次实测，每条都附复现命令。

0. 一句话结论

这套 Skill 有 105 篇文档，但真正需要精读的只有大约 20 篇。 剩下的，知道它存在、知道什么时候翻，就够了。

而"哪 20 篇要精读"取决于你的目标：做片子和写包，需要精读的不是同一批。

⚠️ 先说清楚：本节出现的编号（script-syntax.md、timing.md…）是官方文档名， 不是本系列的章节号。本系列的章节号在 导读 里。

1. 全库账本（可复现）

cd hypit-main/skills/hypit  # 顶层 + 全部 references find . -name "*.md" | wc -l                            # 105 篇 find . -name "*.md" -exec cat {} + | wc -l             # 13844 行  # 拆成"非中译 / 中译"两部分 find . -name "*.md" -not -path "*/zh/*" | wc -l        # 64 篇 find . -name "*.md" -not -path "*/zh/*" -exec cat {} + | wc -l   # 9559 行 find . -name "*.md" -path "*/zh/*" | wc -l             # 39 篇 find . -name "*.md" -path "*/zh/*" -exec cat {} + | wc -l        # 3821 行 

再拆细一点：

口径提醒：production/zh/ 里的 34 = 33 篇译文 + TRANSLATION-GLOSSARY.zh-CN.md。 别把它算成 34 篇译文。

2. 分级标准

⚠️ 这个分级是我的判断，不是官方说法。 官方只提供目录和索引，不提供优先级。 我的判据很简单：这篇里有没有"不这么做就一定会错"的内容。

3. 逐目录分级表

3.1 creation/（5 篇 / 963 行）—— 要做什么

这一层是全 🔴，没有按需项。 原因：它管的是"要做什么"，做错了后面全是白干。

3.2 production/ 的导航与统一模型（2 篇 / 242 行）

system.md 是理解成本最高、回报也最高的一篇。如果只允许我推荐一篇官方原文，就是它。

3.3 production/：Script 与时间（2 篇 / 332 行）

3.4 production/：工程骨架（4 篇 / 869 行）

3.5 production/：组件（6 篇 / 1,076 行）

3.6 production/：时空与素材（6 篇 / 770 行）

3.7 production/：呈现层（7 篇 / 620 行）

3.8 production/：交付与协作（6 篇 / 934 行）

3.9 playbooks/craft/（12 篇 / 1,503 行）+ examples（2 篇 / 341 行）

这一层里有 5 篇 🔴，而且它们是全文最"有经验含量"的部分——这是"出片质量"的真正来源，值得单独精讲。

3.10 playbooks/formats/（7 篇 / 678 行）

全部 🟡 按需：知道有这么 7 种形态，做的时候再翻。

3.11 environment/（4 篇 / 1,156 行）

4. 两条路线

路线 A · 深度使用（目标是做出自己的片子）

 A 路线的三个人容易漏掉的前提：

1. environment/*
    是前置，不是"以后再说"。没有服务，build 跑不起来。
2. playbooks/formats/*
   （7 种形态）全都按需。不要先读，先做，卡住了再翻。
3. production/review.md
    是收尾必读：它是"怎么判断成片能不能交付"的唯一依据。

路线 B · 深度开发（目标是写自己的包 / 组件）

B 路线的四个入口（都已实测存在）：

⚠️ 注意：packages/ 里还有一些 SDK 性质的包（如 component-kit、build-result-kit）不在根 package.json 的 exports 列表里。 判断"哪些是公开 SDK 入口"要以 exports 为准，不要以 packages/ 里有这个目录为准。

路线 C · 就是我实际走的顺序

本系列 01 → 02 → 03 → 04 → 05 → 06 → 07 → 附录 A → 再按路线 A 或 B 深入官方原文 

系统性最强，但"能跑起来"来得最晚。 如果你手上已经有一条想做的片子，建议直接用路线 A。

5. 中文阅读资源（官方中译现状）

如果你想读中文，官方中译比大多数人以为的多：

其中一个文件值得单独提：

references/production/zh/TRANSLATION-GLOSSARY.zh-CN.md

这是官方译名基准，规定了"哪些术语保留英文、哪些意译"，依据是 Studio 的官方 UI 词条和 docs/zh/**。 它是读中文文档时最该先看的一份——因为术语一旦理解偏了，后面 33 篇都会偏。 本系列的术语约定就是照它执行的（见 导读 第 7 节）。

⚠️ 一个容易踩的坑：playbooks/ 和 environment/完全没有中文版。 所以「出片质量」和「能跑起来」这两件最要紧的事，恰恰是英文独有的。

6. 证据与出处

7. 我不确定的地方

• 🔴🟡⚪ 分级是我的判断
  ，依据是"有没有'不这么做就一定错'的内容"。换了目标（比如你要做的是播客而不是口播），分级的答案会变。
• "大约 20 篇需要精读"是个估计
  ，不是统计结果：它是上表里 🔴 的条目数（按路线取向不同，在 18～22 之间浮动）。
• packages/ 的 121 个目录 ≠ 官方发行版启用的包数
  ：真正接近官方清单的是 packages/video-cli/package.json 的 dependencies（34 个，见 06 章 第 1 节）。
• local-tools.md 是全文最长（410 行）但只标了 🟡
  ：这个判断基于"它讲的是本地准备，托管服务路线可以跳过"。如果你要走本地推理，它其实应该是 🔴。