Skip to content

PPT Design Skill 1.3：让 PowerPoint 生成进入可验收的设计交付流程

Pre-release
Pre-release

Choose a tag to compare

View all tags
@sunchaokun sunchaokun released this 03 Sep 03:55
· 49 commits to main since this release
1.3
2348656

我们发布了 PPT Design Skill 1.3。

它不是又一个“输入一句话，吐出几页幻灯片”的包装层，而是一套面向开发者和 AI 编码工具的 PowerPoint 设计交付工作流：先理解需求和受众，再规划页面结构、锁定视觉方向，生成原生可编辑的 PPTX，最后将结果渲染为 PNG 并逐页检查，必要时回到源码或内容继续修订。

为什么需要它？

PPTX 文件成功生成，不代表演示文稿已经完成。真实交付中，问题往往出现在生成之后：

  • 页面有标题和内容，但没有清晰的视觉重心；
  • 信息过多，只能不断缩小字号；
  • 图片被拉伸或裁切不当；
  • 图表和技术图示难以阅读；
  • 每一页都像同一个卡片模板；
  • 代码运行正常，但导出的页面并不适合展示。

PPT Design Skill 将视觉结果纳入交付标准。它要求工作流经过：

需求确认 → 页面结构 → 视觉方向 → 主题锁定
       → 生成可编辑 PPTX → PPTX / PDF / PNG 渲染
       → 逐页视觉检查 → 修订并再次验证 → 交付

这次发布包含什么？

1. 三种生成模式，覆盖从探索到交付

模式 适合场景 特点
Build Mode 客户交付、提案、战略、路演和正式汇报 使用 Python 和公开 API 精确控制页面结构与布局，默认推荐
FreeStyle Mode 快速探索、方向草稿和轻量 PPT 使用 generate_ppt()，通过自然语言 query 或结构化 content 快速生成
VI Build Mode 企业模板、母版和品牌合规 提取模板的设计 DNA，在保留品牌框架的前提下生成新页面

三种模式共享同一套设计原则，但分别服务于不同的控制需求：需要最高构图控制时使用 Build Mode，需要速度时使用 FreeStyle，需要服从现有模板时使用 VI Build Mode。

2. 从“内容生成”升级为“设计决策”

Skill 会要求 AI 在写生成代码前明确：

  • 受众、场景、语言和期望行动；
  • 页面数量与逐页目标；
  • 领域范式，例如技术架构、科研证据、商业叙事或城市策略；
  • 视觉方向、设计 token、页面锚点和信息密度；
  • 图片、模板和可编辑性约束。

主题通过 versioned Theme Lock 固化颜色、字体、网格、间距、组件语言、图片处理和图表语言，让整套 deck 成为一个统一的视觉系统，而不是一组互不相关的页面。

3. 原生可编辑的 PPTX 输出

底层生成由已发布的 pptx-designer Python 包负责；Skill 使用公开 API 组织文本、形状、图表和图示，尽可能保留 PowerPoint 中的独立编辑能力。

同时，仓库不再依赖旧的 ppt_pro_max 实现。生成代码应使用公开的 pptx_designer API，便于审查、修改和重复构建。

4. PNG 视觉验收与迭代修订

每次正式交付都要经过 PPTX → PDF → PNG 渲染。检查不只关注文件是否存在，还会逐页确认：

  • 视觉层级、构图、节奏和留白是否服务于内容；
  • 文字是否溢出、重叠或不可读；
  • 图片比例和裁切是否正确；
  • 图表、流程图和架构图是否能在展示尺寸下阅读；
  • 页面是否满足 brief 中的 MUST、SHOULD 和 NICE_TO_HAVE 条件。

发现问题后，必须回到内容、布局或视觉方向进行修订，并重新渲染检查。技术上“运行成功”不再被当作视觉交付完成的证明。

最快开始

克隆仓库并安装 Skill：

git clone https://github.com/sunchaokun/PPT-Design-Skill.git
cd PPT-Design-Skill

python installer/install.py --platform codex --force
python skill/scripts/check_runtime.py

将 codex 替换为 claude、opencode、deepseek-harness 或 all，即可安装到其他支持的平台。

PPTX 生成需要 Python >=3.10 和 pptx-designer。渲染检查优先使用 Windows 上的 Microsoft PowerPoint；没有 PowerPoint 时，可使用 LibreOffice 和 Poppler 作为后备渲染链：

python installer/install.py --platform codex --force --render-deps

一个最小的 FreeStyle 示例

from pptx_designer import generate_ppt
from pptx_designer.renderer.theme import ThemeComposer

theme = ThemeComposer().compose(style="dark-tech", seed=17)

result = generate_ppt(
    "AI startup investor pitch",
    theme=theme,
    output="output/pitch.pptx",
)

如果需要精确控制每页的坐标、图示和构图，请选择 Build Mode；如果必须保留已有企业模板，请选择 VI Build Mode。

真实案例

仓库包含可下载、可继续编辑的完整案例，覆盖技术系统、基础设施研究、科学证据、建筑文化和城市策略：

这些案例展示的重点不是“脚本能否运行”，而是从设计判断到最终 PNG，再到可编辑 PPTX 的完整交付结果。

适合谁？

如果你正在用 AI 编码工具生成 PowerPoint，并且希望结果能够用于客户、管理层、投资人、研究汇报或正式会议，PPT Design Skill 可以作为一套可复用的设计与验收层。

欢迎通过 GitHub Issues 反馈问题、提交案例，或分享你对页面结构、视觉验收和模板适配的改进建议。

Assets 2
Loading