dsh-ppt 0.34.0 → 0.36.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 +31 -0
- package/README.en.md +14 -17
- package/README.md +14 -17
- package/docs/USAGE.en.md +44 -35
- package/docs/USAGE.md +45 -36
- package/docs/VALIDATION.md +4 -0
- package/docs/assets/intro/screen-en.webp +0 -0
- package/docs/assets/intro/screen-zh.webp +0 -0
- 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 +333 -45
- 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,36 @@
|
|
|
1
1
|
# 更新记录
|
|
2
2
|
|
|
3
|
+
## 0.36.0 (2026-11-22)
|
|
4
|
+
|
|
5
|
+
- **实体胶片灯箱工作台(`灯箱总览` 默认进入 + `单页精修` 一键切换)**:
|
|
6
|
+
- 打开任意演示文稿工程默认进入发光桌面级 **16:9 实体胶片灯箱(`灯箱总览`)**:每页幻灯片以透光 16:9 胶片卡片呈现,带胶片页码印章、版式徽标、质量指示点、拖拽 / `← →` 一键调序、原地复制与 `+16:9` 全部 31 种版式快速加页卡片;点击任意胶片卡片即可平滑跃入 **`单页精修`**(`document.startViewTransition`,完整尊重 `prefers-reduced-motion`)。
|
|
7
|
+
- 完整保留 `0.35.0` 的全部能力(8 大领域权威信源检索、`SLOP-13/14`、三模路由、41 种图谱、逆向 Office 导出、企业金页库、无损翻译、离线 `R` 键审阅及 `@stardustlc/dsh-updates 0.2.10` 更新条)。
|
|
8
|
+
- **交互引导、英文顶栏适配与文档焕新**:同步升级工程库与灯箱/单页双态 4 步「? 引导」聚光灯导览,优化英文工程顶栏标签排布避免截断,并刷新双语 README、使用说明、8 张浅深色流程示意图与最新工作台实景截图。
|
|
9
|
+
- **Physical Slide Lightbox Workbench (`Lightbox` default + 1-click `Slide Studio` toggle)**: opening any deck lands on an illuminated 16:9 drafting-table Lightbox with slide stamps, layout badges, quality dots, drag/`←→` reorder, duplicate, and `+16:9` 31-archetype starter card; clicking any transparency transitions smoothly into `Slide Studio` (with `prefers-reduced-motion` support). Includes updated 4-step `? Tour`, crisp English header layout, and refreshed bilingual docs, workflow SVGs, and screenshots while preserving 100% of `0.35.0` capabilities.
|
|
10
|
+
|
|
11
|
+
## 0.35.0 (2026-11-22)
|
|
12
|
+
|
|
13
|
+
- **8 大领域权威信源检索引擎、代码级信源审计(`SLOP-13` 升级 9 项)与三模路由(`deck-evidence.mjs` + `deck-brand-kit.mjs`)**:
|
|
14
|
+
- 内置 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 轮定向权威检索包;
|
|
15
|
+
- 新增 `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:`);
|
|
16
|
+
- 技能协议升级为 **三模路由(Mode A 有资料直出 / Mode B 零资料 8 域深研 / Mode C 本地混合素材包 × 权威外源对标)**,新增 `skills/dsh-ppt/references/office-pack.md` 并全面刷新 `research-plan.md` 与 `SKILL.md`。
|
|
17
|
+
- **Mode C 本地素材包精炼体检(`inspectOnly`)与需求驱动 Office / 照片智能编排(`deck-office.mjs`)**:
|
|
18
|
+
- `ppt_from_office({ inspectOnly: true })`(CLI `--inspect-only`)以极低 Token 输出 **Material Dossier**(Excel 极值统计与推荐图型、Word/PDF 章节提纲与 `.docx` 内嵌图缓存、照片像素/方向/焦距建议、本地 `[E1..Ek]` 账本)与 **`enrichmentPlan`**(外部权威支柱缺口诊断、顺延编号 `nextEvidenceId` 与精准检索式),配合 `mergeHybridEvidence` 实现本地与外源双轨零冲突溯源;
|
|
19
|
+
- 新增 `instructions` 自然语言编排(页数预算/跳过目录/指定封面或样机图/焦点词加权)、`maxSlides` 权重预算、`includeSheets` 工作表筛选、`photoRoles` 显式照片角色映射,以及 `bindDataModel: true`(CLI `--bind-data`)自动将 Excel 数值表绑定至 `dataModel` `{{metricId}}` 供 `ppt_data` 实时刷新;零依赖 PNG/JPEG/WebP 二进制头解析自动为竖屏/人像/团队照设 `focalPoint: 'top'` 防切头,移动端与浏览器/看板截图自动归位 `mockup[mobile|browser]`。
|
|
20
|
+
- **4 套高管咨询级原生矢量图谱(`deck-charts-exec.mjs` — 41 种标准版式 + 53 别名)与 HTML CSS 按需 Tree-Shaking**:
|
|
21
|
+
- 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 三档商业报价选型矩阵);
|
|
22
|
+
- 新增 `buildLayoutCss` 按文稿实际使用的版式按需裁剪注入 HTML 样式表,保持离线 HTML 精简轻快。
|
|
23
|
+
- **逆向 Office 配套导出、企业金页库拼装、无损双语翻译、分步动画与离线 `R` 键审阅闭环(`deck-export.mjs` / `deck-compose.mjs` / `deck-i18n.mjs` / `deck-delivery.mjs`)**:
|
|
24
|
+
- **逆向配套导出(`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`;
|
|
25
|
+
- **企业金页库与跨工程拼装(`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]` 证据编号无冲突重映射;
|
|
26
|
+
- **100% 版式无损翻译与双语化(`deck-i18n.mjs`)**:`ppt_edit({ translations, bilingualMode, targetLang })`(CLI `--translate` / `--bilingual`)按槽位无损回填译文或中英双语对照,100% 锁死原版式、图表数值、嵌入图片、品牌宪章与 `[E#]` 溯源;
|
|
27
|
+
- **分步点击显现与离线 `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 自动修订闭环。
|
|
28
|
+
- **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)**:
|
|
29
|
+
- **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`).
|
|
30
|
+
- **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).
|
|
31
|
+
- **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.
|
|
32
|
+
- **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.
|
|
33
|
+
|
|
3
34
|
## 0.34.0 (2026-11-21)
|
|
4
35
|
|
|
5
36
|
- **企业级品牌宪章锁(`deck-brand-kit.mjs` + `SLOP-14`)与多源素材包直吞(含纯 Node `.pdf` 解析)**:
|
package/README.en.md
CHANGED
|
@@ -2,30 +2,27 @@
|
|
|
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
|
|
|
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?v=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.
|
|
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.
|
|
15
|
-
<img src="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-light.svg?v=0.
|
|
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.36.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.36.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.36.0">
|
|
15
|
+
<img src="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-en-light.svg?v=0.36.0" alt="Turn docs, spreadsheets, Mermaid diagrams, or legacy decks into deliverables via the Physical Slide Lightbox & Slide Studio. · workflow illustration" width="100%">
|
|
16
16
|
</picture>
|
|
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, Physical Slide Lightbox 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`, 13 styles + 8 font pairings) opens decks directly into an illuminated **16:9 Physical Slide Lightbox** (drag or `←/→` reorder, duplicate, insert starter transparencies) with 1-click entry into **Slide Studio** (double-click inline edits, Evidence Ledger & Revision Diff drawers, 1-click exports for 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
|
|
|
@@ -59,7 +56,7 @@ All previews are LibreOffice-rendered from native OOXML `.pptx` outputs using sa
|
|
|
59
56
|
<details>
|
|
60
57
|
<summary>View the workbench</summary>
|
|
61
58
|
|
|
62
|
-

|
|
63
60
|
|
|
64
61
|
Actual interface with controlled validation data; the PPTX image is a rendered sample when shown.
|
|
65
62
|
|
|
@@ -82,7 +79,7 @@ Four intuitive steps — start either in chat or directly inside the workbench:
|
|
|
82
79
|
1. **Draft in seconds (three ways)**:
|
|
83
80
|
- **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.
|
|
84
81
|
- **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.
|
|
85
|
-
2. **
|
|
82
|
+
2. **Physical Slide Lightbox → Slide Studio**: Opening any deck launches the illuminated 16:9 **Lightbox** overview with slide stamps, layout badges, and quality dots — drag or click `←/→` to reorder, duplicate inline, or insert 31+ starter archetypes from the trailing card; click any transparency (or toggle **Slide Studio**) to edit inline by double-clicking text, switch across **41 layouts (MECE Issue Tree, Treemap, OKR Gauge, Pricing, Mermaid, World/China Maps, 2.5D Isometric & LaTeX formulas)**, monitor **Target Duration (min)**, and press `Ctrl/⌘+S` to sync HTML & PPTX.
|
|
86
83
|
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**.
|
|
87
84
|
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.
|
|
88
85
|
|
|
@@ -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,30 +2,27 @@
|
|
|
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
|
|
|
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?v=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.
|
|
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.
|
|
15
|
-
<img src="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-light.svg?v=0.
|
|
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.36.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.36.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.36.0">
|
|
15
|
+
<img src="https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/docs/assets/intro/workflow-zh-light.svg?v=0.36.0" alt="从文档、表格、流程图或旧 PPTX 出发,经实体胶片灯箱编排与单页精修,一键交付全套产物。 · 流程示意" width="100%">
|
|
16
16
|
</picture>
|
|
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`,内置 13 套视觉风格与 8 套字体)打开工程默认进入 **发光 16:9 实体胶片灯箱(`灯箱总览`)**,支持拖拽/`←→` 调序、1 键复制与新增空白胶片,单击任意胶片跃入 **`单页精修`**(画布双击原地改写、证据账本与修订差异抽屉、一键导出 PPTX / PDF / PNG 图包 / Excel / Word / 质询预案 / 一页纸 / 社媒长图 / 字幕,以及按需开启的 **数字溯源推演、24 页双层 AI 视觉审查与模拟答辩**)。
|
|
29
26
|
|
|
30
27
|
## 风格预览
|
|
31
28
|
|
|
@@ -59,7 +56,7 @@
|
|
|
59
56
|
<details>
|
|
60
57
|
<summary>查看工作台界面</summary>
|
|
61
58
|
|
|
62
|
-

|
|
63
60
|
|
|
64
61
|
图片来自验证环境的真实界面或示例 PPTX 渲染,使用示例数据。
|
|
65
62
|
|
|
@@ -82,7 +79,7 @@ dsh plugin --profile desktop add dsh-ppt
|
|
|
82
79
|
1. **快速起稿(三选一)**:
|
|
83
80
|
- **直接在面板起稿或一键体验**:从左侧栏打开「演示文稿」(可随时点顶部 **`? 引导`** 启动四步导览),点击 **「一键体验旗舰示例」** 零延迟预览旗舰版式,或点击 **「新建演示文稿」** 从 20 套行业蓝图起步,或拖入 **`.xlsx` / `.csv` / `.docx` / `.pptx`** 直接建稿。
|
|
84
81
|
- **在对话中交给助手**:把 Word、Excel/CSV、Markdown(含 ```` ```mermaid ```` 流程图/时序图)或参考 `.pptx` 发给助手,自动导演会按听众匹配明亮投影风与多版式节奏,并可调用 `ppt_cite` 关联 `dsh-cite` 真实文献。
|
|
85
|
-
2.
|
|
82
|
+
2. **实体胶片灯箱总览 → 单页精修**:打开工程默认进入发光 16:9 **「灯箱总览」** 实体胶片桌,俯瞰全稿页序、版式徽章与排版提醒,支持拖拽或 `←/→` 调序、1 键复制与末尾卡片插入 31+ 版式空白胶片;单击任意胶片(或点击切换条 **「单页精修」**)直达三栏精调画布——单击画布文字定位、双击原地改写,切换 **41 种图谱(含 MECE 议题树、Treemap、OKR 子弹仪、三档报价、Mermaid 流程图、点阵地图、2.5D 等轴测与原生公式)** 与演讲时长预算,按 `Ctrl/⌘+S` 同步更新 HTML 与 PPTX。
|
|
86
83
|
3. **导入翻新、Office 导回与品牌沉淀**:支持点击「**导入 PPTX 翻新**」或「**导入 Word/Excel**」直接重塑现有文件,或在 PowerPoint / WPS 微调后通过「**导入 Office 修改稿**」同步回工作台(保留撤销历史);也可在「风格与母版」一键套用 8 套名家范本或收藏公司模板到「我的品牌库」。
|
|
87
84
|
4. **双屏演讲、一页纸与视频分镜交付**:需要精检排版时点「渲染当前 PPTX」开启 **HTML + PPTX 并排对比**(或按需开启 AI 叙事预审、模拟答辩与 24 页视觉看图修复);放映 HTML 时按 `P` 开启双屏提词台、按 `L` 使用虚拟激光笔,并在下载菜单一键导出最新 PPTX、**高管一页纸(`.onepager.html`)**、**Remotion 视频分镜包(`.zip`)**、**演讲讲义(`.md`)** 或分享包 ZIP。
|
|
88
85
|
|
|
@@ -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,8 @@
|
|
|
4
4
|
|
|
5
5
|
## Current improvements
|
|
6
6
|
|
|
7
|
+
- **0.36.0 Physical Slide Lightbox Workbench**: Opening any presentation deck now launches into an illuminated 16:9 **Lightbox** drafting table displaying slide stamps, layout badges, and quality dots, with drag or 1-click `←/→` reordering, inline duplication, and a trailing `+16:9` insert card for 31+ starter archetypes; click any transparency (or toggle **Slide Studio**) to smoothly transition into the 3-pane slide canvas, with refreshed `? Guide` spotlight tour steps and workflow docs while preserving 100% of 0.35.0 features, 13 styles, and 8 fonts.
|
|
8
|
+
- **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
9
|
- **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
10
|
- **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
11
|
- **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 +24,25 @@
|
|
|
22
24
|
|
|
23
25
|
| Capability | Description |
|
|
24
26
|
| --- | --- |
|
|
25
|
-
| `ppt_create` tool | Markdown / structured `slides` → `*.html` + `*.pptx` + `*.json`; defaults to `theme: "auto"` and
|
|
26
|
-
| `ppt_from_office` tool | Zero-new-dep
|
|
27
|
+
| `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` |
|
|
28
|
+
| `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
29
|
| `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
30
|
| `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
|
|
31
|
+
| `ppt_remotion` tool | Export a 30fps `dsh-remotion` animated video storyboard pack (`DeckVideo.tsx`, `slides-data.json`, `captions.srt`/`.vtt`) timed from `computePaceBudget` |
|
|
32
|
+
| `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
33
|
| `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
|
|
34
|
+
| 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`) |
|
|
35
|
+
| 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` |
|
|
36
|
+
| `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`) |
|
|
37
|
+
| `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) |
|
|
38
|
+
| `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
39
|
| `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) |
|
|
40
|
+
| `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) |
|
|
41
|
+
| 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
42
|
| 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
43
|
| 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 |
|
|
44
|
+
| 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'` |
|
|
45
|
+
| `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
46
|
|
|
44
47
|
Example:
|
|
45
48
|
|
|
@@ -53,7 +56,7 @@ Example:
|
|
|
53
56
|
dsh plugin --profile web add dsh-ppt
|
|
54
57
|
```
|
|
55
58
|
|
|
56
|
-
On desktop, install `dsh-ppt` through plugin management. Restart the host after updating to load all
|
|
59
|
+
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
60
|
|
|
58
61
|
## Uninstall
|
|
59
62
|
|
|
@@ -68,7 +71,7 @@ Then restart the web service. To clean up fully, also remove the plugin entry fr
|
|
|
68
71
|
### Inside DSH (recommended)
|
|
69
72
|
|
|
70
73
|
```
|
|
71
|
-
1. ppt_themes { preview: true, outputDir: "dist" } # inspect
|
|
74
|
+
1. ppt_themes { preview: true, outputDir: "dist" } # inspect 24 themes + gallery
|
|
72
75
|
2. ppt_create {
|
|
73
76
|
title: "Q3 Operations Review & Next Steps",
|
|
74
77
|
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 +110,21 @@ Artifacts (existing files are never overwritten by default; colliding sets recei
|
|
|
107
110
|
|
|
108
111
|
Open the native sidebar **Presentations** workbench (or **Settings → Presentations**) and select a project registered by `ppt_create`, `ppt_edit` or `ppt_check`:
|
|
109
112
|
|
|
110
|
-
- **
|
|
111
|
-
- **Style Studio**: Browse Daylight (
|
|
113
|
+
- **Physical Slide Lightbox (default) & Slide Studio**: Opening a deck lands on the illuminated 16:9 **Lightbox** overview with drag or `←/→` reordering, inline duplication, and a trailing `+16:9` card to insert 31+ starter archetypes. Click any transparency (or toggle **Slide Studio**) for the 3-pane editor: slide cards in the left rail show layout badges and quality dots with drag-and-drop reorder, duplicate, delete (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.
|
|
114
|
+
- **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
115
|
- **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
116
|
- **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
117
|
|
|
115
118
|
### Structured slides, media and charts
|
|
116
119
|
|
|
117
|
-
Structured `slides` support all
|
|
120
|
+
Structured `slides` support all **41 canonical layouts (36 core + 5 media) + 53 aliases**:
|
|
118
121
|
|
|
119
|
-
- **
|
|
122
|
+
- **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
123
|
- **Harvey-ball matrix & tables** (`harvey | table`): Supports `tableStyle: "consulting" | "booktabs" | "minimal" | "banded" | "harvey"`; `harvey` renders crisp Harvey-ball / check indicators for `●`, `◕`, `◑`, `◔`, `○`, `✓`, `✗`.
|
|
121
124
|
- **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
125
|
- **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
126
|
|
|
124
|
-
`brand` supports `name`, `primaryColor`, `backgroundColor`, `textColor`, `fontFamily`, `logo`, `footer`, and `chromeStyle` (`#RRGGBB` colors; choose recipient-safe fonts). `template` supports all
|
|
127
|
+
`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
128
|
|
|
126
129
|
Edit & structure examples:
|
|
127
130
|
- 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 +146,33 @@ The exact optional peer is not a mandatory engine download for ordinary consumer
|
|
|
143
146
|
|
|
144
147
|
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
148
|
|
|
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.
|
|
149
|
+
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
150
|
|
|
148
151
|
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
152
|
|
|
150
|
-
## Built-in themes (
|
|
153
|
+
## Built-in themes (24 palettes) & 6 Chrome Skeletons
|
|
151
154
|
|
|
152
155
|
### 6 Master Chrome Skeletons (`chromeStyle`)
|
|
153
156
|
|
|
154
157
|
| ID | Name | Structural geometry | Default themes |
|
|
155
158
|
| --- | --- | --- | --- |
|
|
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` |
|
|
159
|
+
| `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` |
|
|
160
|
+
| `keynote-spatial` | Keynote Spatial | Divider-free header, airy margins, 16pt borderless surface cards, minimal takeaway caption | `keynote-light`, `bold`, `venture-daylight`, `aurora-stage` |
|
|
161
|
+
| `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` |
|
|
162
|
+
| `saas-bento` | SaaS Bento | 10pt rounded `surface1` cards with hairline stroke, primary accent focus, monospace pills | `linear-dark`, `swiss`, `data`, `soft`, `stripe-craft` |
|
|
160
163
|
| `academic-minimal` | Academic Beamer | Full-width Beamer tinted header band (`13.333"`) + 3-zone academic footer status bar | `academic`, `course-sage`, `medical-clean` |
|
|
161
164
|
| `gov-ceremonial` | Gov Ceremonial | Double-rule header (`1.5pt` + `0.5pt`), bracketed chapter tag, symmetric warm-paper cards | `exec-jilan`, `exec-palace` |
|
|
162
165
|
|
|
163
|
-
### Daylight themes (
|
|
166
|
+
### Daylight themes (16 — recommended for bright rooms, print, consulting, medical, academic & executive reviews)
|
|
164
167
|
|
|
165
168
|
| ID | Name | Mood | Best for |
|
|
166
169
|
| --- | --- | --- | --- |
|
|
167
170
|
| `consulting` | Strategy Navy (`auto` business default) | Authoritative / crisp | Management consulting, strategy reviews, board & operations decks |
|
|
168
171
|
| `cobalt-cream` | Blue Professional | Paper-warm / modern | Product proposals, B2B pitches, research & technical briefs |
|
|
172
|
+
| `bcg-emerald` | Emerald Strategy | Crisp / executive | Strategy consulting, growth reviews, transformation decks |
|
|
173
|
+
| `economist-brief` | Economist Briefing | Sharp / editorial | Macro research, policy briefs, industry analysis |
|
|
174
|
+
| `venture-daylight` | Venture Daylight | Bright / modern VC | Startup fundraising pitches, investment memos, board briefs |
|
|
175
|
+
| `stripe-craft` | Product Indigo | Crafted / modern | SaaS product launches, PRDs, engineering & product reviews |
|
|
169
176
|
| `exec-jilan` | Imperial Slate | Poised / institutional | Enterprise briefings, public-sector reviews, formal alignments |
|
|
170
177
|
| `exec-palace` | Palace Vermilion | Ceremonial / dignified | Institutional summaries, annual reviews, keynote ceremonies |
|
|
171
178
|
| `academic` | ETH & Nature | Clean / scholarly | Thesis defenses, grant proposals, research seminars |
|
|
@@ -173,11 +180,11 @@ For standalone usage copy the entire skill directory and run `npm install --igno
|
|
|
173
180
|
| `cartesian` | Cartesian Stone | Minimal / geometric | Architecture reviews, engineering postmortems, methodology decks |
|
|
174
181
|
| `course-sage` | Workshop Sage | Calm / legible | Workshops, lectures, training handouts |
|
|
175
182
|
| `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 |
|
|
183
|
+
| `keynote-light` | Keynote Spatial Light | Pure / airy | Product keynotes, flagship launches, Apple-inspired briefs |
|
|
184
|
+
| `financial-ft` | FT Salmon Financial | Editorial / financial | Earnings releases, investor briefings, macro research |
|
|
185
|
+
| `medical-clean` | Clinical Evidence Teal | Crisp / clinical | Clinical case reviews, biotech/pharma R&D, healthcare boards |
|
|
179
186
|
|
|
180
|
-
### Dark themes (
|
|
187
|
+
### Dark themes (8 — recommended for keynotes, dark venues, luxury curation & technical demos)
|
|
181
188
|
|
|
182
189
|
| ID | Name | Mood | Best for |
|
|
183
190
|
| --- | --- | --- | --- |
|
|
@@ -186,9 +193,11 @@ For standalone usage copy the entire skill directory and run `npm install --igno
|
|
|
186
193
|
| `velvet` | Velvet Standard | Premium / restrained | Investor pitches, luxury brand briefings |
|
|
187
194
|
| `bold` | Maximalist Type | Loud / kinetic | Keynotes, big announcements, event openers |
|
|
188
195
|
| `linear-dark` | Obsidian Keynote | Sharp / modern | Modern software launches, startup pitch decks |
|
|
189
|
-
| `luxury-noir` |
|
|
196
|
+
| `luxury-noir` | Luxury Noir Gold | Opulent / editorial | Creative lookbooks, luxury curation, flagship showcases |
|
|
197
|
+
| `aurora-stage` | Aurora Keynote | Theatrical / stage | Flagship launches, annual conference keynotes |
|
|
198
|
+
| `obsidian-amber` | Terminal Amber | High-contrast / terminal | Quant finance, data engineering, telemetry command decks |
|
|
190
199
|
|
|
191
|
-
Full palettes and typography tokens live in `skills/dsh-ppt/references/themes.md`. Run `ppt_themes { preview: true, outputDir: "dist" }` for
|
|
200
|
+
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
201
|
|
|
193
202
|
## Markdown input rules
|
|
194
203
|
|
|
@@ -200,7 +209,7 @@ Full palettes and typography tokens live in `skills/dsh-ppt/references/themes.md
|
|
|
200
209
|
- 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
210
|
- 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
211
|
- `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
|
|
212
|
+
- 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
213
|
|
|
205
214
|
## Configuration
|
|
206
215
|
|
|
@@ -211,7 +220,7 @@ No required configuration. Optional:
|
|
|
211
220
|
config:
|
|
212
221
|
outputDir: E:\decks # optional; defaults to the session working directory
|
|
213
222
|
maxSlides: 40 # optional; default 60 (3–120)
|
|
214
|
-
defaultTheme: auto # optional; used when ppt_create has no theme (auto or any of the
|
|
223
|
+
defaultTheme: auto # optional; used when ppt_create has no theme (auto or any of the 24 theme IDs)
|
|
215
224
|
defaultLang: en # optional; used when ppt_create has no lang (zh/en/bilingual)
|
|
216
225
|
```
|
|
217
226
|
|
|
@@ -229,7 +238,7 @@ Relative paths and configured output directories resolve per session cwd without
|
|
|
229
238
|
|
|
230
239
|
- Tools and the skill share an asynchronous generator. The legacy synchronous plain-text API remains available.
|
|
231
240
|
- 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,
|
|
241
|
+
- 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
242
|
- No `eval` / `child_process` / secrets; artifacts are only written to the user-specified local directory.
|
|
234
243
|
|
|
235
244
|
## Development
|