dsh-ppt 0.25.0 → 0.27.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 +22 -0
- package/README.en.md +14 -13
- package/README.md +14 -13
- package/docs/DATA.md +2 -2
- package/docs/REFERENCE.en.md +8 -8
- package/docs/REFERENCE.zh.md +8 -8
- package/docs/USAGE.en.md +12 -7
- package/docs/USAGE.md +12 -7
- package/docs/VALIDATION.md +8 -0
- package/docs/WORKBENCH.md +4 -4
- package/docs/assets/intro/workflow-en-dark.svg +1 -1
- package/docs/assets/intro/workflow-en-light.svg +1 -1
- package/docs/assets/intro/workflow-en-mobile-dark.svg +1 -1
- package/docs/assets/intro/workflow-en-mobile-light.svg +1 -1
- package/docs/assets/intro/workflow-zh-dark.svg +1 -1
- package/docs/assets/intro/workflow-zh-light.svg +1 -1
- package/docs/assets/intro/workflow-zh-mobile-dark.svg +1 -1
- package/docs/assets/intro/workflow-zh-mobile-light.svg +1 -1
- package/lib/client.js +312 -84
- package/lib/ecosystem.d.ts +73 -0
- package/lib/ecosystem.js +1352 -0
- package/lib/execution.d.ts +6 -1
- package/lib/execution.js +77 -4
- package/lib/tools.js +133 -1
- package/lib/types.d.ts +121 -1
- package/lib/workbench-language.js +4 -0
- package/lib/workbench.d.ts +2 -0
- package/lib/workbench.js +397 -10
- package/package.json +1 -1
- package/skills/dsh-ppt/SKILL.md +6 -6
- package/skills/dsh-ppt/package.json +1 -1
- package/skills/dsh-ppt/references/advanced.md +10 -5
- package/skills/dsh-ppt/references/syntax.md +1 -0
- package/skills/dsh-ppt/scripts/build-deck.mjs +53 -10
- package/skills/dsh-ppt/scripts/deck-absorb.mjs +114 -1
- package/skills/dsh-ppt/scripts/deck-advanced.mjs +153 -25
- package/skills/dsh-ppt/scripts/deck-chrome.mjs +1814 -0
- package/skills/dsh-ppt/scripts/deck-core.mjs +122 -6
- package/skills/dsh-ppt/scripts/deck-covers.mjs +804 -0
- package/skills/dsh-ppt/scripts/deck-delivery.mjs +636 -41
- package/skills/dsh-ppt/scripts/deck-diagrams.mjs +2842 -0
- package/skills/dsh-ppt/scripts/deck-director.mjs +167 -4
- package/skills/dsh-ppt/scripts/deck-icons.mjs +469 -0
- package/skills/dsh-ppt/scripts/deck-layouts.mjs +816 -5177
- package/skills/dsh-ppt/scripts/deck-media.mjs +159 -15
- package/skills/dsh-ppt/scripts/deck-mermaid.mjs +2737 -0
- package/skills/dsh-ppt/scripts/deck-office.mjs +1541 -0
- package/skills/dsh-ppt/scripts/deck-taste.mjs +347 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,27 @@
|
|
|
1
1
|
# 更新记录
|
|
2
2
|
|
|
3
|
+
## 0.27.0 (2026-11-20)
|
|
4
|
+
|
|
5
|
+
- **全栈审美工坊与 8 套大师品味配方(Aesthetic Studio & Curated Taste Recipes)**:新增零外部依赖 `deck-taste.mjs` 与 8 套向世界顶级演示流派致敬的结构化品味配方(`mckinsey-partner` 麦肯锡合伙人精修、`apple-keynote-dark` Apple 发布会暗夜、`apple-keynote-light` Apple 极简纯白、`swiss-editorial` 瑞士杂志 Monocle、`linear-craft` Linear 玻璃工艺、`ft-data-journal` Financial Times 研报、`nature-academic` Nature/NeurIPS 学术、`oriental-zen` 东方极简宋韵),通过 `taste` 参数 / CLI `--taste` / `--list-tastes` / 工作台风格面板一键协同驱动封面形态、材质、节奏、图标语言与图表精修。
|
|
6
|
+
- **材质光影层次、4 套海报级封面与实时议程章节页**:新增 `deck-covers.mjs` 与原生 OOXML 径向光斑渐变(`<a:gradFill><a:path path="circle">`)、半透明描边(`strokeAlpha`)及 4 种卡片材质(`solid` 实心、`frameless` 细线无框、`glass` 发布会玻璃拟态、`editorial-rule` 出版物双发丝);新增 4 套海报级封面(`keynote-glow` 光晕剧场、`editorial-grid` 瑞士三栏网格、`architectural` 建筑深色侧翼、`split-bleed` 半屏出血)与 `section[agenda]` 自动多章节实时进度追踪过场页,HTML 与 PPTX 1:1 双端同构。
|
|
7
|
+
- **反单调主次构图引擎、61 枚原生矢量图标与出版级图表精修**:新增 `kpi[spotlight]`(左侧 50% 主指标英雄位 + 右侧无框副指标栈)、`kpi[frameless]`、`cards[frameless]`、`cards[bento-hero]`(深色渐变反色锚点卡 + 右侧副卡),`deck-director.mjs` 新增视觉节奏优化器 `optimizeVisualRhythm` 与 `SLOP-11`(连续方框疲劳)/`SLOP-12`(图表缺焦点强调)审美门禁;新增 `deck-icons.mjs` 内置 **61 枚零依赖线性矢量图标**(HTML `<svg>` + PPTX 100% 原生可编辑 `<a:custGeom>` 多路径矢量图形,支持中英语义自动匹配 `iconMode: 'auto'`);`deck-media.mjs` 升级图表 `spotlight` 焦点配色、`referenceLine` 基准目标虚线、`showGrowthCallout` 麦肯锡增长飞线与独立顶部注释条(零遮挡),组合图标签智能防碰撞。
|
|
8
|
+
- **标杆 PPTX 深层审美 DNA 吸收与持久品味库**:升级 `deck-absorb.mjs` 自动测算任意外部 `.pptx` 的留白率(`whitespaceRatio`)、卡片材质(`cardMaterial`)、字阶比(`typeScaleRatio`)、封面/章节形态与视觉节奏分(`rhythmScore`),生成可复用 `styleRecipe` 并支持 `--save-taste` / `saveTasteAs` 持久化至 `.dsh-ppt/taste-recipes.json`,后续新稿与工作台风格面板直接复用吸收的标杆品味。
|
|
9
|
+
- **Aesthetic Studio & 8 Curated Taste Recipes (`deck-taste.mjs`)**: Ship 8 world-class Taste Recipes (`mckinsey-partner`, `apple-keynote-dark`, `apple-keynote-light`, `swiss-editorial`, `linear-craft`, `ft-data-journal`, `nature-academic`, `oriental-zen`) across `ppt_create` / `ppt_edit` / `ppt_themes`, CLI (`--taste`, `--list-tastes`, `--save-taste`), and Workbench Style Studio (with atomic `undo` support).
|
|
10
|
+
- **Materiality, Radial Lighting, 4 Poster Covers & Live Agenda Sections (`deck-covers.mjs`)**: Add native OOXML radial gradients (`<a:path path="circle">`), `strokeAlpha`, 4 card surface materials (`solid` | `frameless` | `glass` | `editorial-rule`), 4 poster cover variants (`keynote-glow`, `editorial-grid`, `architectural`, `split-bleed`), and automatic multi-chapter `section[agenda]` tracker slides with 1:1 HTML/PPTX parity.
|
|
11
|
+
- **Anti-Monotony Layouts, 61 Native Vector Icons (`deck-icons.mjs`) & Publication-Grade Chart Finishing**: Add `kpi[spotlight]`, `kpi[frameless]`, `cards[frameless]`, `cards[bento-hero]`, `optimizeVisualRhythm`, and `SLOP-11`/`SLOP-12` aesthetic checks; embed 61 zero-dependency geometric vector icons compiled to both HTML `<svg>` and 100% native editable OOXML `<a:custGeom>` with bilingual semantic auto-matching; upgrade charts with `spotlight`, `referenceLine`, `showGrowthCallout` / `callout`, dedicated non-clipping PPTX annotation strips, and smart combo anti-collision.
|
|
12
|
+
- **Benchmark `.pptx` Aesthetic DNA Learning (`deck-absorb.mjs`)**: Extract 6-signal aesthetic DNA (`whitespaceRatio`, `cardMaterial`, `typeScaleRatio`, `coverVariant`, `sectionVariant`, `rhythmScore` -> `styleRecipe`) from any reference `.pptx` and persist custom recipes in `.dsh-ppt/taste-recipes.json` for 1-click reuse in future decks.
|
|
13
|
+
|
|
14
|
+
## 0.26.0 (2026-11-20)
|
|
15
|
+
|
|
16
|
+
- **原生可编辑 Mermaid 流程图 / 时序图与 `deck-layouts.mjs` 模块化拆分**:零外部依赖新增 `deck-mermaid.mjs`,支持 `layout: 'mermaid'`(别名 `flowchart` / `sequence`)及 Markdown 代码块 ```` ```mermaid ```` 自动识别,将 `flowchart TD/TB/LR/RL`(含 `subgraph`、判断菱形、终端胶囊、数据库圆柱及多样式连线)与 `sequenceDiagram`(含参与者生命线、激活条、消息箭头、批注与 `alt/loop` 框)编译为 100% 原生可编辑 PowerPoint 形状(`<p:sp>`)与吸附连接线(`<p:cxnSp>` + `<a:stCxn>`/`<a:endCxn>`)及高精 HTML SVG;同步将 `deck-layouts.mjs` 模块化拆分为 `deck-chrome.mjs`、`deck-diagrams.mjs` 与精简核心入口,零破坏保留全部导出。
|
|
17
|
+
- **Word / Excel / CSV 直吞建稿(`ppt_from_office`)**:新增零新增依赖 `deck-office.mjs` 与 Agent 工具 `ppt_from_office`(CLI `--from-office`、工作台 `import-office` 上传),直接解析 `.xlsx` 多工作表、`.csv`/`.tsv` 与 `.docx` Word 报告;内置 Data-to-Visual 画像器自动把流向表转 `sankey`、排期转 `gantt`、份额转 `marimekko`、增减桥转 `waterfall`、双量纲转 `combo` 并附三线表,将 `.docx` 标题/表格/内嵌图片/公式送入智能导演生成全套工程。
|
|
18
|
+
- **`dsh-cite` 文献核验与 `dsh-remotion` 视频分镜联动**:新增 `src/ecosystem.ts` 与工具 `ppt_cite`(读取工作区 `.dsh-cite` 库、JSON/JSONL 或 BibTeX,替换 `[@citeKey]` / `[doi:...]` 为真实学术尾注与 `References` 页,零捏造 DOI)及 `ppt_remotion`(按演讲时长预算导出 30fps `DeckVideo.tsx` + `slides-data.json` + `remotion-storyboard.json` 视频分镜包)。
|
|
19
|
+
- **演讲时长预算器、高管一页纸与工作台 `? 引导`**:新增 `computePaceBudget`(按中文 220 字/分、英文 145 词/分与图示理解时长预算每页用时,支持 `targetMinutes` 与超时提醒)、`renderOnePagerHtml`(高管一页纸:支持 A4 打印 PDF 与长图战报切换,HTML 放映面板与工作台 `kind: 'onepager'` 可直接导出)、工作台 **`? 引导`** 四步聚光灯交互导览(`templates/panels/tour.js`)与 **「一键体验旗舰示例」**(`create-demo`),并清理 GitHub Actions `package-manager-cache` 警告与刷新 8 张双语流程 SVG。
|
|
20
|
+
- **Zero-dependency Mermaid-to-Native-OOXML & Modular Layout Split**: Add `deck-mermaid.mjs` (`layout: 'mermaid'` / `'flowchart'` / `'sequence'`, plus automatic ```` ```mermaid ```` Markdown fence detection) compiling `flowchart` (subgraphs, decision diamonds, stadium terminals, cylinder DBs, labeled edges) and `sequenceDiagram` (lifelines, activations, notes, `alt/loop` frames) into 100% native editable PowerPoint shapes (`<p:sp>`) with attached `<p:cxnSp>` connectors (`<a:stCxn>`/`<a:endCxn>`) and crisp HTML SVGs; modularize `deck-layouts.mjs` into `deck-chrome.mjs`, `deck-diagrams.mjs`, and a lean core index with zero API breakage.
|
|
21
|
+
- **Direct `.xlsx` / `.csv` / `.tsv` & `.docx` Ingestion (`ppt_from_office`)**: Add `deck-office.mjs` (`extractOfficeSource`, `importOfficeDeck`, CLI `--from-office`, tool `ppt_from_office`, Workbench `import-office` `≤24 MiB`) using only Node built-ins + `csv-parse`; automatically profiles spreadsheets into `sankey`, `gantt`, `marimekko`, `waterfall`, `combo` `chart-split`, and `table` slides, and extracts Word headings, tables, embedded images, and formulas through Scenario Auto-Director.
|
|
22
|
+
- **Cross-Plugin `dsh-cite` & `dsh-remotion` Bridges (`src/ecosystem.ts`)**: Add `ppt_cite` (`attachCitationsToDeck`) to resolve `[@citeKey]` / `[doi:...]` markers from `.dsh-cite` / JSON / BibTeX into verified `slide.source` footers and a `References` slide, and `ppt_remotion` (`exportRemotionBundle`) to export 30fps Remotion storyboard packages (`DeckVideo.tsx`, `slides-data.json`, `remotion-storyboard.json`, `kind: 'remotion'` ZIP).
|
|
23
|
+
- **Speaking-Pace Budgeter, Executive One-Pager & `? Guide` Spotlight Tour**: Add `computePaceBudget(manifest, targetMinutes)` with live per-slide overrun diagnostics, `renderOnePagerHtml(manifest, lang)` (A4 print + mobile long-card toggle via `#download-onepager` / `kind: 'onepager'` / `--one-pager`), Workbench **`? Guide`** 4-step spotlight tour (`templates/panels/tour.js`) and 1-click **Load Flagship Demo** (`create-demo`), zero-warning GitHub Actions workflows, and refreshed bilingual workflow SVGs.
|
|
24
|
+
|
|
3
25
|
## 0.25.0 (2026-11-18)
|
|
4
26
|
|
|
5
27
|
- **工作台 UI v3、13 套明亮风格与 8 套中英双层字体搭配**:全新升级 48px 单行顶栏(含演示文稿编辑器紧凑单行顶栏)、滑动标签指示器、可拖拽分栏(`DshSplitResizer`)、微光骨架屏(`DshSkeleton`)与悬停快捷操作条;工作台主题扩展至 13 套明亮风格(新增「工程晒图 / Blueprint」「波普孔版 / Risograph」「千禧复古 / Win98」「宋韵朱砂 / Song Xuan」「晴空水晶 / Frutiger」「铅字晨报 / Gazette」等,移除旧版樱粉/抹茶),并新增独立字体切换器(`FontSwitcher` `字`/`Aa`,支持 8 套中英文双层字体搭配,默认「幼圆等宽 / YouYuan Mono」)。
|
package/README.en.md
CHANGED
|
@@ -9,17 +9,18 @@
|
|
|
9
9
|
**[Install](#install) · [Workflow](#start-using-it) · [Full guide](https://github.com/STARDUSTLC666/dsh-ppt/blob/master/docs/REFERENCE.en.md)**
|
|
10
10
|
|
|
11
11
|
<picture>
|
|
12
|
-
<source media="(prefers-color-scheme: dark) and (max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-mobile-dark.svg">
|
|
13
|
-
<source media="(max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-mobile-light.svg">
|
|
14
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-dark.svg">
|
|
15
|
-
<img src="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-light.svg" alt="
|
|
12
|
+
<source media="(prefers-color-scheme: dark) and (max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-mobile-dark.svg?v=0.27.0">
|
|
13
|
+
<source media="(max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-mobile-light.svg?v=0.27.0">
|
|
14
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-dark.svg?v=0.27.0">
|
|
15
|
+
<img src="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-light.svg?v=0.27.0" alt="Turn docs, spreadsheets, Mermaid diagrams, or legacy decks into deliverables. · workflow illustration" width="100%">
|
|
16
16
|
</picture>
|
|
17
17
|
|
|
18
18
|
## Features
|
|
19
19
|
|
|
20
|
-
- **
|
|
21
|
-
- **
|
|
22
|
-
- **
|
|
20
|
+
- **Aesthetic Studio (8 Curated Taste Recipes, 61 Native Vector Icons & Benchmark `.pptx` Taste Learning)**: Ships **8 world-class Taste Recipes** (`mckinsey-partner`, `apple-keynote-dark`, `apple-keynote-light`, `swiss-editorial`, `linear-craft`, `ft-data-journal`, `nature-academic`, `oriental-zen`) orchestrating **4 poster covers** (`keynote-glow` radial ambient orbs, `editorial-grid` Swiss 3-column metadata strip, `architectural` deep executive wing, `split-bleed`), **live multi-chapter `section[agenda]` trackers**, **4 card surface materials** (`solid`, `frameless`, `glass`, `editorial-rule`), **anti-monotony asymmetric layouts** (`kpi[spotlight]`, `cards[bento-hero]`), **61 zero-dependency geometric vector icons** (HTML `<svg>` + 100% native editable OOXML `<a:custGeom>` with bilingual semantic auto-matching), and **publication-grade chart finishing** (`spotlight` bar emphasis, `referenceLine` benchmarks, `showGrowthCallout` growth badges); `ppt_absorb` extracts 6-signal aesthetic DNA (`styleRecipe`) from any benchmark `.pptx` and saves reusable recipes to `.dsh-ppt/taste-recipes.json`.
|
|
21
|
+
- **Zero-taste-burden Auto-Director & Native Editable Mermaid Diagrams**: 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**, **zero-dependency Mermaid (`flowchart` & `sequenceDiagram`) → 100% native editable PPTX `<p:sp>` shapes and attached `<p:cxnSp>` connectors**, and **29+ native editable layouts & pro diagrams** (Marimekko market maps, multi-layer Sankey flow diagrams, Porter Value Chain, SWOT cross matrix, 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).
|
|
22
|
+
- **Direct Word/Excel/CSV Ingestion, `.pptx` Modernization & `dsh-cite` / `dsh-remotion` Bridges**: Ships **`ppt_from_office`** (zero new dependencies) to ingest `.xlsx` multi-sheet workbooks, `.csv`/`.tsv`, and `.docx` Word reports directly into multi-slide decks (auto-profiling flow sheets to Sankey, schedules to Gantt, share tables to Marimekko, bridges to Waterfall, and mixed-scale metrics to Combo charts); retains **`ppt_import`** for legacy `.pptx` refurbishment and Office round-trip sync (`≤24 MiB`, undoable); adds **`ppt_cite`** to attach verified **`dsh-cite`** references & generate a `References` slide, plus **`ppt_remotion`** to export animated **`dsh-remotion`** video storyboard packs.
|
|
23
|
+
- **Human-first Workbench, `? Guide` Spotlight Tour, Pace Budgeter & Multi-Format Delivery**: Adapted for DeepSeek Harness `>=0.2.2-rc.3` with 5 light UI themes; includes a **`? Guide`** 4-step interactive spotlight tour, 1-click **Load Flagship Demo** (`create-demo`), drag-and-drop **`.xlsx`/`.csv`/`.docx`/`.pptx`** import, click-to-edit preview targets (including Mermaid code & LaTeX `formula`s), **Speaking-Pace Budgeter (`targetMinutes` & live overrun badges)**, **Dual-Screen Presenter View** (`P` key + `L` laser), **Executive One-Pager (`.onepager.html` print A4 + mobile long-card toggle)**, **Speaker Handout (`.handout.md`)**, and **Remotion Storyboard `.zip`**.
|
|
23
24
|
- **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
25
|
|
|
25
26
|
## Style previews
|
|
@@ -74,12 +75,12 @@ For the web profile, replace `desktop` with `web`. Restart that DSH profile afte
|
|
|
74
75
|
|
|
75
76
|
Four intuitive steps — start either in chat or directly inside the workbench:
|
|
76
77
|
|
|
77
|
-
1. **Draft in seconds (
|
|
78
|
-
- **Self-serve in the Workbench**: Open **Presentations** in the sidebar
|
|
79
|
-
- **Ask in Chat**: Share
|
|
80
|
-
2. **Click-to-edit &
|
|
81
|
-
3. **Import
|
|
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.
|
|
78
|
+
1. **Draft in seconds (three ways)**:
|
|
79
|
+
- **Self-serve in the Workbench**: Open **Presentations** in the sidebar (click **`? Guide`** anytime for the 4-step spotlight tour), click **Load Flagship Demo** for an instant showcase, click **New presentation** to pick from 20 scenario blueprints, or drag-and-drop **`.xlsx` / `.csv` / `.docx` / `.pptx`** directly.
|
|
80
|
+
- **Ask in Chat**: Share Word/Excel/CSV files, Markdown (including ```` ```mermaid ```` flowcharts or sequence diagrams), or a reference `.pptx` path — Auto-Director picks a projector-safe theme and varied layouts automatically, and `ppt_cite` links verified `dsh-cite` references.
|
|
81
|
+
2. **Click-to-edit, layouts & speaking-pace budget**: Click any title, card, or table in the live preview to focus its editor field; switch bullets into **Mermaid flowcharts/sequence diagrams, 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), set **Target Duration (min)** to spot over-budget slides live, then press `Ctrl/⌘+S` or **Save slide**.
|
|
82
|
+
3. **Import Office/.pptx, round-trip edits & save your brand**: Import `.xlsx`/`.csv`/`.docx` or refurbish legacy `.pptx` files in one click, or sync PowerPoint/WPS edits back 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**.
|
|
83
|
+
4. **Present, verify & deliver everywhere**: 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, **Executive One-Pager (`.onepager.html`)**, **Remotion Storyboard (`.zip`)**, **Handout (`.md`)**, or Share ZIP.
|
|
83
84
|
|
|
84
85
|
Ready-to-copy chat prompts:
|
|
85
86
|
|
package/README.md
CHANGED
|
@@ -9,17 +9,18 @@
|
|
|
9
9
|
**[安装使用](#安装) · [使用流程](#开始使用) · [完整说明](https://github.com/STARDUSTLC666/dsh-ppt/blob/master/docs/REFERENCE.zh.md)**
|
|
10
10
|
|
|
11
11
|
<picture>
|
|
12
|
-
<source media="(prefers-color-scheme: dark) and (max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-mobile-dark.svg">
|
|
13
|
-
<source media="(max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-mobile-light.svg">
|
|
14
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-dark.svg">
|
|
15
|
-
<img src="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-light.svg" alt="
|
|
12
|
+
<source media="(prefers-color-scheme: dark) and (max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-mobile-dark.svg?v=0.27.0">
|
|
13
|
+
<source media="(max-width: 640px)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-mobile-light.svg?v=0.27.0">
|
|
14
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-dark.svg?v=0.27.0">
|
|
15
|
+
<img src="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-light.svg?v=0.27.0" alt="从文档、表格、流程图或旧 PPTX 出发,一键生成高审美可交付全套产物。 · 流程示意" width="100%">
|
|
16
16
|
</picture>
|
|
17
17
|
|
|
18
18
|
## 功能
|
|
19
19
|
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
20
|
+
- **大师审美工坊(8 套品味配方 + 61 枚原生矢量图标 + 标杆 PPTX 品味学习)**:内置 **8 套大师级 Taste Recipes**(`mckinsey-partner`、`apple-keynote-dark`、`apple-keynote-light`、`swiss-editorial`、`linear-craft`、`ft-data-journal`、`nature-academic`、`oriental-zen`),一键驱动 **4 套海报级封面**(径向光晕 `keynote-glow` / 瑞士网格 `editorial-grid` / 建筑深色侧翼 `architectural` / `split-bleed`)、**`section[agenda]` 实时章节进度页**、**4 种卡片材质**(`solid` / `frameless` / `glass` 玻璃拟态 / `editorial-rule` 双发丝)、**反单调主次构图**(`kpi[spotlight]` / `cards[bento-hero]`)、**61 枚零依赖原生矢量图标**(HTML `<svg>` + PPTX 原生 `<a:custGeom>` + 中英语义自动配图)及出版级图表精修(`spotlight` 焦点染色、`referenceLine` 目标虚线、`showGrowthCallout` 增长飞线);上传任意优秀 `.pptx` 还可提取留白率/材质/字阶比等深层审美 DNA(`styleRecipe`)持久化复用。
|
|
21
|
+
- **零品味负担自动导演 & 原生可编辑 Mermaid 流程图**:无需懂排版配色,一句话或文档自动匹配 **24 套大师主题**(16 套明亮投影友好 + 8 套沉浸深色,涵盖麦肯锡、BCG 翡翠战略、经济学人、金融时报、红杉创投、Stripe 工程、Apple 空间白与故宫霁蓝政务)与 **6 套差异化母版骨架**,覆盖 **20 套行业场景蓝图**、**原生 `<m:oMath>` 数学公式**、**Mermaid 流程图/时序图直转原生可编辑 PPTX 形状与吸附连接线(`<p:cxnSp>`)**,以及 **29+ 种原生可编辑版式与专业图示**(麦肯锡不等宽市场图 `marimekko`、财报级多层桑基图 `sankey`、波特价值链 `value-chain`、SWOT 十字矩阵 `swot`、价值链箭头 `chevron`、Bento 网格、KPI 大数字、2×2 矩阵、痛点对比、飞轮/漏斗、甘特图路线图、分层系统架构、哈维球竞品矩阵、TAM/SAM/SOM 同心圆、组织图谱、学术三线表、13 种出版级图表与矢量瀑布桥)。
|
|
22
|
+
- **全格式直吞与生态联动(Word / Excel / CSV / PPTX / Cite / Remotion)**:新增 `ppt_from_office` 支持零外部依赖直吞 **`.xlsx` 多工作表 / `.csv` / `.tsv` 与 `.docx` Word 报告**(自动识别流向表→桑基图、排期→甘特图、份额→Mekko、增减桥→瀑布图、指标→组合图与三线表);保留 `ppt_import` 外部 `.pptx` 一键翻新与 Office 双向导回(≤24 MiB 内存解析,保留撤销历史);新增 `ppt_cite` 联动 **`dsh-cite`** 核验文献并生成真实参考文献页,以及 `ppt_remotion` 导出 **`dsh-remotion`** 动画视频分镜包。
|
|
23
|
+
- **符合直觉的工作台、`? 引导` 交互导览与全场景交付**:适配 DeepSeek Harness `>=0.2.2-rc.3`,内置五套明亮主题切换;支持右上角 **`? 引导`** 四步聚光灯交互导览、空态/新建向导 **「一键体验旗舰示例」** 与 **「导入 Office / PPTX」**、点击预览画面直定位编辑文字 / LaTeX 公式 / Mermaid 代码、**演讲时长预算器(Speaking-Pace Budgeter,设置目标分钟数并实时标记超预算页)**;导出除原生 PPTX / 工程包 / 讲义 `.handout.md` 外,新增 **高管一页纸(Executive One-Pager,支持 A4 打印 PDF 与长图战报切换)**、**Remotion 视频分镜包(`.zip`)** 与独立 HTML 放映 **`P` 键双屏演讲者提词台 + `L` 键虚拟激光笔**。
|
|
23
24
|
- **可选高阶能力**:数字溯源与现场推演(支持卡片/甘特图/TAM/哈维球/架构绑定)、24 页双层 AI 视觉审查(含 12 种无损排版修复与全宽前后对比)、高管叙事预审与模拟答辩。
|
|
24
25
|
|
|
25
26
|
## 风格预览
|
|
@@ -74,12 +75,12 @@ dsh plugin --profile desktop add dsh-ppt
|
|
|
74
75
|
|
|
75
76
|
符合直觉的四步工作流(无需记参数,对话或工作台均可直接起步):
|
|
76
77
|
|
|
77
|
-
1.
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
2. **点哪改哪 &
|
|
81
|
-
3. **导入翻新、Office 导回与品牌沉淀**:支持点击「**导入 PPTX
|
|
82
|
-
4.
|
|
78
|
+
1. **快速起稿(三选一)**:
|
|
79
|
+
- **直接在面板起稿或一键体验**:从左侧栏打开「演示文稿」(可随时点顶部 **`? 引导`** 启动四步导览),点击 **「一键体验旗舰示例」** 零延迟预览旗舰版式,或点击 **「新建演示文稿」** 从 20 套行业蓝图起步,或拖入 **`.xlsx` / `.csv` / `.docx` / `.pptx`** 直接建稿。
|
|
80
|
+
- **在对话中交给助手**:把 Word、Excel/CSV、Markdown(含 ```` ```mermaid ```` 流程图/时序图)或参考 `.pptx` 发给助手,自动导演会按听众匹配明亮投影风与多版式节奏,并可调用 `ppt_cite` 关联 `dsh-cite` 真实文献。
|
|
81
|
+
2. **点哪改哪 & 换版式与时长预算**:在「内容编辑」直接点击预览画面里的标题、卡片或表格即可定位到右侧编辑框;顶部可一键切换 **Mermaid 流程图/时序图、KPI 大数字、不等宽市场图(Marimekko)、桑基流向图(Sankey)、波特价值链、SWOT 矩阵、甘特图、系统架构图、哈维球矩阵或学术三线表**(并支持 LaTeX 原生公式),设置 **目标演讲时长(分钟)** 实时检查每页超时风险,改完按 `Ctrl/⌘+S` 或点击「保存此页」同步更新 HTML 与 PPTX。
|
|
82
|
+
3. **导入翻新、Office 导回与品牌沉淀**:支持点击「**导入 PPTX 翻新**」或「**导入 Word/Excel**」直接重塑现有文件,或在 PowerPoint / WPS 微调后通过「**导入 Office 修改稿**」同步回工作台(保留撤销历史);也可在「风格与母版」一键套用 8 套名家范本或收藏公司模板到「我的品牌库」。
|
|
83
|
+
4. **双屏演讲、一页纸与视频分镜交付**:需要精检排版时点「渲染当前 PPTX」开启 **HTML + PPTX 并排对比**(或按需开启 AI 叙事预审、模拟答辩与 24 页视觉看图修复);放映 HTML 时按 `P` 开启双屏提词台、按 `L` 使用虚拟激光笔,并在下载菜单一键导出最新 PPTX、**高管一页纸(`.onepager.html`)**、**Remotion 视频分镜包(`.zip`)**、**演讲讲义(`.md`)** 或分享包 ZIP。
|
|
83
84
|
|
|
84
85
|
常用对话指令示例(可直接复制告诉助手):
|
|
85
86
|
|
package/docs/DATA.md
CHANGED
|
@@ -23,7 +23,7 @@ PPTX 保留确认后的静态数值及原生可编辑图表。每页的演讲备
|
|
|
23
23
|
|
|
24
24
|
## 材料与分享
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
`ppt_data` 实时来源绑定与替换支持 UTF-8 CSV、TSV、TXT、Markdown 或内嵌表格(不自动联网寻找来源,也不监视或回写原始文件)。如需从多工作表 `.xlsx` 财务/排期表或 `.docx` Word 报告直接自动生成全套演示文稿,请使用 **`ppt_from_office`**(或 CLI `--from-office` / 工作台「导入 Word/Excel」)。
|
|
27
27
|
|
|
28
28
|
来源只能说明“这个数字如何得到”,不代表材料真实或结论正确。JSON 工程包含导入的完整材料;HTML / PPTX 包含指标引用的材料行摘录和来源名称,摘录可能包含同一行的其他字段,分享前应核对。
|
|
29
29
|
|
|
@@ -35,7 +35,7 @@ Both features are optional. Ordinary finished-deck delivery does not require a d
|
|
|
35
35
|
|
|
36
36
|
- Supply actual material and ask DSH to link its numbers (`{{metricId}}`) and expose selected assumptions. In the Presentations workbench (**Data and what-if** tab), click a linked number to inspect its source row, CSV cell, or formula. Follow formula inputs to their origins. Unlinked numbers are labelled explicitly.
|
|
37
37
|
- Adjust declared assumptions; titles, bullets, structured `items` across KPI/cards/`gantt`/`tam`/`architecture`/`org` (`value`, `delta`, `text`, `bullets`), `takeaway` callouts, `source` footnotes, tables & Harvey matrices (`rows`), and all **13 native chart kinds** (including `waterfall`, `combo`, and stacked charts) recalculate together. Source facts remain read-only in what-if mode. Preview metric and slide differences before confirming. The default is an undoable new copy, preserving the original.
|
|
38
|
-
- Replace an existing source by importing or pasting UTF-8 CSV, TSV, TXT, or Markdown
|
|
38
|
+
- Replace an existing source in `ppt_data` by importing or pasting UTF-8 CSV, TSV, TXT, or Markdown (nothing watches or writes original source files, and automatic online research is not included). To build a full presentation directly from multi-sheet `.xlsx` workbooks or `.docx` reports, use **`ppt_from_office`** (or CLI `--from-office` / Workbench **Import Office**).
|
|
39
39
|
- Offline HTML retains controls and lineage (`D` opens the panel). Export scenario parameters, import them into the same DSH project, preview, and confirm to create a matching static PPTX. Foreign or stale packets are rejected. Downloads of older PPTX/JSON files are blocked while the HTML has unsaved values.
|
|
40
40
|
- PPTX contains confirmed static values and native editable charts, with formulas, assumptions, source excerpts/locators, and checksums in speaker notes. Download the Markdown lineage report separately. It does not execute HTML controls inside PowerPoint.
|
|
41
41
|
- A source link is not factual verification. JSON retains full imported material; HTML/PPTX include metric-referenced row excerpts, which may contain other fields from that row. Review before sharing.
|
package/docs/REFERENCE.en.md
CHANGED
|
@@ -20,9 +20,9 @@ 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
|
-
- **
|
|
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`,
|
|
23
|
+
- **29+ Native Editable Layouts, Native Mermaid Diagrams & `<m:oMath>` Equations**: Ships zero-dependency **`deck-mermaid.mjs`** (`layout: 'mermaid'`, aliases `'flowchart'` / `'sequence'`, plus automatic ```` ```mermaid ```` Markdown block detection) compiling `flowchart` (subgraphs, diamonds, stadium terminals, cylinder DBs, labeled edges) and `sequenceDiagram` (lifelines, activations, message arrows, notes, `alt/loop` frames) into 100% native editable OOXML `<p:sp>` shapes with attached `<p:cxnSp>` connectors and crisp HTML SVGs; alongside variable-width **Marimekko (`marimekko`)**, multi-layer **Sankey (`sankey`)**, authentic **Porter Value Chain (`value-chain`)**, **SWOT Cross Matrix (`swot`)**, LaTeX-to-OOXML `<m:oMath>` + MathML equations (`slide.formula` / `$...$`), interlocking Chevrons (`chevron`), Bento/pillar `cards`, hero `kpi` grids, `comparison`, `matrix`, `process`, `callout`, `gantt`, `architecture`, `harvey`, `tam`, `org`, `table` (`consulting | booktabs | minimal | banded | harvey`), `chart-split`, and 13 Economist/FT chart variants.
|
|
24
|
+
- **Direct Word/Excel/CSV Ingestion & Cross-Plugin Bridges (`ppt_from_office`, `ppt_import`, `ppt_cite`, `ppt_remotion`)**: Adds **`ppt_from_office`** (zero new dependencies) to convert `.xlsx` multi-sheet workbooks, `.csv`/`.tsv`, and `.docx` Word reports directly into multi-slide decks (auto-profiling sheets into Sankey, Gantt, Marimekko, Waterfall, Combo charts, and tables); retains **`ppt_import`** for legacy `.pptx` refurbishment and Office round-trip sync (`≤24 MiB`, undoable); adds **`ppt_cite`** to link verified **`dsh-cite`** / BibTeX citations into `slide.source` and a `References` slide, and **`ppt_remotion`** to export 30fps **`dsh-remotion`** storyboard packages; includes **Dual-Screen Presenter View** (`P` / `L` laser), **Speaking-Pace Budgeter (`targetMinutes`)**, **Executive One-Pager (`.onepager.html`)**, and **`.handout.md`** speaker handouts.
|
|
25
|
+
- **Rich Workbench, `? Guide` Spotlight Tour & Style Studio**: Search and filter projects with theme/page metadata; launch the 4-step **`? Guide`** interactive spotlight tour, click **Load Flagship Demo** (`create-demo`), drag-and-drop `.xlsx`/`.csv`/`.docx`/`.pptx`, switch slide archetypes (including Mermaid) and per-slide chrome skeletons in one click, set **Target Duration (`targetMinutes`)** with live overrun badges, edit Gantt timelines, Harvey matrices, structured `items`, `formula`s, `mermaid` code, and tables, compare HTML ↔ rendered PPTX side-by-side, jump directly from quality findings to slides, and undo up to 20 revisions.
|
|
26
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).
|
|
27
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).
|
|
28
28
|
- **Optional Executive Storyline Review & Rehearsal**: Critique Action Titles, SCQA narrative flow, and missing evidence (up to 8 findings across 7 audience personas) or practice live Q&A. See [the rehearsal guide](COACHING.md#english).
|
|
@@ -40,11 +40,11 @@ For the web version, replace `desktop` with `web`. Restart DSH after installatio
|
|
|
40
40
|
|
|
41
41
|
## Start using it
|
|
42
42
|
|
|
43
|
-
1. Provide material, purpose, audience, or a reference `.pptx` in the target workspace; request HTML, PPTX and project files.
|
|
44
|
-
2. Open Presentations in the sidebar and search for or select the generated project.
|
|
45
|
-
3. Edit
|
|
46
|
-
4. Explicitly start optional AI storyline review, rehearsal
|
|
47
|
-
5. Deliver the share bundle or retain editability with the project bundle; check the result in the target browser or Office application.
|
|
43
|
+
1. Provide source material (`.docx`/`.xlsx`/`.csv`/Markdown/Mermaid), purpose, audience, or a reference `.pptx` in the target workspace; request HTML, PPTX, Executive One-Pager, and project files.
|
|
44
|
+
2. Open **Presentations** in the sidebar (click **`? Guide`** for the 4-step spotlight tour or **Load Flagship Demo** for an instant showcase) and search for or select the generated project.
|
|
45
|
+
3. Edit 29+ slide archetypes (including Mermaid code and LaTeX `formula`s), per-slide chrome skeletons, Gantt timelines, Harvey matrices, structured cards/tables, images, order, or **Target Duration (`targetMinutes`)** in **Edit content**, or switch across 24 themes & 6 master skeletons and absorb a `.pptx` in **Style Studio**; render the current PPTX for side-by-side inspection when needed.
|
|
46
|
+
4. Explicitly start optional AI storyline review, rehearsal, 24-slide visual repair, `ppt_cite` citation linking, or `ppt_remotion` storyboard export when needed; direct download does not require them.
|
|
47
|
+
5. Deliver the share bundle, **Executive One-Pager (`.onepager.html`)**, **Remotion Storyboard (`.zip`)**, or `.handout.md` handout, or retain editability with the project bundle; check the result in the target browser or Office application.
|
|
48
48
|
|
|
49
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.
|
|
50
50
|
|
package/docs/REFERENCE.zh.md
CHANGED
|
@@ -20,9 +20,9 @@
|
|
|
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
|
-
-
|
|
25
|
-
-
|
|
23
|
+
- **29+ 种原生可编辑版式/专业图示、Mermaid 原生流程图与 `<m:oMath>` 数学公式**:新增零外部依赖 **`deck-mermaid.mjs`**(支持 `layout: 'mermaid'`、`'flowchart'` / `'sequence'` 别名及 Markdown ```` ```mermaid ```` 代码块自动识别),将 `flowchart`(含 `subgraph`、菱形决策、终端胶囊、数据库圆柱与多样连线)与 `sequenceDiagram`(含生命线、激活条、消息箭头、批注与 `alt/loop` 框)编译为 100% 原生可编辑 PowerPoint `<p:sp>` 形状与吸附连接线(`<p:cxnSp>`)及高精 HTML SVG;同源涵盖 **不等宽市场图(`marimekko`)**、**多层桑基流向图(`sankey`)**、**真·波特价值链(`value-chain`)**、**SWOT 战略十字矩阵(`swot`)**、原生 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
|
+
- **全格式直吞与生态工具(`ppt_from_office`、`ppt_import`、`ppt_cite`、`ppt_remotion`)**:新增 **`ppt_from_office`** 直吞 `.xlsx` 多工作表、`.csv`/`.tsv` 与 `.docx` Word 报告(Data-to-Visual 画像器自动匹配桑基图/甘特图/Mekko/瀑布图/组合图与三线表);保留 **`ppt_import`** 导入任意 `.pptx` 一键翻新或导回 Office 修改稿(保留 `.history/` 撤销历史);新增 **`ppt_cite`** 对接 `dsh-cite` 文献库/BibTeX 生成真实尾注与 `References` 页,以及 **`ppt_remotion`** 导出 `dsh-remotion` 30fps 视频分镜包;内置双屏演讲者提词台(HTML 按 `P` 开启、`L` 键虚拟激光笔)、**演讲时长预算器(Speaking-Pace Budgeter,`targetMinutes`)**、**高管一页纸(`.onepager.html`)** 与 `.handout.md` 演讲讲义导出。
|
|
25
|
+
- **工程库与增强工作台**:按关键词/主题搜索排序,展示主题与页数标签;支持顶栏 **`? 引导`** 四步聚光灯交互导览、空态 **「一键体验旗舰示例」**、拖拽上传 `.xlsx`/`.csv`/`.docx`/`.pptx`、单页版式与单页母版骨架一键无损切换、结构化卡片/甘特图/哈维球/Mermaid/LaTeX 公式编辑、目标演讲时长预算、HTML ↔ PPTX 并排分屏对比、点击质量提醒直接跳页,以及最多 20 步撤销。
|
|
26
26
|
- **可选数字溯源与现场推演**:点击数字追到原始材料、CSV 单元格或公式(全面支持 `items`、甘特图、`tam`、架构、哈维球矩阵、`takeaway`、`source` 与图表绑定);调整假设、预览影响并确认保存。见[数据说明](DATA.md)。
|
|
27
27
|
- **可选双层 AI 视觉检查(最多 24 页)**:看实际 PPTX 渲染图,兼顾排版溢出检测与审美层级把关,支持 12 种零文本篡改排版动作、全宽画布前后对比、停止与撤销。见[看图修复](VISUAL.md)。
|
|
28
28
|
- **可选高管叙事预审与模拟答辩**:把关结论先行 Action Title、SCQA 金字塔叙事与论据缺口(单轮最多 8 条建议,支持高管/投资人/学术评委/技术评审等 7 类听众画像),导出问答与待补充材料清单。见[演练说明](COACHING.md)。
|
|
@@ -40,11 +40,11 @@ dsh plugin --profile desktop add dsh-ppt
|
|
|
40
40
|
|
|
41
41
|
## 开始使用
|
|
42
42
|
|
|
43
|
-
1.
|
|
44
|
-
2.
|
|
45
|
-
3. 在「内容编辑」切换
|
|
46
|
-
4. 按需要主动开启 AI
|
|
47
|
-
5.
|
|
43
|
+
1. 在目标工作区提供材料(Word/Excel/CSV/Markdown/Mermaid)、用途、听众或参考 `.pptx`,例如“把这份季报 Excel 做成可交付的汇报演示文稿,导出 HTML、PPTX、高管一页纸与工程文件”。
|
|
44
|
+
2. 从左侧栏打开“演示文稿”(可点右上角 **`? 引导`** 快速上手或点击 **「一键体验旗舰示例」**),在工程库搜索或选择生成的项目。
|
|
45
|
+
3. 在「内容编辑」切换 29+ 种单页版式(含 Mermaid 流程图/时序图)与单页母版骨架、编辑文字/甘特图/哈维球/卡片/表格/公式/图片、设置目标演讲时长(`targetMinutes`)检查节奏,或新增页面;在「风格与母版」一键切换 24 套主题、6 套母版骨架或拖拽 `.pptx` 吸收企业风格与骨架;需要时渲染当前 PPTX 并开启并排对比。
|
|
46
|
+
4. 按需要主动开启 AI 预审、模拟答辩、看图修复、`ppt_cite` 文献核验或 `ppt_remotion` 视频分镜导出;直接下载成品不要求这些步骤。
|
|
47
|
+
5. 下载“分享成品包”、**高管一页纸(`.onepager.html`)**、**Remotion 分镜包(`.zip`)**、演讲讲义(`.handout.md`)交付,或下载“完整工程包”保留编辑能力;在目标播放器或 Office 中再核对一次。
|
|
48
48
|
|
|
49
49
|
支持通过 `ppt_import` 或工作台「导入 Office 修改稿」将 PowerPoint / WPS 中的修改导回工程(保留撤销历史)。若外部直接修改成品且未走导回,可用面板「另存副本」或 `ppt_edit(saveAs:true)` 从 JSON 重建新文件,保留原成品。
|
|
50
50
|
|
package/docs/USAGE.en.md
CHANGED
|
@@ -4,20 +4,25 @@
|
|
|
4
4
|
|
|
5
5
|
## Current improvements
|
|
6
6
|
|
|
7
|
+
- **0.27.0 Aesthetic Studio, 8 Curated Taste Recipes, 61 Native Vector Icons & Benchmark `.pptx` Taste Learning**: Adds zero-dependency `deck-taste.mjs`, `deck-covers.mjs`, and `deck-icons.mjs` shipping 8 Curated Taste Recipes (`mckinsey-partner`, `apple-keynote-dark`, `apple-keynote-light`, `swiss-editorial`, `linear-craft`, `ft-data-journal`, `nature-academic`, `oriental-zen`), 4 poster covers (`keynote-glow`, `editorial-grid`, `architectural`, `split-bleed`), automatic multi-chapter `section[agenda]` trackers, 4 card surface materials (`solid`, `frameless`, `glass`, `editorial-rule`), anti-monotony asymmetric layouts (`kpi[spotlight]`, `cards[bento-hero]`), 61 native vector icons (HTML `<svg>` + editable OOXML `<a:custGeom>` with bilingual auto-matching), publication-grade chart finishing (`spotlight`, `referenceLine`, `showGrowthCallout` with dedicated non-clipping PPTX annotation strips), `optimizeVisualRhythm` + `SLOP-11`/`SLOP-12` checks, and deep 6-signal `.pptx` aesthetic DNA extraction (`styleRecipe`, persisted to `.dsh-ppt/taste-recipes.json` via `saveTasteAs` / `--save-taste`).
|
|
8
|
+
- **0.26.0 Direct Office Ingestion, Native Editable Mermaid & Ecosystem Bridges**: Adds zero-dependency `deck-mermaid.mjs` (`layout: 'mermaid'`, aliases `'flowchart'`/`'sequence'`, and automatic ```` ```mermaid ```` Markdown fences) compiling `flowchart` and `sequenceDiagram` into 100% native editable PPTX shapes (`<p:sp>`) and attached `<p:cxnSp>` connectors; adds **`ppt_from_office`** (CLI `--from-office`, Workbench `import-office`) to ingest `.xlsx`/`.csv`/`.tsv` and `.docx` directly with zero new dependencies; adds **`ppt_cite`** (`dsh-cite` verified citations + `References` slide) and **`ppt_remotion`** (`dsh-remotion` 30fps storyboard export); adds **Speaking-Pace Budgeter (`computePaceBudget` / `targetMinutes`)**, **Executive One-Pager (`.onepager.html`)**, Workbench **`? Guide`** 4-step spotlight tour, and 1-click **Load Flagship Demo**.
|
|
7
9
|
- **Zero-taste-burden Auto-Director, 6 Chrome Skeletons & Deep `.pptx` Absorption**: `ppt_create` defaults to `theme: "auto"` to match topic, audience, and master chrome skeleton automatically (standalone CLI keeps `data` by default for backward compatibility unless `--theme auto` is passed). `ppt_absorb` and `referencePptx` (with `cloneStructure: true` / `--clone-structure`) resolve OOXML `lumMod`/`tint`/`shade` color modifiers, CJK/Latin fonts, master logos, skeleton geometry (`extractedSkeleton`, `recommendedChrome`), and slide-by-slide layout sequences (`slideSkeleton[]`) locally with WCAG ≥4.5:1 contrast sanitization.
|
|
8
|
-
- **
|
|
9
|
-
- **Style Studio & visual workbench**: Switch across
|
|
10
|
-
- **Artifact integrity & safe delivery bundles**: Every build records HTML/PPTX digests so external Office edits are never silently overwritten; save a copy (`saveAs: true`) when needed. Save workbench edits, then download
|
|
10
|
+
- **24 built-in themes, 6 Master Chrome Skeletons, 29+ canonical layouts & 20 industry blueprints**: 16 daylight-first themes and 8 dark themes mapped to 6 structurally distinct chrome skeletons (`consulting-classic`, `keynote-spatial`, `editorial-folio`, `saas-bento`, `academic-minimal`, `gov-ceremonial`), covering `mermaid`, `marimekko`, `sankey`, `value-chain`, `swot`, native `<m:oMath>` equations, `gantt`, `architecture`, `harvey`, `tam`, `org`, `flywheel`/`funnel` process variants, `tableStyle` (`consulting | booktabs | minimal | banded | harvey`), per-slide `chrome`, `columns`, `takeaway` bars, `source` footnotes, and 13 publication-grade chart kinds including vector `waterfall` bridges.
|
|
11
|
+
- **Style Studio & visual workbench**: Switch across 24 themes, 8 Reference Presets, and **6 Master Chrome Skeletons (`brand.chromeStyle`)**, drag-and-drop `.xlsx`/`.csv`/`.docx`/`.pptx` (`≤24 MiB`, parsed in memory with zero host path reads), switch across 29+ slide archetypes (including Mermaid & LaTeX formulas), set **Target Duration (`targetMinutes`)** with live pace diagnostics, compare HTML ↔ PPTX side-by-side, inspect full-width Vision QA before/after diffs (up to 24 slides, 12 lossless actions), and run storyline/action-title coaching (up to 8 findings across 7 audience personas).
|
|
12
|
+
- **Artifact integrity & safe delivery bundles**: Every build records HTML/PPTX digests so external Office edits are never silently overwritten; save a copy (`saveAs: true`) when needed. Save workbench edits, then download the **Share bundle ZIP**, **Project bundle ZIP**, **Executive One-Pager (`.onepager.html`)**, or **Remotion Storyboard (`.zip`)** (each file ≤64 MiB, total ≤128 MiB; excludes config, secrets, and unrelated workspace files).
|
|
11
13
|
|
|
12
14
|
## Capabilities
|
|
13
15
|
|
|
14
16
|
| Capability | Description |
|
|
15
17
|
| --- | --- |
|
|
16
|
-
| `ppt_create` tool | Markdown / structured `slides` → `*.html` + `*.pptx` + `*.json`; defaults to `theme: "auto"` and accepts `referencePptx
|
|
17
|
-
| `
|
|
18
|
+
| `ppt_create` tool | Markdown / structured `slides` → `*.html` + `*.pptx` + `*.json`; defaults to `theme: "auto"` and accepts `referencePptx`, `cloneStructure: true`, and `targetMinutes` pace budgeting |
|
|
19
|
+
| `ppt_from_office` tool | Zero-new-dep direct ingestion of `.xlsx` multi-sheet workbooks, `.csv`/`.tsv`, and `.docx` Word reports via Data-to-Visual profiling and Auto-Director |
|
|
20
|
+
| `ppt_import` 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 with undo history |
|
|
21
|
+
| `ppt_cite` tool | Link verified `dsh-cite` / JSON / BibTeX citations (`[@citeKey]`, `[doi:...]`) into `slide.source` footers and an auto-generated `References` slide |
|
|
22
|
+
| `ppt_remotion` tool | Export a 30fps `dsh-remotion` animated video storyboard pack (`DeckVideo.tsx`, `slides-data.json`, `remotion-storyboard.json`) timed from `computePaceBudget` |
|
|
18
23
|
| `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` |
|
|
19
24
|
| `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 |
|
|
20
|
-
|
|
|
25
|
+
| 29+ layouts & diagrams | `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `process` / `callout` (with native `<m:oMath>` `formula`) / `mermaid` (native editable flowchart & sequence diagrams) / `gantt` / `architecture` / `harvey` / `tam` / `org` / `marimekko` / `sankey` / `swot` / `value-chain` / `table` / `closing` / `image` / `image-left` / `image-right` / `chart` / `chart-split` (plus `flowchart`, `sequence`, `chevron`, `waterfall`, `gallery`, and `flywheel` aliases) |
|
|
21
26
|
| 13 chart kinds | `column` / `bar` / `stacked-column` / `stacked-bar` / `percent-column` / `percent-bar` / `line` / `area` / `pie` / `doughnut` / `scatter` / `combo` / `waterfall` with `highlight` focal emphasis |
|
|
22
27
|
| `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` |
|
|
23
28
|
| `ppt_edit` / `ppt_undo` | Edit selected slides, switch deck `theme` / `brand` / `referencePptx`, append/duplicate/remove/reorder slides with 20-step undo and revision guards |
|
|
@@ -131,7 +136,7 @@ The exact optional peer is not a mandatory engine download for ordinary consumer
|
|
|
131
136
|
|
|
132
137
|
This repository's pnpm overrides are not inherited by consumers. If an installed renderer's audit reports `fflate@0.8.2`, set `overrides: { "@deepseek-ai/libreoffice-kit": { "fflate": "0.8.3" } }` in the consumer's root package.json (npm), or `overrides: { "@deepseek-ai/libreoffice-kit>fflate": "0.8.3" }` in its root pnpm-workspace.yaml, then reinstall. The plugin also validates PPTX/ZIP64 bounds before rendering; that check does not replace updating the underlying dependency.
|
|
133
138
|
|
|
134
|
-
CLI supports `--slides @slides.json`, `--brand @brand.json`, `--reference-pptx ref.pptx`, `--absorb ref.pptx`, `--template consulting`, `--edit report.json --edits @edits.json --revision 0`, `--undo report.json --revision 1`, `--check report.json`, and `--render report.pptx --format both`. Explicit receipt validation uses `--check report.json --render-receipt path/to/render-receipt.json`; failure returns a nonzero exit code.
|
|
139
|
+
CLI supports `--slides @slides.json`, `--brand @brand.json`, `--from-office report.xlsx`, `--import-pptx legacy.pptx`, `--one-pager`, `--target-minutes 15`, `--handout`, `--reference-pptx ref.pptx`, `--absorb ref.pptx`, `--template consulting`, `--edit report.json --edits @edits.json --revision 0`, `--undo report.json --revision 1`, `--check report.json`, and `--render report.pptx --format both`. Explicit receipt validation uses `--check report.json --render-receipt path/to/render-receipt.json`; failure returns a nonzero exit code.
|
|
135
140
|
|
|
136
141
|
For standalone usage copy the entire skill directory and run `npm install --ignore-scripts` there. Plain text remains usable without Office Kit; image/chart/logo/footer PPTX export needs Office Kit 0.21.0. `dsh-ppt/deck-advanced` exports `buildDeckAsync`, `editDeck`, `undoDeck`, `checkDeckAsync`, `renderDeck`, and `absorbPptx`. The legacy synchronous `deck-core` API supports plain text and explicitly rejects unsupported media inputs.
|
|
137
142
|
|
package/docs/USAGE.md
CHANGED
|
@@ -4,20 +4,25 @@
|
|
|
4
4
|
|
|
5
5
|
## 本次改进
|
|
6
6
|
|
|
7
|
+
- **0.27.0 全栈审美工坊、8 套大师品味配方、61 枚原生矢量图标与标杆 PPTX 审美 DNA 学习**:新增 `deck-taste.mjs`、`deck-covers.mjs` 与 `deck-icons.mjs`(零新增依赖),内置 8 套精选品味配方(`mckinsey-partner` / `apple-keynote-dark` / `apple-keynote-light` / `swiss-editorial` / `linear-craft` / `ft-data-journal` / `nature-academic` / `oriental-zen`),一键协同驱动 4 套海报级封面(`keynote-glow` / `editorial-grid` / `architectural` / `split-bleed`)、`section[agenda]` 自动章节进度过场、4 种卡片材质(`solid` / `frameless` / `glass` / `editorial-rule`)、反单调构图(`kpi[spotlight]` / `cards[bento-hero]`)、61 枚双端矢量图标(HTML `<svg>` + PPTX 原生 `<a:custGeom>`)、出版级图表精修(`spotlight` / `referenceLine` / `showGrowthCallout`)以及 `optimizeVisualRhythm` + `SLOP-11`/`SLOP-12` 门禁;`ppt_absorb`(CLI `--save-taste`)支持从任意优秀 `.pptx` 提取 6 维审美 DNA 生成 `styleRecipe` 持久化至 `.dsh-ppt/taste-recipes.json` 复用。
|
|
8
|
+
- **0.26.0 全谱系多源直吞、原生可编辑 Mermaid 与生态联动**:新增 `deck-mermaid.mjs` 支持 `layout: 'mermaid'`(别名 `flowchart`/`sequence`)及 Markdown ```` ```mermaid ```` 代码块,把 `flowchart` 与 `sequenceDiagram` 编译为 100% 原生可编辑 PPTX 形状与吸附连接线(`<p:cxnSp>`);新增 `ppt_from_office`(CLI `--from-office`、工作台 `import-office`)零新增依赖直吞 `.xlsx`/`.csv`/`.tsv` 与 `.docx`;新增 `ppt_cite` 对接 `dsh-cite` 核验文献并生成 `References` 页,以及 `ppt_remotion` 导出 `dsh-remotion` 30fps 视频分镜包;新增演讲时长预算器(`computePaceBudget` / `targetMinutes`)、高管一页纸(`.onepager.html`)、工作台 `? 引导` 四步聚光灯交互导览与「一键体验旗舰示例」。
|
|
7
9
|
- **智能审美托管、6 套母版骨架与深度 PPTX 吸收**:`ppt_create` 默认启用 `theme: "auto"` 按语境与受众自动选定最优主题与母版骨架(裸 CLI 不传 `--theme` 时保持兼容默认 `data`,显式传 `--theme auto` 启用自动选型);`ppt_absorb` 与 `referencePptx`(支持 `cloneStructure: true` / `--clone-structure`)可纯本地解析 OOXML `lumMod`/`tint`/`shade` 修饰色板、字体、母版 Logo、骨架几何(`extractedSkeleton` / `recommendedChrome`)与逐页版式序列(`slideSkeleton[]`),自动执行 WCAG ≥4.5:1 对比度净化。
|
|
8
|
-
- **
|
|
9
|
-
- **风格与母版工作台(Style Studio)**:工作台支持
|
|
10
|
-
- **产物校验与交付包保护**:每次生成保存 HTML / PPTX 校验值。外部修改过成品或旧工程缺少校验记录时,`ppt_edit`、`ppt_undo` 和面板保存会拒绝覆盖。保留 Office 修改后的原件,点击「另存副本」或调用 `ppt_edit({deckPath, saveAs:true})` 从 JSON 重建不同文件名的三件套;副本不导入 Office 修改,使用新工程 ID 和修订号 0。在工作台保存修改后可下载「分享成品包 ZIP
|
|
10
|
+
- **24 套内置主题、6 套差异化母版骨架、29+ 种页型与 20 套行业蓝图**:覆盖 16 套明亮主题与 8 套深色主题,匹配 6 套结构差异化的母版骨架(`consulting-classic` / `keynote-spatial` / `editorial-folio` / `saas-bento` / `academic-minimal` / `gov-ceremonial`);覆盖 `mermaid`、`marimekko`、`sankey`、`value-chain`、`swot`、原生 `<m:oMath>` 公式、`gantt`、`architecture`、`harvey`、`tam`、`org` 及 `process` 飞轮/漏斗变体,支持 `tableStyle: consulting | booktabs | minimal | banded | harvey`、单页 `chrome`、`columns`、`takeaway` 结论栏与 `source` 来源脚注;图表覆盖 13 类出版级图表与矢量瀑布桥。
|
|
11
|
+
- **风格与母版工作台(Style Studio)**:工作台支持 24 套主题、8 套名家范本预设与 **6 套母版骨架(`brand.chromeStyle`)**一键切换、单页一键切换 29+ 种版式原型与甘特图/哈维球/Mermaid/公式编辑、「+ 新建页面」、目标演讲时长预算、拖拽 `.pptx` 展示 `recommendedChrome` 与 `extractedSkeleton` 摘要、HTML ↔ PPTX 并排分屏对照、画布级 AI 视觉修复前后对比(上限 24 页与 12 种无损动作)及最多 8 条叙事金字塔/结论句预审建议。
|
|
12
|
+
- **产物校验与交付包保护**:每次生成保存 HTML / PPTX 校验值。外部修改过成品或旧工程缺少校验记录时,`ppt_edit`、`ppt_undo` 和面板保存会拒绝覆盖。保留 Office 修改后的原件,点击「另存副本」或调用 `ppt_edit({deckPath, saveAs:true})` 从 JSON 重建不同文件名的三件套;副本不导入 Office 修改,使用新工程 ID 和修订号 0。在工作台保存修改后可下载「分享成品包 ZIP」「完整工程包 ZIP」、高管一页纸(`.onepager.html`)或 Remotion 分镜包(`.zip`),单文件 ≤64 MiB、合计 ≤128 MiB,不包含配置、密钥或工作区其他文件。
|
|
11
13
|
|
|
12
14
|
## 能力一览
|
|
13
15
|
|
|
14
16
|
| 能力 | 说明 |
|
|
15
17
|
| --- | --- |
|
|
16
|
-
| `ppt_create` 工具 | Markdown / 结构化 `slides` → `*.html` + `*.pptx` + `*.json` 三件套;默认 `theme: "auto"` 自动匹配主题与骨架,支持 `referencePptx` 与 `
|
|
17
|
-
| `
|
|
18
|
+
| `ppt_create` 工具 | Markdown / 结构化 `slides` → `*.html` + `*.pptx` + `*.json` 三件套;默认 `theme: "auto"` 自动匹配主题与骨架,支持 `referencePptx`、`cloneStructure: true` 与 `targetMinutes` 演讲时长预算 |
|
|
19
|
+
| `ppt_from_office` 工具 | 零新增依赖直吞 `.xlsx` 多工作表、`.csv`/`.tsv` 与 `.docx` Word 报告,自动识别流向/排期/份额/增减桥/组合指标并生成高颜值全套工程 |
|
|
20
|
+
| `ppt_import` 工具 | 导入外部 `.pptx`(正文、表格、原生图表、图片、备注)一键翻新为可编辑工程,或传入 `projectId` 将 Office 修改稿导回既有工程更新(支持撤销) |
|
|
21
|
+
| `ppt_cite` 工具 | 联动 `dsh-cite` 文献库/BibTeX,核验并替换 `[@citeKey]` / `[doi:...]` 为真实 `slide.source` 学术尾注并生成 `References` 文献页(零捏造 DOI) |
|
|
22
|
+
| `ppt_remotion` 工具 | 按 `computePaceBudget` 时长预算导出 `dsh-remotion` 30fps 视频分镜包(`DeckVideo.tsx` + `slides-data.json` + `remotion-storyboard.json`) |
|
|
18
23
|
| `ppt_absorb` 工具 | 本地只读解析参考 `.pptx` 的主题修饰色板、字体、画幅比例、母版骨架几何(`extractedSkeleton` / `recommendedChrome`)、逐页序列(`slideSkeleton`)与可选嵌入 Logo |
|
|
19
24
|
| `ppt_themes` 工具 | 列出 24 套内置主题(16 明亮 + 8 深色)与 6 套母版骨架;传 `preview: true, outputDir: "dist"` 生成主题对比页 + 每套 SVG 色板卡 |
|
|
20
|
-
|
|
|
25
|
+
| 29+ 种页型与图示 | `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `process` / `callout`(支持原生 `<m:oMath>` `formula`) / `mermaid`(原生可编辑流程图与时序图) / `gantt` / `architecture` / `harvey` / `tam` / `org` / `marimekko` / `sankey` / `swot` / `value-chain` / `table` / `closing` / `image` / `image-left` / `image-right` / `chart` / `chart-split`(兼容 `flowchart`、`sequence`、`chevron`、`waterfall`、`gallery`、`flywheel` 别名) |
|
|
21
26
|
| 13 类原生图表 | `column` / `bar` / `stacked-column` / `stacked-bar` / `percent-column` / `percent-bar` / `line` / `area` / `pie` / `doughnut` / `scatter` / `combo` / `waterfall`,支持 `highlight` 焦点项染色 |
|
|
22
27
|
| `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` |
|
|
23
28
|
| `ppt_edit` / `ppt_undo` | 按页或整套切换主题/品牌/参考 `.pptx`、增删改排页面,支持最多 20 次历史与修订号冲突保护 |
|
|
@@ -132,7 +137,7 @@ npm install --ignore-scripts @deepseek-ai/libreoffice-kit@0.2.3
|
|
|
132
137
|
|
|
133
138
|
`ppt_render { pptxPath: "report.pptx", format: "both" }` 读取最终 PPTX,生成逐页 PNG、PDF 和 `render-receipt.json`,不重新保存可编辑源文稿。`ppt_check` 可携带返回的 `receiptPath` 作为 `renderReceipt`,核验源文件和每个输出的摘要;编辑源文稿或修改输出后旧收据失效。静态产物不保留动画;LibreOffice 与 PowerPoint/WPS 的排版可能不同。字体诊断不保证每个字符,也不自动安装字体。更多细节见 [渲染说明](../docs/LIBREOFFICE-INTEGRATION-2026-10-01.md)。
|
|
134
139
|
|
|
135
|
-
CLI 支持 `--slides @slides.json`、`--brand @brand.json`、`--reference-pptx ref.pptx`、`--absorb ref.pptx`、`--template consulting`、`--edit report.json --edits @edits.json --revision 0`、`--undo report.json --revision 1`、`--check report.json`、`--render report.pptx --format both`。收据核验用 `--check report.json --render-receipt path/to/render-receipt.json`;失败返回非零退出码。
|
|
140
|
+
CLI 支持 `--slides @slides.json`、`--brand @brand.json`、`--from-office report.xlsx`、`--import-pptx legacy.pptx`、`--one-pager`、`--target-minutes 15`、`--handout`、`--reference-pptx ref.pptx`、`--absorb ref.pptx`、`--template consulting`、`--edit report.json --edits @edits.json --revision 0`、`--undo report.json --revision 1`、`--check report.json`、`--render report.pptx --format both`。收据核验用 `--check report.json --render-receipt path/to/render-receipt.json`;失败返回非零退出码。
|
|
136
141
|
|
|
137
142
|
## 内置主题(18 套)与 6 套母版骨架
|
|
138
143
|
|
package/docs/VALIDATION.md
CHANGED
|
@@ -6,6 +6,14 @@
|
|
|
6
6
|
|
|
7
7
|
## 最新记录
|
|
8
8
|
|
|
9
|
+
**0.27.0 全栈审美工坊、8 套大师品味配方与实机双端渲染验收(2026-11-20)**:全量 `tsc`、客户端打包、`npm test`(400 / 400 通过,含 `test/aesthetic-studio.test.mjs` 全部 6 大支柱专项测试与 `deck-layouts.mjs` < 120 KB 模块化守卫)全部通过(0 失败,13 个注册工具 Wire Schema 0 `type` 数组,`templates/workbench-ui.js` 与 `pnpm-lock.yaml` 零改动);`@office-kit/pptx` `validatePresentation()` 0 错误;实机 `@deepseek-ai/libreoffice-kit` 无头渲染(`missingFonts: []`)与 Headless Chrome HTML 对照逐页目视核验 `keynote-glow` 径向光晕封面、`architectural` 深色侧翼封面、`editorial-grid` 瑞士三栏网格封面、`section[agenda]` 实时章节进度、`kpi[spotlight]`、`cards[bento-hero]` 玻璃拟态与 61 枚原生 `<a:custGeom>` 矢量图标、出版级图表 `spotlight` + 顶部非遮挡 `referenceLine` / 增长飞线批注,以及 `absorbPptx` 标杆品味 `styleRecipe` 持久化复用。
|
|
10
|
+
|
|
11
|
+
- **0.27.0 Bilingual Validation Record (2026-11-20)**: Full `tsc`, client bundle build, and `npm test` suite (**400 / 400 passed**, including `test/aesthetic-studio.test.mjs` across all 6 Aesthetic Studio pillars and `deck-layouts.mjs` < 120 KB modular guard) passed with 0 failures, 0 `type` arrays across all 13 registered tools, and untouched `templates/workbench-ui.js` / `pnpm-lock.yaml`; `@office-kit/pptx` `validatePresentation()` passed with 0 errors; real `@deepseek-ai/libreoffice-kit` rendering (`missingFonts: []`) and Headless Chrome HTML parity inspection visually verified `keynote-glow`, `architectural`, and `editorial-grid` poster covers, live `section[agenda]` trackers, `kpi[spotlight]`, `cards[bento-hero]` glass materiality, 61 native `<a:custGeom>` vector icons, publication-grade chart spotlight/reference/growth annotation strips, and `absorbPptx` `styleRecipe` persistence round-trips.
|
|
12
|
+
|
|
13
|
+
**0.26.0 全谱系多源直吞、原生可编辑 Mermaid、生态联动与零警告发布验收(2026-11-20)**:全量 `tsc`、客户端打包、`npm test` 全部通过(0 失败,13 个注册工具 Wire Schema 0 `type` 数组,基于 Workbench UI v3 `templates/workbench-ui.js` 字节锁保持);`deck-layouts.mjs` 完成模块化拆分;`@office-kit/pptx` `validatePresentation()` 0 错误;实机 `@deepseek-ai/libreoffice-kit` 无头渲染(`missingFonts: []`)逐页目视核验 Mermaid `flowchart` / `sequenceDiagram` 原生吸附连线、`.xlsx` 多工作表与 `.docx` 直吞建稿、`dsh-cite` 文献页、`dsh-remotion` 分镜包、高管一页纸预览与 8 张双语 SVG。
|
|
14
|
+
|
|
15
|
+
- **0.26.0 Bilingual Validation Record (2026-11-20)**: Full `tsc`, client bundle build, and `npm test` suite passed with 0 failures, 0 `type` arrays across all 13 registered tools, and Workbench UI v3 `templates/workbench-ui.js` byte lock intact; modular `deck-layouts.mjs` split verified; `@office-kit/pptx` `validatePresentation()` passed with 0 errors; real `@deepseek-ai/libreoffice-kit` rendering (`missingFonts: []`) and browser preview visually verified native-connector Mermaid `flowchart` / `sequenceDiagram`, direct `.xlsx`/`.docx` ingestion, `dsh-cite` References slides, `dsh-remotion` bundles, Executive One-Pager HTML, and all 8 workflow SVGs.
|
|
16
|
+
|
|
9
17
|
**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
18
|
|
|
11
19
|
- **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.
|
package/docs/WORKBENCH.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# dsh-ppt 工作台 / Workbench
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
演示文稿主工作台,提供顶栏 **`? 引导`** 四步聚光灯交互导览、空态 **「一键体验旗舰示例」**、`import-office`(直吞 `.xlsx`/`.csv`/`.tsv`/`.docx`)、自助「新建演示文稿」与「导入 PPTX 翻新」向导、页面栏、画布区与五栏属性面板(内容编辑、风格与母版、视觉检查、演练、数据与推演);支持一键切换 24 套主题、8 套名家范本预设、6 套母版骨架与 29+ 种版式原型(含 **Mermaid 流程图/时序图**、不等宽市场图 `marimekko`、桑基图 `sankey`、波特价值链 `value-chain`、SWOT 矩阵 `swot` 与 LaTeX 原生公式)、**演讲时长预算器(`targetMinutes` 目标时长与超预算标记)**、上传 Office 修改稿导回更新工程(保留撤销历史)、拖拽深度吸收参考 `.pptx`(≤24 MiB)并收藏到「我的品牌库」、导出 **高管一页纸(`.onepager.html`)**、**Remotion 视频分镜包(`.zip`)**、`.handout.md` 演讲讲义、HTML ↔ PPTX 并排对比及画布级视觉修复前后对照,保留跨栏推演联动、未保存保护和画面内全屏退出。
|
|
4
4
|
|
|
5
|
-
Presentation workbench with self-service **New presentation** and **Import & Modernize .pptx** wizards,
|
|
5
|
+
Presentation workbench with header **`? Guide`** 4-step interactive spotlight tour (`templates/panels/tour.js`), 1-click **Load Flagship Demo** (`create-demo`), **Import Office** (`.xlsx`/`.csv`/`.tsv`/`.docx` ≤24 MiB), self-service **New presentation** and **Import & Modernize .pptx** wizards, 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 29+ slide archetypes (including **Mermaid `flowchart`/`sequenceDiagram`**, `marimekko`, `sankey`, Porter `value-chain`, `swot`, and LaTeX `formula` editing), **Speaking-Pace Budgeter (`targetMinutes` & live overrun badges)**, round-trip **Sync Edited .pptx** with undo history, in-memory `.pptx` style & skeleton absorption (`≤24 MiB`) with **My Brand Library**, **Executive One-Pager (`.onepager.html`)**, **Remotion Storyboard (`.zip`)**, and `.handout.md` downloads, HTML ↔ PPTX side-by-side comparison, and full-width Vision QA diffs.
|
|
6
6
|
|
|
7
7
|
## 使用 / Use
|
|
8
8
|
|
|
@@ -31,8 +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
|
|
35
|
-
- 独立打开导出的 HTML 放映页时,按 **`P`**
|
|
34
|
+
- 也可分别下载 PPTX、HTML、**高管一页纸(`kind: 'onepager'`,导出 `.onepager.html`,支持 A4 打印 PDF 与长图战报切换)**、**Remotion 视频分镜包(`kind: 'remotion'`,导出 `.zip` 含 `DeckVideo.tsx` / `slides-data.json` / `remotion-storyboard.json`)**、演讲讲义(`kind: 'handout'`,导出 `.handout.md`)、讲稿 Markdown 或工程。未保存时先保存,旧修订的下载会被拒绝。
|
|
35
|
+
- 独立打开导出的 HTML 放映页时,按 **`P`** 可开启双屏演讲者提词台(支持下一页预览、提词字号缩放、单页演讲时长预算、计时器与 **`L` 键虚拟激光笔**)。
|
|
36
36
|
|
|
37
37
|
分享包里的 HTML、PPTX 备注和讲稿仍保留已绑定的来源摘录与用户填写内容。分包不等于自动脱敏,请按收件人需要选择内容。
|
|
38
38
|
|