dsh-ppt 0.34.0 → 0.35.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 +23 -0
- package/README.en.md +8 -11
- package/README.md +8 -11
- package/docs/USAGE.en.md +43 -35
- package/docs/USAGE.md +44 -36
- package/docs/VALIDATION.md +4 -0
- package/lib/client.js +1 -1
- package/lib/execution.js +20 -2
- package/lib/tools.js +64 -2
- package/lib/types.d.ts +58 -1
- package/lib/workbench.js +18 -2
- package/package.json +2 -2
- package/skills/dsh-ppt/SKILL.md +34 -32
- package/skills/dsh-ppt/package.json +1 -1
- package/skills/dsh-ppt/references/office-pack.md +124 -0
- package/skills/dsh-ppt/references/research-plan.md +93 -62
- package/skills/dsh-ppt/scripts/build-deck.mjs +60 -2
- package/skills/dsh-ppt/scripts/deck-absorb.mjs +2 -0
- package/skills/dsh-ppt/scripts/deck-advanced.mjs +198 -29
- package/skills/dsh-ppt/scripts/deck-brand-kit.mjs +13 -0
- package/skills/dsh-ppt/scripts/deck-charts-exec.mjs +805 -0
- package/skills/dsh-ppt/scripts/deck-chrome.mjs +10 -1
- package/skills/dsh-ppt/scripts/deck-compose.mjs +386 -0
- package/skills/dsh-ppt/scripts/deck-core.mjs +128 -14
- package/skills/dsh-ppt/scripts/deck-delivery.mjs +141 -3
- package/skills/dsh-ppt/scripts/deck-evidence.mjs +811 -118
- package/skills/dsh-ppt/scripts/deck-export.mjs +652 -0
- package/skills/dsh-ppt/scripts/deck-i18n.mjs +170 -0
- package/skills/dsh-ppt/scripts/deck-layouts.mjs +72 -8
- package/skills/dsh-ppt/scripts/deck-office.mjs +833 -38
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,28 @@
|
|
|
1
1
|
# 更新记录
|
|
2
2
|
|
|
3
|
+
## 0.35.0 (2026-11-22)
|
|
4
|
+
|
|
5
|
+
- **8 大领域权威信源检索引擎、代码级信源审计(`SLOP-13` 升级 9 项)与三模路由(`deck-evidence.mjs` + `deck-brand-kit.mjs`)**:
|
|
6
|
+
- 内置 8 大专业领域权威域名白名单(`AUTHORITATIVE_DOMAINS`:`gov-macro`、`finance-filings`、`ai-tech`、`medical-clinical`、`energy-climate`、`academic-science`、`consumer-retail`、`general-business`)与 25 站噪声/二手转引黑名单(`NOISE_DOMAINS`);`detectResearchDomain` 与 `buildAuthoritativeQueryPack` 按选题自动产出自带 `site:` + `filetype:pdf` + `-site:` 排除营销号的 3 轮定向权威检索包;
|
|
7
|
+
- 新增 `classifySourceAuthority` 代码级自动定级 Tier 1/2/3 并扩展 `evidence[]` 治理字段(`origin: 'local-file' | 'web-research'`、`tier: 1 | 2 | 3`、`claimType: 'actual' | 'forecast' | 'policy' | 'benchmark'`);`SLOP-13` 升级为 9 项零误报审计,新增拦截名义权威机构却挂自媒体二手转引链接(`secondary-relay-source`)、Tier 3 噪声站或工作区屏蔽域冒充已核验(`low-authority-source`)、预测口径未标「预计/预测/E」(`unmarked-forecast-claim`)、外源缺失年份(`missing-external-date`)及超 3 年过时外部基准(`stale-evidence-date`);`.dsh-ppt/brand-kit.json` 新增 `preferredSources`(自动提级 T1)与 `blockedDomains`(自动拦截并注入 `-site:`);
|
|
8
|
+
- 技能协议升级为 **三模路由(Mode A 有资料直出 / Mode B 零资料 8 域深研 / Mode C 本地混合素材包 × 权威外源对标)**,新增 `skills/dsh-ppt/references/office-pack.md` 并全面刷新 `research-plan.md` 与 `SKILL.md`。
|
|
9
|
+
- **Mode C 本地素材包精炼体检(`inspectOnly`)与需求驱动 Office / 照片智能编排(`deck-office.mjs`)**:
|
|
10
|
+
- `ppt_from_office({ inspectOnly: true })`(CLI `--inspect-only`)以极低 Token 输出 **Material Dossier**(Excel 极值统计与推荐图型、Word/PDF 章节提纲与 `.docx` 内嵌图缓存、照片像素/方向/焦距建议、本地 `[E1..Ek]` 账本)与 **`enrichmentPlan`**(外部权威支柱缺口诊断、顺延编号 `nextEvidenceId` 与精准检索式),配合 `mergeHybridEvidence` 实现本地与外源双轨零冲突溯源;
|
|
11
|
+
- 新增 `instructions` 自然语言编排(页数预算/跳过目录/指定封面或样机图/焦点词加权)、`maxSlides` 权重预算、`includeSheets` 工作表筛选、`photoRoles` 显式照片角色映射,以及 `bindDataModel: true`(CLI `--bind-data`)自动将 Excel 数值表绑定至 `dataModel` `{{metricId}}` 供 `ppt_data` 实时刷新;零依赖 PNG/JPEG/WebP 二进制头解析自动为竖屏/人像/团队照设 `focalPoint: 'top'` 防切头,移动端与浏览器/看板截图自动归位 `mockup[mobile|browser]`。
|
|
12
|
+
- **4 套高管咨询级原生矢量图谱(`deck-charts-exec.mjs` — 41 种标准版式 + 53 别名)与 HTML CSS 按需 Tree-Shaking**:
|
|
13
|
+
- 100% 零新增依赖、HTML/SVG 与 PPTX 原生可编辑 OOXML 双端同构新增 **`issue-tree`**(别名 `mece` / `logic-tree`,麦肯锡 MECE 逻辑议题树 + 正交连接线)、**`treemap`**(别名 `rect-map` / `budget-map`,Squarified 比例矩形树图 + WCAG 自动反白)、**`gauge`**(别名 `bullet-chart` / `okr-gauge`,Stephen Few 水平子弹图 / OKR 达标仪 + 三段定性区间底带与目标垂线)与 **`pricing`**(别名 `tiers` / `packages`,Good / Better / Best 三档商业报价选型矩阵);
|
|
14
|
+
- 新增 `buildLayoutCss` 按文稿实际使用的版式按需裁剪注入 HTML 样式表,保持离线 HTML 精简轻快。
|
|
15
|
+
- **逆向 Office 配套导出、企业金页库拼装、无损双语翻译、分步动画与离线 `R` 键审阅闭环(`deck-export.mjs` / `deck-compose.mjs` / `deck-i18n.mjs` / `deck-delivery.mjs`)**:
|
|
16
|
+
- **逆向配套导出(`exports[]` / CLI `--export` / 工作台下载)**:零新增依赖支持按需生成标准 OOXML **`.xlsx` Excel 数据工作簿**(总览页 + 各图表/表格/KPI/Treemap/Gauge/Pricing `<c t="n">` 真数值工作表 + 证据台账)、**`.docx` Word 正式文档**(标题层级 + 原生 `<w:tbl>` 表格 + 溯源附录)、**`.qa-prep.md` 会前高管质询预案**、**`.memo.md` 高管阅读备忘录** 与 **`.i18n.json` 翻译槽位包**;工作台新增直接下载 `.xlsx` / `.docx` / `.qa-prep.md`;
|
|
17
|
+
- **企业金页库与跨工程拼装(`deck-compose.mjs`)**:`ppt_edit({ saveToBank })` / `--save-to-bank` 将任意优质单页连同图片资产与关联证据收藏至 `.dsh-ppt/slide-bank.json`(上限 100 条,`--list-bank` 查看);`ppt_create({ mergeSources })` / `--merge` 从多份工程和/或金页库一键拼装新稿,自动 SHA-256 图片去重与跨工程 `[E1..En]` 证据编号无冲突重映射;
|
|
18
|
+
- **100% 版式无损翻译与双语化(`deck-i18n.mjs`)**:`ppt_edit({ translations, bilingualMode, targetLang })`(CLI `--translate` / `--bilingual`)按槽位无损回填译文或中英双语对照,100% 锁死原版式、图表数值、嵌入图片、品牌宪章与 `[E#]` 溯源;
|
|
19
|
+
- **分步点击显现与离线 `R` 键审阅回流**:新增单页 `reveal: 'step'`(HTML 步进 + PPTX 原生 `<p:timing>` 多对象点击构建)与 `motionProfile: 'subtle' | 'executive' | 'keynote'`(`--motion-profile`);独立离线 HTML 新增 **`R` 键审阅批注面板**(按页记录审阅人意见并导出 `review-feedback.json`),经 `ppt_check({ feedbackPath })`(CLI `--feedback`)直接映射为精确页码的 `stakeholder-feedback` 告警,形成离线审阅 → AI 自动修订闭环。
|
|
20
|
+
- **8-Domain Authoritative Research Engine, Code-Level `SLOP-13` Source Governance, Mode C Hybrid Office Packs, 4 Executive Diagrams (41 Canonical Layouts + 53 Aliases), Reverse Office Exports, Slide Bank Composer, Lossless i18n & Offline `R`-Key Review Loop (Zero New Runtime Dependencies, Strictly 13 Registered Tools)**:
|
|
21
|
+
- **8-Domain Authoritative Query Engine & Upgraded `SLOP-13` (`deck-evidence.mjs` + `deck-brand-kit.mjs`)**: Built-in 8-domain whitelist (`gov-macro`, `finance-filings`, `ai-tech`, `medical-clinical`, `energy-climate`, `academic-science`, `consumer-retail`, `general-business`) and 25-site noise blacklist (`NOISE_DOMAINS`) powering `site:` + `filetype:pdf` + `-site:` 3-round query packs; adds `classifySourceAuthority` (T1/T2/T3), `origin` (`local-file` | `web-research`), `tier`, `claimType` (`actual` | `forecast` | `policy` | `benchmark`), workspace `brand-kit.json` `preferredSources` / `blockedDomains`, and 5 new `SLOP-13` gates (`secondary-relay-source`, `low-authority-source`, `unmarked-forecast-claim`, `missing-external-date`, `stale-evidence-date`).
|
|
22
|
+
- **Mode C Material Dossier (`inspectOnly`) & Requirement-Driven Office/Photo Choreography (`deck-office.mjs`)**: `ppt_from_office({ inspectOnly: true })` emits a token-efficient Material Dossier + `enrichmentPlan` (`nextEvidenceId`, authoritative queries) for hybrid local + external decks; adds `instructions`, `maxSlides`, `includeSheets`, `photoRoles`, `bindDataModel: true` (live Excel → `dataModel` `{{metricId}}`), and zero-dep PNG/JPEG/WebP dimension parsing (auto `focalPoint: 'top'` for portrait/team shots, `mockup[mobile|browser]` for app/dashboard screenshots).
|
|
23
|
+
- **4 Executive Consulting Diagrams (`deck-charts-exec.mjs`) & Layout CSS Tree-Shaking**: Expands to **41 canonical layouts (36 core + 5 media) + 53 aliases** with 100% native editable OOXML + HTML/SVG `issue-tree` (`mece`/`logic-tree`), `treemap` (`rect-map`/`budget-map`), `gauge` (`bullet-chart`/`okr-gauge`), and `pricing` (`tiers`/`packages`), plus on-demand `buildLayoutCss` HTML CSS tree-shaking.
|
|
24
|
+
- **Reverse Exports, Slide Bank & Composer, Lossless i18n, Step Reveal & `R`-Key Review Loop (`deck-export.mjs`, `deck-compose.mjs`, `deck-i18n.mjs`, `deck-delivery.mjs`)**: Adds `exports: ['xlsx', 'docx', 'qa-prep', 'memo', 'i18n', ...]` (plus Workbench `.xlsx`/`.docx`/`.qa-prep.md` downloads), `.dsh-ppt/slide-bank.json` (`saveToBank`) + `mergeSources` (SHA-256 asset dedup + collision-free `[E#]` remapping), layout-lossless `translations` + `bilingualMode`, `reveal: 'step'` (HTML + PPTX `<p:timing>`) & `motionProfile`, and offline HTML `R`-key comment export (`review-feedback.json`) → `ppt_check({ feedbackPath })` stakeholder revision loop.
|
|
25
|
+
|
|
3
26
|
## 0.34.0 (2026-11-21)
|
|
4
27
|
|
|
5
28
|
- **企业级品牌宪章锁(`deck-brand-kit.mjs` + `SLOP-14`)与多源素材包直吞(含纯 Node `.pdf` 解析)**:
|
package/README.en.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# PPT
|
|
4
4
|
|
|
5
|
-
**Publication-grade presentation engine & workbench for DeepSeek Harness:
|
|
5
|
+
**Publication-grade presentation engine & workbench for DeepSeek Harness: Tri-Mode Routing (Direct / 8-Domain Authoritative Research / Mode C Hybrid Local + External Enrichment), SLOP-13/14 governance gates, 41 canonical native-editable layouts + 53 aliases (MECE Issue Tree, Squarified Treemap, OKR Gauge, Pricing Matrix, World/China Maps, 2.5D Isometric, Mermaid, Formulas, Code), 20 Gold Exemplars, 24 themes, reverse Office exports (.xlsx/.docx/.qa-prep/.memo/.i18n), Slide Bank Composer, lossless i18n & offline R-key review feedback loop.**
|
|
6
6
|
|
|
7
7
|
[](https://www.npmjs.com/package/dsh-ppt) [](https://www.npmjs.com/package/dsh-ppt) [](https://www.npmjs.com/package/dsh-ppt)
|
|
8
8
|
|
|
@@ -17,15 +17,12 @@
|
|
|
17
17
|
|
|
18
18
|
## Features
|
|
19
19
|
|
|
20
|
-
- **
|
|
21
|
-
- **
|
|
22
|
-
- **
|
|
23
|
-
- **
|
|
24
|
-
- **
|
|
25
|
-
- **
|
|
26
|
-
- **Direct Word/Excel/CSV Ingestion, `.pptx` Modernization & `dsh-cite` / `dsh-remotion` Bridges**: `ppt_from_office` ingests `.xlsx` workbooks, `.csv`/`.tsv`, and `.docx` reports directly with zero new dependencies; `ppt_import` refurbishes legacy `.pptx` files and syncs Office round-trip edits (`≤24 MiB`, undoable); `ppt_cite` links verified **`dsh-cite`** references and `ppt_remotion` exports animated **`dsh-remotion`** storyboard packs.
|
|
27
|
-
- **Direct-Manipulation Workbench & 1-Click PDF / PNG-ZIP Delivery**: Adapted for DeepSeek Harness `>=0.2.2-rc.3`; features **HTML5 Drag-and-Drop Slide Reordering** in the left rail, **Canvas Double-Click Inline Editing** synced atomically to HTML + PPTX, **`? Guide`** spotlight tour, 1-click **Load Flagship Demo**, **Speaking-Pace Budgeter**, **Dual-Screen Presenter View** (`P` key + `L` laser), and direct downloads for **PPTX**, **High-DPI PDF (`.pdf`)**, **Slide PNG Pack (`.zip`)**, **Executive One-Pager (`.onepager.html`)**, **Speaker Handout (`.handout.md`)**, and **Remotion Storyboard (`.zip`)**.
|
|
28
|
-
- **Optional verification & coaching**: Traceable numbers with live what-if sliders, 24-slide two-tier Vision QA (12 lossless formatting actions + full-width before/after canvas diff), and executive storyline coaching / defense rehearsal.
|
|
20
|
+
- **Tri-Mode Routing, 8-Domain Authoritative Research Engine & Mode C Hybrid Packs (`SLOP-13` 9-Check Gate)**: Supports **Mode A (Direct Build)**, **Mode B (Zero-Material 8-Domain Research with `site:` + `filetype:pdf` + `-site:` 25-domain noise exclusion)**, and **Mode C (Hybrid Local Materials + External Authority)**; `ppt_from_office({ inspectOnly: true })` emits a token-efficient **Material Dossier** & **`enrichmentPlan`** (indexing local `E1..Ek` and returning collision-free `nextEvidenceId`), with `instructions`, `maxSlides`, `includeSheets`, `photoRoles`, `bindDataModel: true` (live Excel → `dataModel`), and automatic `focalPoint: 'top'` for portrait/team photos; code-level `classifySourceAuthority` (T1/T2/T3) + upgraded **`SLOP-13`** intercepts secondary relays, low-authority T3/blocked domains, unmarked forecasts, missing external dates, and stale benchmarks, honoring workspace `brand-kit.json` `preferredSources` & `blockedDomains`.
|
|
21
|
+
- **41 Canonical Native-Editable Layouts (36 Core + 5 Media, + 53 Aliases) & 4 Executive Diagrams**: Zero new runtime dependencies, 100% HTML/SVG + editable OOXML parity — adds **McKinsey MECE `issue-tree`**, **Squarified `treemap`**, **Stephen Few OKR `gauge`**, and **Good/Better/Best `pricing`** (plus on-demand `buildLayoutCss` HTML CSS tree-shaking), alongside **World/China Dotted Maps (`map`)**, **2.5D Isometric Stack & Pillars (`isometric`)**, **Magic Quadrant (`quadrant`)**, **Radar (`radar`)**, **Dumbbell (`dumbbell`)**, **Heatmap (`heatmap`)**, **Device Mockups (`mockup`)**, **9-Language Code Terminals (`code`)**, native `<m:oMath>` equations, Mermaid connectors, Marimekko, Sankey, Porter Value Chain, SWOT, Gantt, Architecture, Harvey balls, TAM, Org charts, booktabs tables, and **13 publication-grade chart kinds**.
|
|
22
|
+
- **Reverse Office Exports, Slide Bank Composer, Lossless i18n, Step Reveal & Offline `R`-Key Review Loop**: Export optional zero-dep companions via `exports[]` / `--export` — **`.xlsx` Excel data workbook**, **`.docx` Word formal report**, **`.qa-prep.md` executive Q&A defense guide**, **`.memo.md` prose memo**, and **`.i18n.json` translation bundle** (Workbench also downloads `.xlsx`/`.docx`/`.qa-prep.md`); save reusable slides into **`.dsh-ppt/slide-bank.json` (`saveToBank`)** and compose cross-deck builds via **`mergeSources`** (SHA-256 asset dedup + collision-free `[E#]` remapping); apply 100% layout-lossless **`translations` / `bilingualMode`**; control click-by-click **`reveal: 'step'`** (HTML + PPTX `<p:timing>`) & **`motionProfile`**; let stakeholders press **`R`** in offline HTML to pin slide comments & export `review-feedback.json` → `ppt_check({ feedbackPath })` for precision AI revisions.
|
|
23
|
+
- **Enterprise Brand Kit Lock (`SLOP-14`), Multi-Audience Remix, Social Carousel & Live Presenter Power Pack**: Persist corporate palette, fonts, logo, footer, content-slide confidentiality watermark (`CONFIDENTIAL · 内部资料`), mandatory closing, and trusted/blocked source lists in `.dsh-ppt/brand-kit.json`; compress decks into **`exec-5min` (6p)** / **`board-brief` (8p)** / **`sales-pitch` (7p)** copies with omitted notes archived losslessly plus **`4:5` / `1:1` Social Carousel HTML**; standalone HTML includes **`Ctrl/Cmd+K` jump search (with `[E#]` evidence)**, **`R` review comments**, **`D` whiteboard pen**, **`T` Q&A countdown timer**, **`A` narrated Auto-Tour**, **`P` Dual-Screen Presenter Console**, **`L` laser pointer**, and **`.srt`/`.vtt` subtitles** (also bundled into `dsh-remotion`).
|
|
24
|
+
- **20 Curated Gold Exemplars (12 GitHub OSS-Distilled), 8 Taste Recipes & Zero-LLM Self-Repair Loop**: Ships **13 registered tools**, **24 built-in themes (16 daylight + 8 dark)**, **6 Master Chrome Skeletons**, **8 Taste Recipes**, **20 industry blueprints**, **20 Gold Exemplars** (`exemplar: "auto"`, `alignOrder: true`, Few-Shot JSON), and **61 native `<a:custGeom>` vector icons**; batch-ingest local `.pptx` folders via `ppt_absorb` / `--ingest-exemplars` into `.dsh-ppt/exemplars.json` & `.dsh-ppt/taste-recipes.json`; deterministic Weak-LLM Compensator + pre-commit `SLOP-01..14` Zero-LLM Self-Repair Loop produces zero-warning decks with 0 extra LLM calls.
|
|
25
|
+
- **Multi-Source Ingestion, Direct-Manipulation Workbench & Ecosystem Bridges**: `ppt_from_office` ingests `.pdf`/`.docx`/`.xlsx`/`.csv`/`.tsv`/`.png`/`.jpg`/`.webp` packs with zero new dependencies; `ppt_import` refurbishes legacy `.pptx` files and syncs Office round-trip edits with undo history; `ppt_cite` links `dsh-cite` references and `ppt_remotion` exports `dsh-remotion` packs; Workbench (`DSH >=0.2.2-rc.3`) supports drag-and-drop reorder, double-click inline edits, Evidence Ledger & Revision Diff drawers, 1-click exports (PPTX/PDF/PNG-ZIP/XLSX/DOCX/QA-Prep/One-Pager/Carousel/Subtitles), plus optional **live what-if data lineage, 24-slide Vision QA, and rehearsal coaching**.
|
|
29
26
|
|
|
30
27
|
## Style previews
|
|
31
28
|
|
|
@@ -93,7 +90,7 @@ Ready-to-copy chat prompts:
|
|
|
93
90
|
|
|
94
91
|
## Before you start
|
|
95
92
|
|
|
96
|
-
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;
|
|
93
|
+
Download the finished deck directly; AI review, rehearsal and visual repair are optional. CLI and skill error messages are in Chinese. Import external `.pptx` decks for one-click modernization or sync Office-edited `.pptx` changes back into your workbench project with undo history; standalone HTML includes Dual-Screen Presenter View (`P`), offline review comment export (`R` → `review-feedback.json` for AI revision), and companion `.xlsx` / `.docx` / `.qa-prep.md` / `.handout.md` exports.
|
|
97
94
|
|
|
98
95
|
Configuration, detailed tools and troubleshooting: [full reference](https://github.com/STARDUSTLC666/dsh-ppt/blob/master/docs/REFERENCE.en.md).
|
|
99
96
|
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# PPT
|
|
4
4
|
|
|
5
|
-
**DeepSeek Harness
|
|
5
|
+
**DeepSeek Harness 大师级演示文稿引擎与工作台:支持三模路由(有资料直出 / 零资料 8 域权威深研 / Mode C 本地多源融合+外源对标)、企业品牌宪章锁与 SLOP-13/14 双重合规门禁、41 种原生可编辑图谱(MECE 议题树/Treemap/OKR 子弹仪/三档报价/点阵地图/2.5D 等轴测/Mermaid/公式/代码)、20 套标杆范本、24 主题、逆向导出 Excel/Word/备忘录/答辩预案/无损翻译包、企业金页拼装与离线 R 键审阅回流,一键导出离线 HTML 放映与 100% 可编辑 PPTX。**
|
|
6
6
|
|
|
7
7
|
[](https://www.npmjs.com/package/dsh-ppt) [](https://www.npmjs.com/package/dsh-ppt) [](https://www.npmjs.com/package/dsh-ppt)
|
|
8
8
|
|
|
@@ -17,15 +17,12 @@
|
|
|
17
17
|
|
|
18
18
|
## 功能
|
|
19
19
|
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
- **全格式直吞与生态联动(Word / Excel / CSV / PPTX / Cite / Remotion)**:`ppt_from_office` 零外部依赖直吞 **`.xlsx` 多工作表 / `.csv` / `.tsv` 与 `.docx` Word 报告**;`ppt_import` 支持外部 `.pptx` 一键翻新与 Office 双向导回(≤24 MiB 内存解析,保留撤销历史);`ppt_cite` 联动 **`dsh-cite`** 生成核验参考文献页,`ppt_remotion` 导出 **`dsh-remotion`** 动画视频分镜包。
|
|
27
|
-
- **直接操纵工作台与一键全格式导出**:适配 DeepSeek Harness `>=0.2.2-rc.3`,内置多套明亮风格与字体切换;支持左侧目录 **拖拽排序(Drag-and-Drop)**、画布 **双击文字原地改写并原子同步 PPTX**、右上角 **`? 引导`** 交互导览、**「一键体验旗舰示例」** 与 **演讲时长预算器**;导出面板支持 **最新 PPTX**、**高精 PDF(`.pdf`)**、**逐页 PNG 图包(`.zip`)**、**高管一页纸(`.onepager.html`)**、**Remotion 分镜包(`.zip`)**、**讲义(`.handout.md`)** 与独立 HTML **`P` 键双屏提词台 + `L` 键虚拟激光笔**。
|
|
28
|
-
- **可选高阶能力**:数字溯源与现场推演、24 页双层 AI 视觉审查(含 12 种无损排版修复与全宽前后对比)、高管叙事预审与模拟答辩。
|
|
20
|
+
- **三模路由、8 大领域权威信源引擎与 Mode C 混合深研(`SLOP-13` 升级 9 项)**:支持 **Mode A(有资料直出)**、**Mode B(零资料 8 域权威深研:`site:` + `filetype:pdf` + `-site:` 排除 25 站营销号)** 与 **Mode C(本地混合素材包 × 权威外源对标)**;`ppt_from_office({ inspectOnly: true })` 低 Token 返回精炼 **Material Dossier** 与 **`enrichmentPlan`**(自动编目本地 `E1..Ek` 并顺延外部起始编号),支持 `instructions` 自然语言编排、`maxSlides`、`includeSheets`、`photoRoles`、`bindDataModel: true`(Excel 实时绑定 `dataModel`)与人像自动 `focalPoint: 'top'` 防切头;代码级 `classifySourceAuthority`(T1/T2/T3)与 `SLOP-13` 9 项门禁拦截二手转引、低权威自媒体、未标注预测口径、缺年份及过时外部基准,工作区 `.dsh-ppt/brand-kit.json` 同步支持 `preferredSources` 与 `blockedDomains`。
|
|
21
|
+
- **41 种原生可编辑图谱(36 核心 + 5 媒体,含 53 别名)与 4 套高管咨询新图**:零新增依赖、HTML/SVG 与 PPTX 原生 OOXML 双端同构——新增 **麦肯锡 MECE 逻辑议题树 `issue-tree`**、**比例面积矩形树图 `treemap`**、**Stephen Few OKR 水平子弹仪 `gauge`** 与 **三档商业报价矩阵 `pricing`**(并支持 HTML CSS 按需 Tree-Shaking),叠加 **全球/中国点阵地图 `map`**、**2.5D 等轴测堆叠/柱碑 `isometric`**、**魔力象限 `quadrant`**、**多维雷达 `radar`**、**哑铃跃迁 `dumbbell`**、**热力图 `heatmap`**、**设备样机 `mockup`**、**9 语言语法高亮代码窗 `code`**、原生 `<m:oMath>` 公式、Mermaid 原生吸附连线、Marimekko、桑基图、波特价值链、SWOT、甘特图、系统架构、哈维球、TAM、组织图谱、学术三线表与 **13 类出版级图表**。
|
|
22
|
+
- **逆向 Office 配套导出、企业金页拼装、100% 无损翻译与离线 `R` 键审阅闭环**:零新增依赖通过 `exports[]`(CLI `--export`)按需配套导出 **`.xlsx` Excel 数据工作簿**、**`.docx` Word 汇报文档**、**`.qa-prep.md` 会前高管质询预案**、**`.memo.md` 高管备忘录** 与 **`.i18n.json` 翻译槽位包**(工作台同步支持下载 `.xlsx`/`.docx`/`.qa-prep.md`);支持 **企业金页库 `.dsh-ppt/slide-bank.json`(`saveToBank`)+ 跨工程拼装(`mergeSources`)**(SHA-256 图片去重 + 跨工程 `[E#]` 无冲突重映射)、**100% 版式无损翻译与中英双语化(`translations` / `bilingualMode`)**、单页分步点击显现 **`reveal: 'step'`** 与 **`motionProfile`**,以及独立 HTML 按 **`R` 键离线批注导出 `review-feedback.json`** → `ppt_check({ feedbackPath })` 回流 AI 逐页修订。
|
|
23
|
+
- **企业品牌宪章锁(`SLOP-14`)、多受众改编、社媒长图与现场演示增强包**:支持将企业色板、字体、Logo、统一页脚、内容页保密水印(`CONFIDENTIAL · 内部资料`,HTML/PPTX 同构)、官方封底及权威信源名单锁存至 `.dsh-ppt/brand-kit.json`;`ppt_edit({ remixPreset })` / `--remix` 一键压缩改编为 **高管 5 分钟(6 页)** / **董事会(8 页)** / **客户路演(7 页)**副本(被折叠要点无损归档备注)并导出 **4:5 / 1:1 社媒长图卡片(`.carousel.html`)**;独立 HTML 内置 **`Ctrl/Cmd+K` 全局速搜(含 `[E#]` 证据)**、**`R` 键审阅批注**、**`D` 键白板画笔**、**`T` 键 Q&A 倒计时**、**`A` 键自动字幕导览**、**`P` 键双屏提词台**、**`L` 键虚拟激光笔** 与 **`.srt`/`.vtt` 字幕导出**(同步内置于 `dsh-remotion`)。
|
|
24
|
+
- **20 套标杆范本槽位契约(含 12 套 GitHub 开源实机蒸馏)、8 套品味配方与零模型自检修复闭环**:内置 **13 个注册工具**、**24 套大师主题(16 浅 8 深)**、**6 套母版骨架**、**8 套大师 Taste Recipes**、**20 套行业蓝图**、**20 套标杆范本**(支持 `exemplar: "auto"`、`alignOrder: true` 与 Few-Shot JSON 样板)与 **61 枚原生 `<a:custGeom>` 矢量图标**;支持 `ppt_absorb` / `--ingest-exemplars` 批量吸收本地 `.pptx` 目录沉淀审美 DNA 与范本;内置 **确定性弱模型补偿器 + 落盘前 `SLOP-01..14` 零模型自检修复闭环**,0 额外模型开销直出零告警成品。
|
|
25
|
+
- **全格式直吞、直接操纵工作台与生态联动**:`ppt_from_office` 零新增依赖直吞 `.pdf`/`.docx`/`.xlsx`/`.csv`/`.tsv`/`.png`/`.jpg`/`.webp` 混合素材包;`ppt_import` 支持外部 `.pptx` 一键翻新与 Office 双向导回(保留撤销历史);`ppt_cite` 联动 `dsh-cite` 核验文献,`ppt_remotion` 导出 `dsh-remotion` 视频分镜包;工作台(适配 DSH `>=0.2.2-rc.3`)支持左侧拖拽排序、画布双击原地改写、证据账本与修订差异抽屉、一键导出 PPTX / PDF / PNG 图包 / Excel / Word / 质询预案 / 一页纸 / 社媒长图 / 字幕,以及按需开启的 **数字溯源推演、24 页双层 AI 视觉审查与模拟答辩**。
|
|
29
26
|
|
|
30
27
|
## 风格预览
|
|
31
28
|
|
|
@@ -94,7 +91,7 @@ dsh plugin --profile desktop add dsh-ppt
|
|
|
94
91
|
|
|
95
92
|
## 开始前要知道
|
|
96
93
|
|
|
97
|
-
可直接下载成品;AI
|
|
94
|
+
可直接下载成品;AI 预审、模拟答辩与看图修复均按需开启。CLI 与工具报错信息均为中文。支持导入外部 PPTX 一键翻新,或在 Office 微调后导回工作台更新工程;独立 HTML 内置按 `P` 开启双屏演讲者提词台、按 `R` 离线批注导出 `review-feedback.json` 给 AI 修订,并支持配套导出 `.xlsx` / `.docx` / `.qa-prep.md` / `.handout.md`。
|
|
98
95
|
|
|
99
96
|
配置、完整工具与排错见[详细使用说明](https://github.com/STARDUSTLC666/dsh-ppt/blob/master/docs/REFERENCE.zh.md)。
|
|
100
97
|
|
package/docs/USAGE.en.md
CHANGED
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## Current improvements
|
|
6
6
|
|
|
7
|
+
- **0.35.0 8-Domain Authoritative Research Engine, Mode C Hybrid Office Packs (`inspectOnly`), 4 Executive Diagrams (41 Canonical Layouts + 53 Aliases), Reverse Office Exports, Slide Bank Composer, Lossless i18n & Offline `R`-Key Review Loop**: `deck-evidence.mjs` adds an 8-domain whitelist + 25-site noise blacklist (`site:` + `filetype:pdf` + `-site:` queries), code-level `classifySourceAuthority` (T1/T2/T3), and 5 new `SLOP-13` gates (`secondary-relay-source`, `low-authority-source`, `unmarked-forecast-claim`, `missing-external-date`, `stale-evidence-date`), with workspace `.dsh-ppt/brand-kit.json` `preferredSources` & `blockedDomains`; `deck-office.mjs` adds Mode C `inspectOnly: true` (Material Dossier + `enrichmentPlan` + `nextEvidenceId`), `instructions`, `maxSlides`, `includeSheets`, `photoRoles`, `bindDataModel: true`, and zero-dep PNG/JPEG/WebP header parsing (portrait/team → `focalPoint: 'top'`, app/dashboard screenshots → `mockup`); `deck-charts-exec.mjs` adds **`issue-tree`** (MECE logic tree), **`treemap`** (squarified area map), **`gauge`** (Stephen Few OKR bullet chart), and **`pricing`** (Good/Better/Best tiers) plus on-demand `buildLayoutCss` HTML CSS tree-shaking; zero-dep `deck-export.mjs` (`exports: ['xlsx', 'docx', 'qa-prep', 'memo', 'i18n', ...]`, Workbench downloads for `.xlsx`/`.docx`/`.qa-prep.md`), `deck-compose.mjs` (`.dsh-ppt/slide-bank.json` `saveToBank` + `mergeSources`), `deck-i18n.mjs` (100% layout-lossless `translations` / `bilingualMode`), `reveal: 'step'` + `motionProfile`, and offline HTML `R`-key comment export (`review-feedback.json`) → `ppt_check({ feedbackPath })`.
|
|
7
8
|
- **0.34.0 Enterprise Brand Kit Lock (`SLOP-14`), Pure-Node `.pdf` & Multi-Source Pack Ingestion, Multi-Audience Remix & Social Carousel, Live Presenter Power Pack & Workbench Sync**: Adds zero-dependency `deck-brand-kit.mjs` (`.dsh-ppt/brand-kit.json` persistence, HTML/PPTX content-slide confidentiality watermarks, `mandatoryClosing`, `SLOP-14` forbidden-term & palette-drift audit via `ppt_absorb({ saveBrandKit: true })` / `--save-brand-kit` / `--no-brand-kit`) and `deck-remix.mjs` (`exec-5min` / `board-brief` / `sales-pitch` lossless backup-notes remixing + `4:5`/`1:1` printable Social Carousel HTML); upgrades `deck-office.mjs` with zero-dep `FlateDecode`/UTF-16BE `.pdf` extraction and whole-folder / `filePaths[]` multi-source pack fusion with automatic `[E1..En]` Evidence Ledger binding; upgrades `deck-delivery.mjs` with `Ctrl/Cmd+K` jump search (slides + `[E#]` evidence), `D` whiteboard pen, `T` Q&A countdown timer, `A` narrated Auto-Tour, and `.srt`/`.vtt` timed subtitles (also bundled into `dsh-remotion`); syncs the Workbench UI with `map`/`isometric`, `waves`/`isometric-mesh`/`editorial-arcs`, Layout Morph pills, `focalPoint`, `imageBrief`, Evidence Ledger & Revision Diff drawers, Remix actions, `.pdf` uploads, and Carousel/Subtitle downloads.
|
|
8
9
|
- **0.33.0 Visual & Map Intelligence (World/China Dotted Maps, 2.5D Isometric Infographics, Procedural Cover Artwork & Smart Visual Briefs)**: Adds zero-dependency `deck-infographics.mjs` expanding native editable layouts to **37+** — Economist-style **World & China Dotted Strategic Maps (`map`: `world` | `china`)** with bilingual hub routing, collision-free tags, and ranked sidebars; **2.5D Isometric Infographics (`isometric`: `stack` | `pillars`)** rendered via native 3-face `<a:custGeom>` prisms in PPTX + `<svg>` in HTML; procedural cover patterns **`waves`**, **`isometric-mesh`**, and **`editorial-arcs`**; **Smart Visual Brief slots (`imageBrief` / `visualBriefs[]`)**, **`image.focalPoint`** smart cropping, and automatic bottom-up dark gradient scrims (`sendShapeToBack`) on **`image[full-bleed]`**.
|
|
9
10
|
- **0.32.0 Zero-Material Research-to-Deck Planner, Verified Evidence Ledger & `SLOP-13` Fact-Grounding Gate**: Adds zero-dependency `deck-evidence.mjs` and the Dual-Mode research skill protocol (`skills/dsh-ppt/references/research-plan.md`, keeping strictly 13 registered tools and 100% offline engine execution); `ppt_templates({ topic, evidence })` and CLI `--plan` match the best Gold Exemplar and emit a 3-round retrieval checklist, quantitative gap diagnostics, and user-ready `planMarkdown` storyboard; `ppt_create({ evidence, evidenceAppendix: true })` and CLI `--evidence @file.json --evidence-appendix` bind verified `E1..En` entries into compact single-line `source` footers, full URL/scope speaker notes, a naturally sorted zero-overflow 4-column `booktabs` Sources Appendix slide before `closing`, and `.handout.md` ledger tables; `SLOP-13` intercepts dangling refs, undisclosed `unverified`/`conflicting` claims, vague placeholder sources, and unsourced research numbers with 0 false positives.
|
|
@@ -22,24 +23,25 @@
|
|
|
22
23
|
|
|
23
24
|
| Capability | Description |
|
|
24
25
|
| --- | --- |
|
|
25
|
-
| `ppt_create` tool | Markdown / structured `slides` → `*.html` + `*.pptx` + `*.json`; defaults to `theme: "auto"` and
|
|
26
|
-
| `ppt_from_office` tool | Zero-new-dep
|
|
26
|
+
| `ppt_create` tool | Markdown / structured `slides` → `*.html` + `*.pptx` + `*.json`; defaults to `theme: "auto"` and supports `exemplar`, `alignOrder`, `evidence[]`, `mergeSources` multi-deck composer, `exports[]` companions, `motionProfile`, `referencePptx`, `cloneStructure`, and `targetMinutes` |
|
|
27
|
+
| `ppt_from_office` tool | Zero-new-dep ingestion of `.xlsx`/`.csv`/`.tsv`/`.docx`/`.pdf`/photo packs; supports Mode C `inspectOnly: true` (Material Dossier + `enrichmentPlan`), `instructions`, `maxSlides`, `includeSheets`, `photoRoles`, `bindDataModel: true`, hybrid `evidence[]`, and `exports[]` |
|
|
27
28
|
| `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 |
|
|
28
29
|
| `ppt_cite` tool | Link verified `dsh-cite` / JSON / BibTeX citations (`[@citeKey]`, `[doi:...]`) into `slide.source` footers and an auto-generated `References` slide |
|
|
29
|
-
| `ppt_remotion` tool | Export a 30fps `dsh-remotion` animated video storyboard pack (`DeckVideo.tsx`, `slides-data.json`, `
|
|
30
|
-
| `ppt_absorb` tool | Read-only local extraction of
|
|
30
|
+
| `ppt_remotion` tool | Export a 30fps `dsh-remotion` animated video storyboard pack (`DeckVideo.tsx`, `slides-data.json`, `captions.srt`/`.vtt`) timed from `computePaceBudget` |
|
|
31
|
+
| `ppt_absorb` tool | Read-only local extraction of single `.pptx` or whole `.pptx` folders (`--ingest-exemplars`) into `.dsh-ppt/taste-recipes.json`, `.dsh-ppt/exemplars.json`, and `.dsh-ppt/brand-kit.json` (including `watermark`, `forbiddenTerms`, `preferredSources`, `blockedDomains`) |
|
|
31
32
|
| `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 |
|
|
32
|
-
|
|
|
33
|
-
| 13 chart kinds | `column` / `bar` / `stacked-column` / `stacked-bar` / `percent-column` / `percent-bar` / `line` / `area` / `pie` / `doughnut` / `scatter` / `combo` / `waterfall` with `highlight`
|
|
34
|
-
| `ppt_templates` | 20
|
|
35
|
-
| `ppt_edit` / `ppt_undo` | Edit
|
|
36
|
-
| `ppt_check` | Read-only layout & aesthetic
|
|
33
|
+
| 41 canonical layouts + 53 aliases | **36 core**: `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `swot` / `process` / `value-chain` / `marimekko` / `sankey` / `mermaid` / `callout` (native `<m:oMath>` `formula`) / `gantt` / `architecture` / `harvey` / `tam` / `org` / `mockup` / `code` / `quadrant` / `radar` / `dumbbell` / `heatmap` / `map` / `isometric` / **`issue-tree`** / **`treemap`** / **`gauge`** / **`pricing`** / `table` / `closing`; **5 media**: `image` / `image-left` / `image-right` / `chart` / `chart-split` (plus 53 aliases including `mece`, `logic-tree`, `rect-map`, `budget-map`, `bullet-chart`, `okr-gauge`, `tiers`, `packages`, `world-map`, `china-map`, `iso-stack`, `flowchart`, `sequence`, `chevron`, `waterfall`, `gallery`) |
|
|
34
|
+
| 13 chart kinds | `column` / `bar` / `stacked-column` / `stacked-bar` / `percent-column` / `percent-bar` / `line` / `area` / `pie` / `doughnut` / `scatter` / `combo` / `waterfall` with `spotlight` / `highlight` / `referenceLine` / `showGrowthCallout` |
|
|
35
|
+
| `ppt_templates` | 20 industry blueprints + 20 Gold Exemplars (with Few-Shot JSON) + Mode B 8-Domain Authoritative Research Planner (`topic` + `evidence` → 3-round `site:` query pack & `planMarkdown`) |
|
|
36
|
+
| `ppt_edit` / `ppt_undo` | Edit slides, switch `theme`/`taste`/`brand`/`motionProfile`/`referencePptx`, reorder/duplicate/remove/append, `remixPreset` multi-audience remix, `saveToBank` golden slides, layout-lossless `translations`/`bilingualMode`, and `exports[]` (20-step undo + revision lock) |
|
|
37
|
+
| `ppt_check` | Read-only layout & `SLOP-01..14` aesthetic/authority/brand audit; supports `renderReceipt` digest verification and `feedbackPath` ingestion of offline HTML `R`-key `review-feedback.json` (`stakeholder-feedback`) |
|
|
37
38
|
| `ppt_render` | Optional official LibreOffice Kit PNG / PDF page rendering with missing-font diagnostics |
|
|
38
|
-
| `ppt_data` | Optional source lineage updates and what-if simulation with diff preview before saving; see [data guide](DATA.md#english) |
|
|
39
|
+
| `ppt_data` | Optional source lineage updates and what-if simulation (`bindDataModel: true` auto-binds Excel sheets) with diff preview before saving; see [data guide](DATA.md#english) |
|
|
40
|
+
| Reverse exports & Slide Bank | `exports: ['xlsx', 'docx', 'qa-prep', 'memo', 'i18n', 'handout', 'one-pager', 'social-carousel', 'subtitles']`; Workbench direct `.xlsx`/`.docx`/`.qa-prep.md`/`.pdf`/`.zip` downloads; `.dsh-ppt/slide-bank.json` cross-deck reuse |
|
|
39
41
|
| 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) |
|
|
40
42
|
| 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) |
|
|
41
|
-
| Presenter
|
|
42
|
-
| `dsh-ppt` skill & CLI |
|
|
43
|
+
| Presenter Power Pack & motion | Standalone HTML supports `P` Dual-Screen Presenter Console, `L` laser, `Ctrl/Cmd+K` jump search, `R` offline review comments JSON export, `D` pen, `T` Q&A timer, `A` Auto-Tour; supports `reveal: 'step'`, `motionProfile`, and `motion: 'off'` |
|
|
44
|
+
| `dsh-ppt` skill & CLI | Tri-Mode (Mode A/B/C) SOP registered in DSH (13 tools total), or copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for standalone cross-harness builds |
|
|
43
45
|
|
|
44
46
|
Example:
|
|
45
47
|
|
|
@@ -53,7 +55,7 @@ Example:
|
|
|
53
55
|
dsh plugin --profile web add dsh-ppt
|
|
54
56
|
```
|
|
55
57
|
|
|
56
|
-
On desktop, install `dsh-ppt` through plugin management. Restart the host after updating to load all
|
|
58
|
+
On desktop, install `dsh-ppt` through plugin management. Restart the host after updating to load all 13 tools and the `dsh-ppt` skill. Ask naturally to match a reference template, include screenshots/charts, switch slide 3 to a 3-pillar card layout, or undo the last edit; users never need to hand-write JSON.
|
|
57
59
|
|
|
58
60
|
## Uninstall
|
|
59
61
|
|
|
@@ -68,7 +70,7 @@ Then restart the web service. To clean up fully, also remove the plugin entry fr
|
|
|
68
70
|
### Inside DSH (recommended)
|
|
69
71
|
|
|
70
72
|
```
|
|
71
|
-
1. ppt_themes { preview: true, outputDir: "dist" } # inspect
|
|
73
|
+
1. ppt_themes { preview: true, outputDir: "dist" } # inspect 24 themes + gallery
|
|
72
74
|
2. ppt_create {
|
|
73
75
|
title: "Q3 Operations Review & Next Steps",
|
|
74
76
|
content: "# Executive Summary\n> [!TAKEAWAY] First-response time dropped to 8s while net retention rose +4.2 pts\n\n::: kpi\n- 8s | First response | -64% QoQ\n- 98.5% | SLA attainment | +4.2 pts\n:::",
|
|
@@ -107,21 +109,21 @@ Artifacts (existing files are never overwritten by default; colliding sets recei
|
|
|
107
109
|
|
|
108
110
|
Open the native sidebar **Presentations** workbench (or **Settings → Presentations**) and select a project registered by `ppt_create`, `ppt_edit` or `ppt_check`:
|
|
109
111
|
|
|
110
|
-
- **Content inspector & 1-click archetype switching**: Slide cards in the left rail show layout badges and per-slide quality status dots, plus **+ New slide** starter archetypes (including Gantt, Architecture, Harvey, TAM, Org), reorder, duplicate, delete (keeping 1–120 slides), and undo. At the top of the inspector, switch across all
|
|
111
|
-
- **Style Studio**: Browse Daylight (
|
|
112
|
+
- **Content inspector & 1-click archetype switching**: Slide cards in the left rail show layout badges and per-slide quality status dots, plus **+ New slide** starter archetypes (including `issue-tree`, `treemap`, `gauge`, `pricing`, `map`, `isometric`, Gantt, Architecture, Harvey, TAM, Org), drag-and-drop reorder, duplicate, delete (keeping 1–120 slides), and undo. At the top of the inspector, switch across all 41 canonical archetypes, variants, per-slide `chrome` skeletons, and density modes (`compact | balanced | airy`) with lossless draft projection across bullets, structured `items` (including `actual`/`target`/`max`, Gantt `start`/`span`, `columns`, `role`, `conversion`), and `rows`; edit KPI/card fields, switch `tableStyle` (`consulting | booktabs | minimal | banded | harvey`), and edit `takeaway` callouts and `source` footnotes.
|
|
113
|
+
- **Style Studio**: Browse Daylight (16) vs Dark (8) themes with live palette swatches and scenario tags, switch across **8 Taste Recipes** and **6 Master Chrome Skeletons** (`brand.chromeStyle`), apply a new deck theme in 1 click, customize brand colors/fonts/footer/watermark/PNG-or-JPEG logo, or drag-and-drop a `.pptx` (`≤10 MiB`, decoded in memory with zero host path reads) to preview `recommendedChrome`, `extractedSkeleton`, `slideSkeleton`, and apply its extracted palette and recommended theme.
|
|
112
114
|
- **Side-by-side split & clickable findings**: Toggle between HTML preview, rendered PPTX PNGs, and **HTML + PPTX side-by-side** comparison; click any quality finding row to jump straight to that slide.
|
|
113
115
|
- **Concurrency & asset safety**: Saving regenerates HTML, PPTX, and JSON atomically. Stale revisions return HTTP 409 so another writer's edits are never overwritten; choose “Load latest, keep my input” to reconcile before saving. Uploaded PNG/JPEG images are capped at 5 MiB each (switching slides or cancelling aborts in-flight reads). The workbench edits this plugin's own JSON projects and does not import arbitrary external PPTX slides for text editing.
|
|
114
116
|
|
|
115
117
|
### Structured slides, media and charts
|
|
116
118
|
|
|
117
|
-
Structured `slides` support all
|
|
119
|
+
Structured `slides` support all **41 canonical layouts (36 core + 5 media) + 53 aliases**:
|
|
118
120
|
|
|
119
|
-
- **
|
|
121
|
+
- **Executive diagrams (`issue-tree | treemap | gauge | pricing | map | isometric | quadrant | radar | dumbbell | heatmap | mockup | code | mermaid | gantt | architecture | tam | org | marimekko | sankey | value-chain | swot`) & structured cards (`kpi | cards | comparison | matrix | process`)**: Supply up to 8 `items` (`{ tag, title, text, value, unit, delta, actual, target, max, before, after, x, y, size, start, span, milestone, role, conversion, icon, status, bullets }`), Gantt `columns: ["Q1","Q2","Q3","Q4"]`, plus optional `chrome`, `reveal: 'step'`, `takeaway`, and `source`.
|
|
120
122
|
- **Harvey-ball matrix & tables** (`harvey | table`): Supports `tableStyle: "consulting" | "booktabs" | "minimal" | "banded" | "harvey"`; `harvey` renders crisp Harvey-ball / check indicators for `●`, `◕`, `◑`, `◔`, `○`, `✓`, `✗`.
|
|
121
123
|
- **Image slides** (`image | image-left | image-right`): Accept `image: { src, alt, fit: "contain" | "cover", caption }` using local PNG/JPEG paths relative to session cwd or matching data URIs. Assets are embedded in all outputs (limits: 5 MiB / 32 megapixels per image, 32 MiB total project assets; remote URLs and SVGs are not fetched or converted).
|
|
122
124
|
- **Native chart slides** (`chart | chart-split`): Accept `chart: { kind, categories, series: [{ name, values }], unit, highlight, caption }` or `rows` with headers across all 13 chart kinds (`column`, `bar`, `stacked-column`, `stacked-bar`, `percent-column`, `percent-bar`, `line`, `area`, `pie`, `doughnut`, `scatter`, `combo`, `waterfall`). Values must be finite with matching lengths; `pie`/`doughnut` require one nonnegative series with a positive sum. HTML renders accessible SVG + screen-reader tables; PPTX embeds native editable charts and workbooks.
|
|
123
125
|
|
|
124
|
-
`brand` supports `name`, `primaryColor`, `backgroundColor`, `textColor`, `fontFamily`, `logo`, `footer`, and `chromeStyle` (`#RRGGBB` colors; choose recipient-safe fonts). `template` supports all
|
|
126
|
+
`brand` supports `name`, `primaryColor`, `backgroundColor`, `textColor`, `fontFamily`, `logo`, `footer`, `watermark`, and `chromeStyle` (`#RRGGBB` colors; choose recipient-safe fonts). `template` supports all 20 industry 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`) without overwriting supplied narratives.
|
|
125
127
|
|
|
126
128
|
Edit & structure examples:
|
|
127
129
|
- Content + theme update: `{ deckPath: "report.json", expectedRevision: 0, theme: "consulting", edits: [{ slide: 3, patch: { layout: "kpi", title: "All core SLA targets exceeded plan", takeaway: "Net retention improved +4.2 pts QoQ" } }] }`
|
|
@@ -143,29 +145,33 @@ The exact optional peer is not a mandatory engine download for ordinary consumer
|
|
|
143
145
|
|
|
144
146
|
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.
|
|
145
147
|
|
|
146
|
-
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.
|
|
148
|
+
CLI supports `--slides @slides.json`, `--brand @brand.json`, `--from-office report.xlsx` (combinable with `--inspect-only`, `--instructions "..."`, `--bind-data`), `--export xlsx,docx,qa-prep,memo,i18n`, `--merge @sources.json`, `--save-to-bank 3`, `--list-bank`, `--translate @en.json --bilingual`, `--motion-profile executive`, `--plan "topic"`, `--evidence @evidence.json --evidence-appendix`, `--import-pptx legacy.pptx`, `--sync-pptx edited.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 --feedback review-feedback.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.
|
|
147
149
|
|
|
148
150
|
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.
|
|
149
151
|
|
|
150
|
-
## Built-in themes (
|
|
152
|
+
## Built-in themes (24 palettes) & 6 Chrome Skeletons
|
|
151
153
|
|
|
152
154
|
### 6 Master Chrome Skeletons (`chromeStyle`)
|
|
153
155
|
|
|
154
156
|
| ID | Name | Structural geometry | Default themes |
|
|
155
157
|
| --- | --- | --- | --- |
|
|
156
|
-
| `consulting-classic` | Consulting Classic | 0px sharp cards, left vertical accent rule, top-right section tracker, 0.75pt header rule | `consulting`, `cobalt-cream`, `financial-ft` |
|
|
157
|
-
| `keynote-spatial` | Keynote Spatial | Divider-free header, airy margins, 16pt borderless surface cards, minimal takeaway caption | `keynote-light`, `bold` |
|
|
158
|
-
| `editorial-folio` | Editorial Folio | Full-width top running folio, page number top-right, 0px borders, display serif numerals | `editorial-forest`, `cartesian`, `velvet`, `luxury-noir` |
|
|
159
|
-
| `saas-bento` | SaaS Bento | 10pt rounded `surface1` cards with hairline stroke, primary accent focus, monospace pills | `linear-dark`, `swiss`, `data`, `soft` |
|
|
158
|
+
| `consulting-classic` | Consulting Classic | 0px sharp cards, left vertical accent rule, top-right section tracker, 0.75pt header rule | `consulting`, `cobalt-cream`, `financial-ft`, `bcg-emerald`, `obsidian-amber` |
|
|
159
|
+
| `keynote-spatial` | Keynote Spatial | Divider-free header, airy margins, 16pt borderless surface cards, minimal takeaway caption | `keynote-light`, `bold`, `venture-daylight`, `aurora-stage` |
|
|
160
|
+
| `editorial-folio` | Editorial Folio | Full-width top running folio, page number top-right, 0px borders, display serif numerals | `editorial-forest`, `cartesian`, `velvet`, `luxury-noir`, `economist-brief` |
|
|
161
|
+
| `saas-bento` | SaaS Bento | 10pt rounded `surface1` cards with hairline stroke, primary accent focus, monospace pills | `linear-dark`, `swiss`, `data`, `soft`, `stripe-craft` |
|
|
160
162
|
| `academic-minimal` | Academic Beamer | Full-width Beamer tinted header band (`13.333"`) + 3-zone academic footer status bar | `academic`, `course-sage`, `medical-clean` |
|
|
161
163
|
| `gov-ceremonial` | Gov Ceremonial | Double-rule header (`1.5pt` + `0.5pt`), bracketed chapter tag, symmetric warm-paper cards | `exec-jilan`, `exec-palace` |
|
|
162
164
|
|
|
163
|
-
### Daylight themes (
|
|
165
|
+
### Daylight themes (16 — recommended for bright rooms, print, consulting, medical, academic & executive reviews)
|
|
164
166
|
|
|
165
167
|
| ID | Name | Mood | Best for |
|
|
166
168
|
| --- | --- | --- | --- |
|
|
167
169
|
| `consulting` | Strategy Navy (`auto` business default) | Authoritative / crisp | Management consulting, strategy reviews, board & operations decks |
|
|
168
170
|
| `cobalt-cream` | Blue Professional | Paper-warm / modern | Product proposals, B2B pitches, research & technical briefs |
|
|
171
|
+
| `bcg-emerald` | Emerald Strategy | Crisp / executive | Strategy consulting, growth reviews, transformation decks |
|
|
172
|
+
| `economist-brief` | Economist Briefing | Sharp / editorial | Macro research, policy briefs, industry analysis |
|
|
173
|
+
| `venture-daylight` | Venture Daylight | Bright / modern VC | Startup fundraising pitches, investment memos, board briefs |
|
|
174
|
+
| `stripe-craft` | Product Indigo | Crafted / modern | SaaS product launches, PRDs, engineering & product reviews |
|
|
169
175
|
| `exec-jilan` | Imperial Slate | Poised / institutional | Enterprise briefings, public-sector reviews, formal alignments |
|
|
170
176
|
| `exec-palace` | Palace Vermilion | Ceremonial / dignified | Institutional summaries, annual reviews, keynote ceremonies |
|
|
171
177
|
| `academic` | ETH & Nature | Clean / scholarly | Thesis defenses, grant proposals, research seminars |
|
|
@@ -173,11 +179,11 @@ For standalone usage copy the entire skill directory and run `npm install --igno
|
|
|
173
179
|
| `cartesian` | Cartesian Stone | Minimal / geometric | Architecture reviews, engineering postmortems, methodology decks |
|
|
174
180
|
| `course-sage` | Workshop Sage | Calm / legible | Workshops, lectures, training handouts |
|
|
175
181
|
| `soft` | Soft Signal | Warm / human | Brand stories, enablement, team talks |
|
|
176
|
-
| `keynote-light` |
|
|
177
|
-
| `financial-ft` | FT Salmon | Editorial / financial | Earnings releases, investor briefings, macro research |
|
|
178
|
-
| `medical-clean` | Clinical Teal | Crisp / clinical | Clinical case reviews, biotech/pharma R&D, healthcare boards |
|
|
182
|
+
| `keynote-light` | Keynote Spatial Light | Pure / airy | Product keynotes, flagship launches, Apple-inspired briefs |
|
|
183
|
+
| `financial-ft` | FT Salmon Financial | Editorial / financial | Earnings releases, investor briefings, macro research |
|
|
184
|
+
| `medical-clean` | Clinical Evidence Teal | Crisp / clinical | Clinical case reviews, biotech/pharma R&D, healthcare boards |
|
|
179
185
|
|
|
180
|
-
### Dark themes (
|
|
186
|
+
### Dark themes (8 — recommended for keynotes, dark venues, luxury curation & technical demos)
|
|
181
187
|
|
|
182
188
|
| ID | Name | Mood | Best for |
|
|
183
189
|
| --- | --- | --- | --- |
|
|
@@ -186,9 +192,11 @@ For standalone usage copy the entire skill directory and run `npm install --igno
|
|
|
186
192
|
| `velvet` | Velvet Standard | Premium / restrained | Investor pitches, luxury brand briefings |
|
|
187
193
|
| `bold` | Maximalist Type | Loud / kinetic | Keynotes, big announcements, event openers |
|
|
188
194
|
| `linear-dark` | Obsidian Keynote | Sharp / modern | Modern software launches, startup pitch decks |
|
|
189
|
-
| `luxury-noir` |
|
|
195
|
+
| `luxury-noir` | Luxury Noir Gold | Opulent / editorial | Creative lookbooks, luxury curation, flagship showcases |
|
|
196
|
+
| `aurora-stage` | Aurora Keynote | Theatrical / stage | Flagship launches, annual conference keynotes |
|
|
197
|
+
| `obsidian-amber` | Terminal Amber | High-contrast / terminal | Quant finance, data engineering, telemetry command decks |
|
|
190
198
|
|
|
191
|
-
Full palettes and typography tokens live in `skills/dsh-ppt/references/themes.md`. Run `ppt_themes { preview: true, outputDir: "dist" }` for
|
|
199
|
+
Full palettes and typography tokens live in `skills/dsh-ppt/references/themes.md`. Run `ppt_themes { preview: true, outputDir: "dist" }` for a 24-theme side-by-side HTML gallery and SVG palette cards.
|
|
192
200
|
|
|
193
201
|
## Markdown input rules
|
|
194
202
|
|
|
@@ -200,7 +208,7 @@ Full palettes and typography tokens live in `skills/dsh-ppt/references/themes.md
|
|
|
200
208
|
- Plain text without headings: the first paragraph is the cover, then every 5 sentences become one slide; a single sentence produces a complete 3-slide structure (cover → statement → closing).
|
|
201
209
|
- Long tables paginate automatically with repeated headers and up to 8 data rows per page (`notes` stay on the first page; `tableStyle` supports `consulting | booktabs | minimal | banded | harvey`). Short rows are padded consistently across all artifacts.
|
|
202
210
|
- `maxSlides` counts pages after expansion. Exceeding it fails before writing files; raise the limit (up to 120) or split the deck. Middle slides are never silently discarded.
|
|
203
|
-
- For exact per-slide control, pass structured `slides` using any of the
|
|
211
|
+
- For exact per-slide control, pass structured `slides` using any of the 41 canonical `layout` values (+ 53 aliases), `chrome`, `reveal`, `columns`, `items`, `rows`, `chart`, `image`, `takeaway`, `source`, and `notes`.
|
|
204
212
|
|
|
205
213
|
## Configuration
|
|
206
214
|
|
|
@@ -211,7 +219,7 @@ No required configuration. Optional:
|
|
|
211
219
|
config:
|
|
212
220
|
outputDir: E:\decks # optional; defaults to the session working directory
|
|
213
221
|
maxSlides: 40 # optional; default 60 (3–120)
|
|
214
|
-
defaultTheme: auto # optional; used when ppt_create has no theme (auto or any of the
|
|
222
|
+
defaultTheme: auto # optional; used when ppt_create has no theme (auto or any of the 24 theme IDs)
|
|
215
223
|
defaultLang: en # optional; used when ppt_create has no lang (zh/en/bilingual)
|
|
216
224
|
```
|
|
217
225
|
|
|
@@ -229,7 +237,7 @@ Relative paths and configured output directories resolve per session cwd without
|
|
|
229
237
|
|
|
230
238
|
- Tools and the skill share an asynchronous generator. The legacy synchronous plain-text API remains available.
|
|
231
239
|
- Images and native charts use MIT-licensed `@office-kit/pptx@0.21.0`; reference `.pptx` absorption uses safe local `fflate` + OOXML parsing with ZIP-bomb and path-traversal guards; optional rendering is loaded on demand.
|
|
232
|
-
- Unit tests cover registration contracts, JSON Schema,
|
|
240
|
+
- Unit tests cover registration contracts (13 tools), JSON Schema, 24 themes, 6 chrome skeletons, 8 taste recipes, 20 Gold Exemplars, 41 canonical layouts + 53 aliases, 20 industry blueprints, 13 chart kinds, 61 vector icons, deep `.pptx` absorption, 8-domain authoritative research & `SLOP-13/14`, Mode C hybrid Office packs, reverse exports / Slide Bank / lossless i18n, artifact generation, PPTX part integrity, workbench security bounds, and the CLI.
|
|
233
241
|
- No `eval` / `child_process` / secrets; artifacts are only written to the user-specified local directory.
|
|
234
242
|
|
|
235
243
|
## Development
|