dsh-ppt 0.33.0 → 0.35.0

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