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): settle media scope and tighten the status vocabulary
hugohe3efe598ec7c9c
diff --git a/docs/roadmap.md b/docs/roadmap.mdindex efeaf264..0f03e483 100644--- a/docs/roadmap.md+++ b/docs/roadmap.md@@ -20,15 +20,16 @@ Today that axis is expressed through four explicit artifact routes: **Generate PA presentation is four layers: what is on the slide, how it is arranged, how it behaves, and how the document itself is structured. The tables below map each layer against what PPT Master does today.-**Read this as a map, not a backlog.** *Bounded by design* and *Not on the path* are settled end states, not unfinished cells — a blank there is a decision, not a debt. Only *Signal-driven* rows are open, and their reasoning lives in [Future directions](#future-directions--signal-driven) rather than being repeated here.+**Read this as a map, not a backlog.** *Bounded by design* and *Asymmetric by design* are settled shapes, not unfinished cells — a blank there is a decision, not a debt. *Not planned* rows say in the row why they are not being worked on. Only *Signal-driven* rows lean open, and their reasoning lives in [Future directions](#future-directions--signal-driven) rather than being repeated here. Positions that have actually been argued out live in [Non-goals](#non-goals); this map describes, it does not adjudicate.| Status | Meaning ||---|---|-| **Systematized** | Has its own authoring contract and checker coverage; actively refined |+| **Systematized** | Has its own authoring contract and validation; actively refined || **Covered** | Works today without a dedicated specification system || **Bounded by design** | Deliberately stops where it stops; the reason is recorded |+| **Asymmetric by design** | Supported on one side only — typically reading or preserving a source deck, but not authoring || **Signal-driven** | Worth doing when real demand shows; not a commitment |-| **Not on the path** | Evaluated and declined — see [Non-goals](#non-goals) |+| **Not planned** | Not being considered right now; the reason is in the row |### Layer 1 — Visible objects@@ -43,10 +44,11 @@ A presentation is four layers: what is on the slide, how it is arranged, how it| Charts | Systematized | Dedicated authoring reference; SVG by default, native Chart replacement available as an explicit opt-in || Tables | Systematized | Dedicated authoring reference; six cell-grid grammars, native Table replacement on the same opt-in || Diagrams | Systematized | Six relationship atoms — `order`, `link`, `parent`, `membership`, `contrast`, `overlap` |-| Formulas | Implemented | Standalone block formulas and same-paragraph inline formulas compile from a strict LaTeX subset to editable PowerPoint OMML; SVG previews are authoring-only and no formula image fallback is emitted. PowerPoint 2010+ is supported; non-PowerPoint clients are outside the contract |-| Audio & video | Covered / Signal-driven | Narration audio embeds per slide today; arbitrary video, background music, and media compression are planned modules in the Enhance route |+| Formulas | Systematized | Standalone block formulas and same-paragraph inline formulas compile from a strict LaTeX subset to editable PowerPoint OMML; SVG previews are authoring-only and no formula image fallback is emitted. PowerPoint 2010+ is supported; non-PowerPoint clients are outside the contract |+| Narration & animation audio | Systematized | Per-slide narration audio, plus native transition and object sounds drawn from the bundled CC0 catalog |+| Arbitrary video & background music | Not planned | A one-off, content-specific insert that is faster to place by hand in PowerPoint, and the AI cannot pick the file for you. Background music additionally pulls in narration-mixing decisions that are out of scope. Media already present in a source deck is preserved unchanged through the Fill and Enhance routes || SmartArt | Asymmetric by design | Source diagram parts are read for their content and structure; generated decks redraw that content through the ordinary shape pipeline. DiagramML is never edited and native SmartArt regeneration is not promised |-| 3D models, OLE objects | Signal-driven | No read or authoring path today |+| 3D models, OLE objects | Not planned | Both need the host application or a recent Office build on the opening machine and fall back to a still preview elsewhere — the cross-renderer problem this project avoids by design. Inserting one by hand takes seconds. Objects already present in a source deck are preserved unchanged |*Illustration* is deliberately absent from this table. It is a composite result — an image, an SVG, or a group of shapes — not a seventh carrier, and listing it beside *Images* would reintroduce the category confusion this layering removes.@@ -69,9 +71,9 @@ A presentation is four layers: what is on the slide, how it is arranged, how it| Page transitions | Systematized | Includes on-demand transition sounds from a bundled CC0 catalog || Object animation | Systematized | Off by default and opt-in; per-object configuration is explicit || Auto-advance | Covered | Derived from narration lead-in, audio duration, and page-tail padding |-| Media playback | Covered | Narration audio; arbitrary embedded media follows the Layer 1 row above |+| Media playback | Covered | Narration audio and animation sounds play natively; media already present in a source deck keeps its playback settings || Hyperlinks | Systematized | Whole-object and inline-text links author through standard SVG `<a href>`, export as native external or same-deck click relationships, and reconstruct on supported PPTX import |-| Actions & navigation | Bounded by design | An `actionButton*` preset maps visual geometry only — preset appearance never invents action behavior or navigation targets |+| Actions & navigation | Systematized | Navigation is authored explicitly by wrapping the target in a hyperlink anchor, including same-deck slide jumps. An `actionButton*` preset contributes visual geometry only — appearance alone never implies an action. Mouse-over triggers, custom shows, macro or program execution, and raw `ppaction://` injection stay outside the contract |### Layer 4 — Document structure@@ -85,7 +87,7 @@ A presentation is four layers: what is on the slide, how it is arranged, how it| Subtitles | Systematized | Word-timed regrouping across supported providers into shared compact SRT || Document metadata | Covered | Set at export rather than left to the packaging library || Accessibility (alt text, reading order) | Signal-driven | Image manifests already carry `alt_text`, but it is not yet written to DrawingML `descr` — this is wiring, not a missing specification |-| Comments, revisions, collaboration state | Not on the path | Office collaboration surface, outside the authoring product |+| Comments, revisions, collaboration state | Not planned | Office collaboration surface, outside the authoring product |---@@ -120,6 +122,7 @@ One line per month. Full detail lives in the [release notes](https://github.com/| 2026-05 | **Visual editing + AI-image systematization** — Live Preview with deterministic in-place editing (built on [@WodenJay](https://github.com/WodenJay)'s [PR #85](https://github.com/hugohe3/ppt-master/pull/85)), template workspaces from PPTX, the rendering × palette × type image system, and the legacy raster LaTeX renderer || 2026-06 | **Mode & visual-style dual catalogs + intake expansion** — 5 narrative modes × 18 visual styles (+ `custom`), content-faithful beautify profile, multi-deck intake, spot-illustration pipeline, web-image quality gates, source-conversion fidelity gains (caption recognition from [@suay1113](https://github.com/suay1113)'s [PR #191](https://github.com/hugohe3/ppt-master/pull/191), hyperlink preservation distilled from [@ZhaoZuohong](https://github.com/ZhaoZuohong)'s [PR #155](https://github.com/hugohe3/ppt-master/pull/155)) || 2026-07 | **Positioning charter + native masters & layouts + token efficiency** ([v4.0.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.0.0)) — three-pass staged confirmation UI, real `p:sldMaster` / `p:sldLayout` export, `--native-charts-and-tables` opt-in, motion-export hardening, chart template library compacted |+| 2026-08 | **Template library + page-image reconstruction + native math and links** ([v4.5.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.5.0), [v4.6.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.6.0)) — brand / style / layout workspace library, visualizations split by information model with structure as a composition grammar, the Codex-supported `image-to-pptx` profile, video delivery carrying native animation sound, three editable whole-solution design directions, editable OMML formulas, native hyperlink authoring, and the four-layer coverage map |---diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.mdindex e33346c0..57611f28 100644--- a/docs/zh/roadmap.md+++ b/docs/zh/roadmap.md@@ -20,15 +20,16 @@一份演示文稿由四层构成:页面上有什么、如何组织、如何行动、文档自身如何结构化。下面的表把每一层与 PPT Master 今天的实现对应起来。-**这是地图,不是待办清单。**「有意边界」与「不做」是**终态**而非未完成的格子——那里的空白是决定,不是欠账。只有「信号驱动」的行是开放的,其理由留在下面的[未来方向](#未来方向信号驱动)一节,不在此重复。+**这是地图,不是待办清单。**「有意边界」与「有意的不对称」是**已定形态**而非未完成的格子——那里的空白是决定,不是欠账。「暂不考虑」的行会在该行内写明为什么现在不做。只有「信号驱动」的行偏开放,其理由留在下面的[未来方向](#未来方向信号驱动)一节,不在此重复。真正被论证过的立场放在 [Non-goals](#明确不做non-goals);这张地图只描述,不做裁决。| 状态 | 含义 ||---|---|-| **系统化** | 有专属创作契约与 checker 覆盖,持续打磨中 |+| **系统化** | 有专属创作契约与校验把关,持续打磨中 || **已覆盖** | 今天可用,但没有专门的规范体系 || **有意边界** | 有意停在这里,理由已记录在案 |+| **有意的不对称** | 只支持单侧——通常是读取或保留来源 deck,而不创作 || **信号驱动** | 真实需求出现时值得做,不构成承诺 |-| **不做** | 已评估并决定不做,见 [Non-goals](#明确不做non-goals) |+| **暂不考虑** | 当前不在考虑范围,理由写在该行内 |### 第一层 — 可见对象@@ -43,10 +44,11 @@| 图表 | 系统化 | 有专属创作 reference;默认 SVG,原生 Chart 替换为显式 opt-in || 表格 | 系统化 | 有专属创作 reference;六种单元格网格语法,原生 Table 替换走同一 opt-in || 关系图 | 系统化 | 六个关系原子——`order`、`link`、`parent`、`membership`、`contrast`、`overlap` |-| 公式 | 已实现 | 独立块级公式与同段行内公式都可从严格 LaTeX 子集编译为可编辑 PowerPoint OMML;SVG 预览仅供创作阶段使用,不生成公式图片兜底。支持 PowerPoint 2010+,非 PowerPoint 客户端不在合同内 |-| 音视频 | 已覆盖 / 信号驱动 | 旁白音频今天逐页嵌入;任意视频、背景音乐与媒体压缩是 Enhance 路线中的 planned 模块 |+| 公式 | 系统化 | 独立块级公式与同段行内公式都可从严格 LaTeX 子集编译为可编辑 PowerPoint OMML;SVG 预览仅供创作阶段使用,不生成公式图片兜底。支持 PowerPoint 2010+,非 PowerPoint 客户端不在合同内 |+| 旁白与动画音效 | 系统化 | 逐页旁白音频,以及取自内置 CC0 音效库的原生转场与对象音效 |+| 任意视频与背景音乐 | 暂不考虑 | 属于一次性、内容特定的插入动作,在 PowerPoint 里手动放进去更快,AI 也无法替你挑文件。背景音乐还会牵出旁白混音决策,那在范围之外。来源 deck 中已有的媒体在 Fill 与 Enhance 路线中原样保留 || SmartArt | 有意的不对称 | 读取来源 diagram part 的内容与结构;生成 deck 用普通形状管线把这些内容重画出来。从不编辑 DiagramML,也不承诺原生 SmartArt 再生 |-| 3D 模型、OLE 对象 | 信号驱动 | 目前既无读取路径也无创作路径 |+| 3D 模型、OLE 对象 | 暂不考虑 | 两者都要求打开文件的机器装有宿主程序或较新版 Office,否则退化成一张静态预览图——正是本项目有意规避的跨渲染器问题。手动插入只要几秒。来源 deck 中已有的对象原样保留 |**插图**有意不列进这张表。它是复合结果——一张图片、一段 SVG,或一组形状——而不是第七种载体;把它与「图片」并列,会重新引入这套分层正要消除的维度混淆。@@ -69,9 +71,9 @@| 页面转场 | 系统化 | 含来自内置 CC0 音效库的按需转场音 || 对象动画 | 系统化 | 默认关闭、opt-in;逐对象配置为显式声明 || 自动翻页 | 已覆盖 | 由旁白起始留白、音频时长与页尾补白推导 |-| 音视频播放 | 已覆盖 | 旁白音频;任意嵌入媒体见第一层对应行 |+| 音视频播放 | 已覆盖 | 旁白音频与动画音效原生播放;来源 deck 中已有的媒体保留其播放设置 || 超链接 | 系统化 | 整体对象与行内文字通过标准 SVG `<a href>` 创作,导出为原生外链或 deck 内跳转关系,并在受支持的 PPTX 回导中重建 |-| 动作与导航 | 有意边界 | `actionButton*` 预设只映射视觉几何——预设外观绝不凭空发明动作行为或导航目标 |+| 动作与导航 | 系统化 | 导航通过把目标包进超链接锚点显式创作,含 deck 内跳到指定页。`actionButton*` 预设只贡献视觉几何——光有外观绝不隐含动作。鼠标悬停触发、自定义放映、宏或程序执行、以及裸 `ppaction://` 注入都在契约之外 |### 第四层 — 文档结构@@ -85,7 +87,7 @@| 字幕 | 系统化 | 受支持 provider 的逐词时间轴重组为统一的紧凑 SRT || 文档元数据 | 已覆盖 | 在导出时设定,而非交给打包库默认生成 || 无障碍信息(Alt Text、阅读顺序) | 信号驱动 | 图片 manifest 里已有 `alt_text`,但尚未写入 DrawingML `descr`——这是一段接线,不是缺一套规范 |-| 评论、修订、协作状态 | 不做 | 属于 Office 协作面,在创作型产品之外 |+| 评论、修订、协作状态 | 暂不考虑 | 属于 Office 协作面,在创作型产品之外 |---@@ -120,6 +122,7 @@| 2026-05 | **可视化编辑 + AI 图片体系化** — Live Preview 确定性原位编辑(基于 [@WodenJay](https://github.com/WodenJay) 的 [PR #85](https://github.com/hugohe3/ppt-master/pull/85))、从 PPTX 创建模板工作区、rendering × palette × type 图片体系、旧版栅格 LaTeX 渲染器 || 2026-06 | **mode 与 visual-style 双 catalog + intake 扩展** — 5 种叙事 mode × 18 种视觉风格(+ `custom`)、内容忠实的美化 profile、多 deck 合并 intake、插画切片管线、网络图片质量闸门、源转换保真提升(图注识别基于 [@suay1113](https://github.com/suay1113) 的 [PR #191](https://github.com/hugohe3/ppt-master/pull/191),超链接保留提炼自 [@ZhaoZuohong](https://github.com/ZhaoZuohong) 的 [PR #155](https://github.com/hugohe3/ppt-master/pull/155)) || 2026-07 | **定位章程 + 原生母版 / 版式 + token 效率**([v4.0.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.0.0))— 三段式分步确认 UI、真 `p:sldMaster` / `p:sldLayout` 导出、`--native-charts-and-tables` opt-in、动效导出加固、图表模板库压缩 |+| 2026-08 | **模板库 + 页面图重建 + 原生公式与链接**([v4.5.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.5.0)、[v4.6.0](https://github.com/hugohe3/ppt-master/releases/tag/v4.6.0))— brand / style / layout 工作区库、可视化按信息模型拆分且结构改为组合语法、Codex 支持的 `image-to-pptx` profile、带原生动画音效的视频交付、三条可编辑整体设计方向、可编辑 OMML 公式、原生超链接创作,以及四层能力覆盖地图 |---diff --git a/skills/ppt-master/references/shared-standards-core.md b/skills/ppt-master/references/shared-standards-core.mdindex 83cb7327..25b402dc 100644--- a/skills/ppt-master/references/shared-standards-core.md+++ b/skills/ppt-master/references/shared-standards-core.md@@ -472,7 +472,8 @@ as a grouped editable text box. Authoring v1 creates only unconnected`p:cxnSp`; it does not accept hand-written endpoint/site metadata. An`actionButton*` preset maps visual geometry only. Preset appearance neverinvents connector attachment, action behavior, navigation targets, or-hyperlinks.+hyperlinks. Link and navigation behavior is authored explicitly instead — see+[`native-hyperlinks.md`](./native-hyperlinks.md).---diff --git a/skills/ppt-master/workflows/native-enhance-pptx.md b/skills/ppt-master/workflows/native-enhance-pptx.mdindex b4283953..b34ce9ed 100644--- a/skills/ppt-master/workflows/native-enhance-pptx.md+++ b/skills/ppt-master/workflows/native-enhance-pptx.md@@ -54,7 +54,7 @@ source.pptx| `narration.timings` | Enabled | Set narrated slides to auto-advance from page-start lead-in, audio duration, and page-tail padding || `narration.transitions` | Enabled | Add page-level transitions for narrated/selected slides || `delivery.check` | Enabled | Read-only package/font/media/hidden-slide/file-size and existing-motion audit |-| `media` | Planned | Background music, video, media compression |+| `delivery.compress` | Planned | Reduce embedded media size for oversized packages; the audit above already reports them || `presenter` | Planned | Q&A notes, speaker cues, rehearsal artifacts || `animation` | Planned | Explicit object-level animation only || `visible-stamp` | Planned | Watermark/footer/logo; requires explicit confirmation |