Rhetoric Of Decks

MB/MC 均衡

最优 deck 使每张 slide 的「边际收益/边际成本」相等：

• 过载的 slide（MB/MC 太低）：文字溢出底部、多个竞争想法、图表线条太多 → 观众放弃
• 过空的 slide（MB/MC 太高）：一个词可以支撑一句话、浪费了加强论点的机会

审查方法：逐张问"再加一个元素，收益能覆盖认知成本吗？再删一个，损失大于清晰度提升吗？"

留白是自信

空白不是浪费。满屏内容暗示恐惧——怕漏掉什么。留白暗示你知道什么重要。

Bullet 通常是认输

列表往往意味着你没找到信息之间的结构。问自己：

• 是序列？→ 用流程图
• 是对比？→ 用双栏
• 是层次？→ 用大小/颜色区分
• 是因果？→ 用箭头

例外：真正平行的条目（公理列表、定理条件）适合用 bullet。

叙事结构

三幕结构

金字塔原则

先说结论，再给证据。观众不是悬疑小说读者。

✅ 正确顺序：结论 → 支撑证据 → 为什么重要 ❌ 错误顺序：背景 → 更多背景 → 分析 → 终于到了结论

教学例外：当教学目标是让学生理解推理过程（而非结论），可以逐步推导再揭示结果。

开场和结尾

开场（第一张内容 slide 最重要，60 秒内决定观众是否注意）：

• ✅ 一个惊人数字（大字居中）
• ✅ 一个悬念/困惑
• ✅ 一个大胆主张
• ❌ "今天我要讲..."
• ❌ 12 项的大纲
• ❌ 定义 slide

结尾（最后一张 slide 决定他们记住什么）：

• ✅ 一句明天还能记住的话
• ✅ 回到开场的困惑，现在已解答
• ❌ "Questions?"
• ❌ "Thank you!"

魔鬼辩护人 Slide

在 Q&A 之前主动展示最强反驳：

"有人会质疑：[最强反对意见]" "这个质疑合理，因为 [为什么合理]" "我们这样回应：[你的应对]"

效果：建立可信度（ethos）+ 预防性回答 + 展示严谨思考。

受众适配

开始制作前先确认受众类型，再选择对应风格：

学术研讨（Research Seminar）

• 极简，一个系数一张 slide
• 第 6 张 slide 前必须展示 identification strategy
• 不要展示完整回归表——高亮 1-2 个关键系数
• 在 Q&A 前主动承认局限性
• 图表：后排可读、处理日期标注、前后期区分、关键模式注释、置信区间阴影

教学（Teaching）

• 允许更多文字（学生要记笔记）
• 重复是学习手段，可以有回顾 slide
• 逐步揭示：用 \pause（Beamer）或 fragment（RevealJS）
• 定义和推导单独一张 slide
• 路标 slide（"我们在这里"）有价值

工作底稿（给合作者）

• 可以更详细
• 记录决策："我们选 A 而非 B，因为..."
• 保留不确定性标记
• 日期一切内容——假设未来的你已忘记上下文

外部汇报（非学术）

• 故事驱动，视觉冲击
• 最少术语
• 一张图胜过一页字

视觉规范

排版

• 正文 ≥ 24pt（绝对底线 18pt）
• 最多两种字体（标题 + 正文）
• 投影用无衬线体（衬线细节远距离消失）
• 不要两端对齐（左对齐更易读）

图表

• 每张图传达一个信息
• 标题说发现（"注册量在 2015 年后翻倍"），不说图表类型（"注册量随时间变化"）
• 直接在数据上标注，不用图例（减少眼球移动）
• 删除所有 chartjunk：3D 效果、过多网格线、装饰元素

数学内容

• 每个推导步骤单独一张 slide 或明确分块
• 用颜色/框/箭头指向关键项
• 相关公式对齐等号
• 标注符号含义（"其中 $\bar{x}$ 是样本均值"）

颜色

如需配色方案，参见 references/palettes.md。

工作流程

制作流程

1. 定义一句话要点：观众必须记住的一件事是什么？
2. 分析受众：他们是谁？知道什么？怀疑什么？
3. 勾画三幕弧线：问题 → 探索 → 解答
4. 先做丑版：把想法倒出来，不管排版
5. 应用三条铁律：一张一想法、美即功能、服务口述
6. 加入魔鬼辩护人：他们会在哪里反驳？提前回应
7. 狠心删减：犹豫时删掉
8. 出声练习：slide 支撑讲话，不是反过来

自检清单

• 后排的人能读每张 slide 吗？
• 每张 slide 都推进了论点吗？
• 每张只有一个想法吗？
• 标题读下来能理解整个论点吗？
• 承认了最强反驳吗？
• 明天他们会记住什么？

格式选择

Beamer（LaTeX）

适合：数学密集、需要精确排版控制、传统学术场景。 详见 references/beamer-template.md。

RevealJS / Quarto

适合：HTML 交互、嵌入代码输出、在线分享。 详见 references/revealjs-template.md。

编译验证环节（硬性要求）

每次编辑 .tex 或 .qmd 后，必须执行以下验证。不通过则不算完成。

Step 1: 编译

# Beamer（推荐 XeLaTeX 用于中文）
xelatex -interaction=nonstopmode deck.tex
# 或通过 Overleaf
bash ol.sh compile "项目名" --compiler xelatex

Step 2: 检查致命错误

grep "^!" deck.log

有任何输出 → 修复后重新编译。

Step 3: 零警告（硬性要求）

grep -cE "Overfull|Underfull" deck.log

必须返回 0。对每个警告：

即使只溢出 0.5pt 也必须修复。

Step 4: 检查字体警告

grep -i "font" deck.log | grep -i "warning"

Step 5: TikZ 视觉验证

TikZ 错误不会触发编译警告，必须手动检查。详见 references/tikz-rules.md。

按顺序执行四轮 Pass：

1. Pass 0: 跨 slide 一致性——相同元素颜色/位置/字号是否一致
2. Pass 1: Bézier 曲线碰撞——计算弯曲深度，检查 label 是否在安全距离外
3. Pass 2: 节点间隙计算——label 宽度是否小于节点间可用空间
4. Pass 3: 箭头 label 定位——每个边 label 是否有 above/below/left/right

无 TikZ 内容时跳过。

Step 6: Figure-Checker 视觉自审（默认关闭）

此步骤默认跳过，仅在用户明确要求时启用（如「帮我看看视觉效果」「用视觉检查」「开启视觉审查」）。

启用后，先将 PDF 转为图片，再为每一页 slide 分别启动 figure-checker 子代理做视觉审查。

# Convert PDF to slide images
pdftoppm -jpeg -jpegopt quality=85 -r 150 deck.pdf /tmp/deck-review/slide

# For each slide image, spawn figure-checker
spawn agent=figure-checker task="Check the image at: /tmp/deck-review/slide-01.jpg
Scene: slides
Intent: <slide title or content description>

Additional context:
- This is slide N of a presentation deck
- Topic: <deck topic>
- Check for: text overflow, readability at distance, layout balance, color contrast"

为什么是 150 DPI JPEG：figure-checker 会在内部处理图像压缩与视觉审查输入，150 DPI JPEG 已足够清晰且体积较小，适合直接使用，无需额外转 PNG 或进一步压缩。

figure-checker 会自动检查以下问题：

汇总所有 slide 的检查结果：只要任意一页返回 ❌ REGENERATE，就必须回到 .tex 源文件修复问题，并从 Step 1 重新开始完整验证。只有全部 slide 通过后，才可继续交付用户。

Step 7: 交付用户检查

验证循环

编译 → 查错 → 查警告 → 查字体 → 查 TikZ → [可选] Agent 看图自审 → 交付用户
  ↑                                                                  |
  └───────── 有问题则修复后重新开始 ←──────────────────────────────┘

全部通过后才可交付。

常见失败模式