AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
docs: surface quick generation in README and Windows smoke test
hugohe39052355a365c
diff --git a/README.md b/README.mdindex 027e0d09..3cf2c8a1 100644--- a/README.md+++ b/README.md@@ -316,6 +316,14 @@ AI: Sure. Let's confirm the design spec:The AI handles everything — content analysis, visual design, SVG generation, and PPTX export.+**Quick generation (skip the confirmation round trip):** say so explicitly and the AI goes straight to authoring and export.++```+You: Quickly generate a 5-page deck from projects/q3-report/sources/report.pdf — no need to confirm with me+```++Whatever you state explicitly is followed; whatever you leave unspecified the agent decides on its own instead of asking. It still converts sources, fills factual gaps, and prepares images/icons/formulas — it drops the strategy and confirmation phase, not the material. There is no `svg_final/` preview in this mode. Full guide → [Quick mode](./docs/getting-started.md#quick-mode).+> **Output:** The SVG pipeline has one PPTX converter: it reads `svg_output/` and writes a directly editable native DrawingML deck to `exports/<name>_<timestamp>.pptx`. The default Generate flow runs `finalize_svg.py` and produces self-contained previews in `svg_final/`; PowerPoint's manual **Convert to Shape** command is outside the supported contract. Explicit [quick generation](./skills/ppt-master/workflows/profiles/quick-generate.md) skips the Strategist analysis and the confirmation stage: whatever you state explicitly is followed, and whatever you leave unspecified the agent decides directly instead of asking. It still converts sources, researches factual gaps, and prepares required images, icons, formulas, and resource manifests when needed, skips `design_spec.md`, `spec_lock.md`, and `finalize_svg.py`, then hand-authors the SVG pages, passes the lockless Quick final quality check, and exports the final PPTX. Ordinary export capabilities remain available as needed, including native chart/table replacement, notes, motion, narration, and diagnostics; notes, custom object animation, and narration start off, and the agent may enable them when the request or deck needs them. A default-path Quick export writes the normal postflight report and snapshots `svg_output/` to `backup/<timestamp>/svg_output/`; an explicit output path keeps the ordinary no-backup behavior. By default charts and tables export as individually editable SVG-derived DrawingML shapes, which prioritize cross-app visual consistency. Pass `--native-charts-and-tables` to replace eligible groups with PowerPoint-native Chart/Table objects backed by data, which provide **Edit Data** and object-specific controls but may render differently across apps; this variant is saved as `exports/<name>_<timestamp>_native_charts_tables.pptx`. Both chart/table export variants are editable—the distinction is the PowerPoint object model, not editability itself.> **Already have a `.pptx` you want to reuse?** Hand the AI that deck plus your material and ask it to "fill this deck with the new content" — it fills text, table, and chart data into your existing design and exports only the pages you pick, staying natively editable. See the [FAQ](./docs/faq.md) and [template-fill workflow](./skills/ppt-master/workflows/template-fill-pptx.md).diff --git a/README_CN.md b/README_CN.mdindex 93e1a699..5aa6b6ec 100644--- a/README_CN.md+++ b/README_CN.md@@ -325,6 +325,14 @@ AI:好的,先确认设计规范:AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。+**快速生成(跳过来回确认):** 显式说明即可,AI 直接进入创作与导出。++```+你:用 projects/q3-report/sources/report.pdf 快速生成一份 5 页 PPT,不用跟我确认+```++你明确提的照做,你没提的由 AI 直接定,不再回来问你。它仍会转换来源、补齐事实、准备图片 / 图标 / 公式——省掉的是策略与确认阶段,不是材料本身。这种模式下不会生成 `svg_final/` 预览。完整说明 → [快速模式](./docs/zh/getting-started.md#快速模式)。+> **输出说明:** SVG 管线统一由项目转换器读取 `svg_output/`,生成可直接编辑的原生 DrawingML `.pptx`,保存至 `exports/<name>_<timestamp>.pptx`。默认 Generate 流程会运行 `finalize_svg.py` 并生成自包含预览 `svg_final/`;PowerPoint 手工“转换为形状”不在支持范围。用户可显式启用[快速生成](./skills/ppt-master/workflows/profiles/quick-generate.md):它跳过策略师分析与确认阶段——你明确提出的要求照做,你没提的由 Agent 直接决定,不再回来问你;仍按需转换来源、研究事实缺口,并准备图片、图标、公式和资源 manifest,跳过 `design_spec.md`、`spec_lock.md` 与 `finalize_svg.py`,随后按规范手写 SVG,通过无锁的 Quick 最终质量检查,再导出最终 PPTX。原生图表 / 表格替换、讲稿、动效、旁白和诊断等普通导出能力仍可按需使用;讲稿、自定义对象动画和旁白默认关闭,Agent 可在用户要求或 deck 确有需要时启用。Quick 使用默认输出路径时仍会生成普通 postflight 报告,并把 `svg_output/` 镜像到 `backup/<timestamp>/svg_output/`;显式指定输出路径时沿用普通流程不创建备份的行为。图表和表格默认导出为 SVG 派生、可逐形状编辑的 DrawingML 对象,优先保证 PowerPoint / Keynote / WPS 间的视觉一致性;可加 `--native-charts-and-tables`,把符合合同的组替换为带数据源和对象专属编辑能力的 PowerPoint 原生 Chart/Table 对象,跨软件渲染可能略有差异,保存为 `exports/<name>_<timestamp>_native_charts_tables.pptx`。这两种图表/表格导出变体都可编辑,区别在于 PowerPoint 对象模型,而不是“能否编辑”。> **已有一份想复用的 `.pptx`?** 把那份 deck 连同素材给 AI,说「套模板」即可——它会把新内容(文字、表格、图表数据)填进你现有的设计,只导出你挑选的页面,且保持原生可编辑。详见 [常见问题](./docs/zh/faq.md) 与 [套模板工作流](./skills/ppt-master/workflows/template-fill-pptx.md)。diff --git a/docs/windows-installation.md b/docs/windows-installation.mdindex e4760d29..a256ca6c 100644--- a/docs/windows-installation.md+++ b/docs/windows-installation.md@@ -75,15 +75,16 @@ python -c "import pptx; import fitz; print('All core dependencies OK')"Open the `ppt-master` folder in an agent-capable AI tool (Claude Code, Codex, Cursor, a VS Code agent, etc.) and type in the chat:```-Please create a simple 3-page test PPT with a cover, one content page, and a closing page. Topic: "Hello World".+Quickly generate a simple 3-page test PPT with a cover, one content page, and a closing page. Topic: "Hello World". No need to confirm with me.```-After the standard flow finishes, you should see:+Asking for **quick generation** is what keeps this smoke test short: the AI skips the Strategist analysis and the design-confirmation round trips and goes straight to authoring and export. The default flow confirms the design spec with you first, which is what you want for a real deck but slow when all you are checking is that the environment works. Full guide → [Quick mode](./getting-started.md#quick-mode).++When it finishes, you should see:- A native DrawingML `.pptx` under `exports/`, generated from `svg_output/`, that opens in PowerPoint and remains editable element by element.-- A `svg_final/` directory containing self-contained visual-preview SVGs. They may be inserted manually as SVG pictures, but manual "Convert to Shape" is outside the supported contract.-If both are present, **you're done.**+That's the check that matters — if the file is there and opens, **you're done.** Note that quick generation skips `finalize_svg.py`, so there is no `svg_final/` preview directory; the default flow produces one, containing self-contained visual-preview SVGs. They may be inserted manually as SVG pictures, but manual "Convert to Shape" is outside the supported contract.---diff --git a/docs/zh/windows-installation.md b/docs/zh/windows-installation.mdindex f0cb7977..0abff78a 100644--- a/docs/zh/windows-installation.md+++ b/docs/zh/windows-installation.md@@ -78,15 +78,16 @@ python -c "import pptx; import fitz; print('All core dependencies OK')"在支持 Agent 的 AI 工具(Claude Code、Codex、Cursor、VS Code agent 等)中打开 `ppt-master` 目录,在聊天面板输入:```-请创建一个 3 页测试 PPT,封面 + 内容页 + 封底,主题"Hello World"+请快速生成一个 3 页测试 PPT,封面 + 内容页 + 封底,主题"Hello World",不用跟我确认```-标准流程完成后应同时看到:+这里显式要求**快速生成**是关键:AI 会跳过策略师分析和设计确认的来回,直接创作并导出。默认流程会先跟你确认设计规范——做正式 deck 时需要,但只是验证环境能不能跑通时太慢。完整说明 → [快速模式](./getting-started.md#快速模式)。++跑完后应看到:- `exports/` 下出现由项目转换器从 `svg_output/` 生成的原生 DrawingML `.pptx`,并能在 PowerPoint 中打开、逐元素编辑。-- 项目下生成 `svg_final/`,其中是可直接打开的自包含视觉预览 SVG;这些文件也可作为 SVG 图片手动插入 PowerPoint,但手工“转换为形状”不在支持范围。-两项都满足 → **搞定了。**+这一项满足 → **搞定了。** 注意快速生成会跳过 `finalize_svg.py`,因此不会生成 `svg_final/` 预览目录;默认流程才会生成,其中是可直接打开的自包含视觉预览 SVG,也可作为 SVG 图片手动插入 PowerPoint,但手工“转换为形状”不在支持范围。---