《Codex 使用手册》· 第 9 章｜把资料做成一次专业交付

CHAPTER 9 · 公开候选

上一章解决“材料能不能信”，这一章解决“怎样交付而不带偏事实”。你会实际生成一个可打开的十页 PowerPoint、同内容 HTML 预览、一页摘要、事实底稿与五条反查记录。

打开第 9 章练习入口。完整任务位于练习包内 tasks/chapter-09.md；网站只提供下载与阅读，不会替你执行本地文件。

1. 起点

第 8 章已经把可用事实、旧版和未决问题分开。现在要把已确认材料组织成一页摘要和十页演示，而不是只交一份大纲。

先理解问题

一份顺滑的大纲仍可能把未知写成事实，也可能根本没有形成用户可打开的交付物。本章同时约束内容链和文件链：陈述要回到 A-ID，.pptx 要有真实十页结构，预览要离线可读。

2. 只读输入

• workbench/library/index.csv
• workbench/library/pending.md
• 第 8 章索引指向的 current 原材料
• inputs/chapter-09/audience-and-purpose.md
• inputs/chapter-09/deck-constraints.json
• inputs/chapter-09/statement-check.json

建议阅读顺序

先读受众与用途，再看十页约束和五条抽查表；最后才打开模板。先决定“讲什么、依据什么”，视觉模板不能反过来决定事实。

3. 唯一写入位置

只写 workbench/content-package/。

写入位置是本章的安全边界。Codex 可以创建目录，但不能扩大到 inputs、checkpoint 或别章输出。

4. 本章唯一成果

交付 facts.md、one-page-summary.md、deck-outline.md、十页 weekend-learning-workbench.pptx、deck-preview.html、visual-assets.md 和 acceptance.md。

成果必须能打开、能回查、能由本章检查验证。只有一句“已经完成”不算交付。

5. 可复制给 Codex 的任务

只使用第 8 章 index.csv 中 current 且 status=已确认的材料，以及 inputs/chapter-09 的读者与约束。先写带 A 系列材料 ID 的 facts.md，再写一页摘要和十页 deck-outline.md，并把同一十页内容写入 workbench/content-package/deck-model.json。按脚本 usage 运行 `node scripts/export-deck.mjs workbench/content-package/deck-model.json workbench/content-package/weekend-learning-workbench.pptx`；export-deck.mjs 只生成实际十页 PPTX，再读取同一 deck-model.json 单独生成同内容的 deck-preview.html。deck-model.json 是中间文件，不替代七项交接成果。U-04 的品牌颜色仍待确认，因此 PPTX 和 HTML 预览只使用中性灰阶，不得自行选择蓝绿或其他品牌强调色；在 visual-assets.md 明写这一边界，并为每项视觉素材写清来源类别与用途。不得把 pending.md 的问题改写成事实，不得联网取图。只写 workbench/content-package，最后运行 npm run check:09。

把代码块整段复制，不要拆掉输入范围、停止条件和检查命令。Codex 的总结不能代替产出文件。

6. 你必须亲手完成

按 statement-check.json 指定的五条陈述，逐条从摘要或演示回到 facts.md，再回到 A 系列材料。把核对结果与日期写入 acceptance.md。

人工动作为什么不能省

你要亲手从第 1 页滚到第 10 页，并用演示软件打开实际 PPTX。再按 statement-check.json 做五条双向反查；只看大纲或相信扩展名都不算完成。

7. 你应该看到

• .pptx 是可识别的演示文件，内部正好十页。
• HTML 预览也正好十页，没有演示软件仍可阅读。
• 五条抽查陈述都有事实 ID 和材料 ID。
• PPTX 与 HTML 预览只使用中性灰阶；视觉素材清单明确说明 U-04 的品牌颜色仍待确认。
• 视觉素材清单说明“为什么用”，没有网络素材依赖。

跟着做：从输入到可观察结果

1. 锁定受众与事实

阅读 audience-and-purpose.md，并确认事实底稿只引用第 8 章已确认 A-ID。

**你应看到：**U-01 至 U-05 只出现在排除声明，不进入确定陈述。

2. 生成真实内容包

把第 5 节任务整段交给 Codex；它用包内 scripts/export-deck.mjs 从 deck-model.json 只导出 PPTX，再从同一模型单独生成预览。

**你应看到：**出现真实 .pptx、十页预览、摘要、底稿、素材表和验收表。

3. 打开而不是猜

先浏览 deck-preview.html，再打开 weekend-learning-workbench.pptx。

**你应看到：**两处均恰有 10 页；封面、第 5 页和第 10 页内容与大纲一致。

4. 反查与离线检查

完成五条反查，运行 npm run check:09。

**你应看到：**输出 CH09_PASS: 10 slides · 5 statements traced，PPTX 无外部关系。

参考完成态：本地实跑记录

• PPTX 包内恰有 10 个 slide XML。
• 五条抽查均回到事实底稿和 A-ID。
• 所有关系文件均无 External link，U-ID 未进入事实。

证据文件：completed-example/content-package/weekend-learning-workbench.pptx。这些记录只证明虚构练习在本地按规则跑通，不代表网站已发布、现实用户已使用或作者已批准。

8. 三个真实坑

坑 1：补写没有依据的事实

待确认清单含有很容易被补全的数字和时间。事实检查会拒绝任何 U 系列 ID 或无法回到 A 系列正文的陈述。

坑 2：把大纲冒充完成的演示

检查会直接打开 .pptx 包并数 slide XML；只有 Markdown 大纲或改后缀的文本文件无法通过。

坑 3：视觉层偷偷替待确认项做决定

U-04 没有确认品牌颜色。即使素材全是本地生成，也不能在预览里擅自选蓝绿强调色；本轮只用中性灰阶，并在 visual-assets.md 同时说明颜色边界、来源类别和用途。检查器会读取 HTML CSS 与 PPTX 页面的显式颜色。

这三个坑都由练习材料、代码或检查实际暴露，不是提醒语。

先看信号，再做补救

**识别信号：**facts.md 出现 U-ID、PPTX 不是十页、某条陈述回不到 A-ID，或关系文件出现 External，说明事实链或文件链已经断开。**补救动作：**先从已确认索引重建 facts.md，再清理 workbench/content-package/ 重新导出；不要靠补页、改扩展名或联网素材掩盖失败。

补救后仍不能让本章检查因正确原因通过，就按第 10 节停止并回退；不要手改日志或复制参考完成态绕过。

9. 复选框验收

• facts.md 的确定陈述全部带 A 系列引用。
• 摘要能在一页内读完。
• PPTX 与 HTML 预览均为十页。
• PPTX 与 HTML 预览均为中性灰阶，visual-assets.md 保留 U-04 的待确认边界。
• 五条陈述已亲手完成双向反查。
• npm run check:09 通过。

每一项都要靠打开文件或完成动作后再勾选；不要只凭 Codex 报告的 PASS。

10. 停止、回退与交接

事实无法回到第 8 章、PPTX 不是十页、出现非灰阶品牌配色、或出现联网素材时停止。回退只清理 workbench/content-package/ 后从 facts.md 重建。交给第 10 章的是已验收的内容包和 inputs/chapter-10/field-card.md；不得带入任何现实任务数据。

**停止条件：**PPTX 无法打开、页数不等于 10、陈述无法回到 A-ID、或出现网络素材依赖。

**回退动作：**只清理 workbench/content-package/，保留第 8 章资料库，从 facts.md 和安全模板重建。

**交接文件：**完整内容包与第 10 章字段卡；下一章只把这些虚构成果当记录对象，不读取现实任务或账号。