dsh-ppt 0.12.1 → 0.13.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 +7 -0
- package/README.en.md +47 -46
- package/README.md +48 -47
- package/docs/USAGE.en.md +196 -196
- package/docs/USAGE.md +217 -217
- package/docs/validation/0.8.0.md +10 -10
- package/lib/client.js +337 -269
- package/package.json +1 -1
- package/skills/dsh-ppt/SKILL.md +76 -76
- package/skills/dsh-ppt/package.json +11 -11
- package/skills/dsh-ppt/references/advanced.md +41 -41
- package/skills/dsh-ppt/references/syntax.md +43 -43
- package/skills/dsh-ppt/references/troubleshooting.md +19 -19
- package/skills/dsh-ppt/scripts/deck-advanced.mjs +538 -538
- package/skills/dsh-ppt/scripts/deck-core.mjs +2380 -2380
- package/skills/dsh-ppt/scripts/deck-delivery.mjs +104 -104
- package/skills/dsh-ppt/scripts/deck-render.mjs +270 -270
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,13 @@
|
|
|
4
4
|
|
|
5
5
|
[历史英文记录](docs/CHANGELOG.en.md)
|
|
6
6
|
|
|
7
|
+
## 0.13.0(2026-10-20)
|
|
8
|
+
|
|
9
|
+
- **设置面板体验**:新增 Ctrl/⌘+S 保存、Esc 取消或返回、Alt+←/→ 切换页面;HTML 预览 iframe 内同样生效。
|
|
10
|
+
- **未保存保护**:标题旁显示「未保存」徽标;刷新/关闭页面前提示;Esc 取消修改前先确认。
|
|
11
|
+
- **错误恢复**:错误提示旁新增「重试」按钮;空状态支持一键复制示例提示词。
|
|
12
|
+
- **无障碍**:补充 aria-busy、aria-keyshortcuts、role=status;焦点在 SELECT 上时不再劫持 Esc。
|
|
13
|
+
- 中英文案与 README 同步;131 项测试通过。
|
|
7
14
|
## 0.12.1(2026-10-20)
|
|
8
15
|
|
|
9
16
|
- 修复 #4:记录 HTML / PPTX 的 SHA-256;检测外部修改或旧工程缺少记录时拒绝覆盖,新增「另存副本」与 `ppt_edit.saveAs`,原文件保留。副本从 JSON 重建,不导入 Office 手工修改。
|
package/README.en.md
CHANGED
|
@@ -1,51 +1,52 @@
|
|
|
1
|
-
# dsh-ppt
|
|
2
|
-
|
|
3
|
-
[中文](README.md)
|
|
4
|
-
|
|
5
|
-

|
|
6
|
-
|
|
7
|
-
Turn source material into an HTML slideshow, editable PPTX and a reusable project.
|
|
8
|
-
|
|
1
|
+
# dsh-ppt
|
|
2
|
+
|
|
3
|
+
[中文](README.md)
|
|
4
|
+
|
|
5
|
+

|
|
6
|
+
|
|
7
|
+
Turn source material into an HTML slideshow, editable PPTX and a reusable project.
|
|
8
|
+
|
|
9
9
|
[](https://www.npmjs.com/package/dsh-ppt) [](https://www.npmjs.com/package/dsh-ppt)
|
|
10
10
|
|
|
11
11
|
Feedback and contributions are welcome: report [issues](https://github.com/STARDUSTLC666/dsh-ppt/issues) or submit [pull requests](https://github.com/STARDUSTLC666/dsh-ppt/pulls).
|
|
12
12
|
|
|
13
|
-
## What it does
|
|
14
|
-
|
|
15
|
-
- Create branded decks with text, images, tables and native charts.
|
|
16
|
-
- Edit text and images in Settings, reorder, duplicate or delete slides, and undo changes.
|
|
17
|
-
- Check quality and optionally render the final PPTX as images or PDF.
|
|
13
|
+
## What it does
|
|
14
|
+
|
|
15
|
+
- Create branded decks with text, images, tables and native charts.
|
|
16
|
+
- Edit text and images in Settings, reorder, duplicate or delete slides, and undo changes.
|
|
17
|
+
- Check quality and optionally render the final PPTX as images or PDF.
|
|
18
18
|
- Download Markdown speaker notes with each slide's current title and notes.
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
- [
|
|
46
|
-
- [
|
|
47
|
-
- [
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
19
|
+
- Keyboard support: Ctrl/⌘+S save, Esc cancel or go back, Alt+←/→ switch slides; leaving with unsaved edits prompts first.
|
|
20
|
+
|
|
21
|
+
## Install
|
|
22
|
+
|
|
23
|
+
In DSH Desktop, install `dsh-ppt` from the Plugins panel. If the bundled dsh command is available:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
dsh plugin --profile desktop add dsh-ppt
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
For the web version, replace `desktop` with `web`. Restart DSH after installation.
|
|
30
|
+
|
|
31
|
+
## Start using it
|
|
32
|
+
|
|
33
|
+
Ask to turn your material into a deliverable deck with HTML, PPTX and project files. From 0.8.0, use Settings → Presentations to edit projects generated by this plugin, or continue editing the PPTX in PowerPoint or WPS.
|
|
34
|
+
|
|
35
|
+
Office changes do not sync back to JSON. Externally changed outputs and legacy projects without integrity records cannot be overwritten. Use **Save a copy** or `ppt_edit(saveAs:true)` to rebuild a new trio from JSON while preserving the originals. The copy does not import Office edits.
|
|
36
|
+
|
|
37
|
+
## Requirements and configuration
|
|
38
|
+
|
|
39
|
+
Normal generation does not require Office. Final PPTX rendering uses the optional official LibreOffice Kit; see the guide for dependencies, fonts and installation.
|
|
40
|
+
|
|
41
|
+
Detailed configuration, tool arguments and troubleshooting are in the [usage guide](docs/USAGE.en.md). For standalone development, follow the Node requirement in [package.json](package.json).
|
|
42
|
+
|
|
43
|
+
## Documentation
|
|
44
|
+
|
|
45
|
+
- [Usage and troubleshooting](docs/USAGE.en.md)
|
|
46
|
+
- [Changelog](CHANGELOG.md)
|
|
47
|
+
- [Validation scope and history](docs/VALIDATION.md)
|
|
48
|
+
- [Report a problem or suggest a feature](https://github.com/STARDUSTLC666/dsh-ppt/issues)
|
|
49
|
+
|
|
50
|
+
## License
|
|
51
|
+
|
|
52
|
+
[MIT](LICENSE)
|
package/README.md
CHANGED
|
@@ -1,51 +1,52 @@
|
|
|
1
|
-
# dsh-ppt
|
|
2
|
-
|
|
3
|
-
[English](README.en.md)
|
|
4
|
-
|
|
5
|
-

|
|
6
|
-
|
|
7
|
-
把材料制作成 HTML 放映、可编辑 PPTX 和可继续修改的工程文件。
|
|
8
|
-
|
|
1
|
+
# dsh-ppt
|
|
2
|
+
|
|
3
|
+
[English](README.en.md)
|
|
4
|
+
|
|
5
|
+

|
|
6
|
+
|
|
7
|
+
把材料制作成 HTML 放映、可编辑 PPTX 和可继续修改的工程文件。
|
|
8
|
+
|
|
9
9
|
[](https://www.npmjs.com/package/dsh-ppt) [](https://www.npmjs.com/package/dsh-ppt)
|
|
10
10
|
|
|
11
11
|
欢迎使用,遇到问题或有改进建议,请提交 [issues](https://github.com/STARDUSTLC666/dsh-ppt/issues) 和 [PR](https://github.com/STARDUSTLC666/dsh-ppt/pulls)。
|
|
12
12
|
|
|
13
|
-
## 功能
|
|
14
|
-
|
|
15
|
-
- 生成图文、表格、原生图表和品牌化演示文稿。
|
|
16
|
-
- 在设置页编辑文字和图片、调整顺序、复制或删除页面,并支持撤销。
|
|
17
|
-
- 提供质量检查与可选的最终 PPTX 图片 / PDF 渲染。
|
|
18
|
-
- 下载按页整理的 Markdown 讲稿,保留当前版本的标题与演讲备注。
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
- [
|
|
46
|
-
- [
|
|
47
|
-
- [
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
13
|
+
## 功能
|
|
14
|
+
|
|
15
|
+
- 生成图文、表格、原生图表和品牌化演示文稿。
|
|
16
|
+
- 在设置页编辑文字和图片、调整顺序、复制或删除页面,并支持撤销。
|
|
17
|
+
- 提供质量检查与可选的最终 PPTX 图片 / PDF 渲染。
|
|
18
|
+
- 下载按页整理的 Markdown 讲稿,保留当前版本的标题与演讲备注。
|
|
19
|
+
- 键盘操作:Ctrl/⌘+S 保存、Esc 取消或返回、Alt+←/→ 切换页面;有未保存修改时离开会提示。
|
|
20
|
+
|
|
21
|
+
## 安装
|
|
22
|
+
|
|
23
|
+
桌面版可在「插件」面板按包名 `dsh-ppt` 安装。已配置 dsh 命令时也可使用:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
dsh plugin --profile desktop add dsh-ppt
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
网页版把命令中的 `desktop` 改为 `web`。安装后重启 DSH。
|
|
30
|
+
|
|
31
|
+
## 开始使用
|
|
32
|
+
|
|
33
|
+
可说:“把这份材料做成可直接交付的演示文稿,生成 HTML、PPTX 和工程文件。”0.8.0 起可在「设置 → 演示文稿」轻量修改自产工程,也可在 PowerPoint / WPS 中继续编辑 PPTX。
|
|
34
|
+
|
|
35
|
+
Office 中的修改不会同步回 JSON。插件检测到成品在外部修改,或旧工程没有校验记录时,会拒绝直接覆盖;可用面板「另存副本」或 `ppt_edit(saveAs:true)` 从 JSON 生成新文件,保留原成品。副本不包含 Office 手工修改。
|
|
36
|
+
|
|
37
|
+
## 依赖与配置
|
|
38
|
+
|
|
39
|
+
普通生成不需要 Office。最终 PPTX 渲染使用可选的官方 LibreOffice Kit;依赖版本、字体环境和安装方法见使用说明。
|
|
40
|
+
|
|
41
|
+
详细配置、工具参数与排错见[使用说明](docs/USAGE.md)。从源码独立开发时,Node 要求以 [package.json](package.json) 为准。
|
|
42
|
+
|
|
43
|
+
## 文档
|
|
44
|
+
|
|
45
|
+
- [使用与排错](docs/USAGE.md)
|
|
46
|
+
- [更新记录](CHANGELOG.md)
|
|
47
|
+
- [验证范围与历史记录](docs/VALIDATION.md)
|
|
48
|
+
- [问题反馈与功能建议](https://github.com/STARDUSTLC666/dsh-ppt/issues)
|
|
49
|
+
|
|
50
|
+
## License
|
|
51
|
+
|
|
52
|
+
[MIT](LICENSE)
|
package/docs/USAGE.en.md
CHANGED
|
@@ -1,200 +1,200 @@
|
|
|
1
|
-
# dsh-ppt usage guide
|
|
2
|
-
|
|
3
|
-
[Overview](../README.en.md) · [Changelog](../CHANGELOG.md) · [Validation](VALIDATION.md)
|
|
4
|
-
|
|
1
|
+
# dsh-ppt usage guide
|
|
2
|
+
|
|
3
|
+
[Overview](../README.en.md) · [Changelog](../CHANGELOG.md) · [Validation](VALIDATION.md)
|
|
4
|
+
|
|
5
5
|
## Current improvements
|
|
6
6
|
|
|
7
7
|
Save workbench edits, then choose Download delivery ZIP. Individual downloads remain available. The ZIP excludes configuration, secrets and other workspace files; each file is limited to 64 MiB and the total to 128 MiB.
|
|
8
8
|
|
|
9
|
-
## Capabilities
|
|
10
|
-
|
|
11
|
-
| Capability | Description |
|
|
12
|
-
| --- | --- |
|
|
13
|
-
| `ppt_create` tool | Markdown / structured slides → `*.html` + `*.pptx` + `*.json` |
|
|
14
|
-
| `ppt_themes` tool | Lists the 5 built-in themes and their best use cases; pass `preview: true` with `outputDir` to write a side-by-side gallery plus one SVG palette card per theme |
|
|
15
|
-
| 11 layouts | cover / section / bullets / statement / quote / table / closing / image / image-left / image-right / chart |
|
|
16
|
-
| Speaker notes | `<!-- note: ... -->` comments or the `notes` field: press `S` in the HTML player; native PPTX notes slides (presenter view) |
|
|
17
|
-
| Motion | On by default: HTML slide-in transitions + staggered bullet entrances; native PPTX fade transitions + click-to-reveal bullets. `motion: 'off'` / `--motion off` for a fully static deck |
|
|
18
|
-
| Markdown extras | Tables (`\| ... \|`), blockquotes (`>`), and note comments are auto-detected into matching layouts |
|
|
19
|
-
| `dsh-ppt` skill | A complete six-step SOP registered into DSH |
|
|
20
|
-
| Standalone SKILL.md | Copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for cross-harness use |
|
|
21
|
-
| Visual engine | Reuses the hyperframes visual style library; HTML and PPTX share the same theme source |
|
|
22
|
-
|
|
23
|
-
Example:
|
|
24
|
-
|
|
25
|
-
> Turn this sentence into a deck: "AI support cuts first response time to 8 seconds", with a dark tech theme.
|
|
26
|
-
>
|
|
27
|
-
> Turn `docs/quarterly-review.md` into a bilingual presentation and export PPTX.
|
|
28
|
-
|
|
29
|
-
## Installation
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
dsh plugin --profile web add dsh-ppt
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
On desktop, install `dsh-ppt` through plugin management. Restart the host after updating to load seven tools and the skill. Ask naturally to include screenshots/charts, edit only slide three, or undo the last edit; users do not need to write JSON.
|
|
36
|
-
|
|
37
|
-
## Uninstall
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
dsh plugin --profile web remove dsh-ppt
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
|
|
44
|
-
|
|
45
|
-
## Quick start
|
|
46
|
-
|
|
47
|
-
### Inside DSH (recommended)
|
|
48
|
-
|
|
49
|
-
```
|
|
50
|
-
1. ppt_themes { preview: true, outputDir: "dist" } # themes + gallery
|
|
51
|
-
2. ppt_create {
|
|
52
|
-
title: "Fewer Meetings",
|
|
53
|
-
content: "# Problem\n- Too many meetings\n\n# Solution\n- Async decisions",
|
|
54
|
-
theme: "data",
|
|
55
|
-
lang: "en"
|
|
56
|
-
}
|
|
57
|
-
3. Open the returned HTML path in a browser; edit the PPTX in PowerPoint / WPS / Keynote
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
### Any harness (standalone SKILL.md)
|
|
61
|
-
|
|
62
|
-
Copy `skills/dsh-ppt/` to any Agent Skills directory, then:
|
|
63
|
-
|
|
64
|
-
```bash
|
|
65
|
-
node <skill-dir>/scripts/build-deck.mjs \
|
|
66
|
-
--title "Product Launch" \
|
|
67
|
-
--content deck.md \
|
|
68
|
-
--theme data \
|
|
69
|
-
--lang en \
|
|
70
|
-
--out dist/deck
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
Artifacts:
|
|
74
|
-
|
|
75
|
-
Existing artifacts are not overwritten by default: if any member of the trio already exists, the whole set receives a shared `-1`, `-2`, ... suffix. Replacement requires explicit `overwrite: true` (or `--overwrite` in the CLI).
|
|
76
|
-
|
|
77
|
-
| File | Purpose |
|
|
78
|
-
| --- | --- |
|
|
79
|
-
| `*.html` | Standalone slideshow: arrow keys, V presenter view (separate window with real current/next previews, thumbnail strip, notes, timer, progress, pause, font size, blank screen), S notes, G thumbnail overview, F fullscreen, P print, ? shortcuts, Esc close |
|
|
80
|
-
| `*.pptx` | Editable 16:9 presentation (hand-written OOXML, zip via `node:zlib`, no third-party deps) |
|
|
81
|
-
| `*.json` | Structured manifest (version, theme, language, slides) |
|
|
82
|
-
|
|
83
|
-
## Images, charts, editing and review
|
|
84
|
-
|
|
85
|
-
### Lightweight Settings editor (0.8.0)
|
|
86
|
-
|
|
87
|
-
Open Settings → Presentations and choose a project registered by `ppt_create`, `ppt_edit` or `ppt_check`. Select a page to edit text, bullets and speaker notes; clicking text in the HTML preview focuses its field. Upload PNG/JPEG images, reorder, duplicate or delete slides and undo changes. Copies preserve images, charts and notes. The last slide cannot be deleted; the limit is 120 slides. Save or cancel pending edits before changing slide structure. Saving regenerates HTML, PPTX and JSON together.
|
|
88
|
-
|
|
89
|
-
Save or cancel pending changes before switching pages, reordering, downloading or rendering. A stale revision cannot overwrite another writer's changes. Use “Load latest, keep my input”, review overlapping fields, then explicitly save. The HTML preview and actual PPTX rendering are separate; edits invalidate previous renders. Review every rendered page and font diagnostics before downloading the latest files. The editor works with this plugin's own JSON projects; it does not import arbitrary external PPTX files, and ordinary generation/editing does not need the optional renderer.
|
|
90
|
-
|
|
91
|
-
The additional tools are `ppt_templates`, `ppt_edit`, `ppt_undo`, `ppt_check`, and `ppt_render`. New layouts are `image`, `image-left`, `image-right` and `chart`, alongside the seven existing layouts.
|
|
92
|
-
|
|
93
|
-
An image slide accepts `image: {src, alt, fit: "contain"|"cover", caption}`. Use local PNG/JPEG paths relative to session cwd or matching data URIs. Assets are embedded in all outputs and undo works after original files move. Limits: 5 MiB / 32 megapixels per image, 32 MiB total project assets. Remote links and SVG are not automatically downloaded or converted.
|
|
94
|
-
|
|
95
|
-
A chart accepts `chart: {kind:"column"|"bar"|"line"|"pie", categories, series:[{name,values}], unit, caption}` or `rows` with a category/series header. Values must be finite with matching lengths. Pie requires one nonnegative series with a positive total. HTML uses accessible SVG and data tables; PPTX contains native charts and embedded editable workbooks.
|
|
96
|
-
|
|
97
|
-
`brand` supports `name`, `primaryColor`, `backgroundColor`, `textColor`, `fontFamily`, `logo` and `footer`. Colors are `#RRGGBB`; select a font available on the recipient computer. `template` is `weekly|defense|project|pitch` and does not overwrite a supplied narrative.
|
|
98
|
-
|
|
99
|
-
Edit example: `{deckPath:"report.json",expectedRevision:0,edits:[{slide:3,patch:{title:"A clearer conclusion",bullets:["Evidence","Next action"]}}]}`. Use `ppt_check` to obtain stable IDs and the revision; `ppt_undo` restores the latest edit including assets/brand. Keeps up to 20 edits and rejects stale revisions. The artifact trio is regenerated atomically with rollback on commit failure.
|
|
100
|
-
|
|
101
|
-
Structure example: `{deckPath:"report.json",expectedRevision:0,duplicate:[2],remove:[3]}`. References use the original 1-based slide numbers or stable IDs. Copies follow the source slide with new IDs; existing slides keep theirs. A slide cannot be copied and removed in the same request. Keep 1–120 slides. Text edits, reordering and structural changes can share one undo step.
|
|
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.
|
|
104
|
-
|
|
105
|
-
## Optional PNG/PDF renderer
|
|
106
|
-
|
|
107
|
-
Install in the plugin's project or standalone skill directory:
|
|
108
|
-
|
|
109
|
-
```bash
|
|
110
|
-
npm install --ignore-scripts @deepseek-ai/libreoffice-kit@0.1.5
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
The exact optional peer is not a mandatory engine download for ordinary consumers. Windows also needs the Microsoft Visual C++ v14 runtime matching Node's architecture. Missing dependency/engine returns `unavailable` with guidance.
|
|
114
|
-
|
|
115
|
-
`ppt_render {pptxPath:"report.pptx",format:"both"}` reads the final PPTX without resaving it and returns page PNGs, PDF and `receiptPath`. Pass that path as `renderReceipt` to `ppt_check` to recheck the current PPTX and every output's digest. Editing the source or outputs invalidates the receipt. Static artifacts do not retain animation. LibreOffice/PowerPoint/WPS may lay out files differently; font diagnostics do not guarantee every glyph or install fonts. See [integration details](../docs/LIBREOFFICE-INTEGRATION-2026-10-01.md).
|
|
116
|
-
|
|
117
|
-
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
|
-
|
|
119
|
-
CLI supports `--slides @slides.json`, `--brand @brand.json`, `--template weekly`, `--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.
|
|
120
|
-
|
|
121
|
-
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` and `renderDeck`. The legacy synchronous `deck-core` API supports plain text and explicitly rejects unsupported media inputs.
|
|
122
|
-
|
|
123
|
-
## Theme palette
|
|
124
|
-
|
|
125
|
-
| ID | Name | Mood | Best for |
|
|
126
|
-
| --- | --- | --- | --- |
|
|
127
|
-
| `data` | Data Drift (default) | Futuristic / immersive | AI, tech launches, research |
|
|
128
|
-
| `swiss` | Swiss Pulse | Precise / rational | Data, SaaS, developer tools |
|
|
129
|
-
| `velvet` | Velvet Standard | Premium / restrained | Executive decks, brand, investor pitches |
|
|
130
|
-
| `soft` | Soft Signal | Warm / human | Brand stories, training, personal talks |
|
|
131
|
-
| `bold` | Maximalist Type | Loud / kinetic | Product launches, events, big moments |
|
|
132
|
-
|
|
133
|
-
Themes are derived from [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) `visual-styles.md`. Full palettes: `skills/dsh-ppt/references/themes.md`. Run `ppt_themes { preview: true, outputDir: "dist" }` for a side-by-side gallery and SVG palette cards.
|
|
134
|
-
|
|
135
|
-
## Markdown input rules
|
|
136
|
-
|
|
137
|
-
- The first `# heading` becomes the cover title; its first paragraph becomes the cover subtitle.
|
|
138
|
-
- Each `## section` becomes one slide: lists produce `bullets` slides; empty sections produce `section` dividers.
|
|
139
|
-
- Plain text without headings: the first paragraph is the cover, then every 5 sentences become one slide.
|
|
140
|
-
- A single sentence automatically produces a complete 3-slide structure: cover → core idea → closing.
|
|
141
|
-
- Long tables paginate automatically with repeated headers and up to 8 data rows per page. Notes stay on the first page. Tables support 8 columns and 60 characters per cell; oversized input returns an actionable error. Short rows are padded consistently in all artifacts.
|
|
142
|
-
- `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 precise control, use structured `slides` (`cover | section | bullets | statement | quote | table | closing`), with `rows` for tables and `notes` for speaker notes.
|
|
144
|
-
|
|
145
|
-
## Configuration
|
|
146
|
-
|
|
147
|
-
No required configuration. Optional:
|
|
148
|
-
|
|
149
|
-
```yaml
|
|
150
|
-
- id: dsh-ppt
|
|
151
|
-
config:
|
|
152
|
-
outputDir: E:\decks # optional; defaults to the session working directory
|
|
153
|
-
maxSlides: 40 # optional; default 60 (3–120)
|
|
154
|
-
defaultTheme: data # optional; used when ppt_create has no theme
|
|
155
|
-
defaultLang: en # optional; used when ppt_create has no lang (zh/en/bilingual)
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
The `DSH_PPT_OUTPUT_DIR` env var can also set the default output directory; the `ppt_create` `outputDir`/`theme`/`lang` arguments have the highest priority.
|
|
159
|
-
|
|
160
|
-
Relative paths and configured output directories resolve per session cwd without changing process cwd. Cancellation is checked during generation and before atomic commit of the trio. Optional rendering defaults to a unique `<deck>-render` directory beside the PPTX.
|
|
161
|
-
|
|
162
|
-
## Bilingual support
|
|
163
|
-
|
|
164
|
-
- `lang` argument: `zh` (default) / `en` / `bilingual` controls the player UI, page numbers, and closing defaults.
|
|
165
|
-
- Content language is up to the author: for a bilingual deck, prefer "Chinese title + English subtitle" or generate two decks from the same outline.
|
|
166
|
-
- Plugin docs come in Chinese (README.md) and English (this file); CLI and skill error messages are in Chinese.
|
|
167
|
-
|
|
168
|
-
## Engineering quality
|
|
169
|
-
|
|
170
|
-
- 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, theme resolution, Markdown parsing, artifact generation, PPTX part integrity, and the CLI.
|
|
173
|
-
- No `eval` / `child_process` / secrets; artifacts are only written to the user-specified local directory.
|
|
174
|
-
|
|
175
|
-
## Development
|
|
176
|
-
|
|
177
|
-
```sh
|
|
178
|
-
pnpm install
|
|
179
|
-
pnpm run build # tsc → lib/
|
|
180
|
-
pnpm test # build + node --test (registration/config/engine/CLI)
|
|
181
|
-
pnpm run smoke:cli # bare CLI smoke test, generates .smoke-deck
|
|
182
|
-
```
|
|
183
|
-
|
|
184
|
-
## Known limitations
|
|
185
|
-
|
|
186
|
-
- The PPTX uses a blank layout plus text boxes: text is editable in PowerPoint / WPS, but no smart master placeholders yet.
|
|
187
|
-
- A one-sentence input produces a minimal 3-slide structure; for richer decks, expand the content into a Markdown outline first.
|
|
188
|
-
- `bilingual` only localizes the player UI; it does not translate content.
|
|
189
|
-
- Selected-page editing supports this plugin's JSON project, not arbitrary external PPTX editing.
|
|
190
|
-
- Text fit checks are static estimates; inspect actual rendered output for clipping and font substitution.
|
|
191
|
-
|
|
192
|
-
## License
|
|
193
|
-
|
|
194
|
-
Plugin: MIT. Office Kit: MIT. Optional official LibreOffice Kit and its engine retain their own source/license/third-party notices. This community plugin is not officially maintained by DeepSeek.
|
|
195
|
-
|
|
196
|
-
## Related projects
|
|
197
|
-
|
|
198
|
-
- [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) — HTML video skills (source of this plugin's visual styles)
|
|
199
|
-
- [dsh-remotion](https://github.com/STARDUSTLC666/dsh-remotion) — React programmatic video skills
|
|
200
|
-
- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — Email toolset
|
|
9
|
+
## Capabilities
|
|
10
|
+
|
|
11
|
+
| Capability | Description |
|
|
12
|
+
| --- | --- |
|
|
13
|
+
| `ppt_create` tool | Markdown / structured slides → `*.html` + `*.pptx` + `*.json` |
|
|
14
|
+
| `ppt_themes` tool | Lists the 5 built-in themes and their best use cases; pass `preview: true` with `outputDir` to write a side-by-side gallery plus one SVG palette card per theme |
|
|
15
|
+
| 11 layouts | cover / section / bullets / statement / quote / table / closing / image / image-left / image-right / chart |
|
|
16
|
+
| Speaker notes | `<!-- note: ... -->` comments or the `notes` field: press `S` in the HTML player; native PPTX notes slides (presenter view) |
|
|
17
|
+
| Motion | On by default: HTML slide-in transitions + staggered bullet entrances; native PPTX fade transitions + click-to-reveal bullets. `motion: 'off'` / `--motion off` for a fully static deck |
|
|
18
|
+
| Markdown extras | Tables (`\| ... \|`), blockquotes (`>`), and note comments are auto-detected into matching layouts |
|
|
19
|
+
| `dsh-ppt` skill | A complete six-step SOP registered into DSH |
|
|
20
|
+
| Standalone SKILL.md | Copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for cross-harness use |
|
|
21
|
+
| Visual engine | Reuses the hyperframes visual style library; HTML and PPTX share the same theme source |
|
|
22
|
+
|
|
23
|
+
Example:
|
|
24
|
+
|
|
25
|
+
> Turn this sentence into a deck: "AI support cuts first response time to 8 seconds", with a dark tech theme.
|
|
26
|
+
>
|
|
27
|
+
> Turn `docs/quarterly-review.md` into a bilingual presentation and export PPTX.
|
|
28
|
+
|
|
29
|
+
## Installation
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
dsh plugin --profile web add dsh-ppt
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
On desktop, install `dsh-ppt` through plugin management. Restart the host after updating to load seven tools and the skill. Ask naturally to include screenshots/charts, edit only slide three, or undo the last edit; users do not need to write JSON.
|
|
36
|
+
|
|
37
|
+
## Uninstall
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
dsh plugin --profile web remove dsh-ppt
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
|
|
44
|
+
|
|
45
|
+
## Quick start
|
|
46
|
+
|
|
47
|
+
### Inside DSH (recommended)
|
|
48
|
+
|
|
49
|
+
```
|
|
50
|
+
1. ppt_themes { preview: true, outputDir: "dist" } # themes + gallery
|
|
51
|
+
2. ppt_create {
|
|
52
|
+
title: "Fewer Meetings",
|
|
53
|
+
content: "# Problem\n- Too many meetings\n\n# Solution\n- Async decisions",
|
|
54
|
+
theme: "data",
|
|
55
|
+
lang: "en"
|
|
56
|
+
}
|
|
57
|
+
3. Open the returned HTML path in a browser; edit the PPTX in PowerPoint / WPS / Keynote
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Any harness (standalone SKILL.md)
|
|
61
|
+
|
|
62
|
+
Copy `skills/dsh-ppt/` to any Agent Skills directory, then:
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
node <skill-dir>/scripts/build-deck.mjs \
|
|
66
|
+
--title "Product Launch" \
|
|
67
|
+
--content deck.md \
|
|
68
|
+
--theme data \
|
|
69
|
+
--lang en \
|
|
70
|
+
--out dist/deck
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Artifacts:
|
|
74
|
+
|
|
75
|
+
Existing artifacts are not overwritten by default: if any member of the trio already exists, the whole set receives a shared `-1`, `-2`, ... suffix. Replacement requires explicit `overwrite: true` (or `--overwrite` in the CLI).
|
|
76
|
+
|
|
77
|
+
| File | Purpose |
|
|
78
|
+
| --- | --- |
|
|
79
|
+
| `*.html` | Standalone slideshow: arrow keys, V presenter view (separate window with real current/next previews, thumbnail strip, notes, timer, progress, pause, font size, blank screen), S notes, G thumbnail overview, F fullscreen, P print, ? shortcuts, Esc close |
|
|
80
|
+
| `*.pptx` | Editable 16:9 presentation (hand-written OOXML, zip via `node:zlib`, no third-party deps) |
|
|
81
|
+
| `*.json` | Structured manifest (version, theme, language, slides) |
|
|
82
|
+
|
|
83
|
+
## Images, charts, editing and review
|
|
84
|
+
|
|
85
|
+
### Lightweight Settings editor (0.8.0)
|
|
86
|
+
|
|
87
|
+
Open Settings → Presentations and choose a project registered by `ppt_create`, `ppt_edit` or `ppt_check`. Select a page to edit text, bullets and speaker notes; clicking text in the HTML preview focuses its field. Upload PNG/JPEG images, reorder, duplicate or delete slides and undo changes. Copies preserve images, charts and notes. The last slide cannot be deleted; the limit is 120 slides. Save or cancel pending edits before changing slide structure. Saving regenerates HTML, PPTX and JSON together.
|
|
88
|
+
|
|
89
|
+
Save or cancel pending changes before switching pages, reordering, downloading or rendering. A stale revision cannot overwrite another writer's changes. Use “Load latest, keep my input”, review overlapping fields, then explicitly save. The HTML preview and actual PPTX rendering are separate; edits invalidate previous renders. Review every rendered page and font diagnostics before downloading the latest files. The editor works with this plugin's own JSON projects; it does not import arbitrary external PPTX files, and ordinary generation/editing does not need the optional renderer.
|
|
90
|
+
|
|
91
|
+
The additional tools are `ppt_templates`, `ppt_edit`, `ppt_undo`, `ppt_check`, and `ppt_render`. New layouts are `image`, `image-left`, `image-right` and `chart`, alongside the seven existing layouts.
|
|
92
|
+
|
|
93
|
+
An image slide accepts `image: {src, alt, fit: "contain"|"cover", caption}`. Use local PNG/JPEG paths relative to session cwd or matching data URIs. Assets are embedded in all outputs and undo works after original files move. Limits: 5 MiB / 32 megapixels per image, 32 MiB total project assets. Remote links and SVG are not automatically downloaded or converted.
|
|
94
|
+
|
|
95
|
+
A chart accepts `chart: {kind:"column"|"bar"|"line"|"pie", categories, series:[{name,values}], unit, caption}` or `rows` with a category/series header. Values must be finite with matching lengths. Pie requires one nonnegative series with a positive total. HTML uses accessible SVG and data tables; PPTX contains native charts and embedded editable workbooks.
|
|
96
|
+
|
|
97
|
+
`brand` supports `name`, `primaryColor`, `backgroundColor`, `textColor`, `fontFamily`, `logo` and `footer`. Colors are `#RRGGBB`; select a font available on the recipient computer. `template` is `weekly|defense|project|pitch` and does not overwrite a supplied narrative.
|
|
98
|
+
|
|
99
|
+
Edit example: `{deckPath:"report.json",expectedRevision:0,edits:[{slide:3,patch:{title:"A clearer conclusion",bullets:["Evidence","Next action"]}}]}`. Use `ppt_check` to obtain stable IDs and the revision; `ppt_undo` restores the latest edit including assets/brand. Keeps up to 20 edits and rejects stale revisions. The artifact trio is regenerated atomically with rollback on commit failure.
|
|
100
|
+
|
|
101
|
+
Structure example: `{deckPath:"report.json",expectedRevision:0,duplicate:[2],remove:[3]}`. References use the original 1-based slide numbers or stable IDs. Copies follow the source slide with new IDs; existing slides keep theirs. A slide cannot be copied and removed in the same request. Keep 1–120 slides. Text edits, reordering and structural changes can share one undo step.
|
|
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.
|
|
104
|
+
|
|
105
|
+
## Optional PNG/PDF renderer
|
|
106
|
+
|
|
107
|
+
Install in the plugin's project or standalone skill directory:
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
npm install --ignore-scripts @deepseek-ai/libreoffice-kit@0.1.5
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
The exact optional peer is not a mandatory engine download for ordinary consumers. Windows also needs the Microsoft Visual C++ v14 runtime matching Node's architecture. Missing dependency/engine returns `unavailable` with guidance.
|
|
114
|
+
|
|
115
|
+
`ppt_render {pptxPath:"report.pptx",format:"both"}` reads the final PPTX without resaving it and returns page PNGs, PDF and `receiptPath`. Pass that path as `renderReceipt` to `ppt_check` to recheck the current PPTX and every output's digest. Editing the source or outputs invalidates the receipt. Static artifacts do not retain animation. LibreOffice/PowerPoint/WPS may lay out files differently; font diagnostics do not guarantee every glyph or install fonts. See [integration details](../docs/LIBREOFFICE-INTEGRATION-2026-10-01.md).
|
|
116
|
+
|
|
117
|
+
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
|
+
|
|
119
|
+
CLI supports `--slides @slides.json`, `--brand @brand.json`, `--template weekly`, `--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.
|
|
120
|
+
|
|
121
|
+
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` and `renderDeck`. The legacy synchronous `deck-core` API supports plain text and explicitly rejects unsupported media inputs.
|
|
122
|
+
|
|
123
|
+
## Theme palette
|
|
124
|
+
|
|
125
|
+
| ID | Name | Mood | Best for |
|
|
126
|
+
| --- | --- | --- | --- |
|
|
127
|
+
| `data` | Data Drift (default) | Futuristic / immersive | AI, tech launches, research |
|
|
128
|
+
| `swiss` | Swiss Pulse | Precise / rational | Data, SaaS, developer tools |
|
|
129
|
+
| `velvet` | Velvet Standard | Premium / restrained | Executive decks, brand, investor pitches |
|
|
130
|
+
| `soft` | Soft Signal | Warm / human | Brand stories, training, personal talks |
|
|
131
|
+
| `bold` | Maximalist Type | Loud / kinetic | Product launches, events, big moments |
|
|
132
|
+
|
|
133
|
+
Themes are derived from [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) `visual-styles.md`. Full palettes: `skills/dsh-ppt/references/themes.md`. Run `ppt_themes { preview: true, outputDir: "dist" }` for a side-by-side gallery and SVG palette cards.
|
|
134
|
+
|
|
135
|
+
## Markdown input rules
|
|
136
|
+
|
|
137
|
+
- The first `# heading` becomes the cover title; its first paragraph becomes the cover subtitle.
|
|
138
|
+
- Each `## section` becomes one slide: lists produce `bullets` slides; empty sections produce `section` dividers.
|
|
139
|
+
- Plain text without headings: the first paragraph is the cover, then every 5 sentences become one slide.
|
|
140
|
+
- A single sentence automatically produces a complete 3-slide structure: cover → core idea → closing.
|
|
141
|
+
- Long tables paginate automatically with repeated headers and up to 8 data rows per page. Notes stay on the first page. Tables support 8 columns and 60 characters per cell; oversized input returns an actionable error. Short rows are padded consistently in all artifacts.
|
|
142
|
+
- `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 precise control, use structured `slides` (`cover | section | bullets | statement | quote | table | closing`), with `rows` for tables and `notes` for speaker notes.
|
|
144
|
+
|
|
145
|
+
## Configuration
|
|
146
|
+
|
|
147
|
+
No required configuration. Optional:
|
|
148
|
+
|
|
149
|
+
```yaml
|
|
150
|
+
- id: dsh-ppt
|
|
151
|
+
config:
|
|
152
|
+
outputDir: E:\decks # optional; defaults to the session working directory
|
|
153
|
+
maxSlides: 40 # optional; default 60 (3–120)
|
|
154
|
+
defaultTheme: data # optional; used when ppt_create has no theme
|
|
155
|
+
defaultLang: en # optional; used when ppt_create has no lang (zh/en/bilingual)
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
The `DSH_PPT_OUTPUT_DIR` env var can also set the default output directory; the `ppt_create` `outputDir`/`theme`/`lang` arguments have the highest priority.
|
|
159
|
+
|
|
160
|
+
Relative paths and configured output directories resolve per session cwd without changing process cwd. Cancellation is checked during generation and before atomic commit of the trio. Optional rendering defaults to a unique `<deck>-render` directory beside the PPTX.
|
|
161
|
+
|
|
162
|
+
## Bilingual support
|
|
163
|
+
|
|
164
|
+
- `lang` argument: `zh` (default) / `en` / `bilingual` controls the player UI, page numbers, and closing defaults.
|
|
165
|
+
- Content language is up to the author: for a bilingual deck, prefer "Chinese title + English subtitle" or generate two decks from the same outline.
|
|
166
|
+
- Plugin docs come in Chinese (README.md) and English (this file); CLI and skill error messages are in Chinese.
|
|
167
|
+
|
|
168
|
+
## Engineering quality
|
|
169
|
+
|
|
170
|
+
- 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, theme resolution, Markdown parsing, artifact generation, PPTX part integrity, and the CLI.
|
|
173
|
+
- No `eval` / `child_process` / secrets; artifacts are only written to the user-specified local directory.
|
|
174
|
+
|
|
175
|
+
## Development
|
|
176
|
+
|
|
177
|
+
```sh
|
|
178
|
+
pnpm install
|
|
179
|
+
pnpm run build # tsc → lib/
|
|
180
|
+
pnpm test # build + node --test (registration/config/engine/CLI)
|
|
181
|
+
pnpm run smoke:cli # bare CLI smoke test, generates .smoke-deck
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
## Known limitations
|
|
185
|
+
|
|
186
|
+
- The PPTX uses a blank layout plus text boxes: text is editable in PowerPoint / WPS, but no smart master placeholders yet.
|
|
187
|
+
- A one-sentence input produces a minimal 3-slide structure; for richer decks, expand the content into a Markdown outline first.
|
|
188
|
+
- `bilingual` only localizes the player UI; it does not translate content.
|
|
189
|
+
- Selected-page editing supports this plugin's JSON project, not arbitrary external PPTX editing.
|
|
190
|
+
- Text fit checks are static estimates; inspect actual rendered output for clipping and font substitution.
|
|
191
|
+
|
|
192
|
+
## License
|
|
193
|
+
|
|
194
|
+
Plugin: MIT. Office Kit: MIT. Optional official LibreOffice Kit and its engine retain their own source/license/third-party notices. This community plugin is not officially maintained by DeepSeek.
|
|
195
|
+
|
|
196
|
+
## Related projects
|
|
197
|
+
|
|
198
|
+
- [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) — HTML video skills (source of this plugin's visual styles)
|
|
199
|
+
- [dsh-remotion](https://github.com/STARDUSTLC666/dsh-remotion) — React programmatic video skills
|
|
200
|
+
- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — Email toolset
|