Skip to content

quick_reference.md

Latest commit

 

History

History
474 lines (344 loc) · 12.2 KB

quick_reference.md

File metadata and controls

474 lines (344 loc) · 12.2 KB
Raw

PPT Master 快速参考指南

本指南提供常用操作的快速参考，帮助你高效使用 PPT Master 系统。

🎯 角色速查

角色 何时使用 输入 输出
Strategist 项目开始时 源文档 设计规范与内容大纲
Image_Generator 选择 AI 生成图片时 图片资源清单 图片文件 + 提示词
Executor_General 生成通用风格页面 设计规范 SVG 代码
Executor_Consultant 生成一般咨询风格页面 设计规范 SVG 代码
Executor_Consultant_Top 生成顶级咨询风格页面（MBB 级） 设计规范 SVG 代码
Optimizer_CRAP 优化重要页面 SVG 代码 优化后的 SVG

📋 工作流程检查清单

✅ 开始前准备

  • 准备完整的源文档内容
  • 明确目标受众和使用场合
  • 确定期望的页面数量
  • 选择设计风格（通用 / 一般咨询 / 顶级咨询）
  • 准备相关数据和素材

✅ 使用 Strategist

  • 完成八项确认（Strategist 会为每个问题提供专业建议）
    • 画布格式（PPT 16:9 / 小红书 / 朋友圈等）
    • 页数范围（参考 Strategist 基于内容量的建议）
    • 关键信息（确认或调整 Strategist 对受众和场合的判断）
    • 风格选择（A 通用灵活 / B 一般咨询 / C 顶级咨询）
    • 配色方案（主导色、辅助色、强调色的 HEX 色值）
    • 图标方式（A Emoji / B AI生成 / C 内置图标库 / D 自定义路径）
    • 图片使用（A 不使用 / B 用户提供 / C AI生成 / D 占位符预留）
    • 若图片包含「B) 用户提供」，八项确认后立即运行 python3 tools/analyze_images.py <项目路径>/images， 在输出设计规范前填充图片资源清单
    • 排版方案（字体组合 P1-P5 + 正文字号基准 18-24px）
  • 等待 Strategist 生成设计规范
  • 仔细检查并确认设计规范
  • 创建项目文件夹：python3 tools/project_manager.py init <名称> --format <格式>
  • 保存设计规范到项目文件夹

💡 提示: Strategist 不仅会提问，还会主动提供专业建议供你参考

✅ 使用 Image_Generator（条件触发）

⚠️ 触发条件：图片方式包含「C) AI 生成」时必须执行此步骤

  • 阅读设计规范中的图片资源清单
  • 为每张图片判断类型（背景图/实景照片/插画/图表/装饰）
  • 创建提示词文档 images/image_prompts.md
  • 为每张待生成图片生成：类型 + 优化提示词 + 负面提示词 + Alt Text
  • 调用 AI 图像生成工具生成图片
  • 保存所有图片到 images/ 目录
  • 确认所有图片已归集完成，状态从「待生成」变更为「已生成」

💡 提示: 图片生成是串行环节，必须完成后才能进入 Executor 阶段

✅ 使用 Executor（两阶段）

视觉构建阶段：

  • 明确告知需要生成哪一页
  • 提供设计规范引用
  • 检查生成的 SVG 效果
  • 如需修改，提供具体反馈
  • 保存 SVG 到项目的 svg_output 文件夹

逻辑构建阶段（必须）：

  • 所有 SVG 页面完成后，生成完整演讲备注文稿 notes/total.md
  • 确保讲稿包含所有页面的过渡语和控场标记

✅ 使用 Optimizer（可选）

  • 仅在完整初版产出后仍不满意时使用
  • 选择需要优化的页面
  • 提供原始 SVG
  • 说明优化重点（如果有）
  • 检查优化后的效果
  • 保存为 yh_前缀的文件名
  • 优化后重新运行 finalize_svg.py 与 svg_to_pptx.py 以保持产物一致

✅ 完成后（自动执行）

后处理和导出步骤由 AI 自动执行：

  • AI 自动拆分讲稿：python3 tools/total_md_split.py <项目路径>
    • 将 notes/total.md 拆分为各页独立文件
  • AI 自动运行后处理：python3 tools/finalize_svg.py <项目路径>
    • 修正图片路径
    • 优化代码结构
    • 生成最终版本到 svg_final/
  • AI 自动导出 PPTX：python3 tools/svg_to_pptx.py <项目路径> -s final
    • 生成可用的 PowerPoint 文件
    • 自动嵌入演讲备注
  • 在 PowerPoint 中预览最终效果
  • 检查所有页面的一致性
  • 添加项目 README 文档（可选）
  • 备份重要文件（可选）

💡 提示: 后处理和导出无需手动执行，AI 会在完成演讲备注后自动完成

🎨 设计风格选择指南

选择"通用灵活风格"当：

✅ 适用场景：

  • 一般商业演示
  • 团队内部汇报
  • 教育培训课件
  • 需要更多创意自由
  • 视觉丰富的内容展示

✅ 优势：

  • 更灵活的布局选择
  • 丰富的色彩使用
  • 详细的卡片高度规划
  • 适合各类主题

选择"一般咨询风格"当：

✅ 适用场景：

  • 商务报告
  • 项目汇报
  • 一般客户演示
  • 需要专业感但不过度正式

✅ 优势：

  • 简洁清晰
  • 数据可视化
  • 专业感强
  • 入门咨询风格

选择"顶级咨询风格（MBB 级）"当：

✅ 适用场景：

  • 面向高管或董事会
  • 战略分析报告
  • 数据密集型内容
  • 高端客户提案
  • 追求极致专业感

✅ 优势：

  • 麦肯锡、贝恩、BCG 级别
  • 5 大核心技巧：
    • 数据情境化（永不孤立呈现）
    • SCQA 框架（叙事结构）
    • 金字塔原则（结论先行）
    • 颜色战略性使用
    • 图表 vs 表格选择矩阵
  • 商业框架导向
  • 符合顶尖咨询行业标准

💬 常用指令模板

开始新项目

我需要创建一份关于[主题]的演示文稿。

源文档内容：
[粘贴或描述你的内容]

💡 提示：Strategist 会主动分析内容并提供以下建议：
- 合理的页数范围
- 目标受众和使用场景的判断
- 推荐的设计风格及理由
- 配色方案（含 HEX 色值）
- 图标使用方式推荐
- 图片使用方式推荐

你可以直接接受建议，也可以提出自己的想法进行讨论。

请求生成页面

请根据设计规范生成第[X]页：[页面主题]
请将SVG保存到：projects/[项目名]_[格式]_[YYYYMMDD]/svg_output/[页码]_[主题].svg

例如: projects/company_report_20251012/svg_output/01_cover.svg

请求修改

第[X]页有以下问题需要调整：
1. [具体问题1]
2. [具体问题2]

请重新生成这一页。

请求优化

请使用CRAP原则优化第[X]页的视觉效果。
重点优化：[对齐/对比/重复/亲密性]
将优化后的文件保存为 yh_slide_[页码]_[主题].svg

自定义配色

请使用我们公司的品牌色作为主导色：
- 主色：#XXXXXX
- 辅助色：#YYYYYY

请基于这些颜色构建完整的配色方案。

🛠️ 常见问题快速解决

问题：代码被截断

解决方案：

代码被截断了，请将SVG分成几个部分发送：
1. 先发送前半部分（到第[X]个元素）
2. 然后发送后半部分

问题：元素重叠

解决方案：

[元素A]和[元素B]重叠了。
请调整[元素B]的Y坐标，向下移动[X]px。

问题：颜色不对

解决方案：

请将[元素描述]的颜色从[#旧颜色]改为[#新颜色]

问题：字体太小/太大

解决方案：

[元素描述]的字体太小/太大。
请将字号从[旧大小]px调整为[新大小]px。

问题：布局不平衡

解决方案：

页面左右不平衡，左侧内容太多。
建议：
1. 将部分内容移到右侧
2. 或者调整左右两侧的宽度比例

📐 常用尺寸参考

SVG 画布

宽度: 1280px
高度: 720px
比例: 16:9
viewBox: "0 0 1280 720"

通用灵活风格 - 边距和间距

页面边距: 40-60px
卡片间距: 20-30px
单行卡片高度: 530-600px
双行卡片高度: 265-295px (每行)

咨询风格 - 边距和间距

页面边距: 80px (左右), 60px (上下)
标题区域: 距顶60px
内容区域: 标题下方120px起始

字体大小参考

字号根据内容密度选择，而非设计风格

内容宽松（每页要点少，基准 24px）

H1 页面标题: 60-72px (2.5-3×)
H2 章节标题: 42-48px (1.75-2×)
H3 小节标题: 32-36px (1.3-1.5×)
正文: 24px (1× 基准)
说明文字: 18-20px (0.75-0.85×)

内容密集（每页信息多，基准 18px）

封面标题: 45-54px (2.5-3×)
页面标题: 27-36px (1.5-2×)
章节标题: 22-27px (1.2-1.5×)
正文: 18px (1× 基准)
注释: 14-15px (0.75-0.85×)

🎨 配色速查

咨询风格主导色

德勤蓝:      #0076A8
麦肯锡蓝:    #005587
BCG深蓝:     #003F6C
普华永道橙:  #D04A02
安永黄:      #FFE600

通用色系

/* 数据可视化 */
成功绿:   #4CAF50
警示橙:   #FF9800
警告红:   #F44336
信息蓝:   #2196F3

/* 中性色 */
深灰:     #333333
中灰:     #666666
浅灰:     #999999
极浅灰:   #E0E0E0

📁 文件命名规范

项目文件夹

projects/项目英文名_格式_YYYYMMDD/
或
projects/项目拼音_格式_YYYYMMDD/

例如:
projects/market_analysis_ppt169_20251012/
projects/shichang_fenxi_ppt169_20251012/

重要: 命名格式为 name_format_YYYYMMDD，例如 market_analysis_ppt169_20251012

源文档

source_document.md

设计规范

design_specification.md

SVG 文件

格式: {页码}_{主题}.svg

示例:
01_cover.svg
02_kpi_dashboard.svg
03_market_analysis.svg

优化后的 SVG

格式: yh_{页码}_{主题}.svg

示例:
yh_01_cover.svg
yh_02_kpi_dashboard.svg

🔗 快速链接

💡 专业提示

提高效率

  1. 批量操作: 一次性与 Strategist 确认所有规范
  2. 模板复用: 保存成功的配色和布局方案
  3. 迭代优化: 先完成所有页面，再统一优化
  4. 文档化: 记录每个项目的关键决策

质量保证

  1. 一致性检查: 确保全套幻灯片风格统一
  2. 对比度测试: 确保文字清晰可读
  3. 多设备预览: 在不同屏幕上查看效果
  4. 导出测试: 验证转换为其他格式的效果

协作技巧

  1. 清晰沟通: 提供具体、可操作的反馈
  2. 分步进行: 不要一次性提出太多修改
  3. 保存版本: 重要迭代保存独立版本
  4. 团队共享: 建立团队的设计规范库

⚠️ PPT 兼容性规则

为确保导出 PPT 后效果一致，透明度必须使用标准写法：

❌ 禁止 ✅ 正确
fill="rgba(255,255,255,0.1)" fill="#FFFFFF" fill-opacity="0.1"
<g opacity="0.2">...</g> 每个子元素单独设置透明度
<image opacity="0.3"/> 图片后加遮罩层 <rect fill="背景色" opacity="0.7"/>

📌 记忆口诀：PPT 不认 rgba、不认组透明、不认图片透明、不认 marker

🔧 后处理工具

拆分讲稿

# 将 notes/total.md 拆分为各页独立文件
python3 tools/total_md_split.py <项目路径>

最终化处理

# 修正图片路径、嵌入图标
python3 tools/finalize_svg.py <项目路径>

导出为 PPTX（推荐）

# 基本用法（使用 svg_output）
python3 tools/svg_to_pptx.py <项目路径>

# 指定 SVG 来源目录
python3 tools/svg_to_pptx.py <项目路径> -s output      # svg_output（原始版本）
python3 tools/svg_to_pptx.py <项目路径> -s final       # svg_final（推荐）

# 指定输出文件
python3 tools/svg_to_pptx.py <项目路径> -o presentation.pptx

特点：SVG 以原生矢量格式嵌入，需要 PowerPoint 2016+ 查看。

📌 收藏此页面，随时查阅！