dsh-ppt 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,75 +1,90 @@
-# Changelog
-
+# Changelog
+
+## 0.6.0（2026-10-01）
+
+- 新增离线嵌入图片的三种布局、四类原生可编辑图表及数据工作簿；精确使用 MIT Office Kit 0.21.0，保留备注和原有动效。
+- 新增 ppt_templates、ppt_edit、ppt_undo、ppt_check、ppt_render；四种场景结构参考、品牌、稳定页面ID、修订冲突保护和最多20次原子撤销。
+- 质量报告定位具体页面；未填模板明确标注草稿，静态估算、渲染、视觉检查分开说明。
+- 可选官方 LibreOffice Kit 0.1.3 读取最终PPTX生成PNG/PDF，报告缺失字体并写入完整性收据；不修改可编辑源文件。
+- 修正总览缩略图重叠、PPTX表格标题字号、正文段间距、图片说明间距和图表坐标/比例标签。
+- CLI覆盖全部流程，显式收据失效返回非零，默认渲染目录位于PPTX旁。
+- 修正默认主题PPTX字体映射：CSS可选字体与本机Office字体分离，明确东亚字体，避免官方渲染时中文字符重叠；工具schema使用官方宿主支持的oneOf。
+
+## 0.5.1（2026-09-28）
+
+- 兼容验证更新到 Harness 0.2.0-rc.1：70 项测试与 18 插件共同加载检查通过（`ppt_create` / `ppt_themes` 与 `dsh-ppt` 技能注册正常）。
+- 运行时代码未变；同步中英文兼容性声明。
+
 ## 0.5.0（2026-09-27）
 
-- 包含新的演讲者预览、缩略图和计时控件。浏览器不支持或拒绝全屏时显示操作提示，不再无声失败。
-
-- **演讲者视图升级**：独立窗口内显示真实当前页与下一页预览（复用幻灯片渲染）、全片缩略图条（点击跳页）、wall clock + 计时（P 暂停 / T 重置）、备注字号 +/-、黑屏 / 白屏（B / W）、结束放映一键退出。
-- **通信更稳**：演讲者窗口改用 Blob URL + postMessage 同步，不再依赖同源 document 直连，file:// 打开的 deck 也能正常联动；窗口被直接关闭后 0.8 秒内自动恢复普通模式。
-- **观众端**：黑屏 / 白屏时隐藏 HUD；观众端备注与 HUD 默认隐藏逻辑保持不变。
-- 播放器保留 0.4.5 的全部修复，70 项测试通过。
-## 0.4.5（2026-09-23）
-
-- **播放器交互修复（由合成用户复测驱动）**：备注面板不再遮挡页脚 HUD，新增关闭按钮并支持 Esc；无备注页显示「本页无备注」占位；`G` 改为缩略图网格总览（当前页高亮、页码同步、点击跳页、Esc 退出、页码角标）；`?` 打开快捷键帮助；表格页补页面标题、数字列右对齐、表格边界与内容列对齐、表头对比度达标；窄屏字号下限 14px、HUD 按钮 44px；新增环绕提示、ArrowUp/Down 翻页、数字 1-9 跳页、focus-visible 与 reduced-motion 处理。
-- **演讲者视图（V）**：独立窗口显示当前页 / 下一页 / 备注 / 计时 / 进度，支持 +/- 字号、T 重置计时、P 暂停、方向键翻页、Esc 关闭；打开后主窗口隐藏备注与 HUD，观众端不泄露备注，关闭后状态自动恢复。
-- **主题预览**：`ppt_themes { preview: true, outputDir: "..." }` 生成 `themes-preview.html`（5 套主题并排对比）与每套主题一张 `theme-<id>.svg` 色板卡，可直接用于 README / npm 首屏。
-- 测试 70 项通过；三个合成用户（非技术运营 / 键盘党 / 培训讲师）真实浏览器复测通过，无 P0/P1。
-
-## 0.4.4（2026-09-21）
-
-- Markdown 与结构化长表格自动按每页 8 行数据分页，续页重复表头，备注仅放第一页；修复无小标题、首个 H1 下表格被丢弃。
-- 不再静默裁掉中间幻灯片、额外列或长单元格：总页数超过 maxSlides、超过 8 列或单元格超过 60 字符时，生成前提示调整。短行补空白，HTML 与 PPTX 保留同一份数据。
-- 续页标题跟随中文、英文或双语设置。新增 7 项回归，67 项测试通过；生成产物检查覆盖全部 17 行数据。
-
-## 0.4.3（2026-09-18）
-
-- 修复：中文分句导致正文丢内容；`--content deck.md` 不读文件；>8 条要点静默丢弃；`deck.json` 版本写死；英文 deck 被标 zh-CN。
-- 稳健性：三件套改为 tmp + rename 原子提交（失败回滚）；过滤 Windows 保留名；文件名探测改一次目录快照。
-- 测试 48 → 60 项。
-## 0.4.2（2026-09-11）
-
-- 适配并验证官方 Harness 0.1.5-rc.1：整套同载、工具/技能契约与 Web 鉴权检查通过。
-- Node 要求与宿主统一为 `^22.19.0 || >=24.0.0`；更新中英文兼容性说明。
-
-## 0.4.1
-
-- 修复中文正文分页：中英文标点都作为句子边界，无标题纯文本严格按「每 5 句一页」分页，不再把整段中文当一句而截断丢正文。
-- CLI `--content <path>` 与 `--content @<path>` 行为一致：路径存在即读取文件，README / SKILL.md 示例可直接复制运行。
-- 单节要点超过 8 条时自动续页（第二页起标题带「（续）」），不再静默丢弃第 9 条之后的要点。
-- manifest `version` 改从 `package.json` 读取，消除与发版号的漂移；测试同步改为动态断言。
-- PPTX 文本与备注 run 的语言跟随 `lang`（zh-CN / en-US），英文 deck 不再被 PowerPoint 标成中文。
-
-## 0.4.0
-
-- **动效（motion，默认开）**：HTML 放映页间淡入 + 要点按序逐条入场（打印自动兜底为静态）；PPTX 每页原生淡入转场，`bullets` 页按段落构建、放映时点击一次出现一条要点（PowerPoint「出现，按段落」标准时序）。
-- **`motion` 开关**：`ppt_create` 新增 `motion: 'on' | 'off'`，CLI 新增 `--motion on|off`；`off` 时产物不含任何动画代码，适合严肃/打印场景。manifest 记录该开关。
-- **技能文件瘦身**：SKILL.md 收敛为触发条件 + 执行纪律 + 六步流水线 + 按需装载索引 + 质量门禁；新增 `references/syntax.md`（Markdown 解析、表格/金句/备注语法、结构化 slides、motion）与 `references/troubleshooting.md`；写作规则去重归口 `references/copywriting.md`，hyperframes 视觉联动并入 `references/themes.md`。
-- 动效相关测试 8 例（转场/时序树/点击节点计数/静态开关/CLI/工具层），全套 42/42 通过。
-
-## 0.3.0
-
-- **演讲者备注**：结构化 `slides` 的 `notes` 字段与 Markdown `<!-- 备注: ... -->` 注释都会成为该页备注；HTML 放映按 `S` 键（或右下角「备注」按钮）呼出备注面板；PPTX 生成原生 `notesSlide` + `notesMaster` 部件，PowerPoint 演示者视图直接可用。
-- **新增 `quote` 金句版式**：`>` 引用块自动识别，末行 `—— 出处` 识别为署名；HTML 与 PPTX 双端实现。
-- **新增 `table` 表格版式**：Markdown 表格（`| ... |`）自动识别，PPTX 用原生 `a:tbl` 图形帧（主题色表头 + 隔行着色），限 9 行 8 列。
-- 版式集合扩为 `cover | section | bullets | statement | quote | table | closing`；结构化 `slides` 增加 `rows` 字段。
-- 无表格数据的 `table` 页自动退化为要点页，避免空白版式。
-- 新特性测试 8 例（解析/规范化/HTML/PPTX 部件/端到端）。
-
-## 0.2.1
-
-- 修复 PPTX zip 中央目录 local header 偏移恒为 0 导致 PowerPoint 提示修复的问题（issue #1/#3，社区 PR #2 同修法）。
-
-## 0.2.0
-
-- 新增 `defaultTheme` / `defaultLang` 配置，作为 `ppt_create` 未显式传参时的默认值。
-- 配置校验：`defaultLang` 仅接受 `zh` / `en` / `bilingual`。
-- 更新测试覆盖与双语文档。
-
-## 0.1.0
-
-- 首发：`dsh-ppt` 技能 + 工具插件。
-- `ppt_create`：Markdown / 结构化 slides → HTML 网页放映 + PPTX 导出 + manifest。
-- `ppt_themes`：5 套内置视觉主题（Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type）。
-- 中英双语界面（zh / en / bilingual）。
-- 裸 SKILL.md + `build-deck.mjs` CLI，跨 Claude Code / Cursor / Gemini CLI / Codex / DSH。
-- 零运行时依赖：OOXML 与 zip 由 `node:zlib` 手写生成。
+- 包含新的演讲者预览、缩略图和计时控件。浏览器不支持或拒绝全屏时显示操作提示，不再无声失败。
+
+- **演讲者视图升级**：独立窗口内显示真实当前页与下一页预览（复用幻灯片渲染）、全片缩略图条（点击跳页）、wall clock + 计时（P 暂停 / T 重置）、备注字号 +/-、黑屏 / 白屏（B / W）、结束放映一键退出。
+- **通信更稳**：演讲者窗口改用 Blob URL + postMessage 同步，不再依赖同源 document 直连，file:// 打开的 deck 也能正常联动；窗口被直接关闭后 0.8 秒内自动恢复普通模式。
+- **观众端**：黑屏 / 白屏时隐藏 HUD；观众端备注与 HUD 默认隐藏逻辑保持不变。
+- 播放器保留 0.4.5 的全部修复，70 项测试通过。
+## 0.4.5（2026-09-23）
+
+- **播放器交互修复（由合成用户复测驱动）**：备注面板不再遮挡页脚 HUD，新增关闭按钮并支持 Esc；无备注页显示「本页无备注」占位；`G` 改为缩略图网格总览（当前页高亮、页码同步、点击跳页、Esc 退出、页码角标）；`?` 打开快捷键帮助；表格页补页面标题、数字列右对齐、表格边界与内容列对齐、表头对比度达标；窄屏字号下限 14px、HUD 按钮 44px；新增环绕提示、ArrowUp/Down 翻页、数字 1-9 跳页、focus-visible 与 reduced-motion 处理。
+- **演讲者视图（V）**：独立窗口显示当前页 / 下一页 / 备注 / 计时 / 进度，支持 +/- 字号、T 重置计时、P 暂停、方向键翻页、Esc 关闭；打开后主窗口隐藏备注与 HUD，观众端不泄露备注，关闭后状态自动恢复。
+- **主题预览**：`ppt_themes { preview: true, outputDir: "..." }` 生成 `themes-preview.html`（5 套主题并排对比）与每套主题一张 `theme-<id>.svg` 色板卡，可直接用于 README / npm 首屏。
+- 测试 70 项通过；三个合成用户（非技术运营 / 键盘党 / 培训讲师）真实浏览器复测通过，无 P0/P1。
+
+## 0.4.4（2026-09-21）
+
+- Markdown 与结构化长表格自动按每页 8 行数据分页，续页重复表头，备注仅放第一页；修复无小标题、首个 H1 下表格被丢弃。
+- 不再静默裁掉中间幻灯片、额外列或长单元格：总页数超过 maxSlides、超过 8 列或单元格超过 60 字符时，生成前提示调整。短行补空白，HTML 与 PPTX 保留同一份数据。
+- 续页标题跟随中文、英文或双语设置。新增 7 项回归，67 项测试通过；生成产物检查覆盖全部 17 行数据。
+
+## 0.4.3（2026-09-18）
+
+- 修复：中文分句导致正文丢内容；`--content deck.md` 不读文件；>8 条要点静默丢弃；`deck.json` 版本写死；英文 deck 被标 zh-CN。
+- 稳健性：三件套改为 tmp + rename 原子提交（失败回滚）；过滤 Windows 保留名；文件名探测改一次目录快照。
+- 测试 48 → 60 项。
+## 0.4.2（2026-09-11）
+
+- 适配并验证官方 Harness 0.1.5-rc.1：整套同载、工具/技能契约与 Web 鉴权检查通过。
+- Node 要求与宿主统一为 `^22.19.0 || >=24.0.0`；更新中英文兼容性说明。
+
+## 0.4.1
+
+- 修复中文正文分页：中英文标点都作为句子边界，无标题纯文本严格按「每 5 句一页」分页，不再把整段中文当一句而截断丢正文。
+- CLI `--content <path>` 与 `--content @<path>` 行为一致：路径存在即读取文件，README / SKILL.md 示例可直接复制运行。
+- 单节要点超过 8 条时自动续页（第二页起标题带「（续）」），不再静默丢弃第 9 条之后的要点。
+- manifest `version` 改从 `package.json` 读取，消除与发版号的漂移；测试同步改为动态断言。
+- PPTX 文本与备注 run 的语言跟随 `lang`（zh-CN / en-US），英文 deck 不再被 PowerPoint 标成中文。
+
+## 0.4.0
+
+- **动效（motion，默认开）**：HTML 放映页间淡入 + 要点按序逐条入场（打印自动兜底为静态）；PPTX 每页原生淡入转场，`bullets` 页按段落构建、放映时点击一次出现一条要点（PowerPoint「出现，按段落」标准时序）。
+- **`motion` 开关**：`ppt_create` 新增 `motion: 'on' | 'off'`，CLI 新增 `--motion on|off`；`off` 时产物不含任何动画代码，适合严肃/打印场景。manifest 记录该开关。
+- **技能文件瘦身**：SKILL.md 收敛为触发条件 + 执行纪律 + 六步流水线 + 按需装载索引 + 质量门禁；新增 `references/syntax.md`（Markdown 解析、表格/金句/备注语法、结构化 slides、motion）与 `references/troubleshooting.md`；写作规则去重归口 `references/copywriting.md`，hyperframes 视觉联动并入 `references/themes.md`。
+- 动效相关测试 8 例（转场/时序树/点击节点计数/静态开关/CLI/工具层），全套 42/42 通过。
+
+## 0.3.0
+
+- **演讲者备注**：结构化 `slides` 的 `notes` 字段与 Markdown `<!-- 备注: ... -->` 注释都会成为该页备注；HTML 放映按 `S` 键（或右下角「备注」按钮）呼出备注面板；PPTX 生成原生 `notesSlide` + `notesMaster` 部件，PowerPoint 演示者视图直接可用。
+- **新增 `quote` 金句版式**：`>` 引用块自动识别，末行 `—— 出处` 识别为署名；HTML 与 PPTX 双端实现。
+- **新增 `table` 表格版式**：Markdown 表格（`| ... |`）自动识别，PPTX 用原生 `a:tbl` 图形帧（主题色表头 + 隔行着色），限 9 行 8 列。
+- 版式集合扩为 `cover | section | bullets | statement | quote | table | closing`；结构化 `slides` 增加 `rows` 字段。
+- 无表格数据的 `table` 页自动退化为要点页，避免空白版式。
+- 新特性测试 8 例（解析/规范化/HTML/PPTX 部件/端到端）。
+
+## 0.2.1
+
+- 修复 PPTX zip 中央目录 local header 偏移恒为 0 导致 PowerPoint 提示修复的问题（issue #1/#3，社区 PR #2 同修法）。
+
+## 0.2.0
+
+- 新增 `defaultTheme` / `defaultLang` 配置，作为 `ppt_create` 未显式传参时的默认值。
+- 配置校验：`defaultLang` 仅接受 `zh` / `en` / `bilingual`。
+- 更新测试覆盖与双语文档。
+
+## 0.1.0
+
+- 首发：`dsh-ppt` 技能 + 工具插件。
+- `ppt_create`：Markdown / 结构化 slides → HTML 网页放映 + PPTX 导出 + manifest。
+- `ppt_themes`：5 套内置视觉主题（Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type）。
+- 中英双语界面（zh / en / bilingual）。
+- 裸 SKILL.md + `build-deck.mjs` CLI，跨 Claude Code / Cursor / Gemini CLI / Codex / DSH。
+- 零运行时依赖：OOXML 与 zip 由 `node:zlib` 手写生成。

package/README.en.md

@@ -1,174 +1,213 @@
-# dsh-ppt
+# dsh-ppt
+
+## 0.6.0 (2026-10-01)
+
+Adds image/text layouts, four native editable chart types, selected-page edits and undo, page-specific quality reports, four scenario outlines and shared branding. Optional official LibreOffice Kit rendering reads the final PPTX to produce PNG/PDF with font diagnostics. Fixes overlapping overview thumbnails, undersized table titles, image-caption spacing and chart labels.
+
+The goal remains a usable finished deck. The agent prepares actual facts and content; the deterministic generator does not research or invent missing facts. Template-only output is explicitly an unfilled **draft** and must not be delivered as a finished presentation.
+
+Default PPTX fonts use platform fallbacks and explicit East Asian families separately from HTML's CSS font stacks. Replace missing fonts, regenerate and review the pages; unresolved font problems must be disclosed instead of claiming acceptance.
+
+Validation: Windows / Node 24.16.0, 100 passing tests; 18 components mount together on official-source Harness 0.2.0-rc.2 (639ed01539) with 104 tools and 35 skills. Fifteen default-theme pages without brand overrides passed native PNG/PDF rendering and individual visual review; an eleven-page image/chart/brand sample was checked in the browser, Microsoft PowerPoint and the official Kit. This covers those samples, not automatic acceptance of arbitrary decks.
 
 ## 0.5.0 update (2026-09-27)
 
 Includes presenter previews, thumbnails and timer controls. Unsupported or rejected fullscreen requests now show an actionable message instead of silently failing.
 
-Validation host: Harness 0.1.7-rc.2 built from official sources, retaining the local tool-scheduler fix. Build and automated checks pass; interactive coverage and external-service limits are recorded in this release round.
-
-![npm](https://img.shields.io/npm/v/dsh-ppt) ![downloads](https://img.shields.io/npm/dm/dsh-ppt) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-ppt) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-ppt?style=social)
-
-[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
-
-> **One sentence or one document → a complete presentation**: HTML web slideshow + PPTX export, 5 visual themes, slide transitions + bullet entrance animations, bilingual Chinese/English.
-
-DeepSeek Harness (DSH) presentation skill + tool plugin: turns a sentence, a paragraph, or a Markdown document into a ready-to-present **HTML slideshow** and an editable **PPTX**. Pure Node, **zero runtime dependencies**, one codebase for Windows / macOS / Linux.
-
-## Capabilities
-
-| Capability | Description |
-| --- | --- |
-| `ppt_create` tool | Markdown / structured slides → `*.html` + `*.pptx` + `*.json` |
-| `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 |
-| 7 layouts | cover / section / bullets / statement / **quote** / **table** / closing |
-| Speaker notes | `<!-- note: ... -->` comments or the `notes` field: press `S` in the HTML player; native PPTX notes slides (presenter view) |
-| 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 |
-| Markdown extras | Tables (`\| ... \|`), blockquotes (`>`), and note comments are auto-detected into matching layouts |
-| `dsh-ppt` skill | A complete six-step SOP registered into DSH |
-| Standalone SKILL.md | Copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for cross-harness use |
-| Visual engine | Reuses the hyperframes visual style library; HTML and PPTX share the same theme source |
-
-Example:
-
-> Turn this sentence into a deck: "AI support cuts first response time to 8 seconds", with a dark tech theme.
->
-> Turn `docs/quarterly-review.md` into a bilingual presentation and export PPTX.
-
-## Compatibility
-
-2026-09-21: the current release package was installed through the official CLI in an isolated profile and co-loaded with the other two most-downloaded plugins on source-built Harness `0.1.6-alpha.2`. All 18 plugin tools registered; calendar/email configuration checks, PPT theme listing and 17-row table generation passed. The host is based on the official alpha.2 release plus the tool-scheduler `Symbol.for` fix (`93badd88`). This run did not connect to live mail or calendar services.
-
-Verified with official `@deepseek-ai/dsh@0.1.5-rc.1` and Node `24.16.0` on 2026-09-11: all 18 components load alongside Modlens, with passing tool-schema, skill-registration and offline read-only invocation checks. Uses the `cordis.patch.yml` + `dsh.bundle.patch` bundle model. Node requirements match this Harness release: 22.19 or later within 22.x, or 24 or later. Live external-service workflows require separate configuration and validation.
-
-## Installation
-
-```bash
-dsh plugin --profile web add dsh-ppt
-```
-
-After restart, the `ppt_create` / `ppt_themes` tools and the `dsh-ppt` skill are available. The plugin ships with an empty config and **won't crash startup**.
-
-## Uninstall
-
-```bash
-dsh plugin --profile web remove dsh-ppt
-```
-
-Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
-
-
-## Quick start
-
-### Inside DSH (recommended)
-
-```
-1. ppt_themes { preview: true, outputDir: "dist" }   # themes + gallery
-2. ppt_create {
-     title: "Fewer Meetings",
-     content: "# Problem\n- Too many meetings\n\n# Solution\n- Async decisions",
-     theme: "data",
-     lang: "en"
-   }
-3. Open the returned HTML path in a browser; edit the PPTX in PowerPoint / WPS / Keynote
-```
-
-### Any harness (standalone SKILL.md)
-
-Copy `skills/dsh-ppt/` to any Agent Skills directory, then:
-
-```bash
-node <skill-dir>/scripts/build-deck.mjs \
-  --title "Product Launch" \
-  --content deck.md \
-  --theme data \
-  --lang en \
-  --out dist/deck
-```
-
-Artifacts:
-
-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).
-
-| File | Purpose |
-| --- | --- |
-| `*.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 |
-| `*.pptx` | Editable 16:9 presentation (hand-written OOXML, zip via `node:zlib`, no third-party deps) |
-| `*.json` | Structured manifest (version, theme, language, slides) |
-
-## Built-in themes
-
-| ID | Name | Mood | Best for |
-| --- | --- | --- | --- |
-| `data` | Data Drift (default) | Futuristic / immersive | AI, tech launches, research |
-| `swiss` | Swiss Pulse | Precise / rational | Data, SaaS, developer tools |
-| `velvet` | Velvet Standard | Premium / restrained | Executive decks, brand, investor pitches |
-| `soft` | Soft Signal | Warm / human | Brand stories, training, personal talks |
-| `bold` | Maximalist Type | Loud / kinetic | Product launches, events, big moments |
-
-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.
-
-## Markdown input rules
-
-- The first `# heading` becomes the cover title; its first paragraph becomes the cover subtitle.
-- Each `## section` becomes one slide: lists produce `bullets` slides; empty sections produce `section` dividers.
-- Plain text without headings: the first paragraph is the cover, then every 5 sentences become one slide.
-- A single sentence automatically produces a complete 3-slide structure: cover → core idea → closing.
-- 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.
-- `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.
-- For precise control, use structured `slides` (`cover | section | bullets | statement | quote | table | closing`), with `rows` for tables and `notes` for speaker notes.
-
-## Configuration
-
-No required configuration. Optional:
-
-```yaml
-- id: dsh-ppt
-  config:
-    outputDir: E:\decks   # optional; defaults to the session working directory
-    maxSlides: 40         # optional; default 60 (3–120)
-    defaultTheme: data    # optional; used when ppt_create has no theme
-    defaultLang: en       # optional; used when ppt_create has no lang (zh/en/bilingual)
-```
-
-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.
-
-Output paths resolve against each tool call's `exec.agent.session.header.cwd`: omitted paths use the session directory, relative paths (including plugin configuration) resolve within it, and absolute paths keep their meaning. Direct calls without a session fall back to the process working directory; concurrent sessions never change process cwd. Tools check `exec.signal` before and after loading the engine, so cancelled calls do not proceed to generation. Rendering and writing are synchronous and finish the artifact trio once started.
-
-## Bilingual support
-
-- `lang` argument: `zh` (default) / `en` / `bilingual` controls the player UI, page numbers, and closing defaults.
-- Content language is up to the author: for a bilingual deck, prefer "Chinese title + English subtitle" or generate two decks from the same outline.
-- Plugin docs come in Chinese (README.md) and English (this file); CLI and skill error messages are in Chinese.
-
-## Engineering quality
-
-- Pure Node, zero runtime dependencies: HTML template, OOXML, and zip are hand-written using only `node:fs` / `node:path` / `node:zlib`.
-- The skill and tools share one engine (`skills/dsh-ppt/scripts/deck-core.mjs`), so DSH and bare-skill output are identical.
-- Unit tests cover registration contracts, JSON Schema, theme resolution, Markdown parsing, artifact generation, PPTX part integrity, and the CLI.
-- No `eval` / `child_process` / secrets; artifacts are only written to the user-specified local directory.
-
-## Development
-
-```sh
-pnpm install
-pnpm run build      # tsc → lib/
-pnpm test           # build + node --test (registration/config/engine/CLI)
-pnpm run smoke:cli  # bare CLI smoke test, generates .smoke-deck
-```
-
-## Known limitations
-
-- The PPTX uses a blank layout plus text boxes: text is editable in PowerPoint / WPS, but no smart master placeholders yet.
-- A one-sentence input produces a minimal 3-slide structure; for richer decks, expand the content into a Markdown outline first.
-- `bilingual` only localizes the player UI; it does not translate content.
-- Charts and images are not supported yet; speaker notes and HTML/PPTX motion are already supported.
-
-## License
-
-MIT. Community plugin, not affiliated with DeepSeek; `@deepseek-ai/*` is an officially reserved namespace.
-
-## Related projects
-
-- [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) — HTML video skills (source of this plugin's visual styles)
-- [dsh-remotion](https://github.com/STARDUSTLC666/dsh-remotion) — React programmatic video skills
-- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — Email toolset
+Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. All 70 plugin tests pass in an isolated environment; all 18 plugins mount together in one host registering 1 skills and 2 tools, with tool schemas and health-check contracts passing. No live ports or external services were exercised in this round.
+
+![npm](https://img.shields.io/npm/v/dsh-ppt) ![downloads](https://img.shields.io/npm/dm/dsh-ppt) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-ppt) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-ppt?style=social)
+
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
+> **One sentence or one document → a complete presentation**: HTML web slideshow + PPTX export, 5 visual themes, slide transitions + bullet entrance animations, bilingual Chinese/English.
+
+DeepSeek Harness (DSH) presentation skill and tools: the agent prepares content, then generates an offline **HTML slideshow**, editable **PPTX** and **JSON project**. Images/charts use exact-version `@office-kit/pptx@0.21.0`; the shared Node generator supports Windows/macOS/Linux.
+
+## Capabilities
+
+| Capability | Description |
+| --- | --- |
+| `ppt_create` tool | Markdown / structured slides → `*.html` + `*.pptx` + `*.json` |
+| `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 |
+| 11 layouts | cover / section / bullets / statement / quote / table / closing / image / image-left / image-right / chart |
+| Speaker notes | `<!-- note: ... -->` comments or the `notes` field: press `S` in the HTML player; native PPTX notes slides (presenter view) |
+| 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 |
+| Markdown extras | Tables (`\| ... \|`), blockquotes (`>`), and note comments are auto-detected into matching layouts |
+| `dsh-ppt` skill | A complete six-step SOP registered into DSH |
+| Standalone SKILL.md | Copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for cross-harness use |
+| Visual engine | Reuses the hyperframes visual style library; HTML and PPTX share the same theme source |
+
+Example:
+
+> Turn this sentence into a deck: "AI support cuts first response time to 8 seconds", with a dark tech theme.
+>
+> Turn `docs/quarterly-review.md` into a bilingual presentation and export PPTX.
+
+## Compatibility
+
+Plugin and standalone skill require Node `^22.19.0 || >=24.0.0`. No API key or mandatory configuration. The optional renderer is loaded on demand and its absence does not prevent startup or ordinary creation. Windows samples have been exercised in the browser, opened/exported in Microsoft PowerPoint, and rendered using the official Kit; review the actual pages for each new deck.
+
+## Installation
+
+```bash
+dsh plugin --profile web add dsh-ppt
+```
+
+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.
+
+## Uninstall
+
+```bash
+dsh plugin --profile web remove dsh-ppt
+```
+
+Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
+
+
+## Quick start
+
+### Inside DSH (recommended)
+
+```
+1. ppt_themes { preview: true, outputDir: "dist" }   # themes + gallery
+2. ppt_create {
+     title: "Fewer Meetings",
+     content: "# Problem\n- Too many meetings\n\n# Solution\n- Async decisions",
+     theme: "data",
+     lang: "en"
+   }
+3. Open the returned HTML path in a browser; edit the PPTX in PowerPoint / WPS / Keynote
+```
+
+### Any harness (standalone SKILL.md)
+
+Copy `skills/dsh-ppt/` to any Agent Skills directory, then:
+
+```bash
+node <skill-dir>/scripts/build-deck.mjs \
+  --title "Product Launch" \
+  --content deck.md \
+  --theme data \
+  --lang en \
+  --out dist/deck
+```
+
+Artifacts:
+
+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).
+
+| File | Purpose |
+| --- | --- |
+| `*.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 |
+| `*.pptx` | Editable 16:9 presentation (hand-written OOXML, zip via `node:zlib`, no third-party deps) |
+| `*.json` | Structured manifest (version, theme, language, slides) |
+
+## Images, charts, editing and review
+
+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.
+
+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.
+
+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.
+
+`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.
+
+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.
+
+`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.
+
+## Optional PNG/PDF renderer
+
+Install in the plugin's project or standalone skill directory:
+
+```bash
+npm install --ignore-scripts @deepseek-ai/libreoffice-kit@0.1.3
+```
+
+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.
+
+`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).
+
+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.
+
+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.
+
+## Theme palette
+
+| ID | Name | Mood | Best for |
+| --- | --- | --- | --- |
+| `data` | Data Drift (default) | Futuristic / immersive | AI, tech launches, research |
+| `swiss` | Swiss Pulse | Precise / rational | Data, SaaS, developer tools |
+| `velvet` | Velvet Standard | Premium / restrained | Executive decks, brand, investor pitches |
+| `soft` | Soft Signal | Warm / human | Brand stories, training, personal talks |
+| `bold` | Maximalist Type | Loud / kinetic | Product launches, events, big moments |
+
+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.
+
+## Markdown input rules
+
+- The first `# heading` becomes the cover title; its first paragraph becomes the cover subtitle.
+- Each `## section` becomes one slide: lists produce `bullets` slides; empty sections produce `section` dividers.
+- Plain text without headings: the first paragraph is the cover, then every 5 sentences become one slide.
+- A single sentence automatically produces a complete 3-slide structure: cover → core idea → closing.
+- 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.
+- `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.
+- For precise control, use structured `slides` (`cover | section | bullets | statement | quote | table | closing`), with `rows` for tables and `notes` for speaker notes.
+
+## Configuration
+
+No required configuration. Optional:
+
+```yaml
+- id: dsh-ppt
+  config:
+    outputDir: E:\decks   # optional; defaults to the session working directory
+    maxSlides: 40         # optional; default 60 (3–120)
+    defaultTheme: data    # optional; used when ppt_create has no theme
+    defaultLang: en       # optional; used when ppt_create has no lang (zh/en/bilingual)
+```
+
+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.
+
+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.
+
+## Bilingual support
+
+- `lang` argument: `zh` (default) / `en` / `bilingual` controls the player UI, page numbers, and closing defaults.
+- Content language is up to the author: for a bilingual deck, prefer "Chinese title + English subtitle" or generate two decks from the same outline.
+- Plugin docs come in Chinese (README.md) and English (this file); CLI and skill error messages are in Chinese.
+
+## Engineering quality
+
+- Tools and the skill share an asynchronous generator. The legacy synchronous plain-text API remains available.
+- Images and native charts use MIT-licensed `@office-kit/pptx@0.21.0`; optional rendering is loaded on demand.
+- Unit tests cover registration contracts, JSON Schema, theme resolution, Markdown parsing, artifact generation, PPTX part integrity, and the CLI.
+- No `eval` / `child_process` / secrets; artifacts are only written to the user-specified local directory.
+
+## Development
+
+```sh
+pnpm install
+pnpm run build      # tsc → lib/
+pnpm test           # build + node --test (registration/config/engine/CLI)
+pnpm run smoke:cli  # bare CLI smoke test, generates .smoke-deck
+```
+
+## Known limitations
+
+- The PPTX uses a blank layout plus text boxes: text is editable in PowerPoint / WPS, but no smart master placeholders yet.
+- A one-sentence input produces a minimal 3-slide structure; for richer decks, expand the content into a Markdown outline first.
+- `bilingual` only localizes the player UI; it does not translate content.
+- Selected-page editing supports this plugin's JSON project, not arbitrary external PPTX editing.
+- Text fit checks are static estimates; inspect actual rendered output for clipping and font substitution.
+
+## License
+
+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.
+
+## Related projects
+
+- [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) — HTML video skills (source of this plugin's visual styles)
+- [dsh-remotion](https://github.com/STARDUSTLC666/dsh-remotion) — React programmatic video skills
+- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — Email toolset