Skip to content

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(roadmap): record v3.0 staged confirmation UI + native chart/table maturation

hugohe3777e3abddbc2
diff --git a/docs/roadmap.md b/docs/roadmap.md
index d810b000..bde1bc9a 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -76,6 +76,12 @@ The past two months' structural capability growth. Single flags / incremental po
- **Native PPTX export caps image media size** — keep generated decks editable without embedding huge source images: new native image sizing modes — `cap` (default) limits only oversized source images to a max dimension, while `display` sizes from the rendered SVG box for more aggressive compression; native export preserves full embedded pixels while SVG/PPT display cropping stays as editable picture-crop metadata; `finalize_svg` keeps its existing slice/meet behavior and adds default rendered-size downsampling for compact SVG snapshots. Docs land the `cap` / `display` modes and the `--no-image-optimize` escape hatch
+### 2026-07 — Staged confirmation UI + native chart / table maturation
+
+- **Step 4 confirmation gate restaged into a three-pass wizard + visual previews** — the single Eight-Confirmations gate became a three-stage flow in one browser session (direction anchors → design system → images / execution), each downstream stage re-derived from the user's **actual** confirmed upstream choices instead of the AI's originals — so, e.g., the image strategy fits the confirmed color system by construction. The confirm page adds visual aids for the hard-to-name picks: a bespoke real-SVG page thumbnail for each of the 18 `visual_style` options, real icon-library samples, and AI-image reference previews. `recommendations.json` now carries a canonical `stage` selector (`tier` retained only as an internal back-compat read) and user-facing wording is unified on "stage"; the chat fallback mirrors the same staged order
+
+- **`--native-objects` hardened from dormant marker to production-quality opt-in** — the narrow native-object exception (see Non-goals below) now emits charts and pure-text tables that keep the deck's own design instead of snapping to PowerPoint's white default theme. Classic native charts write explicit chart-area / plot-area / axis-line / gridline / label-text colors — inferred from the visible SVG fallback (largest panel `<rect>` → background, fallback text → labels, fallback strokes → axis/grid) or overridden per `style` (`chart_area_fill` / `plot_area_fill` / `text_color` / `axis_color` / `grid_color`, `"none"` for transparent); the color parser normalizes named CSS colors, `#RGB` shorthand, and `rgb()` / `rgba()` to OOXML hex; bar/column series disable negative-value fill inversion so negative bars keep their series color. The activated export is named `<name>_<ts>_native_charts.pptx` to tell it apart from the default flattened-shape export. **The default route is unchanged** — charts/tables still export as SVG-derived DrawingML shapes for cross-renderer fidelity; native objects stay the deliberate opt-in trade documented under Non-goals below
+
---
## In progress / Next
@@ -116,7 +122,7 @@ PPT Master's main route is "AI generates SVG from scratch → DrawingML", with t
Pixel-fidelity across the four renderers (PowerPoint / Keynote / LibreOffice / WPS) is the project's spine. Switching the default route to native PowerPoint charts breaks that — the same PPTX renders different chart layouts across renderers. Charts as SVG is **by design**, not a capability gap.
-The narrow exception is the `data-pptx-native` marker: supported data charts and pure text-grid tables carry dormant native-object metadata at generation time, and exporting with `--native-objects` activates it for users who deliberately trade cross-renderer fidelity for PowerPoint-side editability on those objects. The default export path and the SVG chart/table system are unchanged.
+The narrow exception is the `data-pptx-native` marker: supported data charts and pure text-grid tables carry native-object metadata at generation time, and exporting with `--native-objects` activates it for users who deliberately trade cross-renderer fidelity for PowerPoint-side editability on those objects — the activated objects now preserve the deck's chart-area / plot / axis / gridline / label colors and native table formatting rather than snapping to PowerPoint's default theme (see 2026-07 above). The default export path and the SVG chart/table system are unchanged.
### uv as default / required dependency
diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.md
index ce8a9411..69d758d2 100644
--- a/docs/zh/roadmap.md
+++ b/docs/zh/roadmap.md
@@ -76,6 +76,12 @@
- **原生 PPTX 导出图片媒体大小封顶** — 保持生成 deck 可编辑、不嵌入巨幅源图:新增原生图片尺寸模式——`cap`(默认)只对超大源图限制最大边长,`display` 按渲染 SVG 框尺寸做更激进压缩;原生导出保留完整嵌入像素,SVG/PPT 显示裁剪仍走可编辑的 picture-crop 元数据;`finalize_svg` 保留原有 slice/meet 行为,另加默认按渲染尺寸下采样以产出紧凑 SVG 快照。文档落地 `cap` / `display` 两模式与 `--no-image-optimize` 逃生舱
+### 2026-07(分阶段确认 UI + 原生图表 / 表格成熟)
+
+- **Step 4 确认 gate 重构为三阶段向导 + 可视化预览** — 原来单次「八项确认」gate 拆成一个浏览器会话内的三阶段流程(方向锚点 → 设计系统 → 图片 / 执行方式),每个下游阶段都从用户**实际已确认**的上游选择重新推导,而非 AI 原始推荐——于是图片策略天然吻合已确认的配色系统。确认页为难以凭名字判断的选项补上视觉辅助:18 个 `visual_style` 每个一张专属 real-SVG 页面缩略图、真实图标库样本、AI 图参考图预览。`recommendations.json` 改用规范的 `stage` 选择器(`tier` 仅作内部向后兼容读取),用户可见措辞统一为「阶段」;聊天 fallback 镜像同样的分阶段顺序
+
+- **`--native-objects` 从休眠 marker 硬化为可用级 opt-in** — 那条窄「原生对象」例外(见下文 Non-goals)现在导出的图表与纯文本表格会**保留 deck 自己的设计**,不再塌回 PowerPoint 的白底默认主题。classic 原生图表显式写入 chart-area / plot-area / 轴线 / 网格线 / 标签文字颜色——从可见的 SVG fallback 推断(最大面板型 `<rect>` → 背景、fallback 文字 → 标签、fallback 描边 → 轴线/网格),或用 `style` 显式覆盖(`chart_area_fill` / `plot_area_fill` / `text_color` / `axis_color` / `grid_color`,`"none"` 表透明);颜色解析把命名色、`#RGB` 简写、`rgb()` / `rgba()` 归一为 OOXML hex;bar/column 系列关掉负值反色,负值柱保持系列色。激活导出命名为 `<name>_<ts>_native_charts.pptx` 以与默认压平形状导出区分。**默认路线不变**——图表/表格仍以 SVG 派生的 DrawingML 形状导出以保跨渲染器保真;原生对象仍是下文 Non-goals 里那条刻意的 opt-in 取舍
+
---
## 进行中 / 下一步
@@ -116,7 +122,7 @@ PPT Master 主路线是「AI 从零生成 SVG → DrawingML」,整条管线围
跨四渲染器(PowerPoint / Keynote / LibreOffice / WPS)的位置保真是项目主轴。把默认路线改成 PowerPoint 原生图表会让「像素级一致性」破功——同一个 PPTX 在不同渲染器里图表会显示不同布局。图表默认用 SVG 是 **by design**,不是能力缺失。
-窄例外是 `data-pptx-native` marker:受支持的数据图表与纯文本网格表格在生成时默认携带休眠的原生对象元数据,导出加 `--native-objects` 才激活——供主动用跨渲染器保真换取 PowerPoint 内可编辑性的用户使用。默认导出路径与 SVG 图表 / 表格系统不变。
+窄例外是 `data-pptx-native` marker:受支持的数据图表与纯文本网格表格在生成时携带原生对象元数据,导出加 `--native-objects` 才激活——供主动用跨渲染器保真换取 PowerPoint 内可编辑性的用户使用;激活后的对象现在会保留 deck 的 chart-area / plot / 轴线 / 网格线 / 标签颜色与原生表格格式,不再塌回 PowerPoint 默认主题(见上文 2026-07)。默认导出路径与 SVG 图表 / 表格系统不变。
### uv 作为默认 / 必需依赖