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(live-preview): document direct editing (L1/L2/L3) across guides

hugohe3f92a635c757d
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 006fcb11..47b6f341 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -62,8 +62,8 @@ Before it starts, the AI confirms a short design spec (template, format, page co
A browser preview opens at `http://localhost:5050` while the deck is being generated.
- **Watch pages render live** as the AI produces them.
-- **Click any element**, type what you want changed, and hit **Submit annotations**.
-- **Back in chat, say "apply my annotations"** — the AI rewrites that SVG and re-exports the PPTX.
+- **Edit directly, no AI** — select an element to change its text, color, font, or size in the side panel; drag it to reposition, or nudge with the arrow keys (`Shift` = 10px). `Ctrl+Z` undoes. Edits preview instantly and write to `svg_output/` when you click **Apply changes**.
+- **Or annotate for the AI** — click an element, type what you want changed, hit **Submit annotations**, then say "apply my annotations" in chat and the AI rewrites that region and re-exports the PPTX.
PPT Master was chat-only by design; visual editing was folded in after enough users asked for it (built on [@WodenJay](https://github.com/WodenJay)'s [PR #85](https://github.com/hugohe3/ppt-master/pull/85)).
diff --git a/docs/roadmap.md b/docs/roadmap.md
index 08f80eb6..a9f194d2 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -42,6 +42,7 @@ The past two months' structural capability growth. Single flags / incremental po
- **Template architecture: three-kind consolidation** ([`docs/templates-architecture.md`](./templates-architecture.md)) — brand / layout / deck split into three independent dirs with per-kind schemas + segment-level fusion + git-style conflict resolution; SKILL.md Step 3 dispatches per `kind`, trigger rule remains "explicit path only"
- **Pattern fill PPTX safety net** — `svg_quality_checker.py` now warns on `<pattern>` without `data-pptx-pattern` (silent fallback to `ltUpDiag`) and errors on values outside OOXML `ST_PresetPatternVal` (schema-failed PPTX that won't open); `shared-standards.md §7` documents the closed preset enum and the required `<rect fill="<bg>"/>` child convention
- **LaTeX math formula rendering shipped** ([`scripts/latex_render.py`](../skills/ppt-master/scripts/latex_render.py)) — Strategist locks one of three policies (`mixed` / `render-all` / `text-only`) inside the Typography confirmation and writes an explicit `images/formula_manifest.json`; the renderer walks a codecogs → quicklatex → mathpad → wikimedia fallback chain and emits transparent PNGs that land in §VIII as `Acquire Via: formula` / `Status: Rendered` rows; formula-heavy decks (academic / engineering / educational) finally have a native rendering route. Formula selection is a Strategist decision — the renderer never scans source files for `$...$` markers
+- **Live preview direct editing — L1 / L2 / L3** ([`workflows/live-preview.md`](../skills/ppt-master/workflows/live-preview.md)) — the browser editor gains deterministic in-place edits with no AI round-trip: text content (L1), presentation attributes like fill / stroke / font-size (L2), and on-canvas geometry (L3) — drag a selected element to move it, arrow-key nudge (`Shift` = 10px), multi-select, plus a right-click overlap picker for stacked shapes. Edits stage with `Ctrl+Z` undo + coalescing and write to `svg_output/` on **Apply changes**; moves persist through finalize / export (moved text frames, promoted multi-line tspans, repositioned icons all reproduce in the PPTX). Re-export stays chat-driven; on-canvas resize handles are not yet implemented (resize via the geometry inputs)
---
diff --git a/docs/why-ppt-master.md b/docs/why-ppt-master.md
index f5a81353..c7aa49cb 100644
--- a/docs/why-ppt-master.md
+++ b/docs/why-ppt-master.md
@@ -81,7 +81,7 @@ Being honest about limitations:
| **Setup required** | Install Python, clone repo, configure AI editor. Not a "open browser and go" experience. |
| **Slower generation** | 10–20 min for a 10-page deck (serial page-by-page for cross-slide consistency). SaaS tools take seconds. |
| **No collaboration** | Local files, no real-time co-editing, no share links. |
-| **No free-form canvas editor** | A browser preview with click-to-annotate (Flask live preview) is provided, but edits are still applied by the AI to the source SVG — no Gamma/Canva-style drag-and-drop canvas. |
+| **No full freeform canvas** | The browser live preview supports direct edits — select to change text/color/font/size, drag or arrow-key to reposition, with undo — plus click-to-annotate for AI rewrites. What it isn't is a full Gamma/Canva-style freeform canvas: no on-canvas resize handles, and re-exporting to PPTX stays a chat step. |
**If you want zero-setup, instant slides in a browser** — Gamma and Canva are excellent choices.
diff --git a/docs/zh/getting-started.md b/docs/zh/getting-started.md
index df676445..fd6a4a94 100644
--- a/docs/zh/getting-started.md
+++ b/docs/zh/getting-started.md
@@ -62,8 +62,8 @@
生成过程中会自动打开浏览器预览 `http://localhost:5050`。
- **实时看着每页渲染**出来。
-- **点选任意元素**,写一句要改成什么,点 **Submit annotations**。
-- **回到对话说一句"应用注解"(或 "apply my annotations")** —— AI 会改写那页 SVG 并重新导出 PPTX。
+- **直接改,无需 AI** —— 选中元素后在右栏改文字、颜色、字体、字号;拖拽即可移动,或用方向键微调(`Shift` = 10px),`Ctrl+Z` 撤销。改动即时预览,点 **Apply changes** 写回 `svg_output/`。
+- **或写注解交给 AI** —— 点选元素写一句要改成什么,点 **Submit annotations**,再回对话说"应用注解"(或 "apply my annotations"),AI 会改写那块区域并重新导出 PPTX。
PPT Master 最初是纯对话设计;可视化编辑是在很多用户提出后融入的(建立在 [@WodenJay](https://github.com/WodenJay) 的 [PR #85](https://github.com/hugohe3/ppt-master/pull/85) 之上)。
diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.md
index 1db23ec1..a7b901d3 100644
--- a/docs/zh/roadmap.md
+++ b/docs/zh/roadmap.md
@@ -42,6 +42,7 @@
- **Template 架构三分类收口**([`docs/zh/templates-architecture.md`](./templates-architecture.md)) — brand / layout / deck 三独立目录 + 每类独立 schema + 段级合成 + git-style 冲突解决;SKILL.md Step 3 按 kind 分支处理,触发规则仍是「显式路径才触发」
- **Pattern 填充 PPTX 安全网** — `svg_quality_checker.py` 现在对未标 `data-pptx-pattern` 的 `<pattern>` 元素发 warning(会静默回退 `ltUpDiag` 斜纹)、对超出 OOXML `ST_PresetPatternVal` 枚举的值发 error(schema 校验失败 PPT 无法打开);`shared-standards.md §7` 落地了完整 preset 清单和 `<rect fill="<bg>"/>` 子元素约定
- **LaTeX 数学公式渲染上线**([`scripts/latex_render.py`](../../skills/ppt-master/scripts/latex_render.py)) — Strategist 在 Typography 确认中锁定 `mixed` / `render-all` / `text-only` 三档策略,显式写 `images/formula_manifest.json`;脚本走 codecogs → quicklatex → mathpad → wikimedia 四源 fallback chain,输出透明 PNG 进 §VIII 表的 `Acquire Via: formula` / `Status: Rendered` 行;公式密集型 deck(学术 / 工程 / 教学)首次拥有原生渲染路径,规则面禁止扫源文件 `$...$` 自动渲染(公式选取是 Strategist 决策)
+- **实时预览直接编辑 — L1 / L2 / L3**([`workflows/live-preview.md`](../../skills/ppt-master/workflows/live-preview.md)) — 浏览器编辑器新增无需 AI 往返的确定性就地编辑:文字内容(L1)、fill / stroke / font-size 等样式属性(L2)、以及画布上的几何操作(L3)——在选中元素上拖拽即移动、方向键微调(`Shift` = 10px)、多选、加右键重叠选择器选取堆叠元素。编辑支持 `Ctrl+Z` 撤销 + 合并,点 **Apply changes** 写回 `svg_output/`;移动经 finalize / 导出保位(移动的 text、提升的多行 tspan、重定位的 icon 都在 PPTX 中如实再现)。重新导出仍由对话触发;画布上的缩放手柄尚未实现(缩放走几何输入框)
---
diff --git a/docs/zh/why-ppt-master.md b/docs/zh/why-ppt-master.md
index 6a7cfb8a..6d443e30 100644
--- a/docs/zh/why-ppt-master.md
+++ b/docs/zh/why-ppt-master.md
@@ -81,7 +81,7 @@ PPT Master 是一个框架,不是某个 IDE 的插件。**编辑器方面**,
| **需要配置** | 安装 Python、克隆仓库、配置 AI 编辑器。不是打开浏览器就能用的体验。 |
| **生成较慢** | 10 页约 10–20 分钟(逐页串行保证跨页一致性)。SaaS 工具只需几秒。 |
| **无协作功能** | 本地文件,无实时共编,无分享链接。 |
-| **无自由画布编辑** | 提供浏览器预览 + 点选注解(Flask live preview),但修改仍由 AI 在源 SVG 上完成——没有 Gamma/Canva 式的拖拽画布。 |
+| **非完整自由画布** | 浏览器实时预览支持直接编辑——选中改文字/颜色/字体/字号,拖拽或方向键移动,可撤销——也保留点选注解交给 AI 改写。它不是 Gamma/Canva 那种完整自由画布:画布上没有缩放手柄,重新导出 PPTX 仍由对话触发。 |
**如果你要零配置、浏览器里秒出幻灯片**——Gamma 和 Canva 是很好的选择。