pitch-deck

填充投资银行路演演示文稿模板

参考文件

在开始任何工作之前，请在任务开始时阅读所有参考文件。 这些文件包含会影响你处理方式的关键模式与反模式。不要等到遇到问题才阅读。

文件	用途
formatting-standards.md	文本、项目符号、表格、图表、对齐
slide-templates.md	常见幻灯片类型的内容映射指南
xml-reference.md	用于表格、形状、箭头的 PowerPoint XML 模式
calculation-standards.md	用于验证的财务公式（CAGR、共识预期）

---

工作流决策树

这是什么类型的任务？

┌─ Populating empty template with source data?
│  └─→ Follow "Template Population Workflow" below
│
├─ Editing existing populated slides?
│  └─→ Extract current content, modify, revalidate
│
└─ Fixing formatting issues on existing slides?
   └─→ See "Common Failures" table, apply targeted fixes

---

⚠️ 关键渲染限制

LibreOffice 用于验证，但无法准确渲染 PowerPoint 文件。 它会破坏字体、渐变、形状位置、文本换行以及部分表格格式。

这意味着： 在 LibreOffice 中通过视觉验证的幻灯片，在 Microsoft PowerPoint 中仍可能存在问题。验证循环能捕捉结构性问题（内容缺失、表格损坏、占位符格式残留），但无法捕捉字体替换、细微的对齐偏移或渐变问题。

必需操作： 交付输出时始终包含以下声明：

"此文件已使用 LibreOffice 进行验证。分发前请在 Microsoft PowerPoint 中审阅，因为可能存在渲染差异。"

---

模板填充工作流

复制并跟踪进度：

Pitch Deck Progress:
- [ ] Phase 1: Extract and validate source data
- [ ] Phase 2: Map content to template sections
- [ ] Phase 3: Populate slides with proper formatting
- [ ] Phase 4: Validate → Fix → Repeat until clean
- [ ] Phase 5: Final verification

阶段 1：数据提取

1. 在进行任何修改之前，创建原始模板的备份 —— 复制为 [filename]_backup.pptx。直接编辑 XML 或意外错误可能导致文件损坏。
2. 识别所有源材料（Excel、CSV、PDF 报告、Word 文档、数据库、网络来源）
3. 从每个来源提取相关数据点
4. 对照原始来源验证所有数字
5. 统一单位和货币（将所有数字转换为模板中使用的主要单位/货币）
6. 记录任何需要验证的计算 → 公式参见 calculation-standards.md

阶段 2：内容映射

1. 打开并目视审查模板 —— 在修改之前了解其结构、风格和现有内容
2. 分析模板结构 —— 识别所有占位区域和内容框
3. 将源数据映射到对应的模板部分 → 映射指南参见 slide-templates.md
4. 识别占位符指导框（任务创建者提供的彩色说明框）
5. 记录任何数据缺口或不匹配 → 解决方案参见 slide-templates.md

阶段 3：模板填充

1. 移除或重新格式化占位框 —— 彩色说明框显示的是要创建什么，而不是如何格式化。删除它们，并在原位置创建格式正确的内容。参见关键反模式。
2. 用映射的内容填充每个部分（先专注于内容）
3. 然后应用格式以匹配模板风格 → 参见 formatting-standards.md
4. 将表格创建为真正的表格对象（切勿使用管道符/制表符分隔的文本）→ 参见 xml-reference.md
5. 将箭头/形状创建为 PowerPoint 对象 → 参见 xml-reference.md
6. 如果任务文件中提供了公司 Logo，则插入；如果不可用，则向用户提示："[未提供 LOGO - 请提供公司 Logo]"

阶段 4：验证 → 修复 → 重复

这是一个反馈循环。重复执行，直到所有检查全部通过，或触发升级。

# Convert to images for visual validation
soffice --headless --convert-to pdf presentation.pptx
pdftoppm -jpeg -r 150 presentation.pdf slide

验证清单（逐一检查每张幻灯片图片）：

• 文字在背景上是否清晰可读？
• 表格是否为真实对象（列对齐，而非管道符/制表符分隔的文本）？
• 图表/表格是否填满指定区域？
• 各章节内的项目符号格式是否一致？
• 同级框体的字号是否一致？
• 是否存在超出幻灯片边界的内容？
• 是否未保留占位符格式（没有把数据直接堆进去的大色块）？
• 是否没有基于文本的"表格"（没有用 | 或制表符分隔符伪造的列）？
• 跨幻灯片一致性：同一指标/数字在所有出现它的幻灯片上是否完全相同？

修复循环协议：

循环	操作
1	修复所有已识别问题，重新验证
2	修复剩余问题，重新验证
3	若问题仍然存在，记录剩余问题并升级给用户

3 轮循环后，如果问题仍然存在：

1. 列出每个未解决的问题，附幻灯片编号和描述
2. 说明已尝试的操作
3. 交付文件并附明确免责声明："以下问题无法自动解决：[列表]。需要人工审核。"

不要无限循环下去。有些问题（字体渲染、复杂形状对齐）可能需要在 PowerPoint 中人工干预。

阶段 5：最终验证

交付前请按最终质量检查清单逐项检查。

---

快速参考表

项目符号

上下文	符号	用途
包含/正面	✓	范围内的项目、具备的功能
排除/负面	×	范围外的项目、缺失的功能
中性列表	•	一般枚举、评论
编号序列	1. 2. 3.	流程步骤、排名
子项目符号	–	主项目符号下的次级要点

幻灯片层级（典型）

这些是典型范围——请根据模板规范调整：

层级	示例	典型字号	样式
标题	幻灯片标题	40-48pt	粗体
副标题	市场定义、幻灯片描述	18-22pt	粗体
章节标题	"关键预测"、"评论"	14-16pt	常规
区块标签	"包含细分"、"定义"侧栏	12-14pt	常规
区块内容	项目符号、正文	11-14pt	常规
表头	列标题	10-12pt	粗体
表格正文	单元格内容	9-11pt	常规
脚注	来源、注释	8-9pt	斜体

字体一致性匹配

处于同一层级的框体必须使用完全相同的字号：

同层级	必须与之一致
"包含细分"	"排除细分"
"定义"	"范围理由"
左列项目符号	右列项目符号
所有区块标签	彼此一致
所有章节标题	彼此一致

演示文稿取整

这些是典型惯例——请根据数值量级和模板风格调整：

数值类型	典型取整方式	示例
大型市场规模（$10bn+）	最接近的 $1bn	18.5 → $19bn
较小市场规模（<$10bn）	最接近的 $0.5bn 或 $0.1bn	2.3 → $2.5bn
规模范围	与来源精度一致	14.9-22.1 → $15-22bn
CAGR	整数 % 或 0.5%	16.4% → 16% 或 16.5%
市场份额	最接近的 5% 或与来源一致	21.4% → 20%
倍数	1 位小数	9.69 → 9.7x

原则： 取整不应实质改变数值。对于较小的值，使用更精细的精度。

文本密度规则

• 每个内容框最多 6-7 个项目符号
• 每个项目符号最多 2 行
• 括号内示例：同行或下方缩进
• 无孤字（不与单个词单独占一行）

对齐原则

垂直堆叠的框必须具有完全相同的：

• 左边距位置、项目符号缩进、文本起始位置、框宽度

水平相邻的框必须具有完全相同的：

• 顶部位置、高度（在可能的情况下）、内部填充

多幻灯片一致性

当相同数据出现在多张幻灯片上时：

• 使用完全相同的数字、格式和术语
• 如果某个指标在一张幻灯片上更新，则更新所有出现的位置
• 在验证期间交叉引用以发现不一致之处

---

必须满足的要求

无论使用何种模板，这些要求都不可协商：

要求	详情
文本可读性	所有文本必须与背景具有足够的对比度。示例：深蓝色、深绿色、黑色背景上的白色/浅色文本；白色、浅灰色、浅黄色背景上的黑色/深色文本。
实际表格对象	表格数据必须是表格对象，而不是制表符分隔的文本。参见 xml-reference.md。
正确的图表/表格尺寸	粘贴的视觉元素必须填满指定区域。参见 formatting-standards.md。
一致的格式	同一节内的项目符号必须匹配（符号、大小、缩进）。同级框必须使用相同的字体大小。
内容边界	所有内容必须保持在幻灯片边缘之内。脚注框宽度：16:9 约为 32.5cm，4:3 约为 24cm。
无占位符格式	移除彩色说明框。正文：按模板使用浅色背景上的深色文本。

---

关键反模式：绝不要这样做

当占位符格式被误认为输出格式时，就会出现这些失败。识别这些模式至关重要。

反模式 1：将数据填充到占位符框中

会发生什么： 模板带有彩色说明框（黄色、橙色等），其中包含指导文本。模型用实际数据替换指导文本，但保留了彩色框。

为什么这是错的： 彩色框就是占位符。它告诉你那里应该放什么内容。输出应该具有不同的格式——通常是白色/浅色背景上的深色文本，或正确设置样式的形状。

识别测试： 如果你填充后的幻灯片中有大量彩色矩形填满数据文本，那么你就是复制了占位符格式，而不是替换它。

关键区别——两种类型的"占位符"：

类型	如何识别	该怎么做
说明框	明亮的颜色（黄色、橙色），包含诸如"在此处插入 X"之类的指导文本，彩色背景上的白色/浅色文本	删除整个形状，然后使用正式格式创建新内容
布局占位符	属于幻灯片母版/布局的一部分，与模板主题匹配的中性颜色，"单击以添加文本"	保留形状，仅替换文本内容

如果不确定：检查该形状是否存在于同一模板的空白幻灯片上。布局占位符会保留；说明框是常规形状。

反模式 2：基于文本的"表格"

会发生什么： 模型使用分隔符（|、制表符、空格）而不是实际的表格对象来创建类似表格的内容。

为什么这是错的： 这不是表格。列永远不会正确对齐，无法一致地设置格式，而且看起来不专业。

识别测试： 如果你正在输入 | 字符或依赖空格/制表符来创建列，那么你创建的是文本，而不是表格。

必须验证： 创建任何表格后，验证它是实际的表格对象。参见 xml-reference.md 了解验证方法。

反模式 3：继承占位符对比度

会发生什么： 占位符在彩色背景上使用浅色文字（例如黄色背景上的白色文字）。模型填充了数据，但保留了这个配色方案，导致输出难以阅读。

为什么这是错的： 占位符颜色被刻意设计成与众不同，以表明“请替换我”。生产演示文稿的正文内容通常使用浅色背景上的深色文字。

识别测试： 如果你填充后的内容在正文区域（非页眉）的明亮彩色背景上出现浅色/白色文字，说明你继承了占位符的格式。

正确做法： 应用生产格式——正文内容通常使用白色或浅色背景上的深色文字（#000000 或 #333333）。页眉和强调区域可以使用品牌色。

摘要：占位符 vs. 生产

元素	占位符（输入）	生产（输出）
指示框	彩色背景、指导文字	移除或重新格式化
数据区域	“[在此插入数据]”文字	具有干净格式的实际数据
表格	对表格应包含内容的描述	具有行/列的实际表格对象
正文文字	彩色背景上的浅色文字	浅色背景上的深色文字

占位符告诉你创建什么，而不是如何格式化它。

---

常见失败

关于最关键失败的详细说明，请参见上文的关键反模式。

失败	解决方案	参考
非结构化文字堆砌	拆分为项目符号（✓、×、•）	formatting-standards.md
管道符/制表符分隔的“表格”	创建实际的表格对象——带分隔符的文字不是表格	xml-reference.md
文字/背景对比度差	审查每个文字元素	—
粘贴的图表过小	调整大小以填满区域，仅粘贴图表	formatting-standards.md
源数据与图表一起粘贴	复制前仅选择图表对象	—
数据被倒入占位符框	删除彩色指示框，创建格式正确的新内容	反模式
项目符号不一致	定义一次样式，应用到所有	formatting-standards.md
各框字体不一致	统一同级框	formatting-standards.md
内容溢出	设置明确的框宽（脚注：16:9 为 32.5cm，4:3 为 24cm）	—
缺少 Logo	使用任务文件中的 Logo；如果未提供，向用户标记	—
残留的 [方括号]	搜索并替换所有占位符	—
文字箭头（→、⟹）	使用 PowerPoint 形状对象	xml-reference.md

---

错误处理

如果 PDF/图片转换失败：

1. 检查是否安装了 LibreOffice：which soffice
2. 尝试替代方案：libreoffice --headless --convert-to pdf presentation.pptx
3. 如果仍然失败，手动在 PowerPoint/LibreOffice 中打开并导出

如果源数据存在不一致或冲突：

1. 优先级顺序：优先使用任务文件中明确提供的数据
2. 如果使用来自其他来源（网络搜索、外部文档）的数据，向用户标记这一点
3. 明确记录任何差异
4. 添加脚注说明数据来源选择

如果计算与源预测不匹配：

1. 展示你的计算方法
2. 注明差异和可能原因（不同的基准年、方法）
3. 如果差异重大，同时呈现两个值
4. 向用户标记以供解决

---

表格结构指南

创建表格时（必须是实际的表格对象）：

列对齐：

• 文本列：左对齐（表头与内容）
• 数值列：右对齐或居中对齐（表头与内容保持一致）

表头行：

• 粗体文本
• 带底纹背景（模板的品牌色）
• 白色或对比色文本

汇总/合计行：

• 粗体文本
• 上方带分隔线
• 独特的背景底纹

宽度： 完全填满指定区域的宽度。

有关 XML 实现，请参阅 xml-reference.md。

---

脚注格式

格式：

Sources: [Source 1] (Year), [Source 2] (Year).
Notes: (1) [First note]; (2) [Second note].

示例：

Sources: Grand View Research (2024), Mordor Intelligence (2024), Markets and Markets (2023).
Notes: (1) Excludes hardware revenue; (2) Includes both B2B and B2C segments.

幻灯片正文中的所有上标数字（¹、²、³）都必须有对应的 Notes 条目。

---

Logo 放置

• 使用任务材料中提供的 logo 文件
• 如果未提供 logo，向用户提示："[LOGO NOT PROVIDED - please supply company logo]"
• 位置：通常位于右上角，在各幻灯片中保持一致的尺寸，不得与内容重叠

---

按幻灯片类型划分的数据要求

有关每种幻灯片类型的详细数据要求、格式原则及示例列标题，请参阅 slide-templates.md。

涵盖的常见幻灯片类型：市场定义、市场规模/TAM、竞争格局、财务摘要、交易可比公司。

---

最终质量检查清单

在交付已填充的模板之前，请核实：

数据准确性

• 所有数字与原始源文档一致
• 计算值已根据公式核实（见 calculation-standards.md）
• 年份和时间段正确
• 公司/竞争对手名称拼写正确
• 相同数字在所有出现该数字的幻灯片中保持一致

内容映射

• 每个模板部分都填充了适当的数据
• 没有残留的 [bracket] 占位符文本
• 所有来源引用均包含在脚注中
• 脚注编号（¹²³）有对应的 Notes 条目

格式

• 文本在所有背景上均可读（对比度充足）
• 表格是实际的表格对象（不是以竖线/制表符分隔的文本）
• 图表/表格填满指定区域（不是缩略图）
• 项目符号格式在每个部分内保持一致
• 同一层级的框中字号一致
• 没有内容超出幻灯片边界
• 没有保留占位框并在其中倾泻数据
• 最终输出中没有彩色说明框

模板合规性

• 占位说明框已重新格式化或移除
• 格式与模板样式一致（颜色、字体）
• Logo 存在且位置正确
• 已应用成品格式（主要内容使用浅色背景上的深色文本）

最后一步

• 建议用户在分发前于 Microsoft PowerPoint 中验证（LibreOffice 的呈现效果可能不同）