dsh-ppt 0.21.1 → 0.23.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 +25 -0
- package/README.en.md +37 -23
- package/README.md +37 -22
- package/docs/COACHING.md +14 -13
- package/docs/DATA.md +8 -8
- package/docs/REFERENCE.en.md +17 -19
- package/docs/REFERENCE.zh.md +16 -18
- package/docs/USAGE.en.md +107 -60
- package/docs/USAGE.md +115 -84
- package/docs/VALIDATION.md +2 -0
- package/docs/VISUAL.md +27 -20
- package/docs/WORKBENCH.md +17 -6
- package/docs/assets/intro/screen-en.webp +0 -0
- package/docs/assets/intro/screen-zh.webp +0 -0
- package/lib/client.js +1286 -52
- package/lib/coaching.d.ts +1 -1
- package/lib/coaching.js +25 -12
- package/lib/config.d.ts +2 -0
- package/lib/config.js +36 -2
- package/lib/execution.d.ts +2 -1
- package/lib/execution.js +21 -1
- package/lib/tools.d.ts +1 -1
- package/lib/tools.js +160 -25
- package/lib/types.d.ts +115 -8
- package/lib/visual.d.ts +3 -1
- package/lib/visual.js +40 -13
- package/lib/workbench-language.js +49 -9
- package/lib/workbench.d.ts +5 -0
- package/lib/workbench.js +603 -12
- package/package.json +8 -3
- package/skills/dsh-ppt/SKILL.md +56 -54
- package/skills/dsh-ppt/package.json +17 -5
- package/skills/dsh-ppt/references/advanced.md +123 -41
- package/skills/dsh-ppt/references/copywriting.md +63 -41
- package/skills/dsh-ppt/references/data.md +83 -36
- package/skills/dsh-ppt/references/syntax.md +157 -28
- package/skills/dsh-ppt/references/themes.md +113 -58
- package/skills/dsh-ppt/references/troubleshooting.md +21 -16
- package/skills/dsh-ppt/scripts/build-deck.mjs +67 -28
- package/skills/dsh-ppt/scripts/deck-absorb.mjs +1338 -0
- package/skills/dsh-ppt/scripts/deck-advanced.mjs +422 -105
- package/skills/dsh-ppt/scripts/deck-core.mjs +572 -717
- package/skills/dsh-ppt/scripts/deck-data-view.mjs +30 -11
- package/skills/dsh-ppt/scripts/deck-data.mjs +35 -5
- package/skills/dsh-ppt/scripts/deck-director.mjs +2057 -0
- package/skills/dsh-ppt/scripts/deck-layouts.mjs +4673 -0
- package/skills/dsh-ppt/scripts/deck-media.mjs +1408 -86
- package/skills/dsh-ppt/scripts/deck-themes.mjs +1854 -0
- package/skills/dsh-ppt/scripts/deck-visual.mjs +133 -31
package/docs/USAGE.en.md
CHANGED
|
@@ -4,27 +4,35 @@
|
|
|
4
4
|
|
|
5
5
|
## Current improvements
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
- **Zero-taste-burden Auto-Director, 6 Chrome Skeletons & Deep `.pptx` Absorption**: `ppt_create` defaults to `theme: "auto"` to match topic, audience, and master chrome skeleton automatically (standalone CLI keeps `data` by default for backward compatibility unless `--theme auto` is passed). `ppt_absorb` and `referencePptx` (with `cloneStructure: true` / `--clone-structure`) resolve OOXML `lumMod`/`tint`/`shade` color modifiers, CJK/Latin fonts, master logos, skeleton geometry (`extractedSkeleton`, `recommendedChrome`), and slide-by-slide layout sequences (`slideSkeleton[]`) locally with WCAG ≥4.5:1 contrast sanitization.
|
|
8
|
+
- **18 built-in themes, 6 Master Chrome Skeletons, 24 canonical layouts & 16 industry blueprints**: 12 daylight-first themes for bright rooms/print and 6 dark themes for keynotes/screens, mapped to 6 structurally distinct chrome skeletons (`consulting-classic`, `keynote-spatial`, `editorial-folio`, `saas-bento`, `academic-minimal`, `gov-ceremonial`); adds 5 native editable pro diagrams (`gantt`, `architecture`, `harvey`, `tam`, `org`) plus `flywheel` process variant, `tableStyle` (`consulting | booktabs | minimal | banded | harvey`), per-slide `chrome`, `columns`, `takeaway` bars, and `source` footnotes; native editable OOXML charts span 13 publication-grade kinds including vector `waterfall` bridges.
|
|
9
|
+
- **Style Studio & visual workbench**: Switch across 18 themes and **6 Master Chrome Skeletons (`brand.chromeStyle`)**, drag-and-drop a `.pptx` (`≤10 MiB`, parsed in memory with zero host path reads) to inspect `recommendedChrome`, `extractedSkeleton`, and `slideSkeleton`, switch across all 24 slide archetypes & per-slide `chrome`, edit Gantt timelines & Harvey matrices, append starter slides (`+ New slide`), compare HTML ↔ PPTX side-by-side, inspect full-width Vision QA before/after diffs (up to 24 slides, 12 lossless actions), and run storyline/action-title coaching (up to 8 findings across 7 audience personas).
|
|
10
|
+
- **Artifact integrity & safe delivery bundles**: Every build records HTML/PPTX digests so external Office edits are never silently overwritten; save a copy (`saveAs: true`) when needed. Save workbench edits, then download either the **Share bundle ZIP** or **Project bundle ZIP** (each file ≤64 MiB, total ≤128 MiB; excludes config, secrets, and unrelated workspace files).
|
|
8
11
|
|
|
9
12
|
## Capabilities
|
|
10
13
|
|
|
11
14
|
| Capability | Description |
|
|
12
15
|
| --- | --- |
|
|
13
|
-
| `ppt_create` tool | Markdown / structured slides → `*.html` + `*.pptx` + `*.json` |
|
|
14
|
-
| `
|
|
15
|
-
|
|
|
16
|
-
|
|
|
17
|
-
|
|
|
18
|
-
|
|
|
19
|
-
| `
|
|
20
|
-
|
|
|
21
|
-
|
|
|
16
|
+
| `ppt_create` tool | Markdown / structured `slides` → `*.html` + `*.pptx` + `*.json`; defaults to `theme: "auto"` and accepts `referencePptx` + `cloneStructure: true` for deep palette, chrome & skeleton cloning |
|
|
17
|
+
| `ppt_absorb` tool | Read-only local extraction of OOXML modified palette colors, fonts, aspect ratio, chrome geometry (`extractedSkeleton`, `recommendedChrome`), slide sequence (`slideSkeleton[]`), and optional logo from a reference `.pptx` |
|
|
18
|
+
| `ppt_themes` tool | Lists all 24 built-in themes (16 daylight + 8 dark) paired with 6 chrome skeletons; pass `preview: true` with `outputDir` to generate a side-by-side HTML gallery and SVG palette cards |
|
|
19
|
+
| 24+ layouts & diagrams | `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `process` / `callout` / `gantt` / `architecture` / `harvey` / `tam` / `org` / `table` / `closing` / `image` / `image-left` / `image-right` / `chart` / `chart-split` (plus `chevron`, `value-chain`, `waterfall`, `gallery`, and `flywheel` aliases) |
|
|
20
|
+
| 13 chart kinds | `column` / `bar` / `stacked-column` / `stacked-bar` / `percent-column` / `percent-bar` / `line` / `area` / `pie` / `doughnut` / `scatter` / `combo` / `waterfall` with `highlight` focal emphasis |
|
|
21
|
+
| `ppt_templates` | 20 scenario blueprints: `weekly`, `defense`, `project`, `pitch`, `consulting`, `keynote`, `gov-report`, `workshop`, `architecture-review`, `financial-earnings`, `medical-case`, `postmortem`, `marketing-campaign`, `promotion-review`, `legal-compliance`, `creative-lookbook`, `quarterly-okr`, `product-prd`, `vc-daylight`, `industry-research` |
|
|
22
|
+
| `ppt_edit` / `ppt_undo` | Edit selected slides, switch deck `theme` / `brand` / `referencePptx`, append/duplicate/remove/reorder slides with 20-step undo and revision guards |
|
|
23
|
+
| `ppt_check` | Read-only layout & aesthetic density check (including action-title, bullet overload, and monotony hints) plus optional render-receipt verification |
|
|
24
|
+
| `ppt_render` | Optional official LibreOffice Kit PNG / PDF page rendering with missing-font diagnostics |
|
|
25
|
+
| `ppt_data` | Optional source lineage updates and what-if simulation with diff preview before saving; see [data guide](DATA.md#english) |
|
|
26
|
+
| Visual review & repair | Optional rendered-PPTX inspection (up to 24 original slides) with 12 lossless repair actions and re-render verification; see [visual guide](VISUAL.md#english) |
|
|
27
|
+
| Coaching & rehearsal | Optional storyline (SCQA / Pyramid / Action Titles), expression, logic & evidence pre-review (up to 8 findings) and 7-persona Q&A rehearsal; see [coaching guide](COACHING.md#english) |
|
|
28
|
+
| Speaker notes & motion | `<!-- note: ... -->` or `notes` field synced to HTML presenter view (`V`/`S`) and native PPTX notes; motion on by default (`motion: 'off'` / `--motion off` for static) |
|
|
29
|
+
| `dsh-ppt` skill & CLI | Full Auto-Director SOP registered in DSH, or copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for standalone cross-harness builds |
|
|
22
30
|
|
|
23
31
|
Example:
|
|
24
32
|
|
|
25
|
-
> Turn this sentence into a deck: "AI support cuts first response time to 8 seconds",
|
|
33
|
+
> Turn this sentence into a deck: "AI support cuts first response time to 8 seconds", and automatically pick an executive-ready daylight theme.
|
|
26
34
|
>
|
|
27
|
-
>
|
|
35
|
+
> Match the palette and fonts of `assets/company-template.pptx`, and turn `docs/quarterly-review.md` into an editable PPTX with KPI cards, a waterfall chart, and booktabs tables.
|
|
28
36
|
|
|
29
37
|
## Installation
|
|
30
38
|
|
|
@@ -32,7 +40,7 @@ Example:
|
|
|
32
40
|
dsh plugin --profile web add dsh-ppt
|
|
33
41
|
```
|
|
34
42
|
|
|
35
|
-
On desktop, install `dsh-ppt` through plugin management. Restart the host after updating to load
|
|
43
|
+
On desktop, install `dsh-ppt` through plugin management. Restart the host after updating to load all nine 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.
|
|
36
44
|
|
|
37
45
|
## Uninstall
|
|
38
46
|
|
|
@@ -47,60 +55,66 @@ Then restart the web service. To clean up fully, also remove the plugin entry fr
|
|
|
47
55
|
### Inside DSH (recommended)
|
|
48
56
|
|
|
49
57
|
```
|
|
50
|
-
1. ppt_themes { preview: true, outputDir: "dist" } # themes + gallery
|
|
58
|
+
1. ppt_themes { preview: true, outputDir: "dist" } # inspect 18 themes + gallery
|
|
51
59
|
2. ppt_create {
|
|
52
|
-
title: "
|
|
53
|
-
content: "#
|
|
54
|
-
theme: "
|
|
60
|
+
title: "Q3 Operations Review & Next Steps",
|
|
61
|
+
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:::",
|
|
62
|
+
theme: "auto",
|
|
55
63
|
lang: "en"
|
|
56
64
|
}
|
|
57
|
-
3. Open the returned HTML path in a browser
|
|
65
|
+
3. Open the returned HTML path in a browser, edit the PPTX in PowerPoint / WPS / Keynote, or refine in the Presentations workbench
|
|
58
66
|
```
|
|
59
67
|
|
|
60
68
|
### Any harness (standalone SKILL.md)
|
|
61
69
|
|
|
62
|
-
Copy `skills/dsh-ppt/` to any Agent Skills directory, then:
|
|
70
|
+
Copy `skills/dsh-ppt/` to any Agent Skills directory, run `npm install --ignore-scripts` inside it, then:
|
|
63
71
|
|
|
64
72
|
```bash
|
|
65
73
|
node <skill-dir>/scripts/build-deck.mjs \
|
|
66
74
|
--title "Product Launch" \
|
|
67
75
|
--content deck.md \
|
|
68
|
-
--theme
|
|
76
|
+
--theme auto \
|
|
69
77
|
--lang en \
|
|
70
78
|
--out dist/deck
|
|
71
79
|
```
|
|
72
80
|
|
|
73
|
-
|
|
81
|
+
The standalone CLI also supports `--absorb ref.pptx`, `--reference-pptx ref.pptx`, `--clone-structure`, and `--chrome consulting-classic` (when `--theme` is omitted on the bare CLI, `data` remains the backward-compatible default).
|
|
74
82
|
|
|
75
|
-
|
|
83
|
+
Artifacts (existing files are never overwritten by default; colliding sets receive `-1`, `-2`, ... suffixes unless `overwrite: true` or `--overwrite` is passed):
|
|
76
84
|
|
|
77
85
|
| File | Purpose |
|
|
78
86
|
| --- | --- |
|
|
79
|
-
| `*.html` | Standalone slideshow: arrow keys, V presenter view (separate window with
|
|
80
|
-
| `*.pptx` | Editable 16:9 presentation
|
|
81
|
-
| `*.json` | Structured manifest (
|
|
87
|
+
| `*.html` | Standalone slideshow: arrow keys, V presenter view (separate window with current/next previews, thumbnail strip, notes, timer, progress, pause, font size, blank screen), S notes, G thumbnail overview, D what-if data panel, F fullscreen, P print, ? shortcuts, Esc close |
|
|
88
|
+
| `*.pptx` | Editable 16:9 presentation with native shapes, structured cards, tables, embedded images, and native editable OOXML charts + workbooks |
|
|
89
|
+
| `*.json` | Structured project manifest (schemaVersion, theme, brand, assets, stable slide IDs, up to 20 undo steps, quality report) |
|
|
82
90
|
|
|
83
|
-
##
|
|
91
|
+
## Workbench, structured layouts, charts and review
|
|
84
92
|
|
|
85
|
-
###
|
|
93
|
+
### Presentations Workbench & Style Studio
|
|
86
94
|
|
|
87
|
-
Open Settings → Presentations and
|
|
95
|
+
Open the native sidebar **Presentations** workbench (or **Settings → Presentations**) and select a project registered by `ppt_create`, `ppt_edit` or `ppt_check`:
|
|
88
96
|
|
|
89
|
-
|
|
97
|
+
- **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 24 archetypes, variants, per-slide `chrome` skeletons, and density modes (`compact | balanced | airy`) with lossless draft projection across bullets, structured `items` (including 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.
|
|
98
|
+
- **Style Studio**: Browse Daylight (12) vs Dark (6) themes with live palette swatches and scenario tags, switch across **6 Master Chrome Skeletons** (`brand.chromeStyle`), apply a new deck theme in 1 click, customize brand colors/fonts/footer/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.
|
|
99
|
+
- **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.
|
|
100
|
+
- **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.
|
|
90
101
|
|
|
91
|
-
|
|
102
|
+
### Structured slides, media and charts
|
|
92
103
|
|
|
93
|
-
|
|
104
|
+
Structured `slides` support all 24 canonical layouts & pro diagrams:
|
|
94
105
|
|
|
95
|
-
|
|
106
|
+
- **Structured cards / KPI / comparison / matrix / process / Gantt / architecture / TAM / org**: Supply up to 8 `items` (`{ tag, title, text, value, unit, delta, start, span, milestone, role, conversion, status, bullets }`), Gantt `columns: ["Q1","Q2","Q3","Q4"]`, plus optional `chrome`, `takeaway`, and `source`.
|
|
107
|
+
- **Harvey-ball matrix & tables** (`harvey | table`): Supports `tableStyle: "consulting" | "booktabs" | "minimal" | "banded" | "harvey"`; `harvey` renders crisp Harvey-ball / check indicators for `●`, `◕`, `◑`, `◔`, `○`, `✓`, `✗`.
|
|
108
|
+
- **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).
|
|
109
|
+
- **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.
|
|
96
110
|
|
|
97
|
-
`brand` supports `name`, `primaryColor`, `backgroundColor`, `textColor`, `fontFamily`, `logo` and `
|
|
111
|
+
`brand` supports `name`, `primaryColor`, `backgroundColor`, `textColor`, `fontFamily`, `logo`, `footer`, and `chromeStyle` (`#RRGGBB` colors; choose recipient-safe fonts). `template` supports all 16 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`) without overwriting supplied narratives.
|
|
98
112
|
|
|
99
|
-
Edit
|
|
113
|
+
Edit & structure examples:
|
|
114
|
+
- 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" } }] }`
|
|
115
|
+
- Structural edit: `{ deckPath: "report.json", expectedRevision: 0, duplicate: [2], remove: [4], append: [{ layout: "callout", title: "Immediate next actions" }] }` (keeps 1–120 slides, up to 20 undo steps, atomic trio commit with rollback on failure).
|
|
100
116
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
`deliveryStatus: draft` means unfilled slots; `ready-for-review` means review can start. Static estimates, rendering and visual inspection are recorded separately. Generation/rendering never automatically certifies visual quality. Inspect HTML and every page image before delivery.
|
|
117
|
+
`deliveryStatus: draft` indicates unfilled template slots; `ready-for-review` means review can start. Static estimates, rendering, and visual inspection are recorded separately—always inspect HTML and rendered page images before final delivery.
|
|
104
118
|
|
|
105
119
|
## Optional PNG/PDF renderer
|
|
106
120
|
|
|
@@ -116,31 +130,64 @@ The exact optional peer is not a mandatory engine download for ordinary consumer
|
|
|
116
130
|
|
|
117
131
|
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.
|
|
118
132
|
|
|
119
|
-
CLI supports `--slides @slides.json`, `--brand @brand.json`, `--template
|
|
133
|
+
CLI supports `--slides @slides.json`, `--brand @brand.json`, `--reference-pptx ref.pptx`, `--absorb ref.pptx`, `--template consulting`, `--edit report.json --edits @edits.json --revision 0`, `--undo report.json --revision 1`, `--check report.json`, and `--render report.pptx --format both`. Explicit receipt validation uses `--check report.json --render-receipt path/to/render-receipt.json`; failure returns a nonzero exit code.
|
|
134
|
+
|
|
135
|
+
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.
|
|
136
|
+
|
|
137
|
+
## Built-in themes (18 palettes) & 6 Chrome Skeletons
|
|
138
|
+
|
|
139
|
+
### 6 Master Chrome Skeletons (`chromeStyle`)
|
|
120
140
|
|
|
121
|
-
|
|
141
|
+
| ID | Name | Structural geometry | Default themes |
|
|
142
|
+
| --- | --- | --- | --- |
|
|
143
|
+
| `consulting-classic` | Consulting Classic | 0px sharp cards, left vertical accent rule, top-right section tracker, 0.75pt header rule | `consulting`, `cobalt-cream`, `financial-ft` |
|
|
144
|
+
| `keynote-spatial` | Keynote Spatial | Divider-free header, airy margins, 16pt borderless surface cards, minimal takeaway caption | `keynote-light`, `bold` |
|
|
145
|
+
| `editorial-folio` | Editorial Folio | Full-width top running folio, page number top-right, 0px borders, display serif numerals | `editorial-forest`, `cartesian`, `velvet`, `luxury-noir` |
|
|
146
|
+
| `saas-bento` | SaaS Bento | 10pt rounded `surface1` cards with hairline stroke, primary accent focus, monospace pills | `linear-dark`, `swiss`, `data`, `soft` |
|
|
147
|
+
| `academic-minimal` | Academic Beamer | Full-width Beamer tinted header band (`13.333"`) + 3-zone academic footer status bar | `academic`, `course-sage`, `medical-clean` |
|
|
148
|
+
| `gov-ceremonial` | Gov Ceremonial | Double-rule header (`1.5pt` + `0.5pt`), bracketed chapter tag, symmetric warm-paper cards | `exec-jilan`, `exec-palace` |
|
|
149
|
+
|
|
150
|
+
### Daylight themes (12 — recommended for bright rooms, print, consulting, medical, academic & executive reviews)
|
|
122
151
|
|
|
123
|
-
|
|
152
|
+
| ID | Name | Mood | Best for |
|
|
153
|
+
| --- | --- | --- | --- |
|
|
154
|
+
| `consulting` | Strategy Navy (`auto` business default) | Authoritative / crisp | Management consulting, strategy reviews, board & operations decks |
|
|
155
|
+
| `cobalt-cream` | Blue Professional | Paper-warm / modern | Product proposals, B2B pitches, research & technical briefs |
|
|
156
|
+
| `exec-jilan` | Imperial Slate | Poised / institutional | Enterprise briefings, public-sector reviews, formal alignments |
|
|
157
|
+
| `exec-palace` | Palace Vermilion | Ceremonial / dignified | Institutional summaries, annual reviews, keynote ceremonies |
|
|
158
|
+
| `academic` | ETH & Nature | Clean / scholarly | Thesis defenses, grant proposals, research seminars |
|
|
159
|
+
| `editorial-forest` | Editorial Forest | Thoughtful / narrative | Industry whitepapers, ESG reports, research essays |
|
|
160
|
+
| `cartesian` | Cartesian Stone | Minimal / geometric | Architecture reviews, engineering postmortems, methodology decks |
|
|
161
|
+
| `course-sage` | Workshop Sage | Calm / legible | Workshops, lectures, training handouts |
|
|
162
|
+
| `soft` | Soft Signal | Warm / human | Brand stories, enablement, team talks |
|
|
163
|
+
| `keynote-light` | Cupertino Spatial | Pure / airy | Product keynotes, flagship launches, Apple-inspired briefs |
|
|
164
|
+
| `financial-ft` | FT Salmon | Editorial / financial | Earnings releases, investor briefings, macro research |
|
|
165
|
+
| `medical-clean` | Clinical Teal | Crisp / clinical | Clinical case reviews, biotech/pharma R&D, healthcare boards |
|
|
166
|
+
|
|
167
|
+
### Dark themes (6 — recommended for keynotes, dark venues, luxury curation & technical demos)
|
|
124
168
|
|
|
125
169
|
| ID | Name | Mood | Best for |
|
|
126
170
|
| --- | --- | --- | --- |
|
|
127
|
-
| `data` | Data Drift (default) | Futuristic / immersive | AI,
|
|
128
|
-
| `swiss` | Swiss Pulse | Precise / rational | Data, SaaS, developer tools |
|
|
129
|
-
| `velvet` | Velvet Standard | Premium / restrained |
|
|
130
|
-
| `
|
|
131
|
-
| `
|
|
171
|
+
| `data` | Data Drift (CLI fallback default) | Futuristic / immersive | AI launches, live telemetry, technical showcases |
|
|
172
|
+
| `swiss` | Swiss Pulse | Precise / rational | Data reports, SaaS products, developer tools |
|
|
173
|
+
| `velvet` | Velvet Standard | Premium / restrained | Investor pitches, luxury brand briefings |
|
|
174
|
+
| `bold` | Maximalist Type | Loud / kinetic | Keynotes, big announcements, event openers |
|
|
175
|
+
| `linear-dark` | Obsidian Keynote | Sharp / modern | Modern software launches, startup pitch decks |
|
|
176
|
+
| `luxury-noir` | Atelier Noir | Opulent / editorial | Creative lookbooks, luxury curation, flagship showcases |
|
|
132
177
|
|
|
133
|
-
|
|
178
|
+
Full palettes and typography tokens live in `skills/dsh-ppt/references/themes.md`. Run `ppt_themes { preview: true, outputDir: "dist" }` for an 18-theme side-by-side HTML gallery and SVG palette cards.
|
|
134
179
|
|
|
135
180
|
## Markdown input rules
|
|
136
181
|
|
|
137
182
|
- The first `# heading` becomes the cover title; its first paragraph becomes the cover subtitle.
|
|
138
|
-
- Each `## section` becomes
|
|
139
|
-
-
|
|
140
|
-
-
|
|
141
|
-
-
|
|
183
|
+
- Each `## section` becomes a slide: standard lists, quotes, and tables are recognized automatically, alongside fenced semantic directives:
|
|
184
|
+
- `::: kpi`, `::: cards`, `::: comparison`, `::: matrix`, `::: process`, `::: callout`, `::: agenda`, `::: gantt`, `::: architecture`, `::: harvey`, `::: tam`, `::: org` → parsed directly into structured cards, pro diagrams, or Harvey-ball matrices.
|
|
185
|
+
- `> [!TAKEAWAY] Single-sentence conclusion` → extracted into the slide's bottom `takeaway` callout bar.
|
|
186
|
+
- `<!-- source: ... -->` / `<!-- 来源: ... -->` → extracted as `source` footnote; `<!-- note: ... -->` → extracted as speaker `notes`.
|
|
187
|
+
- 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).
|
|
188
|
+
- 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.
|
|
142
189
|
- `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.
|
|
143
|
-
- For
|
|
190
|
+
- For exact per-slide control, pass structured `slides` using any of the 24 `layout` values, `chrome`, `columns`, `items`, `rows`, `chart`, `image`, `takeaway`, `source`, and `notes`.
|
|
144
191
|
|
|
145
192
|
## Configuration
|
|
146
193
|
|
|
@@ -151,7 +198,7 @@ No required configuration. Optional:
|
|
|
151
198
|
config:
|
|
152
199
|
outputDir: E:\decks # optional; defaults to the session working directory
|
|
153
200
|
maxSlides: 40 # optional; default 60 (3–120)
|
|
154
|
-
defaultTheme:
|
|
201
|
+
defaultTheme: auto # optional; used when ppt_create has no theme (auto or any of the 18 theme IDs)
|
|
155
202
|
defaultLang: en # optional; used when ppt_create has no lang (zh/en/bilingual)
|
|
156
203
|
```
|
|
157
204
|
|
|
@@ -168,26 +215,26 @@ Relative paths and configured output directories resolve per session cwd without
|
|
|
168
215
|
## Engineering quality
|
|
169
216
|
|
|
170
217
|
- Tools and the skill share an asynchronous generator. The legacy synchronous plain-text API remains available.
|
|
171
|
-
- Images and native charts use MIT-licensed `@office-kit/pptx@0.21.0`; optional rendering is loaded on demand.
|
|
172
|
-
- Unit tests cover registration contracts, JSON Schema,
|
|
218
|
+
- 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.
|
|
219
|
+
- Unit tests cover registration contracts, JSON Schema, 18 themes, 6 chrome skeletons & auto-direction, 24 layouts & pro diagrams, 16 industry blueprints, 13 chart kinds, deep `.pptx` absorption (`cloneStructure`), artifact generation, PPTX part integrity, workbench security bounds, and the CLI.
|
|
173
220
|
- No `eval` / `child_process` / secrets; artifacts are only written to the user-specified local directory.
|
|
174
221
|
|
|
175
222
|
## Development
|
|
176
223
|
|
|
177
224
|
```sh
|
|
178
225
|
pnpm install
|
|
179
|
-
pnpm run build # tsc → lib/
|
|
180
|
-
pnpm test # build + node --test (registration/config/engine/CLI)
|
|
226
|
+
pnpm run build # tsc + client workbench bundle → lib/
|
|
227
|
+
pnpm test # build + node --test (registration/config/engine/charts/absorb/workbench/CLI)
|
|
181
228
|
pnpm run smoke:cli # bare CLI smoke test, generates .smoke-deck
|
|
182
229
|
```
|
|
183
230
|
|
|
184
231
|
## Known limitations
|
|
185
232
|
|
|
186
|
-
-
|
|
187
|
-
-
|
|
188
|
-
- `bilingual`
|
|
233
|
+
- PPTX slides use positioned native shapes, tables, charts, and text boxes: text and chart workbooks are editable in PowerPoint / WPS / Keynote, without complex master-placeholder inheritance chains.
|
|
234
|
+
- `ppt_absorb` and `referencePptx` (including `cloneStructure`) extract colors, fonts, slide aspect ratio, chrome geometry, and slide layout skeletons; they do not copy third-party slide copy verbatim.
|
|
235
|
+
- `bilingual` localizes the player and workbench UI; it does not translate authored slide content.
|
|
189
236
|
- Selected-page editing supports this plugin's JSON project, not arbitrary external PPTX editing.
|
|
190
|
-
-
|
|
237
|
+
- Static checks estimate text fit and visual density; inspect rendered page images for exact font substitution and clipping.
|
|
191
238
|
|
|
192
239
|
## License
|
|
193
240
|
|