dsh-ppt 0.23.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,20 @@
1
1
  # 更新记录
2
2
 
3
+ ## 0.24.0 (2026-11-18)
4
+
5
+ - **原生 Office Math(`<m:oMath>` + MathML)公式引擎与四大巅峰商业图示**:新增零外部依赖 `deck-math.mjs`,支持将 `slide.formula` 与行内 `$...$` / `$$...$$` LaTeX 公式确定性编译为原生可编辑 ECMA-376 `<m:oMath>` / `<m:oMathPara>` 与 HTML W3C MathML(覆盖分式 `\frac`、上下标、根式 `\sqrt`、大型求和积分 `\sum`/`\int`、矩阵与希腊字母);新增 **麦肯锡不等宽市场图(`marimekko`)**、**Apple/NVIDIA 财报级多层级桑基流向图(`sankey`)**、**真·波特价值链(`value-chain`,顶部辅助活动横梁 + 底部咬合基本活动箭头 + 右侧利润楔)** 与 **SWOT 战略十字矩阵(`swot`,含中心破局锚点)**,HTML 与原生 OOXML 100% 同源对齐。
6
+ - **第 10 个 Agent 工具 `ppt_import`、存量 `.pptx` 一键翻新与 Office 双向导回**:支持导入任意外部 `.pptx`(提取文字/加粗重点、表格、原生 `<c:chart>` 图表、嵌入图片与演讲备注)一键翻新为全新可编辑 `dsh-ppt` 工程(可选自动现代焕新主题或保留原稿品牌配色),或将 PowerPoint / WPS 修改后的 `.pptx` 导回既有工程更新(自动保留 `.history/` 撤销历史,支持 `ppt_undo` / 工作台「撤销上次修改」)。
7
+ - **独立双屏演讲者提词台与演讲讲义导出**:HTML 放映内置 **`P` 键双屏演讲者提词台**(`BroadcastChannel` + `postMessage` 双向同步当前页、下一页预览、可调字号提词器、计时器与 **`L` 键虚拟激光笔**),并新增结构化演讲讲义 `.handout.md` 客户端/工作台下载(`kind: 'handout'`)。
8
+ - **工作台同步升级**:首页工程库与新建向导新增「导入 PPTX 翻新 / Import & Modernize .pptx」,打开工程顶栏与「风格与母版」新增「导入 Office 修改稿 / Sync Edited .pptx」,内容编辑器新增 `marimekko` / `sankey` / `swot` / `value-chain` 与 LaTeX `formula` 编辑框,下载面板新增「下载演讲讲义 (.md) / Download Handout」。
9
+ - Ship a zero-dependency LaTeX math engine (`deck-math.mjs`) compiling `slide.formula` and `$...$` / `$$...$$` expressions into native editable Office Math (`<m:oMath>`) in PPTX and W3C MathML in HTML, alongside 4 pinnacle consulting/financial layouts: variable-width **Marimekko (`marimekko`)**, multi-layer cubic-Bezier **Sankey (`sankey`)**, authentic **Porter Value Chain (`value-chain`)**, and **SWOT Cross Matrix (`swot`)**.
10
+ - Add the **10th agent tool `ppt_import`** (`importPptxDeck`, CLI `--import-pptx` / `--sync-pptx`) and Workbench `import-pptx` action (`≤24 MiB` in-memory upload) to extract slides, tables, live native charts, images, and speaker notes from external `.pptx` files — either creating a modernized editable project or syncing Office-edited `.pptx` changes back into an existing project with full undo history.
11
+ - Add **Dual-Screen Presenter View** (`P` shortcut / `#presenter-toggle` with next-slide preview, resizable teleprompter, pace timer, and `L`-key virtual laser pointer) and **Speaker Handout (`.handout.md`)** export across standalone HTML (`#download-handout`) and Workbench (`kind: 'handout'`).
12
+
13
+ ## 0.23.1 (2026-11-18)
14
+
15
+ - 同步 `@stardustlc/dsh-updates` 0.2.3:侧边栏工作台平时默认隐藏底部更新栏(零高度占用),仅在检测到兼容新版本或执行更新时浮现单行精简提示条;完整更新设置与检查入口统一保留在 DSH「插件」详情页底部。
16
+ - Sync `@stardustlc/dsh-updates` 0.2.3: keep the sidebar workbench update footer hidden by default when up-to-date, surfacing a single-line compact strip only for actionable updates or active jobs while retaining full controls in native Plugin Details.
17
+
3
18
  ## 0.23.0 (2026-11-18)
4
19
 
5
20
  - **24 套大师主题、8 套名家范本预设与 20 套行业蓝图**:新增 `bcg-emerald`(翡翠战略)、`economist-brief`(经济学人简报)、`venture-daylight`(红杉日间备忘录)、`stripe-craft`(云靛工坊)、`aurora-stage`(极光发布会)、`obsidian-amber`(黑曜终端)6 套主题(共 16 浅 + 8 深),内置 8 套免上传一键直吸名家范本预设;场景蓝图扩展至 20 套(新增 `quarterly-okr`、`product-prd`、`vc-daylight`、`industry-research`),并新增咨询价值链咬合五边形箭头(`chevron` / `value-chain`)原生可编辑图示。
package/README.en.md CHANGED
@@ -17,9 +17,9 @@
17
17
 
18
18
  ## Features
19
19
 
20
- - **Zero-taste-burden Auto-Director**: Automatically selects from **24 curated themes** (16 projector-safe daylight + 8 stage dark — spanning McKinsey, BCG Emerald, Economist Brief, FT Salmon, Sequoia Daylight Memo, Stripe Craft, Apple Spatial Light, and Gov Ceremonial), **6 distinct Master Chrome Skeletons**, **20 industry blueprints**, and **24+ native editable layouts & pro diagrams** (including interlocking **Value-Chain Chevrons**, Bento cards, KPI hero metrics, 2×2 matrices, comparisons, process/flywheel/funnel flows, Gantt roadmaps, layered architecture diagrams, Harvey-ball competitor matrices, concentric TAM/SAM/SOM, org/team charts, academic 3-line tables, and 13 publication-grade chart types including vector waterfall bridges).
21
- - **Deep Reference `.pptx` Absorption & Master Presets**: Ships **8 1-click World-Class Reference Presets** plus **Deep `.pptx` Absorption** (`ppt_absorb`, `referencePptx` with `cloneStructure: true`, or drag-and-drop up to `24 MiB` in Style Studio) — recursively unwrapping nested `<p:grpSp>` group shapes, resolving OOXML `sysClr`/`prstClr`/`hueMod` color transforms, dual brand accents, heading/body font pairings, dark-cover + daylight-body polarity, master logos, `recommendedChrome`, and 24-layout `slideSkeleton` sequences with WCAG ≥4.5:1 sanitization and reusable **My Brand Library** presets.
22
- - **Human-first Workbench & Self-Serve Creation**: Adapted for DeepSeek Harness `>=0.2.2-rc.3` with 5 switchable light UI themes; launch **New presentation** directly inside the workbench from a blueprint, rough notes, or uploaded `.pptx`; click text/cards/tables in the live preview to jump straight to their editor inputs, insert Harvey balls (`● ◕ ◑ ◔ ○`) in 1 click, compare HTML ↔ rendered PPTX side-by-side, and undo up to 20 revisions.
20
+ - **Zero-taste-burden Auto-Director**: Automatically selects from **24 curated themes** (16 projector-safe daylight + 8 stage dark — spanning McKinsey, BCG Emerald, Economist Brief, FT Salmon, Sequoia Daylight Memo, Stripe Craft, Apple Spatial Light, and Gov Ceremonial), **6 distinct Master Chrome Skeletons**, **20 industry blueprints**, **native `<m:oMath>` + MathML equations**, and **28+ native editable layouts & pro diagrams** (including **Marimekko** variable-width market maps, multi-layer **Sankey** flow diagrams, **Porter Value Chain**, **SWOT** cross matrix with strategic anchor, interlocking Chevrons, Bento cards, KPI metrics, 2×2 matrices, comparisons, flywheel/funnel flows, Gantt roadmaps, layered architecture diagrams, Harvey-ball matrices, concentric TAM/SAM/SOM, org/team charts, academic 3-line tables, and 13 publication-grade chart types including vector waterfall bridges).
21
+ - **One-Click `.pptx` Modernization & Office Round-Trip Sync**: Ships the **10th agent tool `ppt_import`** and Workbench **Import & Modernize .pptx** / **Sync Edited .pptx** (`≤24 MiB` in-memory upload) — extract text, tables, live native charts, images, and speaker notes from legacy `.pptx` decks into a brand-new editable project, or sync PowerPoint/WPS edits back into an open project with full undo support; also includes **8 1-click Reference Presets** and deep `.pptx` brand/skeleton absorption (`ppt_absorb`).
22
+ - **Human-first Workbench, Dual-Screen Presenter View & Handouts**: Adapted for DeepSeek Harness `>=0.2.2-rc.3` with 5 light UI themes; click **New presentation** or **Import & Modernize .pptx** directly in the workbench, click text/cards/tables in the preview to edit fields or LaTeX `formula`s, insert Harvey balls (`● ◕ ◑ ◔ ○`) in 1 click, compare HTML ↔ rendered PPTX side-by-side, export **Speaker Handout (`.handout.md`)**, and press **`P`** in standalone HTML playback to launch **Dual-Screen Presenter View** (with next-slide preview, timer & **`L`** virtual laser pointer).
23
23
  - **Optional verification & coaching**: Traceable numbers with live what-if sliders across diagrams and tables, 24-slide two-tier Vision QA (12 lossless formatting actions + full-width before/after canvas diff), and executive storyline coaching / defense rehearsal.
24
24
 
25
25
  ## Style previews
@@ -77,9 +77,9 @@ Four intuitive steps — start either in chat or directly inside the workbench:
77
77
  1. **Draft in seconds (two ways)**:
78
78
  - **Self-serve in the Workbench**: Open **Presentations** in the sidebar and click **New presentation** to start from any of the 20 scenario blueprints (Quarterly OKR, Product PRD, Investor Memo, Industry Research, Project Update, Defense, etc.), paste rough Markdown notes, or upload a reference `.pptx`.
79
79
  - **Ask in Chat**: Share your notes, data, or reference `.pptx` path (or copy a ready-made prompt from the workbench guide) — Auto-Director picks a projector-safe theme and varied layouts automatically.
80
- 2. **Click-to-edit & upgrade layouts**: Click any title, card, or table in the live preview to focus its editor field; switch bullets into **KPI hero metrics, Value-Chain Chevrons, Gantt timelines, Architecture diagrams, Harvey-ball matrices, or academic 3-line tables** in one click, then press `Ctrl/⌘+S` or **Save slide**.
81
- 3. **Absorb reference `.pptx` & save your brand**: In **Style Studio**, apply **8 built-in Master Reference Presets** in 1 click, or drop a corporate `.pptx` (`≤24 MiB`) to extract dual brand colours, heading/body fonts, cover polarity, logo, and skeleton — then save it to **My Brand Library** for 1-click reuse on future decks.
82
- 4. **Verify & deliver**: Render the current PPTX for **side-by-side HTML & PPTX inspection** (or optionally run AI storyline coaching, rehearsal, or 24-slide visual repair), then click **Download PPTX** or export the Share ZIP bundle.
80
+ 2. **Click-to-edit & upgrade layouts**: Click any title, card, or table in the live preview to focus its editor field; switch bullets into **KPI metrics, Marimekko market maps, Sankey flows, Porter Value Chains, SWOT matrices, Gantt timelines, Architecture diagrams, Harvey-ball matrices, or academic 3-line tables** (plus native LaTeX `formula`s) in one click, then press `Ctrl/⌘+S` or **Save slide**.
81
+ 3. **Import `.pptx`, round-trip Office edits & save your brand**: Click **Import & Modernize .pptx** to refurbish legacy `.pptx` files into modern decks, or upload polished PowerPoint/WPS changes via **Sync Edited .pptx** as an undoable revision; in **Style Studio**, apply 8 Master Presets or save a corporate `.pptx` style into **My Brand Library**.
82
+ 4. **Present, verify & deliver**: Render the current PPTX for **side-by-side HTML & PPTX inspection** (or run optional AI storyline coaching, rehearsal, or 24-slide visual repair); press `P` during standalone HTML playback for **Dual-Screen Presenter View** (`L` for laser pointer), and download PPTX, **Handout (`.md`)**, or Share ZIP.
83
83
 
84
84
  Ready-to-copy chat prompts:
85
85
 
@@ -88,7 +88,7 @@ Ready-to-copy chat prompts:
88
88
 
89
89
  ## Before you start
90
90
 
91
- Download the finished deck directly; AI review, rehearsal and visual repair are optional. Office edits do not sync back into the project.
91
+ Download the finished deck directly; AI review, rehearsal and visual repair are optional. Import external `.pptx` decks for one-click modernization or sync Office-edited `.pptx` changes back into your workbench project with undo history; press `P` during HTML playback for Dual-Screen Presenter View and export structured `.handout.md` speaker handouts.
92
92
 
93
93
  Configuration, detailed tools and troubleshooting: [full reference](https://github.com/STARDUSTLC666/dsh-ppt/blob/master/docs/REFERENCE.en.md).
94
94
 
package/README.md CHANGED
@@ -17,9 +17,9 @@
17
17
 
18
18
  ## 功能
19
19
 
20
- - **零品味负担自动导演**:无需懂排版配色,一句话或文档自动匹配 **24 套大师主题**(16 套明亮投影友好 + 8 套沉浸深色,涵盖麦肯锡、BCG 翡翠战略、经济学人、金融时报、红杉创投、Stripe 工程、Apple 空间白与故宫霁蓝政务)与 **6 套差异化母版骨架**,覆盖 **20 套行业场景蓝图** 与 **24+ 种原生可编辑版式与专业图示**(新增咨询价值链五边形咬合箭头 `chevron`,以及 Bento 网格、KPI 大数字、2×2 矩阵、痛点对比、飞轮/漏斗流程、甘特图路线图、分层系统架构、哈维球竞品矩阵、TAM/SAM/SOM 同心圆、组织/团队图谱、学术三线表、13 种出版级图表与矢量瀑布桥)。
21
- - **深度吸收优质 `.pptx` 与名家范本**:内建 **8 套名家范本一键直吸**(免上传文件即可切换顶级演示 DNA),同时支持通过 `ppt_absorb`、`referencePptx`(`cloneStructure: true`)或工作台拖拽外部 `.pptx`(≤24 MiB)递归拆解嵌套组合形状(`<p:grpSp>`)、解析 OOXML `sysClr`/`prstClr`/`hueMod` 修饰色板、主辅双强调色、标题/正文字体配对、深色庄重封面+浅色正文极性、母版 Logo、骨架几何(`extractedSkeleton` / `recommendedChrome`)与 24 版式逐页序列(`slideSkeleton`),自带 WCAG ≥4.5:1 对比度净化,并支持收藏至「我的品牌库」跨项目一键复用。
22
- - **符合直觉的工作台与双入口起稿**:适配 DeepSeek Harness `>=0.2.2-rc.3`,内置五套明亮主题切换;支持在工作台直接点击「**新建演示文稿**」选蓝图/填大纲/传参考 `.pptx` 零代码生成,或在对话中一键发指令生成;在「风格与母版」一键套用名家范本、收藏企业品牌或切换 24 套演示主题,在「内容编辑」点击画面文字直接定位输入框、用哈维球快捷按钮 `● ◕ ◑ ◔ ○` 填表、一键下载 PPTX 或开启 HTML ↔ PPTX 并排对比与撤销。
20
+ - **零品味负担自动导演**:无需懂排版配色,一句话或文档自动匹配 **24 套大师主题**(16 套明亮投影友好 + 8 套沉浸深色,涵盖麦肯锡、BCG 翡翠战略、经济学人、金融时报、红杉创投、Stripe 工程、Apple 空间白与故宫霁蓝政务)与 **6 套差异化母版骨架**,覆盖 **20 套行业场景蓝图**、**原生 `<m:oMath>` 数学公式** 与 **28+ 种原生可编辑版式与专业图示**(新增麦肯锡 **不等宽市场图 `marimekko`**、**财报级多层桑基图 `sankey`**、**波特价值链 `value-chain`**、**SWOT 十字矩阵 `swot`**,以及咨询价值链五边形箭头 `chevron`、Bento 网格、KPI 大数字、2×2 矩阵、痛点对比、飞轮/漏斗、甘特图路线图、分层系统架构、哈维球竞品矩阵、TAM/SAM/SOM 同心圆、组织/团队图谱、学术三线表、13 种出版级图表与矢量瀑布桥)。
21
+ - **外部 `.pptx` 一键翻新与 Office 双向导回**:新增第 10 个工具 `ppt_import` 与工作台「**导入 PPTX 翻新** / **导入 Office 修改稿**」(≤24 MiB 内存解析):既可将存量老旧 `.pptx`(含文字、表格、原生图表、图片与演讲备注)一键翻新为高颜值可编辑工程,也可在 PowerPoint / WPS 微调后导回工作台更新工程(完整保留撤销历史);同时支持 8 套名家范本一键直吸与 `ppt_absorb`(`cloneStructure: true`)深度吸收公司模板。
22
+ - **符合直觉的工作台、双屏提词台与讲义导出**:适配 DeepSeek Harness `>=0.2.2-rc.3`,内置五套明亮主题切换;支持在工作台直接点击「**新建演示文稿**」或「**导入 PPTX 翻新**」,在「内容编辑」点击画面文字直接定位输入框、编辑 LaTeX 公式(编译为原生 `<m:oMath>` 与 MathML)、用哈维球快捷按钮 `● ◕ ◑ ◔ ○` 填表、一键下载 PPTX / 演讲讲义(`.handout.md`)或开启 HTML ↔ PPTX 并排对比与撤销;独立打开 HTML 放映时按 **`P`** 开启**双屏演讲者提词台**(同步下一页预览、计时器与 **`L` 键虚拟激光笔**)。
23
23
  - **可选高阶能力**:数字溯源与现场推演(支持卡片/甘特图/TAM/哈维球/架构绑定)、24 页双层 AI 视觉审查(含 12 种无损排版修复与全宽前后对比)、高管叙事预审与模拟答辩。
24
24
 
25
25
  ## 风格预览
@@ -77,9 +77,9 @@ dsh plugin --profile desktop add dsh-ppt
77
77
  1. **快速起稿(二选一)**:
78
78
  - **直接在面板起稿**:从左侧栏打开「演示文稿」,点击右上角 **「新建演示文稿」**,从 20 套行业蓝图(周报、季度 OKR、PRD 评审、路演 BP、行业研究、政务述职、学术答辩等)任选一套,或粘贴粗略要点 / 上传参考 `.pptx` 直接生成三件套。
79
79
  - **在对话中交给助手**:把文档、数据或参考 `.pptx` 发给助手(也可直接在工作台顶部复制场景指令),自动导演会按听众匹配明亮投影风与多版式节奏。
80
- 2. **点哪改哪 & 换版式**:在「内容编辑」直接点击预览画面里的标题、卡片或表格即可定位到右侧编辑框;顶部可一键把普通要点切换成 **KPI 大数字、价值链五边形箭头(Chevron)、甘特图、系统架构图、哈维球竞品矩阵或学术三线表**,改完按 `Ctrl/⌘+S` 或点击「保存此页」同步更新 HTML 与 PPTX。
81
- 3. **吸收外部优质 PPT 与沉淀品牌**:在「风格与母版」可一键套用 **8 套名家范本**,或把公司模板 / 喜欢的优质 `.pptx` 拖入解析框——自动提取双品牌色、标题/正文字体、深色封面反白、Logo 与页面骨架,点击「收藏到我的品牌库」后以后每份 PPT 都能一键换上公司皮肤。
82
- 4. **核对与交付**:需要精检排版时点「渲染当前 PPTX」开启 **HTML + PPTX 并排对比**(或按需开启 AI 叙事预审、模拟答辩与 24 页视觉看图修复);确认无误后直接点顶部「**下载 PPTX**」或「下载成品」导出分享包 ZIP。
80
+ 2. **点哪改哪 & 换版式**:在「内容编辑」直接点击预览画面里的标题、卡片或表格即可定位到右侧编辑框;顶部可一键把普通要点切换成 **KPI 大数字、不等宽市场图(Marimekko)、桑基流向图(Sankey)、波特价值链、SWOT 矩阵、甘特图、系统架构图、哈维球矩阵或学术三线表**(并支持 LaTeX 原生公式),改完按 `Ctrl/⌘+S` 或点击「保存此页」同步更新 HTML 与 PPTX。
81
+ 3. **导入翻新、Office 导回与品牌沉淀**:支持点击「**导入 PPTX 翻新**」把老旧 `.pptx` 直接重塑为现代工程,或在 PowerPoint / WPS 微调后通过「**导入 Office 修改稿**」同步回工作台(保留撤销历史);也可在「风格与母版」一键套用 8 套名家范本或收藏公司模板到「我的品牌库」。
82
+ 4. **双屏演讲、核对与交付**:需要精检排版时点「渲染当前 PPTX」开启 **HTML + PPTX 并排对比**(或按需开启 AI 叙事预审、模拟答辩与 24 页视觉看图修复);放映 HTML 时按 `P` 开启双屏提词台、按 `L` 使用虚拟激光笔,并在下载菜单导出最新 PPTX、**演讲讲义(`.md`)** 或分享包 ZIP。
83
83
 
84
84
  常用对话指令示例(可直接复制告诉助手):
85
85
 
@@ -89,7 +89,7 @@ dsh plugin --profile desktop add dsh-ppt
89
89
 
90
90
  ## 开始前要知道
91
91
 
92
- 可直接下载成品;AI 预审、模拟答辩与看图修复均按需开启。Office 中的手工修改不会自动同步回 JSON 工程。
92
+ 可直接下载成品;AI 预审、模拟答辩与看图修复均按需开启。支持导入外部 PPTX 一键翻新,或在 Office 微调后导回工作台更新工程;内置按 P 开启双屏演讲者提词台与讲义导出。
93
93
 
94
94
  配置、完整工具与排错见[详细使用说明](https://github.com/STARDUSTLC666/dsh-ppt/blob/master/docs/REFERENCE.zh.md)。
95
95
 
@@ -20,7 +20,8 @@ Open the workbench from the native DSH sidebar. See the [workbench guide](WORKBE
20
20
 
21
21
  - **Zero-taste-burden Auto-Director, 24 Master Themes & 6 Chrome Skeletons**: Ships 16 projector-safe daylight themes (including `bcg-emerald`, `economist-brief`, `venture-daylight`, `stripe-craft`, `consulting`, `cobalt-cream`, `exec-jilan`, `exec-palace`, `academic`, `editorial-forest`, `cartesian`, `course-sage`, `soft`, `keynote-light`, `financial-ft`, `medical-clean`) and 8 stage dark themes (including `aurora-stage`, `obsidian-amber`, `linear-dark`, `swiss`, `velvet`, `data`, `bold`, `luxury-noir`), paired with **6 Master Chrome Skeletons** and **20 industry scenario blueprints**. When `theme` is omitted in `ppt_create`, `auto` routes content to the best-fit persona theme and chrome.
22
22
  - **Deep Reference `.pptx` Absorption & Master Presets**: Includes **8 World-Class Reference Presets** plus external `.pptx` absorption via `ppt_absorb`, `referencePptx` (`cloneStructure: true`), or drag-and-drop (`≤24 MiB`) in **Style Studio** — unwrapping nested `<p:grpSp>` group shapes and resolving OOXML `sysClr`/`prstClr`/`hueMod` modifiers, dual brand accents, heading/body font pairings, dark-cover + daylight-body polarity, master logos, `recommendedChrome`, and 24-layout `slideSkeleton[]` sequences with WCAG ≥4.5:1 clamping.
23
- - **24+ Native Editable Layouts/Diagrams & 13 Pro Chart Kinds**: Build interlocking **Value-Chain Chevrons** (`chevron`), Bento/pillar `cards`, hero `kpi` grids, `comparison`, `matrix` (2×2), `process` (steps / timeline / chevron / layers / funnel / flywheel), `callout`, `gantt` roadmaps, `architecture` layered diagrams, `harvey`-ball competitor matrices, `tam` concentric circles, `org`/team charts, `table` (`consulting | booktabs | minimal | banded | harvey`), `chart-split`, and 13 Economist/FT chart variants.
23
+ - **28+ Native Editable Layouts, Pinnacle Diagrams & Native `<m:oMath>` Equations**: Adds variable-width **Marimekko (`marimekko`)**, multi-layer **Sankey (`sankey`)**, authentic **Porter Value Chain (`value-chain`)**, **SWOT Cross Matrix (`swot`)**, and zero-dependency LaTeX-to-OOXML `<m:oMath>` + HTML MathML math compilation (`slide.formula` / `$...$`), alongside interlocking Chevrons (`chevron`), Bento/pillar `cards`, hero `kpi` grids, `comparison`, `matrix` (2×2), `process` (steps / timeline / chevron / layers / funnel / flywheel), `callout`, `gantt` roadmaps, `architecture` layered diagrams, `harvey`-ball competitor matrices, `tam` concentric circles, `org`/team charts, `table` (`consulting | booktabs | minimal | banded | harvey`), `chart-split`, and 13 Economist/FT chart variants.
24
+ - **10th Tool `ppt_import`, Legacy `.pptx` Refurbishment, Dual-Screen Presenter & Handouts**: Import external `.pptx` decks (text, tables, live native `<c:chart>` charts, images, and speaker notes) via `ppt_import` or Workbench **Import & Modernize .pptx** / **Sync Edited .pptx** with full undo history; launch **Dual-Screen Presenter View** (`P` key / `L` laser pointer) during HTML playback and export structured `.handout.md` speaker handouts.
24
25
  - **Rich Workbench & Style Studio**: Search and filter projects with theme/page metadata; switch slide archetypes and per-slide chrome skeletons in one click, edit Gantt timelines, Harvey matrices, structured `items`, and tables, add/duplicate/reorder slides, compare HTML ↔ rendered PPTX side-by-side, jump directly from quality findings to slides, and undo up to 20 revisions.
25
26
  - **Traceable Data & What-If Scenarios**: Bind `{{metricId}}` across titles, bullets, `items` (including `gantt`, `tam`, `architecture`, `org`), `harvey`/table `rows`, `takeaway`, `source`, and charts; adjust declared assumptions live in HTML and save confirmed snapshots to PPTX. See [the data guide](DATA.md#english).
26
27
  - **Optional 24-Slide Two-Tier Vision QA**: Inspect rendered PPTX images for both layout bugs and aesthetic hierarchy, apply 12 lossless formatting actions on a copy, and compare full-width before/after renders on the canvas. See [visual review](VISUAL.md#english).
@@ -45,7 +46,7 @@ For the web version, replace `desktop` with `web`. Restart DSH after installatio
45
46
  4. Explicitly start optional AI storyline review, rehearsal or 24-slide visual repair when needed; direct download does not require them.
46
47
  5. Deliver the share bundle or retain editability with the project bundle; check the result in the target browser or Office application.
47
48
 
48
- Office changes do not sync back to JSON. Externally changed outputs and legacy projects without integrity records cannot be overwritten. Use **Save a copy** or `ppt_edit(saveAs:true)` to rebuild a new trio from JSON while preserving the originals. The copy does not import Office edits.
49
+ Sync Office-edited `.pptx` changes back into an open project via `ppt_import` or **Sync Edited .pptx** (undoable). When outputs were altered directly outside the project without syncing, use **Save a copy** or `ppt_edit(saveAs:true)` to rebuild a new trio from JSON while preserving the originals.
49
50
 
50
51
  ## Requirements and configuration
51
52
 
@@ -20,7 +20,8 @@
20
20
 
21
21
  - **零品味负担自动导演、24 套大师主题与 6 套母版骨架**:内建 16 套明亮投影友好主题(含新增翡翠战略 `bcg-emerald`、经济学人简报 `economist-brief`、红杉创投简报 `venture-daylight`、云靛工坊 `stripe-craft`,以及 `consulting`、`cobalt-cream`、`exec-jilan`、`exec-palace`、`academic`、`editorial-forest`、`cartesian`、`course-sage`、`soft`、`keynote-light`、`financial-ft`、`medical-clean`)与 8 套深色舞台主题(含新增极光发布会 `aurora-stage`、黑曜终端 `obsidian-amber`,以及 `linear-dark`、`swiss`、`velvet`、`data`、`bold`、`luxury-noir`),匹配 **6 套差异化母版骨架**与 **20 套行业场景蓝图**。未指定主题时 `ppt_create` 默认启用 `auto` 场景导演。
22
22
  - **深度吸收外部 `.pptx` 骨架与名家范本**:内置 **8 套名家范本一键直吸**,并支持 `ppt_absorb` 工具、`referencePptx`(含 `cloneStructure: true` 结构复刻)或工作台「风格与母版」面板直接上传参考 `.pptx`(≤24 MiB),自动递归拆解嵌套组合形状 `<p:grpSp>`、解析 OOXML `sysClr`/`prstClr`/`hueMod` 修饰色板、主辅双强调色、标题/正文字体配对、深色封面+浅色正文极性、母版 Logo、骨架几何(`extractedSkeleton` / `recommendedChrome`)与 24 版式逐页序列(`slideSkeleton[]`),支持收藏到工作台品牌库复用。
23
- - **24+ 种原生可编辑版式/专业图示与 13 种出版级图表**:新增咨询价值链五边形咬合箭头(`chevron` / `process[chevron]`),并覆盖 Bento/支柱卡片(`cards`)、大数字指标(`kpi`)、双栏/痛点举措对比(`comparison`)、四象限矩阵(`matrix`)、流程/里程碑轴/漏斗/飞轮(`process`)、定理/行动清单(`callout`)、甘特图路线图(`gantt`)、分层系统架构(`architecture`)、哈维球竞品矩阵(`harvey`)、TAM/SAM/SOM 同心圆(`tam`)、组织架构/团队图谱(`org`)、咨询表与学术三线表(`table` `booktabs` `harvey`)、图表+洞察分栏(`chart-split`)及矢量瀑布桥(`waterfall`)等。
23
+ - **28+ 种原生可编辑版式/专业图示与原生 `<m:oMath>` 数学公式**:新增 **不等宽市场图(`marimekko`)**、**多层桑基流向图(`sankey`)**、**真·波特价值链(`value-chain`)**、**SWOT 战略十字矩阵(`swot`)** 及基于 `deck-math.mjs` 的原生 Office Math(`<m:oMath>`)+ W3C MathML LaTeX 公式编译(`slide.formula` / `$...$`),覆盖咨询价值链五边形咬合箭头(`chevron`)、Bento/支柱卡片(`cards`)、大数字指标(`kpi`)、双栏/痛点举措对比(`comparison`)、四象限矩阵(`matrix`)、流程/里程碑轴/漏斗/飞轮(`process`)、定理/行动清单(`callout`)、甘特图路线图(`gantt`)、分层系统架构(`architecture`)、哈维球竞品矩阵(`harvey`)、TAM/SAM/SOM 同心圆(`tam`)、组织架构/团队图谱(`org`)、咨询表与学术三线表(`table` `booktabs` `harvey`)、图表+洞察分栏(`chart-split`)及矢量瀑布桥(`waterfall`)等。
24
+ - **第 10 个工具 `ppt_import`、PPTX 一键翻新与 Office 双向导回**:支持通过 `ppt_import`(或工作台「导入 PPTX 翻新 / 导入 Office 修改稿」)从任意 `.pptx` 提取正文、表格、原生 `<c:chart>` 图表、嵌入图片与演讲备注,既可全新翻新为高颜值工程,也可在 PowerPoint / WPS 微调后导回既有工程更新(保留 `.history/` 撤销历史);同时支持双屏演讲者提词台(HTML 按 `P` 开启、`L` 键虚拟激光笔)与 `.handout.md` 演讲讲义导出。
24
25
  - **工程库与增强工作台**:按关键词/主题搜索排序,展示主题与页数标签;支持单页版式与单页母版骨架一键无损切换、结构化卡片/甘特图时间轴/哈维球与表格编辑、新增页面、HTML ↔ PPTX 并排分屏对比、点击质量提醒直接跳页,以及最多 20 步撤销。
25
26
  - **可选数字溯源与现场推演**:点击数字追到原始材料、CSV 单元格或公式(全面支持 `items`、甘特图、`tam`、架构、哈维球矩阵、`takeaway`、`source` 与图表绑定);调整假设、预览影响并确认保存。见[数据说明](DATA.md)。
26
27
  - **可选双层 AI 视觉检查(最多 24 页)**:看实际 PPTX 渲染图,兼顾排版溢出检测与审美层级把关,支持 12 种零文本篡改排版动作、全宽画布前后对比、停止与撤销。见[看图修复](VISUAL.md)。
@@ -45,7 +46,7 @@ dsh plugin --profile desktop add dsh-ppt
45
46
  4. 按需要主动开启 AI 预审、模拟答辩或看图修复;直接下载成品不要求这些步骤。
46
47
  5. 下载“分享成品包”交付,或下载“完整工程包”保留编辑能力;在目标播放器或 Office 中再核对一次。
47
48
 
48
- Office 中的修改不会同步回 JSON。插件检测到成品在外部修改,或旧工程没有校验记录时,会拒绝直接覆盖;可用面板「另存副本」或 `ppt_edit(saveAs:true)` 从 JSON 生成新文件,保留原成品。副本不包含 Office 手工修改。
49
+ 支持通过 `ppt_import` 或工作台「导入 Office 修改稿」将 PowerPoint / WPS 中的修改导回工程(保留撤销历史)。若外部直接修改成品且未走导回,可用面板「另存副本」或 `ppt_edit(saveAs:true)` 从 JSON 重建新文件,保留原成品。
49
50
 
50
51
  ## 依赖与配置
51
52
 
package/docs/USAGE.en.md CHANGED
@@ -14,9 +14,10 @@
14
14
  | Capability | Description |
15
15
  | --- | --- |
16
16
  | `ppt_create` tool | Markdown / structured `slides` → `*.html` + `*.pptx` + `*.json`; defaults to `theme: "auto"` and accepts `referencePptx` + `cloneStructure: true` for deep palette, chrome & skeleton cloning |
17
+ | `ppt_import` tool | 10th agent tool: import an external `.pptx` (text, tables, native charts, images, speaker notes) into a modernized editable project, or pass `projectId` to sync Office-edited `.pptx` changes back into an existing project with undo history |
17
18
  | `ppt_absorb` tool | Read-only local extraction of OOXML modified palette colors, fonts, aspect ratio, chrome geometry (`extractedSkeleton`, `recommendedChrome`), slide sequence (`slideSkeleton[]`), and optional logo from a reference `.pptx` |
18
19
  | `ppt_themes` tool | Lists all 24 built-in themes (16 daylight + 8 dark) paired with 6 chrome skeletons; pass `preview: true` with `outputDir` to generate a side-by-side HTML gallery and SVG palette cards |
19
- | 24+ layouts & diagrams | `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `process` / `callout` / `gantt` / `architecture` / `harvey` / `tam` / `org` / `table` / `closing` / `image` / `image-left` / `image-right` / `chart` / `chart-split` (plus `chevron`, `value-chain`, `waterfall`, `gallery`, and `flywheel` aliases) |
20
+ | 28+ layouts & diagrams | `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `process` / `callout` (with native `<m:oMath>` `formula`) / `gantt` / `architecture` / `harvey` / `tam` / `org` / `marimekko` / `sankey` / `swot` / `value-chain` / `table` / `closing` / `image` / `image-left` / `image-right` / `chart` / `chart-split` (plus `chevron`, `waterfall`, `gallery`, and `flywheel` aliases) |
20
21
  | 13 chart kinds | `column` / `bar` / `stacked-column` / `stacked-bar` / `percent-column` / `percent-bar` / `line` / `area` / `pie` / `doughnut` / `scatter` / `combo` / `waterfall` with `highlight` focal emphasis |
21
22
  | `ppt_templates` | 20 scenario blueprints: `weekly`, `defense`, `project`, `pitch`, `consulting`, `keynote`, `gov-report`, `workshop`, `architecture-review`, `financial-earnings`, `medical-case`, `postmortem`, `marketing-campaign`, `promotion-review`, `legal-compliance`, `creative-lookbook`, `quarterly-okr`, `product-prd`, `vc-daylight`, `industry-research` |
22
23
  | `ppt_edit` / `ppt_undo` | Edit selected slides, switch deck `theme` / `brand` / `referencePptx`, append/duplicate/remove/reorder slides with 20-step undo and revision guards |
@@ -25,7 +26,7 @@
25
26
  | `ppt_data` | Optional source lineage updates and what-if simulation with diff preview before saving; see [data guide](DATA.md#english) |
26
27
  | Visual review & repair | Optional rendered-PPTX inspection (up to 24 original slides) with 12 lossless repair actions and re-render verification; see [visual guide](VISUAL.md#english) |
27
28
  | Coaching & rehearsal | Optional storyline (SCQA / Pyramid / Action Titles), expression, logic & evidence pre-review (up to 8 findings) and 7-persona Q&A rehearsal; see [coaching guide](COACHING.md#english) |
28
- | Speaker notes & motion | `<!-- note: ... -->` or `notes` field synced to HTML presenter view (`V`/`S`) and native PPTX notes; motion on by default (`motion: 'off'` / `--motion off` for static) |
29
+ | Presenter Console, handout & motion | `<!-- note: ... -->` or `notes` syncs to HTML Dual-Screen Presenter View (`P` to open, `L` laser pointer) and native PPTX notes, plus `.handout.md` export; motion on by default (`motion: 'off'` / `--motion off` for static) |
29
30
  | `dsh-ppt` skill & CLI | Full Auto-Director SOP registered in DSH, or copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for standalone cross-harness builds |
30
31
 
31
32
  Example:
package/docs/USAGE.md CHANGED
@@ -14,9 +14,10 @@
14
14
  | 能力 | 说明 |
15
15
  | --- | --- |
16
16
  | `ppt_create` 工具 | Markdown / 结构化 `slides` → `*.html` + `*.pptx` + `*.json` 三件套;默认 `theme: "auto"` 自动匹配主题与骨架,支持 `referencePptx` 与 `cloneStructure: true` 深度复用参考结构 |
17
+ | `ppt_import` 工具 | 第 10 个工具:导入外部 `.pptx`(正文、表格、原生图表、图片、备注)一键翻新为可编辑工程,或传入 `projectId` 将 Office 修改稿导回既有工程更新(支持撤销) |
17
18
  | `ppt_absorb` 工具 | 本地只读解析参考 `.pptx` 的主题修饰色板、字体、画幅比例、母版骨架几何(`extractedSkeleton` / `recommendedChrome`)、逐页序列(`slideSkeleton`)与可选嵌入 Logo |
18
19
  | `ppt_themes` 工具 | 列出 24 套内置主题(16 明亮 + 8 深色)与 6 套母版骨架;传 `preview: true, outputDir: "dist"` 生成主题对比页 + 每套 SVG 色板卡 |
19
- | 24+ 种页型与图示 | `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `process` / `callout` / `gantt` / `architecture` / `harvey` / `tam` / `org` / `table` / `closing` / `image` / `image-left` / `image-right` / `chart` / `chart-split`(兼容 `chevron`、`value-chain`、`waterfall`、`gallery`、`flywheel` 别名) |
20
+ | 28+ 种页型与图示 | `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `process` / `callout`(支持原生 `<m:oMath>` `formula`) / `gantt` / `architecture` / `harvey` / `tam` / `org` / `marimekko` / `sankey` / `swot` / `value-chain` / `table` / `closing` / `image` / `image-left` / `image-right` / `chart` / `chart-split`(兼容 `chevron`、`waterfall`、`gallery`、`flywheel` 别名) |
20
21
  | 13 类原生图表 | `column` / `bar` / `stacked-column` / `stacked-bar` / `percent-column` / `percent-bar` / `line` / `area` / `pie` / `doughnut` / `scatter` / `combo` / `waterfall`,支持 `highlight` 焦点项染色 |
21
22
  | `ppt_templates` | 20 套场景蓝图:`weekly`、`defense`、`project`、`pitch`、`consulting`、`keynote`、`gov-report`、`workshop`、`architecture-review`、`financial-earnings`、`medical-case`、`postmortem`、`marketing-campaign`、`promotion-review`、`legal-compliance`、`creative-lookbook`、`quarterly-okr`、`product-prd`、`vc-daylight`、`industry-research` |
22
23
  | `ppt_edit` / `ppt_undo` | 按页或整套切换主题/品牌/参考 `.pptx`、增删改排页面,支持最多 20 次历史与修订号冲突保护 |
@@ -26,7 +27,7 @@
26
27
  | AI 看图修复 | 可选实际 PPTX 图片检查(最多 24 页)、12 种无损排版动作、可撤销副本与重新渲染复查;见[看图修复](VISUAL.md) |
27
28
  | AI 预审与模拟答辩 | 可选叙事主线(SCQA / 金字塔 / 动作标题)、表达、逻辑与证据缺口预审(最多 8 条)及 7 类听众模拟答辩;见[预审与答辩](COACHING.md) |
28
29
  | 品牌与母版 | 共享主色、背景色、文字色、字体、Logo、页脚,HTML 与 PPTX 同源同步 |
29
- | 演讲者备注与动效 | `<!-- 备注: ... -->` 或 `notes` 字段同步至 HTML 演讲者视图(`V`/`S`)与 PPTX 原生备注页;`motion` 默认开启,`motion: 'off'` / `--motion off` 产出纯静态 |
30
+ | 演讲者提词台、讲义与动效 | `<!-- 备注: ... -->` 或 `notes` 字段同步至 HTML 双屏演讲者提词台(`P` 开启、`L` 激光笔)与 PPTX 原生备注页,支持导出 `.handout.md` 讲义;`motion` 默认开启,`motion: 'off'` / `--motion off` 产出纯静态 |
30
31
  | `dsh-ppt` 技能 & 裸 CLI | 完整自动审美指导 SOP 注册进 DSH;也可将 `skills/dsh-ppt/` 复制到 Claude Code / Cursor / Gemini CLI / Codex 跨环境独立运行 |
31
32
 
32
33
  示例对话:
@@ -6,6 +6,10 @@
6
6
 
7
7
  ## 最新记录
8
8
 
9
+ **0.24.0 原生公式、巅峰图示、PPTX 双向往返与双屏提词台验收(2026-11-18)**:全量 `tsc`、客户端打包、`test/*.test.mjs` 全部通过(0 失败,Wire Schema 0 `type` 数组);`@office-kit/pptx` `validatePresentation()` 0 错误;实机 `@deepseek-ai/libreoffice-kit` 无头渲染(`missingFonts: []`)逐页目视核验 `marimekko` 不等宽市场图、`sankey` 多层流向桑基图、`value-chain` 波特价值链、`swot` 十字矩阵、原生 `<m:oMath>` 数学公式、老旧 `.pptx` 一键翻新导入与 `.handout.md` / 双屏提词台脚本。
10
+
11
+ - **0.24.0 Bilingual Validation Record (2026-11-18)**: Full `tsc`, client bundle build, and `test/*.test.mjs` suite passed with 0 failures and 0 `type` arrays on tool wire schemas; `@office-kit/pptx` `validatePresentation()` passed with 0 errors; real `@deepseek-ai/libreoffice-kit` headless rendering (`missingFonts: []`) visually verified `marimekko`, `sankey`, Porter `value-chain`, `swot`, native `<m:oMath>` equations, legacy `.pptx` round-trip refurbishment, `.handout.md`, and Dual-Screen Presenter Console.
12
+
9
13
  **0.22.0 深度换骨与实机渲染验收(2026-11-18)**:311 / 311 项自动化测试全部通过;`tsc` 与客户端打包 0 错误;`@office-kit/pptx` `validatePresentation()` 0 错误;实机 `@deepseek-ai/libreoffice-kit` 无头渲染(`missingFonts: []`)逐页目视核验全部 6 套母版骨架、5 大新增原生专业图示(`gantt`、`architecture`、`harvey`、`tam`、`org`)、`flywheel`/`funnel` 及 7 份野生 `.pptx` 深度骨架吸收(`cloneStructure: true`)。
10
14
 
11
15
  [0.19.0 分享成品包验收](validation-0.19.0.md):208 项 Windows 测试、官方 DSH Web 实际保存与两种 ZIP 下载、离线 HTML、三页最终 PPTX 原生渲染及逐页目视检查、中英文与深色窄屏。Electron 专属行为与真实 Office 应用本轮未测。
package/docs/WORKBENCH.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # dsh-ppt 工作台 / Workbench
2
2
 
3
- 演示文稿主工作台,提供自助「新建演示文稿」向导、可折叠四步使用指引、页面栏、画布区与五栏属性面板(内容编辑、风格与母版、视觉检查、演练、数据与推演);支持一键切换 24 套主题、8 套名家范本预设、6 套母版骨架与 24+ 种版式原型(含价值链五边形箭头 `chevron`)、拖拽深度吸收参考 `.pptx`(≤24 MiB)并收藏到「我的品牌库」、HTML ↔ PPTX 并排对比及画布级视觉修复前后对照,保留跨栏推演联动、未保存保护和画面内全屏退出。
3
+ 演示文稿主工作台,提供自助「新建演示文稿」与「导入 PPTX 翻新」向导、可折叠四步使用指引、页面栏、画布区与五栏属性面板(内容编辑、风格与母版、视觉检查、演练、数据与推演);支持一键切换 24 套主题、8 套名家范本预设、6 套母版骨架与 28+ 种版式原型(含不等宽市场图 `marimekko`、桑基图 `sankey`、波特价值链 `value-chain`、SWOT 矩阵 `swot` 与 LaTeX 原生公式)、上传 Office 修改稿导回更新工程(保留撤销历史)、拖拽深度吸收参考 `.pptx`(≤24 MiB)并收藏到「我的品牌库」、导出 `.handout.md` 演讲讲义、HTML ↔ PPTX 并排对比及画布级视觉修复前后对照,保留跨栏推演联动、未保存保护和画面内全屏退出。
4
4
 
5
- Presentation workbench with a self-service **New presentation** wizard, collapsible 4-step workflow guide, slide rail, split-capable canvas, and five inspector tabs (Edit content, Style Studio, Visual review, Rehearsal, Data and what-if); supports 1-click switching across 24 themes, 8 World-Class Reference Presets, 6 master chrome skeletons, and 24+ slide archetypes (including value-chain `chevron`), in-memory deep `.pptx` style & skeleton absorption (`≤24 MiB`) with reusable **My Brand Library** presets, HTML ↔ PPTX side-by-side comparison, and full-width Vision QA before/after diffs.
5
+ Presentation workbench with self-service **New presentation** and **Import & Modernize .pptx** wizards, collapsible 4-step workflow guide, slide rail, split-capable canvas, and five inspector tabs (Edit content, Style Studio, Visual review, Rehearsal, Data and what-if); supports 1-click switching across 24 themes, 8 World-Class Reference Presets, 6 master chrome skeletons, and 28+ slide archetypes (including `marimekko`, `sankey`, Porter `value-chain`, `swot`, and LaTeX `formula` editing), round-trip **Sync Edited .pptx** with undo history, in-memory `.pptx` style & skeleton absorption (`≤24 MiB`) with **My Brand Library**, `.handout.md` speaker handout download, HTML ↔ PPTX side-by-side comparison, and full-width Vision QA diffs.
6
6
 
7
7
  ## 使用 / Use
8
8
 
@@ -31,7 +31,8 @@ The UI follows host language and theme without translating user content. Narrow
31
31
 
32
32
  - **分享成品包 ZIP**:当前 PPTX、可离线放映的 HTML、逐页 Markdown 讲稿与使用说明;不含 JSON 工程和完整导入材料。分享版 HTML 保留 PPTX 下载入口,移除工程下载入口。原文件不会改变。
33
33
  - **完整工程包 ZIP**:PPTX、HTML、JSON 工程与使用说明,方便备份或继续编辑。JSON 可能含完整导入材料。
34
- - 也可分别下载 PPTX、HTML、讲稿或工程。未保存时先保存,旧修订的下载会被拒绝。
34
+ - 也可分别下载 PPTX、HTML、演讲讲义(`kind: 'handout'`,导出 `.handout.md`)、讲稿 Markdown 或工程。未保存时先保存,旧修订的下载会被拒绝。
35
+ - 独立打开导出的 HTML 放映页时,按 **`P`** 可开启双屏演讲者提词台(支持下一页预览、提词字号缩放、计时器与 **`L` 键虚拟激光笔**)。
35
36
 
36
37
  分享包里的 HTML、PPTX 备注和讲稿仍保留已绑定的来源摘录与用户填写内容。分包不等于自动脱敏,请按收件人需要选择内容。
37
38