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(native-formula): publish the expanded formula support boundary

hugohe36041620f87dc
diff --git a/docs/faq.md b/docs/faq.md
index b64ce8d5..93b1b31c 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -157,9 +157,20 @@ remain blocks. Raw LaTeX does not render in SVG, so each marker carries an
ordinary visible preview that native export replaces without adding an image
fallback.
-The native target is PowerPoint 2010+. Formula display and editability in
-Keynote, WPS, LibreOffice, and other non-PowerPoint clients are not supported;
-PPT Master does not add an image fallback for them.
+Forward compilation covers every explicitly named input in Microsoft's
+documented Microsoft 365 2606 / Mac 16.110 LaTeX profile and 2605 / 16.109
+mhchem profile: symbols, structures, environments, macros, chemistry, local
+formula colors, and the documented native normalizations. Unknown and
+explicitly unsupported input fails closed instead of appearing as raw LaTeX.
+PPT Master does not implement reverse OMML-to-LaTeX build-down.
+
+The generated OMML retains the PowerPoint 2010+ package target, and the
+executable source profile is pinned to the Microsoft documentation versions
+above. Repository verification covers compiler behavior, OMML structure, and
+PPTX packaging rather than complete Microsoft 365 UI rendering/editability
+certification. Formula display and editability in Keynote, WPS, LibreOffice,
+and other non-PowerPoint clients are not supported; PPT Master does not add an
+image fallback for them.
## Q: Can generated slides contain clickable links?
diff --git a/docs/powerpoint-svg-mapping.md b/docs/powerpoint-svg-mapping.md
index 63311832..3ec14821 100644
--- a/docs/powerpoint-svg-mapping.md
+++ b/docs/powerpoint-svg-mapping.md
@@ -211,10 +211,11 @@ The exhaustive chart/table schemas and supported family list intentionally remai
| PowerPoint feature | Project representation | PPTX result | Compatibility | Validation boundary |
|---|---|---|---|---|
-| Editable block equation | One `<g data-pptx-replace-with="formula">` with explicit bounds, source LaTeX in `<metadata type="application/json">`, and visible SVG preview children | PowerPoint text shape containing `a14:m > m:oMathPara > m:oMath` | PowerPoint 2010+ | Matrices, multiline derivations, and other standalone high-structure formulas use the registered block contract; unsupported input fails closed |
-| Editable inline formula | A leaf `<tspan data-pptx-inline-formula="delimiter-free LaTeX">preview text</tspan>` among ordinary text runs | The same DrawingML `a:p` retains surrounding runs and inserts `a14:m > m:oMath` | PowerPoint 2010+ | Direct non-empty preview text only; no child element, positional `x/y/dx/dy`, structured placeholder/Master/Layout ownership, preserved imported `txBody`, or native-replacement ancestor |
+| LaTeX input profile | Canonical marker sources omit outer delimiters; one complete `$...$`, `$$...$$`, `\(...\)`, or `\[...\]` pair is also accepted | Every explicitly named input in the pinned Microsoft 365 2606 / Mac 16.110 profile, plus the 2605 / 16.109 mhchem profile, compiles to editable OMML | The profile is pinned to those Microsoft documentation versions; emitted OMML retains the PowerPoint 2010+ package target. Repository verification is compiler/OMML/package-level, not complete Microsoft 365 UI certification | Explicit native normalizations are preserved; unknown or explicitly unsupported input fails closed rather than leaking as literal LaTeX |
+| Editable block equation | One `<g data-pptx-replace-with="formula">` with explicit bounds, source LaTeX in `<metadata type="application/json">`, and visible SVG preview children | PowerPoint text shape containing `a14:m > m:oMathPara > m:oMath` | See the input-profile row | Matrices, multiline derivations, and other standalone high-structure formulas use the registered block contract |
+| Editable inline formula | A leaf `<tspan data-pptx-inline-formula="canonical LaTeX body">preview text</tspan>` among ordinary text runs | The same DrawingML `a:p` retains surrounding runs and inserts `a14:m > m:oMath` | See the input-profile row | Direct non-empty preview text only; no child element, positional `x/y/dx/dy`, structured placeholder/Master/Layout ownership, preserved imported `txBody`, or native-replacement ancestor |
| Browser / live preview | Ordinary SVG children inside a block marker, or the inline marker's direct text | Only the registered preview is discarded when native math is written | Raw LaTeX does not render in SVG | Preview content must express the same formula; it is not a PPTX fallback |
-| Formula typography | Block payload style, or computed inline text-run style | Inline math inherits size and visible solid fill, then uses the project text language and Cambria Math | PowerPoint 2010+ | High-structure or multiline math remains block-level |
+| Formula typography | Block payload style, or computed inline text-run style | Math inherits size and visible solid fill, then uses the project text language and Cambria Math; local `\color` / `\textcolor` scopes override the inherited fill on selectable runs and structural controls, while `\boldsymbol` / `\bm` also styles structural control glyphs | PowerPoint 2010+ OMML | High-structure or multiline math remains block-level |
| Non-PowerPoint formula playback | The same native markers; no picture branch | No compatibility fallback is added | Keynote, WPS, LibreOffice, and other clients are outside the formula contract | Do not claim cross-client rendering or editability |
Formula replacement is always active and does not use
@@ -222,6 +223,10 @@ Formula replacement is always active and does not use
PNG, media relationship, or `mc:Fallback` picture. Block JSON and inline
`data-pptx-inline-formula` values are the native formula sources; SVG preview
content exists only so the authored page remains visible before export.
+Compilation is forward-only: PPT Master does not build OMML back down to LaTeX.
+The executable closed vocabulary and pinned Microsoft source revisions live in
+`formula_profile.py`; Microsoft's open-ended “etc.” does not make undisclosed
+relation aliases part of this contract.
## 10. PowerPoint playback and package features
diff --git a/docs/roadmap.md b/docs/roadmap.md
index ed2c2505..b6959a3c 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -44,7 +44,7 @@ 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 reusable cell-grid references, with custom grids still available; native Table replacement uses the same opt-in |
| Diagrams | Systematized | Six relationship atoms — `order`, `link`, `parent`, `membership`, `contrast`, `overlap` |
-| 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 |
+| Formulas | Systematized | Standalone block and same-paragraph inline formulas compile every explicitly documented Microsoft 365 LaTeX / mhchem input to editable OMML, with documented native normalizations and fail-closed handling outside the profile. SVG previews are authoring-only and no image fallback is emitted. The package target remains PowerPoint 2010+; the executable profile is pinned to the stated Microsoft documentation versions, while repository verification is compiler/OMML/package-level rather than complete Microsoft 365 UI certification. Non-PowerPoint clients remain 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 |
diff --git a/docs/technical-design.md b/docs/technical-design.md
index 7b1cf3d1..4b4dfb72 100644
--- a/docs/technical-design.md
+++ b/docs/technical-design.md
@@ -509,11 +509,23 @@ exports `m:oMathPara`; a leaf
`<tspan data-pptx-inline-formula="...">preview</tspan>` inside ordinary text
exports `m:oMath` in that same DrawingML paragraph. Inline math inherits the
text run's size and visible solid fill, then uses the project text language and
-Cambria Math; matrices,
-multiline derivations, and other high-structure expressions remain blocks. Both
-forms keep ordinary SVG preview content because raw LaTeX does not render in
-SVG. PowerPoint 2010+ is the target, with no formula PNG, media relationship,
-or image fallback for non-PowerPoint clients.
+Cambria Math; compiler-owned local color and `\boldsymbol` / `\bm` control
+emphasis also reach non-selectable structural controls, while ordinary text
+weight/style or math alphabet overrides only the corresponding inherited run
+property. A closed Microsoft
+365 profile table feeds one parser and shared AST, then one emitter produces and
+structurally validates the narrow OMML vocabulary used by both block and inline
+paths. The forward compiler covers every explicitly documented input and native
+normalization in the pinned Microsoft 365 LaTeX and mhchem profiles; unknown,
+explicitly unsupported, invalid, or resource-overflow input fails closed, and
+PPT Master does not build OMML back down to LaTeX. Matrices, multiline
+derivations, and other high-structure expressions remain blocks. Both forms
+keep ordinary SVG preview content because raw LaTeX does not render in SVG.
+PowerPoint 2010+ is the package target, with no formula PNG, media relationship,
+or image fallback for non-PowerPoint clients. The executable profile is pinned
+to the stated Microsoft 365 documentation versions; repository verification is
+compiler-, OMML-, and package-level, not complete Microsoft 365 UI
+rendering/editability certification.
**Native hyperlinks use one SVG authoring truth plus package relationships.**
Standard `<a href>` wraps either a complete visible object/group or one or more
diff --git a/docs/why-ppt-master.md b/docs/why-ppt-master.md
index 166993fc..218481d6 100644
--- a/docs/why-ppt-master.md
+++ b/docs/why-ppt-master.md
@@ -23,14 +23,14 @@ Editable is already table stakes — exporting each slide as an editable `.pptx`
- **Slide masters & layouts** — real `p:sldMaster` / `p:sldLayout` structure with inheritance (on template / structured routes), not the same chrome pasted onto every page
- **Native shapes** — preset geometry with working adjustment handles (block arrows, chevrons, callouts, flowchart nodes…), connectors, and freeform paths, not just rectangles
- **Native charts & tables, on demand** — data-backed chart and table objects with an Edit-Data workbook when you want them (trade-off note below)
-- **Native equations, block or inline** — a strict LaTeX subset compiles to editable PowerPoint OMML instead of a formula picture
+- **Native equations, block or inline** — every explicitly documented Microsoft 365 LaTeX / mhchem input compiles forward to editable PowerPoint OMML instead of a formula picture; out-of-profile input fails closed
- **The full text, picture, fill, and effect model** — run/paragraph formatting, picture crop and shape-clip, gradients, patterns, outer shadow, glow
- **Transitions, entrance / emphasis / path / exit animation, and speaker notes → voice narration** — real OOXML timing and package parts, not baked-in video
- **Template distillation on top** — hand it reference material and it extracts a reusable brand / style / layout / deck template; a layer of reuse built *above* the native primitives
And this depth is a **direction of travel, not a fixed list.** The project's north star is to keep converging with PowerPoint itself — an ongoing effort to build and integrate more of its native capabilities, release after release, narrowing the gap between what an AI can generate for you and what you could build by hand in PowerPoint.
-So the boundary is honest, and it moves. Some things are out of scope today — **SmartArt** (a closed, brittle object model, deliberately left out and better rebuilt from ordinary native shapes), a few decorative effects (WordArt, reflection, soft edges), and embedded or legacy objects (OLE, video, macros). Native equations currently cover standalone blocks and same-paragraph inline math targeting PowerPoint 2010+; matrices and multiline derivations remain block-level, and cross-client rendering/editability is not promised. What's in and what's out is never hand-waved: the exact, feature-by-feature boundary — native / approximate / bake-required / unsupported — is published in the [PowerPoint ↔ SVG Mapping Guide](./powerpoint-svg-mapping.md).
+So the boundary is honest, and it moves. Some things are out of scope today — **SmartArt** (a closed, brittle object model, deliberately left out and better rebuilt from ordinary native shapes), a few decorative effects (WordArt, reflection, soft edges), and embedded or legacy objects (OLE, video, macros). Native equations cover standalone blocks and same-paragraph inline math, with an executable input profile pinned to the documented Microsoft 365 versions and a PowerPoint 2010+ package target; repository verification is compiler/OMML/package-level rather than complete Microsoft 365 UI certification. Matrices and multiline derivations remain block-level, reverse OMML-to-LaTeX build-down is not implemented, and cross-client rendering/editability is not promised. What's in and what's out is never hand-waved: the exact, feature-by-feature boundary — native / approximate / bake-required / unsupported — is published in the [PowerPoint ↔ SVG Mapping Guide](./powerpoint-svg-mapping.md).
And out of scope rarely means *can't* — more often it means *not yet* (the timing isn't right) or *not worth it* (for a niche effect, a quick manual tweak in PowerPoint beats the engineering cost). That call is easy to make precisely because PPT Master's output is a high-quality **draft you keep editing, not a sealed final deck** — the last mile is yours by design.
diff --git a/docs/zh/faq.md b/docs/zh/faq.md
index 9e157d26..a576de48 100644
--- a/docs/zh/faq.md
+++ b/docs/zh/faq.md
@@ -157,9 +157,17 @@ group;行内公式使用夹在普通文本 run 中的叶子
高结构表达仍使用块级形式。原始 LaTeX 不能直接在 SVG 中显示,因此每个
marker 都携带普通可见预览;原生导出会替换该预览,不增加图片兜底。
-原生目标为 PowerPoint 2010+。Keynote、WPS、LibreOffice 等非 PowerPoint
-客户端中的公式显示与编辑能力不在支持范围内;PPT Master 不为这些客户端附加
-公式图片兜底。
+前向编译覆盖 Microsoft 文档中 Microsoft 365 2606 / Mac 16.110 LaTeX
+档位与 2605 / 16.109 mhchem 档位明确点名的全部输入,包括符号、结构、环境、
+宏、化学式、公式局部颜色及文档规定的原生归一化。未知或明确不支持的输入直接
+失败,不会以原始 LaTeX 混进页面。PPT Master 不实现 OMML 到 LaTeX 的反向
+build-down。
+
+生成的 OMML 仍以 PowerPoint 2010+ 包为目标,可执行输入档位锁定到上述
+Microsoft 文档版本。仓库验证覆盖编译器行为、OMML 结构与 PPTX 打包,不等同于
+完整的 Microsoft 365 UI 显示 / 编辑认证。Keynote、WPS、LibreOffice 等非
+PowerPoint 客户端中的公式显示与编辑能力不在支持范围内;PPT Master 不为这些
+客户端附加公式图片兜底。
## Q: 生成的页面可以带可点击链接吗?
diff --git a/docs/zh/powerpoint-svg-mapping.md b/docs/zh/powerpoint-svg-mapping.md
index a61135b6..e27e5a29 100644
--- a/docs/zh/powerpoint-svg-mapping.md
+++ b/docs/zh/powerpoint-svg-mapping.md
@@ -205,16 +205,20 @@ PowerPoint 原生 Chart/Table 对象是可选功能。默认导出保留 SVG fal
| PowerPoint 功能 | 项目表达 | PPTX 结果 | 兼容性 | 校验边界 |
|---|---|---|---|---|
-| 可编辑块级公式 | 一个带显式边界、在 `<metadata type="application/json">` 中保存源 LaTeX、并含可见 SVG 预览子元素的 `<g data-pptx-replace-with="formula">` | 含 `a14:m > m:oMathPara > m:oMath` 的 PowerPoint 文本 shape | PowerPoint 2010+ | 矩阵、多行推导等独立高结构公式使用块级合同;不支持的输入直接失败 |
-| 可编辑行内公式 | 普通文本 run 中的叶子 `<tspan data-pptx-inline-formula="无定界符 LaTeX">preview text</tspan>` | 同一 DrawingML `a:p` 保留前后 run,并插入 `a14:m > m:oMath` | PowerPoint 2010+ | 只允许非空直接预览文本;禁止子元素、`x/y/dx/dy`、结构化 placeholder / Master / Layout 归属、保留的导入 `txBody` 或原生替换祖先 |
+| LaTeX 输入档位 | 规范 marker 源不写外层定界符;也接受一对完整的 `$...$`、`$$...$$`、`\(...\)` 或 `\[...\]` | 锁定的 Microsoft 365 2606 / Mac 16.110 档位中所有明确点名的输入,以及 2605 / 16.109 mhchem 档位,均编译为可编辑 OMML | 档位锁定到这些 Microsoft 文档版本;产出的 OMML 仍保持 PowerPoint 2010+ 包目标。仓库验证覆盖编译器、OMML 与包结构,不等同于完整的 Microsoft 365 UI 认证 | 保留文档明确规定的原生归一化;未知或明确不支持的输入直接失败,不把 LaTeX 字面量漏进页面 |
+| 可编辑块级公式 | 一个带显式边界、在 `<metadata type="application/json">` 中保存源 LaTeX、并含可见 SVG 预览子元素的 `<g data-pptx-replace-with="formula">` | 含 `a14:m > m:oMathPara > m:oMath` 的 PowerPoint 文本 shape | 见输入档位行 | 矩阵、多行推导等独立高结构公式使用块级合同 |
+| 可编辑行内公式 | 普通文本 run 中的叶子 `<tspan data-pptx-inline-formula="规范 LaTeX body">preview text</tspan>` | 同一 DrawingML `a:p` 保留前后 run,并插入 `a14:m > m:oMath` | 见输入档位行 | 只允许非空直接预览文本;禁止子元素、`x/y/dx/dy`、结构化 placeholder / Master / Layout 归属、保留的导入 `txBody` 或原生替换祖先 |
| 浏览器 / 实时预览 | 块级 marker 内的普通 SVG 子元素,或行内 marker 的直接文本 | 写入原生公式时只丢弃已登记预览 | 原始 LaTeX 不能直接在 SVG 中渲染 | 预览必须表达同一公式;它不是 PPTX 兜底 |
-| 公式字体 | 块级 payload 样式,或行内文本 run 的计算样式 | 行内公式继承字号与可见纯色填充,并使用项目文本语言和 Cambria Math | PowerPoint 2010+ | 高结构或多行数学内容仍使用块级形式 |
+| 公式字体 | 块级 payload 样式,或行内文本 run 的计算样式 | 公式继承字号与可见纯色填充,并使用项目文本语言和 Cambria Math;局部 `\color` / `\textcolor` 作用域会覆盖可选中文字 run 与结构控制符的继承填充,`\boldsymbol` / `\bm` 也会设置结构控制字形的样式 | PowerPoint 2010+ OMML | 高结构或多行数学内容仍使用块级形式 |
| 非 PowerPoint 客户端播放 | 同一类原生 marker;没有图片分支 | 不附加兼容兜底 | Keynote、WPS、LibreOffice 等客户端不在公式合同内 | 不宣称跨客户端显示或编辑能力 |
公式替换始终启用,不使用 `--native-charts-and-tables`。该路径不会创建
`formula_manifest.json`、公式 PNG、media relationship 或作为图片的
`mc:Fallback`。块级 JSON 和行内 `data-pptx-inline-formula` 的值是原生公式源;
SVG 预览内容只负责让导出前的作者页面保持可见。
+编译仅支持前向生成;PPT Master 不把 OMML 反向 build-down 为 LaTeX。
+可执行闭合集与锁定的 Microsoft 来源修订记录在 `formula_profile.py`;Microsoft
+文档中开放式的 “etc.” 不会把未披露的 relation alias 自动纳入本合同。
## 10. PowerPoint 播放与打包功能
diff --git a/docs/zh/roadmap.md b/docs/zh/roadmap.md
index a14d365e..c13b4dbf 100644
--- a/docs/zh/roadmap.md
+++ b/docs/zh/roadmap.md
@@ -44,7 +44,7 @@
| 图表 | 系统化 | 有专属创作 reference;默认 SVG,原生 Chart 替换为显式 opt-in |
| 表格 | 系统化 | 有专属创作 reference;六种可复用的单元格网格参考,仍可自定义网格;原生 Table 替换走同一 opt-in |
| 关系图 | 系统化 | 六个关系原子——`order`、`link`、`parent`、`membership`、`contrast`、`overlap` |
-| 公式 | 系统化 | 独立块级公式与同段行内公式都可从严格 LaTeX 子集编译为可编辑 PowerPoint OMML;SVG 预览仅供创作阶段使用,不生成公式图片兜底。支持 PowerPoint 2010+,非 PowerPoint 客户端不在合同内 |
+| 公式 | 系统化 | 独立块级公式与同段行内公式可把 Microsoft 365 LaTeX / mhchem 文档中所有明确点名的输入编译为可编辑 OMML,并遵循文档规定的原生归一化,档位外输入直接失败。SVG 预览仅供创作阶段使用,不生成图片兜底。包目标仍为 PowerPoint 2010+;可执行档位锁定到所述 Microsoft 文档版本,仓库验证覆盖编译器、OMML 与包结构,不等同于完整的 Microsoft 365 UI 认证。非 PowerPoint 客户端仍不在合同内 |
| 旁白与动画音效 | 系统化 | 逐页旁白音频,以及取自内置 CC0 音效库的原生转场与对象音效 |
| 任意视频与背景音乐 | 暂不考虑 | 属于一次性、内容特定的插入动作,在 PowerPoint 里手动放进去更快,AI 也无法替你挑文件。背景音乐还会牵出旁白混音决策,那在范围之外。来源 deck 中已有的媒体在 Fill 与 Enhance 路线中原样保留 |
| SmartArt | 有意的不对称 | 读取来源 diagram part 的内容与结构;生成 deck 用普通形状管线把这些内容重画出来。从不编辑 DiagramML,也不承诺原生 SmartArt 再生 |
diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.md
index d5eb1f83..6d0c0488 100644
--- a/docs/zh/technical-design.md
+++ b/docs/zh/technical-design.md
@@ -431,10 +431,16 @@ Stage-1 沟通推荐的编写不得读取这些候选或任何模板内容。UI
`m:oMathPara`;普通文本中的叶子
`<tspan data-pptx-inline-formula="...">preview</tspan>` 则在同一 DrawingML
段落中导出 `m:oMath`。行内公式继承文本 run 的字号与可见纯色填充,并使用项目文本语言和
-Cambria Math;矩阵、多行推导等高结构表达仍使用块级形式。两种形式都保留
-普通 SVG 预览,因为原始 LaTeX 本身不能在 SVG 中显示。原生目标为 PowerPoint
-2010+,不生成公式 PNG、media relationship,也不为非 PowerPoint 客户端提供
-图片兜底。
+Cambria Math;编译器自己的局部颜色以及 `\boldsymbol` / `\bm` 的控制符强调也会写入不可选中的
+结构控制符,而普通文字粗斜体或数学字母样式只覆盖对应的继承 run 属性。封闭的 Microsoft 365 档位表进入同一个 parser 与共享 AST,再由同一个 emitter
+生成并按结构校验块级和行内路径共同使用的窄 OMML 词汇。前向编译器覆盖锁定版本的
+Microsoft 365 LaTeX 与 mhchem 文档中所有明确点名的输入及原生归一化;未知、明确不支持、
+非法或超出资源上限的输入都会直接失败,PPT Master 不把 OMML 反向 build-down 为
+LaTeX。矩阵、多行推导等高结构表达仍使用块级形式。两种形式都保留普通 SVG 预览,
+因为原始 LaTeX 本身不能在 SVG 中显示。生成包仍以 PowerPoint 2010+ 为目标,可执行
+档位锁定到所述 Microsoft 365 文档版本;仓库验证覆盖编译器、OMML 与包结构,不等同于
+完整的 Microsoft 365 UI 显示 / 编辑认证。不生成公式 PNG、media relationship,也不为
+非 PowerPoint 客户端提供图片兜底。
**原生超链接采用一份 SVG 创作真值,再编译为包内 relationship。** 标准
`<a href>` 包裹完整可见对象 / group,或一个以上的行内 `<tspan>` run。
diff --git a/docs/zh/why-ppt-master.md b/docs/zh/why-ppt-master.md
index 07c72b2f..fac2c693 100644
--- a/docs/zh/why-ppt-master.md
+++ b/docs/zh/why-ppt-master.md
@@ -23,14 +23,14 @@
- **母版与版式** —— 真正的 `p:sldMaster` / `p:sldLayout` 继承结构(走模板 / 结构化路线),而不是把同一套页面框架贴到每一页
- **原生形状** —— 带可用调节手柄的预设几何(箭头、V 形、标注、流程节点……)、连接线、自由路径,而不只是矩形
- **按需的原生图表与表格** —— 需要时就是带「编辑数据」工作簿的数据驱动图表 / 表格对象(取舍见下)
-- **原生公式,块级或行内** —— 将严格 LaTeX 子集编译为可编辑 PowerPoint OMML,而不是公式图片
+- **原生公式,块级或行内** —— 把 Microsoft 365 LaTeX / mhchem 文档中明确点名的输入全部前向编译为可编辑 PowerPoint OMML,而不是公式图片;档位外输入直接失败
- **完整的文本 / 图片 / 填充 / 效果模型** —— 段落与文本级格式、图片裁剪与形状裁切、渐变、图案、外阴影、发光
- **转场、进入 / 强调 / 动作路径 / 退出动画、演讲者备注 → 语音旁白** —— 都是真正的 OOXML 计时与包内部件,不是烤进去的视频
- **在这之上的模板提炼** —— 把参考材料交给它,它能提炼出可复用的 brand / style / layout / deck 模板;这是建立在原生原语**之上**的一层复用能力
而这份深度是**一个前进方向,不是一张固定清单。** 项目的北极星是持续向 PowerPoint 本身靠拢——不断开发、集成更多它的原生能力,一个版本接一个版本,缩小「AI 能替你生成的」和「你在 PowerPoint 里手工能做出的」之间的差距。
-所以边界是诚实的,而且它在移动。有些能力今天还不在范围内——**SmartArt**(一个封闭、脆弱的对象模型,被刻意排除,其含义更适合用普通原生形状重建)、少数装饰性效果(艺术字、反射、柔化边缘)、以及嵌入 / 遗留对象(OLE、视频、宏)。当前原生公式已覆盖面向 PowerPoint 2010+ 的独立块级公式和同段行内公式;矩阵与多行推导仍使用块级形式,且不承诺跨客户端公式显示与编辑。哪些在内、哪些在外从不含糊:逐条的功能对照边界——原生 / 近似 / 需烘焙 / 不支持——都公开在 [PowerPoint ↔ SVG 映射指南](./powerpoint-svg-mapping.md) 里。
+所以边界是诚实的,而且它在移动。有些能力今天还不在范围内——**SmartArt**(一个封闭、脆弱的对象模型,被刻意排除,其含义更适合用普通原生形状重建)、少数装饰性效果(艺术字、反射、柔化边缘)、以及嵌入 / 遗留对象(OLE、视频、宏)。原生公式已覆盖独立块级公式和同段行内公式,可执行输入档位锁定到所述 Microsoft 365 文档版本,生成包仍面向 PowerPoint 2010+;仓库验证覆盖编译器、OMML 与包结构,不等同于完整的 Microsoft 365 UI 认证。矩阵与多行推导继续使用块级形式,不实现 OMML 到 LaTeX 的反向 build-down,也不承诺跨客户端公式显示与编辑。哪些在内、哪些在外从不含糊:逐条的功能对照边界——原生 / 近似 / 需烘焙 / 不支持——都公开在 [PowerPoint ↔ SVG 映射指南](./powerpoint-svg-mapping.md) 里。
而且「不在范围内」很少等于「做不到」——更多时候是「时机未到」,或者「性价比不划算」(一个小众效果,去 PowerPoint 里手动改一下,比为它做工程更值)。这个取舍之所以好做,正因为 PPT Master 的产出是一份高质量的**草稿、供你继续修改,而不是封死的成品**——最后一公里本就交给你。
diff --git a/skills/ppt-master/scripts/README.md b/skills/ppt-master/scripts/README.md
index 6a2e9c43..a3fa4dff 100644
--- a/skills/ppt-master/scripts/README.md
+++ b/skills/ppt-master/scripts/README.md
@@ -310,8 +310,11 @@ python3 scripts/analyze_images.py <project_path>/images
Generated-deck formulas do not use an image command. Author a native formula
marker in the page SVG; `svg_to_pptx.py` compiles its LaTeX metadata to editable
-PowerPoint OMML. The retained `latex_render.py` utility is standalone legacy
-rasterization only and is not connected to either Generate profile.
+PowerPoint OMML. Forward compilation covers the explicitly documented Microsoft
+365 LaTeX and mhchem input profiles and fails closed outside them; it does not
+implement OMML-to-LaTeX build-down. The retained `latex_render.py` utility is
+standalone legacy rasterization only and is not connected to either Generate
+profile.
Repository update: