dsh-ppt 0.21.1 → 0.22.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +16 -0
- package/README.en.md +18 -18
- package/README.md +16 -16
- package/docs/COACHING.md +14 -13
- package/docs/DATA.md +8 -8
- package/docs/REFERENCE.en.md +17 -19
- package/docs/REFERENCE.zh.md +16 -18
- package/docs/USAGE.en.md +107 -60
- package/docs/USAGE.md +115 -84
- package/docs/VALIDATION.md +2 -0
- package/docs/VISUAL.md +27 -20
- package/docs/WORKBENCH.md +17 -6
- package/docs/assets/intro/screen-en.webp +0 -0
- package/docs/assets/intro/screen-zh.webp +0 -0
- package/lib/client.js +905 -46
- package/lib/coaching.d.ts +1 -1
- package/lib/coaching.js +25 -12
- package/lib/config.d.ts +2 -0
- package/lib/config.js +30 -2
- package/lib/execution.d.ts +2 -1
- package/lib/execution.js +21 -1
- package/lib/tools.d.ts +1 -1
- package/lib/tools.js +151 -24
- package/lib/types.d.ts +108 -8
- package/lib/visual.d.ts +3 -1
- package/lib/visual.js +40 -13
- package/lib/workbench-language.js +45 -9
- package/lib/workbench.d.ts +5 -0
- package/lib/workbench.js +485 -9
- package/package.json +8 -3
- package/skills/dsh-ppt/SKILL.md +56 -54
- package/skills/dsh-ppt/package.json +1 -1
- package/skills/dsh-ppt/references/advanced.md +122 -41
- package/skills/dsh-ppt/references/copywriting.md +63 -41
- package/skills/dsh-ppt/references/data.md +83 -36
- package/skills/dsh-ppt/references/syntax.md +157 -28
- package/skills/dsh-ppt/references/themes.md +90 -41
- package/skills/dsh-ppt/references/troubleshooting.md +21 -16
- package/skills/dsh-ppt/scripts/build-deck.mjs +67 -28
- package/skills/dsh-ppt/scripts/deck-absorb.mjs +1029 -0
- package/skills/dsh-ppt/scripts/deck-advanced.mjs +406 -99
- package/skills/dsh-ppt/scripts/deck-core.mjs +568 -717
- package/skills/dsh-ppt/scripts/deck-data-view.mjs +30 -11
- package/skills/dsh-ppt/scripts/deck-data.mjs +35 -5
- package/skills/dsh-ppt/scripts/deck-director.mjs +1717 -0
- package/skills/dsh-ppt/scripts/deck-layouts.mjs +4557 -0
- package/skills/dsh-ppt/scripts/deck-media.mjs +1408 -86
- package/skills/dsh-ppt/scripts/deck-themes.mjs +1503 -0
- package/skills/dsh-ppt/scripts/deck-visual.mjs +133 -31
package/docs/USAGE.md
CHANGED
|
@@ -4,36 +4,36 @@
|
|
|
4
4
|
|
|
5
5
|
## 本次改进
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
7
|
+
- **智能审美托管、6 套母版骨架与深度 PPTX 吸收**:`ppt_create` 默认启用 `theme: "auto"` 按语境与受众自动选定最优主题与母版骨架(裸 CLI 不传 `--theme` 时保持兼容默认 `data`,显式传 `--theme auto` 启用自动选型);`ppt_absorb` 与 `referencePptx`(支持 `cloneStructure: true` / `--clone-structure`)可纯本地解析 OOXML `lumMod`/`tint`/`shade` 修饰色板、字体、母版 Logo、骨架几何(`extractedSkeleton` / `recommendedChrome`)与逐页版式序列(`slideSkeleton[]`),自动执行 WCAG ≥4.5:1 对比度净化。
|
|
8
|
+
- **18 套内置主题、6 套差异化母版骨架、24 种页型与 16 套行业蓝图**:覆盖 12 套明亮主题与 6 套深色主题,匹配 6 套结构差异化的母版骨架(`consulting-classic` / `keynote-spatial` / `editorial-folio` / `saas-bento` / `academic-minimal` / `gov-ceremonial`);新增 `gantt`(甘特图路线图)、`architecture`(分层系统架构)、`harvey`(哈维球竞品矩阵)、`tam`(TAM/SAM/SOM 同心圆)、`org`(组织架构/团队图谱)及 `process` 飞轮变体(`flywheel`),支持 `tableStyle: consulting | booktabs | minimal | banded | harvey`、单页 `chrome`、`columns`、`takeaway` 结论栏与 `source` 来源脚注;图表覆盖 13 类出版级图表与矢量瀑布桥。
|
|
9
|
+
- **风格与母版工作台(Style Studio)**:工作台支持 18 套主题与 **6 套母版骨架(`brand.chromeStyle`)**一键切换、单页一键切换 24 种版式原型与甘特图/哈维球编辑、「+ 新建页面」、拖拽 `.pptx` 展示 `recommendedChrome` 与 `extractedSkeleton` 摘要、HTML ↔ PPTX 并排分屏对照、画布级 AI 视觉修复前后对比(上限 24 页与 12 种无损动作)及最多 8 条叙事金字塔/结论句预审建议。
|
|
10
|
+
- **产物校验与交付包保护**:每次生成保存 HTML / PPTX 校验值。外部修改过成品或旧工程缺少校验记录时,`ppt_edit`、`ppt_undo` 和面板保存会拒绝覆盖。保留 Office 修改后的原件,点击「另存副本」或调用 `ppt_edit({deckPath, saveAs:true})` 从 JSON 重建不同文件名的三件套;副本不导入 Office 修改,使用新工程 ID 和修订号 0。在工作台保存修改后可下载「分享成品包 ZIP」或「完整工程包 ZIP」,单文件 ≤64 MiB、合计 ≤128 MiB,不包含配置、密钥或工作区其他文件。
|
|
10
11
|
|
|
11
12
|
## 能力一览
|
|
12
13
|
|
|
13
14
|
| 能力 | 说明 |
|
|
14
15
|
| --- | --- |
|
|
15
|
-
| `ppt_create` 工具 | Markdown / 结构化 slides → `*.html` + `*.pptx` + `*.json`
|
|
16
|
-
| `
|
|
17
|
-
|
|
|
18
|
-
| `
|
|
19
|
-
| `
|
|
20
|
-
| `
|
|
21
|
-
| `
|
|
16
|
+
| `ppt_create` 工具 | Markdown / 结构化 `slides` → `*.html` + `*.pptx` + `*.json` 三件套;默认 `theme: "auto"` 自动匹配主题与骨架,支持 `referencePptx` 与 `cloneStructure: true` 深度复用参考结构 |
|
|
17
|
+
| `ppt_absorb` 工具 | 本地只读解析参考 `.pptx` 的主题修饰色板、字体、画幅比例、母版骨架几何(`extractedSkeleton` / `recommendedChrome`)、逐页序列(`slideSkeleton`)与可选嵌入 Logo |
|
|
18
|
+
| `ppt_themes` 工具 | 列出 18 套内置主题(12 明亮 + 6 深色)与 6 套母版骨架;传 `preview: true, outputDir: "dist"` 生成主题对比页 + 每套 SVG 色板卡 |
|
|
19
|
+
| 24 种页型与图示 | `cover` / `agenda` / `section` / `bullets` / `statement` / `quote` / `kpi` / `cards` / `comparison` / `matrix` / `process` / `callout` / `gantt` / `architecture` / `harvey` / `tam` / `org` / `table` / `closing` / `image` / `image-left` / `image-right` / `chart` / `chart-split`(兼容 `waterfall`、`gallery`、`flywheel` 别名) |
|
|
20
|
+
| 13 类原生图表 | `column` / `bar` / `stacked-column` / `stacked-bar` / `percent-column` / `percent-bar` / `line` / `area` / `pie` / `doughnut` / `scatter` / `combo` / `waterfall`,支持 `highlight` 焦点项染色 |
|
|
21
|
+
| `ppt_templates` | 16 套场景蓝图:`weekly`、`defense`、`project`、`pitch`、`consulting`、`keynote`、`gov-report`、`workshop`、`architecture-review`、`financial-earnings`、`medical-case`、`postmortem`、`marketing-campaign`、`promotion-review`、`legal-compliance`、`creative-lookbook` |
|
|
22
|
+
| `ppt_edit` / `ppt_undo` | 按页或整套切换主题/品牌/参考 `.pptx`、增删改排页面,支持最多 20 次历史与修订号冲突保护 |
|
|
23
|
+
| `ppt_check` | 只读版面与信息密度检查(含标题动作化、密度过载、连续同构页等提醒),定位具体页;可复核当前渲染收据 |
|
|
24
|
+
| `ppt_render` | 可选官方引擎生成逐页 PNG / PDF,保留源 PPTX,报告缺失字体 |
|
|
22
25
|
| `ppt_data` | 可选来源更新与假设推演,先预览差异再确认保存;见[数据说明](DATA.md) |
|
|
23
|
-
| AI 看图修复 | 可选实际 PPTX
|
|
24
|
-
|
|
|
25
|
-
|
|
|
26
|
-
|
|
|
27
|
-
|
|
|
28
|
-
| `dsh-ppt` 技能 | 完整 SOP 注册进 DSH:从一句话到成品 deck 的六步流水线 |
|
|
29
|
-
| 裸 SKILL.md | 把 `skills/dsh-ppt/` 复制到 Claude Code / Cursor / Gemini CLI / Codex 即可跨 harness 使用 |
|
|
30
|
-
| 视觉引擎 | 复用 hyperframes 视觉风格库,5 套主题 HTML 与 PPTX 同源同色 |
|
|
26
|
+
| AI 看图修复 | 可选实际 PPTX 图片检查(最多 24 页)、12 种无损排版动作、可撤销副本与重新渲染复查;见[看图修复](VISUAL.md) |
|
|
27
|
+
| AI 预审与模拟答辩 | 可选叙事主线(SCQA / 金字塔 / 动作标题)、表达、逻辑与证据缺口预审(最多 8 条)及 7 类听众模拟答辩;见[预审与答辩](COACHING.md) |
|
|
28
|
+
| 品牌与母版 | 共享主色、背景色、文字色、字体、Logo、页脚,HTML 与 PPTX 同源同步 |
|
|
29
|
+
| 演讲者备注与动效 | `<!-- 备注: ... -->` 或 `notes` 字段同步至 HTML 演讲者视图(`V`/`S`)与 PPTX 原生备注页;`motion` 默认开启,`motion: 'off'` / `--motion off` 产出纯静态 |
|
|
30
|
+
| `dsh-ppt` 技能 & 裸 CLI | 完整自动审美指导 SOP 注册进 DSH;也可将 `skills/dsh-ppt/` 复制到 Claude Code / Cursor / Gemini CLI / Codex 跨环境独立运行 |
|
|
31
31
|
|
|
32
32
|
示例对话:
|
|
33
33
|
|
|
34
|
-
> 把这句话做成 PPT:「AI 客服把首次响应时间压缩到 8
|
|
34
|
+
> 把这句话做成 PPT:「AI 客服把首次响应时间压缩到 8 秒」,自动挑一套最稳重的商业汇报风格。
|
|
35
35
|
>
|
|
36
|
-
>
|
|
36
|
+
> 参考 `assets/company-template.pptx` 的配色和字体,把 `docs/季度经营复盘.md` 做成带 KPI 卡片、瀑布图和三线表的可编辑 PPTX。
|
|
37
37
|
|
|
38
38
|
## 安装
|
|
39
39
|
|
|
@@ -41,21 +41,21 @@
|
|
|
41
41
|
dsh plugin --profile web add dsh-ppt
|
|
42
42
|
```
|
|
43
43
|
|
|
44
|
-
桌面版可在插件管理中安装 `dsh-ppt
|
|
44
|
+
桌面版可在插件管理中安装 `dsh-ppt`。更新后重启对应宿主,加载九个工具与 `dsh-ppt` 技能。无需手写 JSON,可直接要求 Agent「按管理层汇报风格自动排版」「参考我的模板 PPTX」「把第三页改成三栏卡片」「撤销上次修改」。
|
|
45
45
|
|
|
46
46
|
## 快速开始
|
|
47
47
|
|
|
48
48
|
### DSH 内(推荐)
|
|
49
49
|
|
|
50
50
|
```
|
|
51
|
-
1. ppt_themes { preview: true, outputDir: "dist" } #
|
|
51
|
+
1. ppt_themes { preview: true, outputDir: "dist" } # 预览 18 套主题 + 生成对比页
|
|
52
52
|
2. ppt_create {
|
|
53
|
-
title: "
|
|
54
|
-
content: "#
|
|
55
|
-
theme: "
|
|
53
|
+
title: "季度经营复盘与下阶段重点",
|
|
54
|
+
content: "# 核心结论\n> [!TAKEAWAY] 首次响应时间降至 8 秒,续费率提升 4.2 个百分点\n\n::: kpi\n- 8s | 首次响应时长 | 环比 -64%\n- 98.5% | 服务达成率 | +4.2%\n:::",
|
|
55
|
+
theme: "auto",
|
|
56
56
|
lang: "zh"
|
|
57
57
|
}
|
|
58
|
-
3. 打开返回的 HTML 路径(浏览器放映),PPTX 用 PowerPoint / WPS / Keynote
|
|
58
|
+
3. 打开返回的 HTML 路径(浏览器放映),PPTX 用 PowerPoint / WPS / Keynote 编辑,或在左侧栏打开演示文稿工作台微调
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
### 任意 harness(裸 SKILL.md)
|
|
@@ -66,58 +66,56 @@ dsh plugin --profile web add dsh-ppt
|
|
|
66
66
|
node <skill-dir>/scripts/build-deck.mjs \
|
|
67
67
|
--title "产品发布" \
|
|
68
68
|
--content deck.md \
|
|
69
|
-
--theme
|
|
69
|
+
--theme auto \
|
|
70
70
|
--lang zh \
|
|
71
71
|
--out dist/deck
|
|
72
72
|
```
|
|
73
73
|
|
|
74
|
-
|
|
74
|
+
裸 CLI 也可使用 `--absorb ref.pptx` 提取参考模板 JSON,或在构建/编辑时传 `--reference-pptx ref.pptx`、`--clone-structure` 与 `--chrome consulting-classic`;未显式传 `--theme` 时 CLI 保持兼容默认 `data`。
|
|
75
75
|
|
|
76
|
-
|
|
76
|
+
输出三件套(默认不覆盖同名产物,存在同名文件时整组追加 `-1`、`-2`… 后缀;仅显式传 `overwrite: true` 或 `--overwrite` 时覆盖):
|
|
77
77
|
|
|
78
78
|
| 文件 | 用途 |
|
|
79
79
|
| --- | --- |
|
|
80
|
-
| `*.html` | 独立网页放映:← → 翻页,V 演讲者视图(独立窗口:真实当前页/下一页预览、缩略图跳页、备注、计时、进度、暂停、字号、黑/白屏),S 备注,G 缩略图总览,F 全屏,P 打印,? 快捷键,Esc 关闭 |
|
|
81
|
-
| `*.pptx` | 16:9
|
|
82
|
-
| `*.json` |
|
|
83
|
-
|
|
84
|
-
## 图片、图表、编辑与交付
|
|
85
|
-
|
|
86
|
-
### 设置页轻量编辑(0.8.0)
|
|
87
|
-
|
|
88
|
-
打开「设置 → 演示文稿」,选择由 `ppt_create`、`ppt_edit` 或 `ppt_check` 登记的本插件工程。点击页码,修改标题、正文、要点和演讲备注;也可点击 HTML 预览中的文字定位字段。上传 PNG/JPEG 会嵌入工程并同步生成 PPTX。页面可上移/下移、复制、删除,均支持撤销。复制会保留图片、图表和备注;最后一页不能删除,最多 120 页。有未保存输入时,先保存或取消再操作页面结构。
|
|
80
|
+
| `*.html` | 独立网页放映:← → 翻页,V 演讲者视图(独立窗口:真实当前页/下一页预览、缩略图跳页、备注、计时、进度、暂停、字号、黑/白屏),S 备注,G 缩略图总览,D 数据推演,F 全屏,P 打印,? 快捷键,Esc 关闭 |
|
|
81
|
+
| `*.pptx` | 16:9 原生可编辑文字、结构化卡片、表格、图片和原生图表(含可编辑工作簿),保留备注与转场 |
|
|
82
|
+
| `*.json` | 工程清单、主题/品牌配置、嵌入资产、稳定页面 ID、修订号、最多 20 次修改历史和质量报告 |
|
|
89
83
|
|
|
90
|
-
|
|
84
|
+
## 工作台、结构化版式、图表与交付
|
|
91
85
|
|
|
92
|
-
|
|
86
|
+
### 演示文稿工作台与风格母版(Style Studio)
|
|
93
87
|
|
|
94
|
-
|
|
88
|
+
打开左侧栏「演示文稿工作台」(或「设置 → 演示文稿」),选择由 `ppt_create`、`ppt_edit` 或 `ppt_check` 登记的本插件工程:
|
|
95
89
|
|
|
96
|
-
|
|
90
|
+
- **内容编辑与一键换版式**:左侧页面栏展示每页版式标签与质量状态圆点,支持「+ 新建页面」按版式原型插入起始页(含甘特图、系统架构、哈维球、TAM/SAM/SOM、组织图谱等),以及上移/下移、复制、删除(保留 1–120 页,均支持撤销)。右侧顶部提供 **24 种版式原型切换器**、变体(`variant`)、单页母版骨架(`chrome`)与疏密(`compact | balanced | airy`)选择,切换版式时自动在要点列表、结构化卡片(`items`)与表格(`rows`)之间无损映射草稿;支持结构化编辑卡片数值/甘特图时间跨度/标签/状态、切换表格样式(咨询表 / 学术三线表 `booktabs` / 极简 / 条纹 / 哈维球 `harvey`)以及编辑底部结论栏(`takeaway`)与来源脚注(`source`)。
|
|
91
|
+
- **风格与母版(Style Studio)**:按「明亮主题(12 套)」与「深色主题(6 套)」分区浏览实时色板与适用场景,一键切换整套文稿主题或 **6 套母版骨架(`brand.chromeStyle`)**;支持自定义品牌色、字体、页脚与 PNG/JPEG Logo;支持拖拽上传自有 `.pptx`(≤10 MiB,浏览器端转交内存解析,绝不读取宿主机任意本地路径)预览 `recommendedChrome`、`extractedSkeleton` 与 `slideSkeleton` 摘要并一键应用。
|
|
92
|
+
- **并排对比与质量定位**:画布区支持「HTML 预览」「PPTX 渲染页」「HTML + PPTX 并排对比」三种视图;点击质量提示行可直接跳转到对应问题页。
|
|
93
|
+
- **并发与资产保护**:保存会原子更新 HTML、PPTX 和 JSON。若助手同时修改了工程,旧修订返回 409 冲突保护,点击「载入最新版本,保留我的输入」核对后再保存。面板上传 PNG/JPEG 每张最多 5 MiB(读取期间切页或取消会自动中止读取)。保存后可单独下载「讲稿 Markdown」(按当前页序生成,不含撤销历史旧备注)。面板仅编辑本插件生成的 JSON 工程,不直接改写外部手工编辑的任意 PPTX。
|
|
97
94
|
|
|
98
|
-
|
|
95
|
+
### 结构化页型、媒体与图表
|
|
99
96
|
|
|
100
|
-
|
|
101
|
-
{ "layout": "image-left", "title": "新版流程减少操作步骤", "image": { "src": "assets/screenshot.png", "alt": "新版流程截图", "fit": "contain" }, "bullets": ["填写内容后即可生成", "修改指定页保留其他页"] }
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
图片只接受本地 PNG/JPEG 或对应 data URI;相对路径按会话工作目录解析。图片嵌入三件套,原文件移走后仍可使用并撤销修改。每张最多 5 MiB / 3200 万像素,工程图片总量最多 32 MiB。不自动下载外链或转换 SVG。`fit` 为 `contain`(完整显示)或 `cover`(居中裁切)。
|
|
97
|
+
结构化 `slides` 支持全部 24 种标准版式与专业图示:
|
|
105
98
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
99
|
+
- **结构化卡片 / KPI / 对比 / 矩阵 / 流程 / 甘特图 / 架构 / TAM / 组织图谱**:通过 `items` 数组传入最多 8 项,每项支持 `{ tag, title, text, value, unit, delta, start, span, milestone, role, conversion, status, bullets }`,甘特图支持 `columns: ["Q1","Q2","Q3","Q4"]`,并可搭配 `chrome`、`takeaway`(核心结论条)与 `source`(数据来源角注)。
|
|
100
|
+
- **哈维球矩阵与表格**(`harvey | table`):支持 `tableStyle: "consulting" | "booktabs" | "minimal" | "banded" | "harvey"`;`harvey` 矩阵支持在单元格中使用 `●` / `◕` / `◑` / `◔` / `○` / `✓` / `✗` 渲染原生矢量哈维球与状态符号。
|
|
101
|
+
- **图文页**(`image | image-left | image-right`):
|
|
102
|
+
```json
|
|
103
|
+
{ "layout": "image-left", "title": "新版流程减少 40% 手工核对步骤", "image": { "src": "assets/screenshot.png", "alt": "新版流程截图", "fit": "contain" }, "bullets": ["填写内容后即可同源生成", "修改指定页保留其他页"], "takeaway": "上线首周人工返工率下降至 1.2%" }
|
|
104
|
+
```
|
|
105
|
+
图片只接受本地 PNG/JPEG 或对应 data URI(相对路径按会话 cwd 解析),嵌入三件套后原文件移走仍可编辑与撤销;单张 ≤5 MiB / 3200 万像素,整套资产 ≤32 MiB,不自动联网下载外链或转换 SVG。
|
|
106
|
+
- **原生图表页**(`chart | chart-split`):
|
|
107
|
+
```json
|
|
108
|
+
{ "layout": "chart-split", "title": "三季度自动化处理量翻倍增长", "chart": { "kind": "column", "categories": ["七月", "八月", "九月"], "series": [{ "name": "处理量", "values": [32, 54, 96] }], "unit": "万单", "highlight": 2 }, "bullets": ["九月峰值突破 96 万单", "自动化分流占比达 78%"], "source": "来源:运营中心月报(2026 Q3)" }
|
|
109
|
+
```
|
|
110
|
+
支持 `column | bar | stacked-column | stacked-bar | percent-column | percent-bar | line | area | pie | doughnut | scatter | combo | waterfall`(也可传表头 + 数据行的 `rows`)。数值须有限且系列长度一致;饼图/环形图要求单个非负系列且总和大于零。HTML 输出无障碍 SVG 与读屏数据表,PPTX 写入原生可编辑图表与工作簿。
|
|
111
111
|
|
|
112
|
-
支持 `
|
|
112
|
+
`brand` 支持 `name`、`primaryColor`、`backgroundColor`、`textColor`、`fontFamily`、`logo`、`footer`、`chromeStyle`(颜色为 `#RRGGBB`,字体请选接收方设备常见字体)。`template` 支持 `weekly | defense | project | pitch | consulting | keynote | gov-report | workshop | architecture-review | financial-earnings | medical-case | postmortem | marketing-campaign | promotion-review | legal-compliance | creative-lookbook` 共 16 套行业蓝图,提供正文时不会覆盖用户原有叙事。
|
|
113
113
|
|
|
114
|
-
|
|
114
|
+
编辑与结构操作示例:
|
|
115
|
+
- 单页与整套主题更新:`ppt_edit { deckPath: "report.json", expectedRevision: 0, theme: "consulting", edits: [{ slide: 3, patch: { layout: "kpi", title: "关键经营指标全面达标", takeaway: "三大核心指标均超季度目标" } }] }`
|
|
116
|
+
- 结构调整:`ppt_edit { deckPath: "report.json", expectedRevision: 0, duplicate: [2], remove: [4], append: [{ layout: "callout", title: "下一步行动" }] }`(引用按修改前页码或稳定 ID 解析,最终保留 1–120 页,可与文字编辑合并为一次可撤销操作)。
|
|
115
117
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
结构示例:`ppt_edit { deckPath: "report.json", expectedRevision: 0, duplicate: [2], remove: [3] }`。引用按修改前的页码或稳定 ID 解析;副本紧跟原页并获得新 ID,其他页面的 ID 保持不变。同一页不能同时复制和删除,最终须保留 1–120 页;可与文字修改、排序合并为一次可撤销操作。
|
|
119
|
-
|
|
120
|
-
`deliveryStatus: draft` 表示模板未填完;`ready-for-review` 表示可开始检查。静态估算、PPTX 渲染和视觉检查分开记录。生成或渲染成功不会自动代表视觉验收通过,应查看 HTML 和每页图片,修正问题后交付。
|
|
118
|
+
`deliveryStatus: draft` 表示模板槽位尚未填完;`ready-for-review` 表示可进入复核。静态估算、PPTX 渲染与 AI 视觉检查分开记录;生成或渲染成功不自动代表人工视觉验收通过,交付前请核对 HTML 与实际渲染页。
|
|
121
119
|
|
|
122
120
|
## 可选 PNG / PDF 渲染
|
|
123
121
|
|
|
@@ -133,29 +131,62 @@ npm install --ignore-scripts @deepseek-ai/libreoffice-kit@0.2.3
|
|
|
133
131
|
|
|
134
132
|
`ppt_render { pptxPath: "report.pptx", format: "both" }` 读取最终 PPTX,生成逐页 PNG、PDF 和 `render-receipt.json`,不重新保存可编辑源文稿。`ppt_check` 可携带返回的 `receiptPath` 作为 `renderReceipt`,核验源文件和每个输出的摘要;编辑源文稿或修改输出后旧收据失效。静态产物不保留动画;LibreOffice 与 PowerPoint/WPS 的排版可能不同。字体诊断不保证每个字符,也不自动安装字体。更多细节见 [渲染说明](../docs/LIBREOFFICE-INTEGRATION-2026-10-01.md)。
|
|
135
133
|
|
|
136
|
-
CLI 支持 `--slides @slides.json`、`--brand @brand.json`、`--template
|
|
134
|
+
CLI 支持 `--slides @slides.json`、`--brand @brand.json`、`--reference-pptx ref.pptx`、`--absorb ref.pptx`、`--template consulting`、`--edit report.json --edits @edits.json --revision 0`、`--undo report.json --revision 1`、`--check report.json`、`--render report.pptx --format both`。收据核验用 `--check report.json --render-receipt path/to/render-receipt.json`;失败返回非零退出码。
|
|
137
135
|
|
|
138
|
-
##
|
|
136
|
+
## 内置主题(18 套)与 6 套母版骨架
|
|
139
137
|
|
|
140
|
-
|
|
138
|
+
### 6 套差异化母版骨架(`chromeStyle`)
|
|
139
|
+
|
|
140
|
+
| ID | 名称 | 结构特征 | 默认绑定主题 |
|
|
141
|
+
| --- | --- | --- | --- |
|
|
142
|
+
| `consulting-classic` | 麦肯锡直角 | 0px 直角卡片 + 左侧强调竖线 + 右上章节胶囊 + 0.75pt 页眉线 | `consulting`、`cobalt-cream`、`financial-ft` |
|
|
143
|
+
| `keynote-spatial` | Apple 空间留白 | 无顶部分隔线 + 16pt 留白无边框浮卡 + 极简底栏结论 | `keynote-light`、`bold` |
|
|
144
|
+
| `editorial-folio` | 杂志社论书脊 | 顶栏刊号 + 页码移至右上角 + 0px 锐利边线 + 衬线大序号 | `editorial-forest`、`cartesian`、`velvet`、`luxury-noir` |
|
|
145
|
+
| `saas-bento` | 黑曜石 Bento | 10pt 圆角 `surface1` 描边网格 + 主卡强调高亮 + 等宽标签 | `linear-dark`、`swiss`、`data`、`soft` |
|
|
146
|
+
| `academic-minimal` | 学术顶栏横幅 | Beamer 通栏色带页眉 + 三段学术底栏(来源 \| 章节 \| 页码) | `academic`、`course-sage`、`medical-clean` |
|
|
147
|
+
| `gov-ceremonial` | 东方政务双线 | 主金双线页眉 + `【01 · 章节】` 标识 + 对称暖纸卡片 | `exec-jilan`、`exec-palace` |
|
|
148
|
+
|
|
149
|
+
### 明亮主题(12 套,推荐日常投影、打印、咨询、政务、医疗与学术答辩)
|
|
150
|
+
|
|
151
|
+
| ID | 名称 | 情绪 | 适用场景 |
|
|
152
|
+
| --- | --- | --- | --- |
|
|
153
|
+
| `consulting` | 蔚蓝战略(`auto` 商务默认) | 权威 / 清晰 | 管理咨询、商业分析、经营汇报、项目复盘 |
|
|
154
|
+
| `cobalt-cream` | 钴蓝简报 | 理性纸感 / 现代简报 | 产品方案、B2B 提案、研究简报、技术方案 |
|
|
155
|
+
| `exec-jilan` | 霁蓝政务 | 沉稳 / 权威 | 集团汇报、政企沟通、重大立项 |
|
|
156
|
+
| `exec-palace` | 故宫丹宸 | 庄重 / 典雅 | 政务总结、年度述职、庆典与典礼汇报 |
|
|
157
|
+
| `academic` | 清澄学术 | 克制 / 规范 | 论文答辩、基金申报、学术研讨会 |
|
|
158
|
+
| `editorial-forest` | 森系社论 | 知性 / 叙事 | 行业研究报告、ESG 与趋势白皮书 |
|
|
159
|
+
| `cartesian` | 暖石极简 | 极简 / 几何 | 架构评审、工程复盘、设计方法论 |
|
|
160
|
+
| `course-sage` | 知行讲义 | 清爽 / 易读 | 课程培训、工作坊、教学讲义 |
|
|
161
|
+
| `soft` | 柔和信号 | 温暖 / 人本 | 品牌故事、内部赋能、团队分享 |
|
|
162
|
+
| `keynote-light` | 库比蒂诺留白 | 纯净 / 空间留白 | 苹果风产品发布、高端品牌简报 |
|
|
163
|
+
| `financial-ft` | 金融时报 | 权威 / 财经纸感 | 财报发布、投研路演、宏观分析 |
|
|
164
|
+
| `medical-clean` | 仁心临床 | 洁净 / 严谨 | 临床病例汇报、医药研发、生物健康评审 |
|
|
165
|
+
|
|
166
|
+
### 深色主题(6 套,推荐大屏发布会、科技路演、奢侈策展与沉浸式演示)
|
|
167
|
+
|
|
168
|
+
| ID | 名称 | 情绪 | 适用场景 |
|
|
141
169
|
| --- | --- | --- | --- |
|
|
142
|
-
| `data` |
|
|
143
|
-
| `swiss` | 瑞士脉冲 | 精准 / 理性 |
|
|
144
|
-
| `velvet` | 天鹅绒标准 | 高级 / 克制 |
|
|
145
|
-
| `
|
|
146
|
-
| `
|
|
170
|
+
| `data` | 数据漂移(CLI 兼容默认) | 未来 / 沉浸 | AI、技术发布、实时数据大屏 |
|
|
171
|
+
| `swiss` | 瑞士脉冲 | 精准 / 理性 | 数据汇报、SaaS 产品、开发者工具 |
|
|
172
|
+
| `velvet` | 天鹅绒标准 | 高级 / 克制 | 高端品牌、投资人闭门路演 |
|
|
173
|
+
| `bold` | 极繁大字 | 大声 / 动能 | 发布会金句、活动开场、大事件宣言 |
|
|
174
|
+
| `linear-dark` | 黑曜石路演 | 锐利 / 现代 | 现代软件发布、创业融资 Pitch |
|
|
175
|
+
| `luxury-noir` | 黑金策展 | 奢雅 / 社论暗调 | 创意 Lookbook、奢侈品牌策展、高端发布 |
|
|
147
176
|
|
|
148
|
-
|
|
177
|
+
完整色板与排版令牌见 `skills/dsh-ppt/references/themes.md`。也可运行 `ppt_themes { preview: true, outputDir: "dist" }` 生成 18 套并排对比页与 SVG 色板卡。
|
|
149
178
|
|
|
150
179
|
## Markdown 输入规则
|
|
151
180
|
|
|
152
181
|
- 第一个 `# 标题` → 封面标题;其下第一段 → 封面副标题。
|
|
153
|
-
- 每个 `## 小节` →
|
|
154
|
-
-
|
|
155
|
-
-
|
|
156
|
-
-
|
|
182
|
+
- 每个 `## 小节` → 一页:支持标准 Markdown 列表、引用、表格,也支持语义化指令块自动生成高级版式与专业图示:
|
|
183
|
+
- `::: kpi` / `::: cards` / `::: comparison` / `::: matrix` / `::: process` / `::: callout` / `::: agenda` / `::: gantt` / `::: architecture` / `::: harvey` / `::: tam` / `::: org` → 自动解析为对应结构化卡片、专业图示或哈维球矩阵页。
|
|
184
|
+
- `> [!TAKEAWAY] 一句话核心结论` → 提取为当前页底部强调结论栏(`takeaway`)。
|
|
185
|
+
- `<!-- 来源: ... -->` 或 `<!-- source: ... -->` → 提取为页面来源角注(`source`);`<!-- 备注: ... -->` → 提取为演讲者备注(`notes`)。
|
|
186
|
+
- 没有标题的纯文本 → 第一段作封面,后续每 5 句一页;只有一句话 → 自动生成「封面 → 核心观点 → 结束页」三页完整结构。
|
|
187
|
+
- 长表格自动分页:每页重复表头,最多 8 行数据;备注只放第一页。支持 `tableStyle`(`consulting | booktabs | minimal | banded | harvey`),超限会明确提示拆分,短行自动补齐,三种产物数据一致。
|
|
157
188
|
- `maxSlides` 计算分页后的总页数;超过限制时先报错,不落盘、不静默删掉中间页。可提高配置上限(最多 120)或拆分文稿。
|
|
158
|
-
-
|
|
189
|
+
- 需要精确控制时直接传结构化 `slides`,支持全部 24 种 `layout`、`chrome`、`columns`、`items`、`rows`、`chart`、`image`、`takeaway`、`source` 与 `notes`。
|
|
159
190
|
|
|
160
191
|
## 配置
|
|
161
192
|
|
|
@@ -166,7 +197,7 @@ CLI 支持 `--slides @slides.json`、`--brand @brand.json`、`--template weekly`
|
|
|
166
197
|
config:
|
|
167
198
|
outputDir: E:\decks # 可选;默认会话工作目录
|
|
168
199
|
maxSlides: 40 # 可选;默认 60(3–120)
|
|
169
|
-
defaultTheme:
|
|
200
|
+
defaultTheme: auto # 可选;ppt_create 未指定 theme 时使用(支持 auto 或 18 套主题 ID)
|
|
170
201
|
defaultLang: zh # 可选;ppt_create 未指定 lang 时使用(zh/en/bilingual)
|
|
171
202
|
```
|
|
172
203
|
|
|
@@ -191,26 +222,26 @@ dsh plugin --profile web remove dsh-ppt
|
|
|
191
222
|
## 工程质量
|
|
192
223
|
|
|
193
224
|
- 技能和工具共用异步生成器;纯文本的旧同步 API 保留,媒体输入会明确要求 `buildDeckAsync`。
|
|
194
|
-
- 图片与原生图表采用 MIT 的 `@office-kit/pptx@0.21.0
|
|
195
|
-
- 单元测试覆盖注册契约、JSON Schema
|
|
225
|
+
- 图片与原生图表采用 MIT 的 `@office-kit/pptx@0.21.0`;参考 `.pptx` 吸收基于本地 `fflate` + OOXML 安全解析(防 ZIP 炸弹与路径穿越);可选渲染引擎按需加载。
|
|
226
|
+
- 单元测试覆盖注册契约、JSON Schema、18 套主题、6 套母版骨架与自动选型、24 种版式与专业图示、16 套行业蓝图、13 类图表、深度参考 `.pptx` 吸收(`cloneStructure`)、三件套落盘、PPTX 部件完整性、工作台安全边界与 CLI。
|
|
196
227
|
- 无 `eval` / `child_process` / 密钥;产物只写用户指定的本地目录。
|
|
197
228
|
|
|
198
229
|
## 开发
|
|
199
230
|
|
|
200
231
|
```sh
|
|
201
232
|
pnpm install
|
|
202
|
-
pnpm run build # tsc → lib/
|
|
203
|
-
pnpm test # 构建 + node --test
|
|
233
|
+
pnpm run build # tsc + 客户端工作台打包 → lib/
|
|
234
|
+
pnpm test # 构建 + node --test(注册/配置/引擎/图表/吸收/工作台/CLI)
|
|
204
235
|
pnpm run smoke:cli # 裸 CLI 冒烟,生成 .smoke-deck
|
|
205
236
|
```
|
|
206
237
|
|
|
207
238
|
## 已知限制
|
|
208
239
|
|
|
209
|
-
- PPTX
|
|
210
|
-
-
|
|
211
|
-
- `bilingual`
|
|
212
|
-
- 按页编辑仅支持本插件 JSON
|
|
213
|
-
-
|
|
240
|
+
- PPTX 采用精确定位原生形状、表格、图表与文本框生成:PowerPoint / WPS / Keynote 中可正常编辑文字与图表数据,但暂不绑定复杂动态母版占位符继承链。
|
|
241
|
+
- `ppt_absorb` / `referencePptx`(含 `cloneStructure`)提取参考 `.pptx` 的配色、字体、画幅比例、母版骨架几何与版式序列,不原样复制外部幻灯片的正文文案。
|
|
242
|
+
- `bilingual` 只双语化播放器与工作台界面,不自动翻译用户正文内容。
|
|
243
|
+
- 按页编辑仅支持本插件 JSON 工程,不直接导入任意外部 PPTX 编辑。
|
|
244
|
+
- 静态质量检查包含版面估算与信息密度建议;实际字体替换与像素级排版核验请结合渲染图与视觉检查。
|
|
214
245
|
|
|
215
246
|
## 协议
|
|
216
247
|
|
package/docs/VALIDATION.md
CHANGED
|
@@ -6,6 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
## 最新记录
|
|
8
8
|
|
|
9
|
+
**0.22.0 深度换骨与实机渲染验收(2026-11-18)**:311 / 311 项自动化测试全部通过;`tsc` 与客户端打包 0 错误;`@office-kit/pptx` `validatePresentation()` 0 错误;实机 `@deepseek-ai/libreoffice-kit` 无头渲染(`missingFonts: []`)逐页目视核验全部 6 套母版骨架、5 大新增原生专业图示(`gantt`、`architecture`、`harvey`、`tam`、`org`)、`flywheel`/`funnel` 及 7 份野生 `.pptx` 深度骨架吸收(`cloneStructure: true`)。
|
|
10
|
+
|
|
9
11
|
[0.19.0 分享成品包验收](validation-0.19.0.md):208 项 Windows 测试、官方 DSH Web 实际保存与两种 ZIP 下载、离线 HTML、三页最终 PPTX 原生渲染及逐页目视检查、中英文与深色窄屏。Electron 专属行为与真实 Office 应用本轮未测。
|
|
10
12
|
|
|
11
13
|
[0.16.0 看图检查与排版修复验收](validation-0.16.0.md):200 项测试、真实 DSH 图片与模型接口、实际模型样例、修复副本复查、中文操作与英文深色窄屏、官方 CLI 全新安装。AI 检查结果与人工 / 桌面原生验收分开记录。
|
package/docs/VISUAL.md
CHANGED
|
@@ -2,31 +2,38 @@
|
|
|
2
2
|
|
|
3
3
|
[返回简介](../README.md) · [English](#english)
|
|
4
4
|
|
|
5
|
-
普通生成仍直接提供 PPTX、HTML
|
|
5
|
+
普通生成仍直接提供 PPTX、HTML 和工程文件。需要进一步检查版面质量与视觉美感时,可在工作台打开工程后切换至 **视觉检查(Visual review)** 分栏(或通过 **设置 → 演示文稿 → 打开工程 → 视觉检查与修复**)主动开启。
|
|
6
6
|
|
|
7
7
|
模型目录可随 DSH 更新。点击“刷新视觉模型”会保留仍然可用的原选择;原模型下线时清空选择,重新选定后才能开始,不会自动换成另一个模型。
|
|
8
8
|
|
|
9
9
|
## 怎么用
|
|
10
10
|
|
|
11
|
-
1. 选择 DSH 已配置、明确声明支持图片输入的视觉模型。选当前页,或一次检查最多
|
|
11
|
+
1. 选择 DSH 已配置、明确声明支持图片输入的视觉模型。选当前页,或一次检查最多 **24 页**原始页面。
|
|
12
12
|
2. 选择“仅看图检查”,或最多自动修复 1 / 2 轮。开始前会显示发送范围与调用上限。
|
|
13
|
-
3. 插件读取当前实际 PPTX,用官方 LibreOffice Kit
|
|
14
|
-
4.
|
|
15
|
-
5.
|
|
13
|
+
3. 插件读取当前实际 PPTX,用官方 LibreOffice Kit 渲染逐页 PNG,然后按**双层审美与版面标尺**(硬性裁切/重叠/溢出 + 留白呼吸感、信息密度、字号层级、图表与表格可读性)把所选页图片和页面文字交给模型。
|
|
14
|
+
4. 模型发现可处理的版面或层级问题后,插件保留原稿,生成可撤销副本,执行受控无损修复动作,再读取副本的 PPTX 重新渲染、复查。拆出的新页也会纳入复查。
|
|
15
|
+
5. 在画布中央查看大尺寸「修复前 / 修复后」并排画面,橙框表示模型定位的问题区域。点击“采用修复副本”即可打开复查后的工程;仍有问题时会明确标注。可以随时撤销、下载最新成品或导出 Markdown 检查记录。
|
|
16
16
|
|
|
17
|
-
**一轮修复包括“检查 → 修改 → 再渲染检查”,不是一次模型调用。** 每次调用最多两张图片,每张渲染图最多 4 MiB
|
|
17
|
+
**一轮修复包括“检查 → 修改 → 再渲染检查”,不是一次模型调用。** 每次调用最多两张图片,每张渲染图最多 4 MiB;若选定页面全部发生拆页,后续轮次调用上限按 `min(120, 页数 × 2^轮次)` 受控收敛。24 个原始页面、两轮修复的最坏调用上限为 **84 次**(`12 + 24 + 48`),开始前会明确展示。服务商自身的重试、计费规则仍然适用。
|
|
18
18
|
|
|
19
|
-
##
|
|
19
|
+
## 能自动改什么(12 种无损动作)
|
|
20
20
|
|
|
21
|
-
|
|
|
21
|
+
| 动作 | 保留的内容与效果 |
|
|
22
22
|
| --- | --- |
|
|
23
|
-
|
|
|
24
|
-
|
|
|
25
|
-
|
|
|
26
|
-
|
|
|
27
|
-
|
|
|
28
|
-
|
|
29
|
-
|
|
23
|
+
| `title-size`(标题字号 24–60 pt) | 收敛折行或放大弱标题,原文不改写,PPTX 与 HTML 同步 |
|
|
24
|
+
| `body-size`(正文字号 14–28 pt) | 缓解拥挤或过小字号,原文与要点顺序不变 |
|
|
25
|
+
| `chart-label-size`(图表标签字号 12–24 pt) | 改善坐标轴与数据标签拥挤,分类、系列、数值、单位和公式不改 |
|
|
26
|
+
| `chart-horizontal`(柱状图转横向条形图) | 解决长类别名斜排或重叠,保留全部数据与数字绑定 |
|
|
27
|
+
| `chart-highlight`(突出关键数据项) | 高亮图表焦点柱/序列以强化视觉重心,不改动任何数值 |
|
|
28
|
+
| `image-contain`(图片改为完整显示) | 消除关键截图裁切,使用已有嵌入图片,不新增或读取外部文件 |
|
|
29
|
+
| `swap-image-side`(左右图文对调) | 平衡图文重心与视线流向,保留原图与说明文字 |
|
|
30
|
+
| `density-mode`(页面疏密 `compact` / `balanced` / `airy`) | 调整留白、行距与内边距,缓解呼吸感不足或版面松散 |
|
|
31
|
+
| `switch-layout`(兼容版式无损切换) | 将单调或失衡的列表页映射为更匹配的卡片/对比/分栏版式,不丢字 |
|
|
32
|
+
| `table-style`(表格样式切换) | 在咨询表(`consulting`)、学术三线表(`booktabs`)、极简(`minimal`)与条纹(`banded`)间切换以提升易读性 |
|
|
33
|
+
| `split-bullets`(过密要点拆页) | 自动拆分为连续两页,保留顺序、原文、备注和数字绑定 |
|
|
34
|
+
| `split-table`(过密表格拆页) | 重复表头拆页,保留全部单元格数据、备注与数字绑定 |
|
|
35
|
+
|
|
36
|
+
不能用这 12 种无损动作解决的问题会明确列出说明。插件绝不会根据模型意见捏造内容、重写业务结论、替换数字、安装系统字体或联网下载图片,也不会把“未发现明显问题”当作人工最终验收通过。缺失字体会单独报告。
|
|
30
37
|
|
|
31
38
|
## 模型与渲染条件
|
|
32
39
|
|
|
@@ -45,14 +52,14 @@
|
|
|
45
52
|
|
|
46
53
|
## English
|
|
47
54
|
|
|
48
|
-
Open **Settings → Presentations → a project → Visual review and repair
|
|
55
|
+
Open the **Visual review** tab in the Presentations workbench (or **Settings → Presentations → a project → Visual review and repair**). Choose a configured image-capable model, the current slide or up to **24** original slides, and inspection only or up to two repair rounds.
|
|
49
56
|
|
|
50
57
|
Refreshing the catalog preserves an available selection by provider and model ID. If that route disappears, selection is cleared and Start stays disabled until you choose again; another model is never substituted automatically.
|
|
51
58
|
|
|
52
|
-
The plugin renders the actual PPTX using the optional official LibreOffice Kit,
|
|
59
|
+
The plugin renders the actual PPTX using the optional official LibreOffice Kit, evaluates both hard layout defects (clipping, overlap, overflow) and visual hierarchy (whitespace, density, typography contrast, chart/table legibility) through native DSH model and attachment services, and records localized findings. Twelve lossless formatting actions may create an undoable copy: `title-size`, `body-size`, `chart-label-size`, `chart-horizontal`, `chart-highlight`, `image-contain`, `swap-image-side`, `density-mode`, `switch-layout`, `table-style`, `split-bullets`, and `split-table`. Original wording, values, formulas, and source bindings remain intact.
|
|
53
60
|
|
|
54
|
-
Each repaired PPTX is rendered and inspected again, including newly split pages.
|
|
61
|
+
Each repaired PPTX is rendered and inspected again, including newly split pages. Inspect the full-width before/after comparison in the center canvas before adopting the copy. AI findings are not human verification. Unsupported issues and missing fonts remain explicit; errors, truncated output, or cancellation stop the run without automatic plugin retries. The source presentation is preserved.
|
|
55
62
|
|
|
56
|
-
Each request carries at most two images. Splitting can increase the scope
|
|
63
|
+
Each request carries at most two images. Splitting can increase the scope up to the per-round cap `min(120, count * 2^round)`; the maximum number of requests is shown before starting (at most **84** for 24 original slides and two repair rounds: `12 + 24 + 48`). Providers may have separate retries or billing. Ordinary generation never starts this optional flow.
|
|
57
64
|
|
|
58
|
-
Records are local and tied to exact project/render hashes. A changed project, PPTX, image or copy cannot be reused as a current review. Deleting a record removes its plugin preview images, not presentation files or the host-managed DSH attachment store.
|
|
65
|
+
Records are local and tied to exact project/render hashes. A changed project, PPTX, image, or copy cannot be reused as a current review. Deleting a record removes its plugin preview images, not presentation files or the host-managed DSH attachment store.
|
package/docs/WORKBENCH.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# dsh-ppt 工作台 / Workbench
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
演示文稿主工作台,提供页面栏、画布区与五栏属性面板(内容编辑、风格与母版、视觉检查、演练、数据与推演);支持一键切换 18 套主题、6 套母版骨架与 24 种版式原型、拖拽深度吸收参考 `.pptx` 配色与骨架、HTML ↔ PPTX 并排对比及画布级视觉修复前后对照,保留跨栏推演联动、未保存保护和画面内全屏退出。
|
|
4
4
|
|
|
5
|
-
Presentation workbench with slide
|
|
5
|
+
Presentation workbench with slide rail, split-capable canvas, and five inspector tabs (Edit content, Style Studio, Visual review, Rehearsal, Data and what-if); supports 1-click switching across 18 themes, 6 master chrome skeletons, and 24 slide archetypes, in-memory deep `.pptx` style & skeleton absorption, HTML ↔ PPTX side-by-side comparison, and full-width Vision QA before/after diffs while preserving live what-if previews, dirty-edit guards, and fullscreen exit controls.
|
|
6
6
|
|
|
7
7
|
## 使用 / Use
|
|
8
8
|
|
|
@@ -14,6 +14,17 @@ Update the plugin, restart DSH and open its native sidebar panel (or More if it
|
|
|
14
14
|
|
|
15
15
|
The UI follows host language and theme without translating user content. Narrow master/detail views have a Back action; editors adapt their columns to available space. Destructive actions require confirmation and edits are protected.
|
|
16
16
|
|
|
17
|
+
## 五栏能力与风格母版 / Inspector tabs and Style Studio
|
|
18
|
+
|
|
19
|
+
- **页面栏与新建页面 / Slide rail & New slide**:每张页面卡片显示当前版式标签与质量状态圆点;点击「+ 新建页面 / + New slide」可按 KPI、多栏卡片、双栏对比、四象限、流程、甘特图路线图、分层系统架构、哈维球竞品矩阵、TAM/SAM/SOM 同心圆、组织/团队图谱、三线表、核心结论等原型直接追加起始页(上限 120 页,支持排序、复制、删除与撤销)。
|
|
20
|
+
Each slide card shows its layout badge and quality status dot; **+ New slide** appends a localized starter slide for the chosen archetype (up to 120 slides, undoable alongside reorder, duplicate, and delete).
|
|
21
|
+
- **内容编辑与一键换版式 / Content inspector & archetype switcher**:顶部一键切换 24 种版式原型、变体、单页母版骨架(`chrome`)与疏密模式(`compact | balanced | airy`),自动在要点列表、结构化卡片(`items`,含甘特图 `start`/`span`、时间轴列头 `columns`、团队 `role`、漏斗 `conversion`)和表格(`rows`)之间无损映射草稿;支持切换表格样式(咨询表 `consulting` / 学术三线表 `booktabs` / 极简 `minimal` / 条纹 `banded` / 哈维球矩阵 `harvey`)以及底部结论栏(`takeaway`)和来源角注(`source`)。
|
|
22
|
+
Switch across all 24 archetypes, variants, per-slide `chrome` skeleton, and density modes with lossless draft projection between bullets, structured `items` (including Gantt `start`/`span`, `columns`, `role`, `conversion`), and table `rows`; edit card fields, `tableStyle` (including `harvey`), `takeaway`, and `source` directly.
|
|
23
|
+
- **风格与母版 / Style Studio**:按明亮主题(12 套)与深色主题(6 套)分区展示实时色板和场景标签,支持整套一键换肤、**6 套母版骨架(`brand.chromeStyle`:麦肯锡直角 / Apple 空间留白 / 杂志社论书脊 / 黑曜石 Bento / 学术顶栏横幅 / 东方政务双线)**一键切换、品牌色/字体/页脚/Logo(PNG/JPEG 面板上传)定制,以及拖拽上传参考 `.pptx`(≤10 MiB,仅在内存中解析色板、字体、嵌入 Logo、骨架几何 `extractedSkeleton`、推荐骨架 `recommendedChrome` 与逐页 `slideSkeleton`,绝不读取浏览器传入的任意宿主机本地路径)并一键应用。
|
|
24
|
+
Browse 12 daylight and 6 dark themes with live palette swatches, switch across **6 Master Chrome Skeletons** (`brand.chromeStyle`), edit brand tokens and uploaded PNG/JPEG logos, or drop a reference `.pptx` (`≤10 MiB`, parsed strictly in memory with zero host path access) to preview `extractedSkeleton`, `recommendedChrome`, `slideSkeleton`, and apply extracted colors and recommended styles in 1 click.
|
|
25
|
+
- **画布并排对比与问题定位 / Split canvas & clickable findings**:画布顶部支持切换「HTML 预览」「PPTX 渲染页」与「HTML + PPTX 并排对比」;视觉检查记录可在画布中央展开大尺寸「修复前 / 修复后」对照图;点击底部质量问题行可直接跳到对应页码。
|
|
26
|
+
Toggle HTML preview, rendered PPTX pages, or **HTML + PPTX side-by-side** split view; inspect full-width Vision QA before/after comparisons in the center canvas, and click any quality finding row to jump directly to its slide.
|
|
27
|
+
|
|
17
28
|
## 下载与分享 / Download and share
|
|
18
29
|
|
|
19
30
|
在项目右上角点击「下载成品」。先保存修改,再选择需要的文件:
|
|
@@ -28,9 +39,9 @@ Open **Download output** and save edits first. **Share bundle ZIP** contains the
|
|
|
28
39
|
|
|
29
40
|
## 源码 / Source
|
|
30
41
|
|
|
31
|
-
编辑 templates/client.js
|
|
42
|
+
编辑 `templates/client.js`、`templates/panels/*.js`(含 `editor.js`、`library.js`、`style-studio.js`)与 `templates/workbench-ui.js`,运行 `pnpm run build`。`lib/client.js` 是确定性产物,请随源码提交。公共组件的规范源位于 `dsh-suite/ui/workbench-ui.js`,Suite 的同步脚本显式分发副本;单个仓库可独立构建和安装。
|
|
32
43
|
|
|
33
|
-
Edit the template sources and run pnpm run build
|
|
44
|
+
Edit the template sources (`templates/client.js`, `templates/panels/*.js`, `templates/workbench-ui.js`) and run `pnpm run build`. Commit generated `lib/client.js` with source changes. The vendored UI has no Suite runtime dependency.
|
|
34
45
|
|
|
35
46
|
## 验收范围 / Validation boundary
|
|
36
47
|
|
|
@@ -42,6 +53,6 @@ Edit the template sources and run pnpm run build. Commit generated lib/client.js
|
|
|
42
53
|
|
|
43
54
|
## 工程查找 / Find projects
|
|
44
55
|
|
|
45
|
-
工程列表可按关键词筛选,并按最近更新、最早更新或自然标题顺序排列;多个词需要同时匹配。PPT
|
|
56
|
+
工程列表可按关键词筛选,并按最近更新、最早更新或自然标题顺序排列;多个词需要同时匹配。PPT 只查目录中的标题和工程路径(目录同时缓存主题、页数与修订号供快速预览);视频查标题、正文和模板,当前列表与归档列表各自保留筛选条件。清空搜索会恢复完整列表,返回工程库会保留刚才的搜索和排序。筛选只在本机列表中执行,不读取未选工程的完整文件,也不修改工程内容。
|
|
46
57
|
|
|
47
|
-
Search the local project list and sort by newest update, oldest update or natural title. Multiple terms must all match. PPT searches catalog titles and paths; video searches titles, text and templates, with separate active/archive filters. Clear restores the full list; returning from editing preserves filters. Filtering does not load unselected project files or change project contents.
|
|
58
|
+
Search the local project list and sort by newest update, oldest update or natural title. Multiple terms must all match. PPT searches catalog titles and paths (while caching theme, slide count, and revision metadata in the catalog); video searches titles, text and templates, with separate active/archive filters. Clear restores the full list; returning from editing preserves filters. Filtering does not load unselected project files or change project contents.
|
|
Binary file
|
|
Binary file
|