dsh-ppt 0.13.0 → 0.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +17 -0
- package/README.en.md +50 -47
- package/README.md +52 -48
- package/docs/COACHING.md +44 -0
- package/docs/DATA.md +43 -0
- package/docs/USAGE.en.md +196 -196
- package/docs/USAGE.md +218 -217
- package/docs/VALIDATION.md +4 -0
- package/docs/validation/0.8.0.md +10 -10
- package/docs/validation-0.14.0.md +24 -0
- package/docs/validation-0.15.0.md +25 -0
- package/lib/client.js +613 -326
- package/lib/coaching-model.d.ts +12 -0
- package/lib/coaching-model.js +93 -0
- package/lib/coaching.d.ts +197 -0
- package/lib/coaching.js +317 -0
- package/lib/execution.d.ts +3 -0
- package/lib/execution.js +11 -0
- package/lib/index.d.ts +1 -1
- package/lib/index.js +8 -1
- package/lib/tools.js +27 -0
- package/lib/types.d.ts +43 -0
- package/lib/workbench-language.js +2 -0
- package/lib/workbench.d.ts +4 -0
- package/lib/workbench.js +68 -10
- package/package.json +5 -3
- package/skills/dsh-ppt/SKILL.md +80 -76
- package/skills/dsh-ppt/package.json +11 -11
- package/skills/dsh-ppt/references/advanced.md +41 -41
- package/skills/dsh-ppt/references/data.md +67 -0
- package/skills/dsh-ppt/references/syntax.md +43 -43
- package/skills/dsh-ppt/references/troubleshooting.md +19 -19
- package/skills/dsh-ppt/scripts/build-deck.mjs +3 -0
- package/skills/dsh-ppt/scripts/deck-advanced.mjs +574 -538
- package/skills/dsh-ppt/scripts/deck-core.mjs +2388 -2380
- package/skills/dsh-ppt/scripts/deck-data-math.mjs +76 -0
- package/skills/dsh-ppt/scripts/deck-data-view.mjs +113 -0
- package/skills/dsh-ppt/scripts/deck-data.mjs +190 -0
- package/skills/dsh-ppt/scripts/deck-delivery.mjs +104 -104
- package/skills/dsh-ppt/scripts/deck-render.mjs +270 -270
|
@@ -1,41 +1,41 @@
|
|
|
1
|
-
# 图文、图表、工程编辑与渲染
|
|
2
|
-
|
|
3
|
-
Agent 先准备实际内容,再生成可放映 HTML 与可编辑 PPTX。用户无需填写 JSON。以下是工具接口参考。
|
|
4
|
-
|
|
5
|
-
## 创建
|
|
6
|
-
|
|
7
|
-
`ppt_templates` 提供 weekly、defense、project、pitch 四种结构参考。`ppt_create` 的 `template` 单独使用时生成待填草稿,返回 `deliveryStatus:draft`;提供完成的 content/slides 才能开始成品验收。
|
|
8
|
-
|
|
9
|
-
`slides` 新增 image/image-left/image-right/chart 布局。图片示例:`{layout:"image-left",title:"新版流程更短",image:{src:"assets/flow.png",alt:"新版流程截图",fit:"contain"},bullets:["可直接生成","可修改指定页"]}`。PNG/JPEG 本地路径按会话 cwd 解析,亦支持 data URI;每张5MiB/3200万像素、合计32MiB。图片嵌入工程和输出,移动原文件后仍可使用。contain完整显示,cover居中裁切。外链/SVG需先由明确授权的其他工具准备,不自动下载。
|
|
10
|
-
|
|
11
|
-
图表示例:`{layout:"chart",title:"完成量逐月增加",chart:{kind:"column",categories:["七月","八月","九月"],series:[{name:"完成量",values:[3,5,9]}],unit:"项"}}`。支持 column/bar/line/pie,也可用带表头 rows。长度必须一致,值必须有限;pie仅一个非负系列、正总和。原生PPTX图表包含编辑数据工作簿,HTML有SVG与读屏数据表。
|
|
12
|
-
|
|
13
|
-
共享品牌 `brand:{primaryColor:"#2C9F87",fontFamily:"Microsoft YaHei",logo:"logo.png",footer:"产品团队 · 2026"}`。还可设背景/文字色及name。选择接收方可用字体;字体诊断不自动安装字体。
|
|
14
|
-
|
|
15
|
-
## 修改与撤销
|
|
16
|
-
|
|
17
|
-
先 `ppt_check {deckPath:"report.json"}` 取得当前revision和页面ID。修改:`ppt_edit {deckPath:"report.json",expectedRevision:0,edits:[{slide:3,patch:{title:"新标题",bullets:["事实一","行动"]}}]}`。slide为1起始页码或ID,其他页保留;重复指定页拒绝。可单独修改brand;brand:null清空品牌,logo:null清空Logo,空footer清空页脚。
|
|
18
|
-
|
|
19
|
-
复制与删除:`ppt_edit {deckPath:"report.json",expectedRevision:0,duplicate:[2],remove:[3]}`。两组引用都按修改前的1起始页码或稳定ID解析;副本紧跟原页,获得新ID,并保留图片、图表和备注。同一页不能同时复制和删除,不能重复指定,最终保留1–120页。可与edits和order合为一次修改,先编辑/排序,再复制/删除;order仍需包含每个原始页面ID各一次。
|
|
20
|
-
|
|
21
|
-
编辑会原子更新整套HTML/PPTX/JSON,失败回滚。历史最多20次。`ppt_undo {deckPath:"report.json",expectedRevision:1}` 恢复上次状态,包含页面结构、图片/图表/品牌;revision继续增长,旧修改不可覆盖撤销。仅编辑本插件JSON工程,不导入任意外部PPTX进行修改。表格扩大到需要分页时会要求另建文稿。
|
|
22
|
-
|
|
23
|
-
## 检查与渲染
|
|
24
|
-
|
|
25
|
-
`ppt_check` 定位页面问题,包括密度、估计溢出、7–8列表格14pt、图片缺失/损坏/分辨率、图表标签和对比度。6列以内原生表格17pt。静态估算不能保证字体或视觉布局。
|
|
26
|
-
|
|
27
|
-
可选安装 `npm install --ignore-scripts @deepseek-ai/libreoffice-kit@0.1.5`。Windows还需相应架构的VC++v14运行库。`ppt_render {pptxPath:"report.pptx",format:"both"}` 读取最终PPTX,输出PNG/PDF/收据,不改源文件。默认png,width默认1440(320–3840),timeoutMs默认120000(1000–300000);最多120页,输入64MiB、输出128MiB、单张16MP。缺失引擎返回unavailable及安装说明,普通创建仍可用。
|
|
28
|
-
|
|
29
|
-
查看每页PNG及HTML,必要时在实际PowerPoint/WPS检查编辑、备注和动画。LibreOffice不保证与Office逐像素一致,PNG/PDF不保留动画。成功渲染仍为 `visual:not-verified`,不会自动声称视觉通过。
|
|
30
|
-
|
|
31
|
-
把返回receiptPath传给 `ppt_check {deckPath:"report.json",renderReceipt:".../render-receipt.json"}`。源文件与所有输出的摘要必须匹配;修改/删除后失效,重新渲染。收据是本地完整性记录,非签名证明。
|
|
32
|
-
|
|
33
|
-
## CLI
|
|
34
|
-
|
|
35
|
-
`--slides @slides.json`、`--brand @brand.json`、`--template weekly`。
|
|
36
|
-
|
|
37
|
-
`--edit report.json --edits @edits.json --revision 0`、`--undo report.json --revision 1`。
|
|
38
|
-
|
|
39
|
-
`--check report.json`、`--render report.pptx --format both`、`--check report.json --render-receipt receipt.json`。
|
|
40
|
-
|
|
41
|
-
默认渲染目录在PPTX旁;显式 `--out` 指定基目录,已有目录追加后缀。引擎不可用/静态错误/显式收据失效返回非零退出码。
|
|
1
|
+
# 图文、图表、工程编辑与渲染
|
|
2
|
+
|
|
3
|
+
Agent 先准备实际内容,再生成可放映 HTML 与可编辑 PPTX。用户无需填写 JSON。以下是工具接口参考。
|
|
4
|
+
|
|
5
|
+
## 创建
|
|
6
|
+
|
|
7
|
+
`ppt_templates` 提供 weekly、defense、project、pitch 四种结构参考。`ppt_create` 的 `template` 单独使用时生成待填草稿,返回 `deliveryStatus:draft`;提供完成的 content/slides 才能开始成品验收。
|
|
8
|
+
|
|
9
|
+
`slides` 新增 image/image-left/image-right/chart 布局。图片示例:`{layout:"image-left",title:"新版流程更短",image:{src:"assets/flow.png",alt:"新版流程截图",fit:"contain"},bullets:["可直接生成","可修改指定页"]}`。PNG/JPEG 本地路径按会话 cwd 解析,亦支持 data URI;每张5MiB/3200万像素、合计32MiB。图片嵌入工程和输出,移动原文件后仍可使用。contain完整显示,cover居中裁切。外链/SVG需先由明确授权的其他工具准备,不自动下载。
|
|
10
|
+
|
|
11
|
+
图表示例:`{layout:"chart",title:"完成量逐月增加",chart:{kind:"column",categories:["七月","八月","九月"],series:[{name:"完成量",values:[3,5,9]}],unit:"项"}}`。支持 column/bar/line/pie,也可用带表头 rows。长度必须一致,值必须有限;pie仅一个非负系列、正总和。原生PPTX图表包含编辑数据工作簿,HTML有SVG与读屏数据表。
|
|
12
|
+
|
|
13
|
+
共享品牌 `brand:{primaryColor:"#2C9F87",fontFamily:"Microsoft YaHei",logo:"logo.png",footer:"产品团队 · 2026"}`。还可设背景/文字色及name。选择接收方可用字体;字体诊断不自动安装字体。
|
|
14
|
+
|
|
15
|
+
## 修改与撤销
|
|
16
|
+
|
|
17
|
+
先 `ppt_check {deckPath:"report.json"}` 取得当前revision和页面ID。修改:`ppt_edit {deckPath:"report.json",expectedRevision:0,edits:[{slide:3,patch:{title:"新标题",bullets:["事实一","行动"]}}]}`。slide为1起始页码或ID,其他页保留;重复指定页拒绝。可单独修改brand;brand:null清空品牌,logo:null清空Logo,空footer清空页脚。
|
|
18
|
+
|
|
19
|
+
复制与删除:`ppt_edit {deckPath:"report.json",expectedRevision:0,duplicate:[2],remove:[3]}`。两组引用都按修改前的1起始页码或稳定ID解析;副本紧跟原页,获得新ID,并保留图片、图表和备注。同一页不能同时复制和删除,不能重复指定,最终保留1–120页。可与edits和order合为一次修改,先编辑/排序,再复制/删除;order仍需包含每个原始页面ID各一次。
|
|
20
|
+
|
|
21
|
+
编辑会原子更新整套HTML/PPTX/JSON,失败回滚。历史最多20次。`ppt_undo {deckPath:"report.json",expectedRevision:1}` 恢复上次状态,包含页面结构、图片/图表/品牌;revision继续增长,旧修改不可覆盖撤销。仅编辑本插件JSON工程,不导入任意外部PPTX进行修改。表格扩大到需要分页时会要求另建文稿。
|
|
22
|
+
|
|
23
|
+
## 检查与渲染
|
|
24
|
+
|
|
25
|
+
`ppt_check` 定位页面问题,包括密度、估计溢出、7–8列表格14pt、图片缺失/损坏/分辨率、图表标签和对比度。6列以内原生表格17pt。静态估算不能保证字体或视觉布局。
|
|
26
|
+
|
|
27
|
+
可选安装 `npm install --ignore-scripts @deepseek-ai/libreoffice-kit@0.1.5`。Windows还需相应架构的VC++v14运行库。`ppt_render {pptxPath:"report.pptx",format:"both"}` 读取最终PPTX,输出PNG/PDF/收据,不改源文件。默认png,width默认1440(320–3840),timeoutMs默认120000(1000–300000);最多120页,输入64MiB、输出128MiB、单张16MP。缺失引擎返回unavailable及安装说明,普通创建仍可用。
|
|
28
|
+
|
|
29
|
+
查看每页PNG及HTML,必要时在实际PowerPoint/WPS检查编辑、备注和动画。LibreOffice不保证与Office逐像素一致,PNG/PDF不保留动画。成功渲染仍为 `visual:not-verified`,不会自动声称视觉通过。
|
|
30
|
+
|
|
31
|
+
把返回receiptPath传给 `ppt_check {deckPath:"report.json",renderReceipt:".../render-receipt.json"}`。源文件与所有输出的摘要必须匹配;修改/删除后失效,重新渲染。收据是本地完整性记录,非签名证明。
|
|
32
|
+
|
|
33
|
+
## CLI
|
|
34
|
+
|
|
35
|
+
`--slides @slides.json`、`--brand @brand.json`、`--template weekly`。
|
|
36
|
+
|
|
37
|
+
`--edit report.json --edits @edits.json --revision 0`、`--undo report.json --revision 1`。
|
|
38
|
+
|
|
39
|
+
`--check report.json`、`--render report.pptx --format both`、`--check report.json --render-receipt receipt.json`。
|
|
40
|
+
|
|
41
|
+
默认渲染目录在PPTX旁;显式 `--out` 指定基目录,已有目录追加后缀。引擎不可用/静态错误/显式收据失效返回非零退出码。
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# 数据来源、公式和推演
|
|
2
|
+
|
|
3
|
+
默认直接交付成品。需要解释数字或现场推演时,才在 `ppt_create` 提供 `dataModel` 和结构化 `slides`。不从相同数值猜来源,不虚构单元格、原文或文件。
|
|
4
|
+
|
|
5
|
+
## 最小完整示例
|
|
6
|
+
|
|
7
|
+
```json
|
|
8
|
+
{
|
|
9
|
+
"title": "经营情景",
|
|
10
|
+
"slides": [
|
|
11
|
+
{ "layout": "cover", "title": "经营情景", "subtitle": "基期收入 {{base}}" },
|
|
12
|
+
{ "layout": "bullets", "title": "增长 {{growth}}", "bullets": ["推演收入 {{revenue}}", "以上增长率是讨论假设"] },
|
|
13
|
+
{ "layout": "chart", "title": "收入对比", "chart": { "kind": "column", "categories": ["基期", "情景"], "series": [{"name": "收入", "values": ["{{base}}", "{{revenue}}"]}], "unit": "万元" } }
|
|
14
|
+
],
|
|
15
|
+
"dataModel": {
|
|
16
|
+
"schemaVersion": 1,
|
|
17
|
+
"sources": [{ "id": "sales", "name": "经营数据.csv", "format": "csv", "content": "项目,收入\n基期,1000" }],
|
|
18
|
+
"metrics": [
|
|
19
|
+
{ "id": "base", "label": "基期收入", "kind": "source", "source": { "sourceId": "sales", "cell": "B2" }, "format": { "digits": 0, "unit": "万元" } },
|
|
20
|
+
{ "id": "growth", "label": "增长率", "kind": "input", "value": 0.3, "min": 0, "max": 1, "step": 0.1, "note": "用于讨论的假设,不是业绩承诺", "format": { "style": "percent", "digits": 0 } },
|
|
21
|
+
{ "id": "revenue", "label": "情景收入", "kind": "formula", "formula": "base * (1 + growth)", "format": { "digits": 0, "unit": "万元" } }
|
|
22
|
+
]
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
`source` 是材料中的事实,`input` 是可调假设,`formula` 是推导。百分比以比例计算:30% 是 `0.3`。数字格式为 `number`(默认)或 `percent`、0–6 位小数及可选 `unit`。显示舍入不改变计算输入。
|
|
28
|
+
|
|
29
|
+
文本、要点、表格、备注和图表标签用 `{{metricId}}`;图表数值必须是完整占位符,计算仍使用原始数值。ID 使用字母开头的字母和数字,最多 48 字符。
|
|
30
|
+
|
|
31
|
+
## 来源
|
|
32
|
+
|
|
33
|
+
- 表格:`format:csv/tsv` + `content`,或 `kind:table` + `rows`。地址 `A1–Z500`,首行表头也算第 1 行。引用格必须是单一数值,可含千位逗号或百分号。
|
|
34
|
+
- 材料:`format:text` + `content`,或 `kind:text` + `text`。引用 `{sourceId,line:1,numberIndex:0}`;行号从 1 开始,该行数值序号从 0 开始。日期、版本号也可能被识别为数字,必须检查截取位置。
|
|
35
|
+
- 工具调用可显式给 `path` 读取本地普通文件,按会话 cwd 解析;只读取一次并嵌入,不监视源文件。网页只能使用用户选取或粘贴的内容,不能让浏览器请求读取任意路径。
|
|
36
|
+
- UTF-8 CSV / TSV / TXT / Markdown;最多 8 个来源、合计 1 MiB,表格最多 500 行 / 26 列,各行等宽,每格最多 2000 字符。文本引用行最多 8000 字符。无 XLSX / PDF 数字自动提取。
|
|
37
|
+
|
|
38
|
+
## 算术与范围
|
|
39
|
+
|
|
40
|
+
最多 80 个指标和 12 个假设。假设必须提供有限的 `value/min/max/step`,处于范围和步长网格内,最多 100000 步。计算结果绝对值不超过 1e15。
|
|
41
|
+
|
|
42
|
+
公式允许指标 ID、括号、`+ - * / % **`、一元正负,以及 `min/max/sum/abs/floor/ceil/round`。`round(value,digits)` 的 digits 为 0–6。最多 256 个 AST 节点、32 层表达式和 40 层指标依赖。循环、除零、未知指标、非有限结果会报错。没有 `eval`、属性访问、赋值、网络或文件执行。
|
|
43
|
+
|
|
44
|
+
## 更新与确认
|
|
45
|
+
|
|
46
|
+
```js
|
|
47
|
+
// 1. 先预览,不修改任何成品。
|
|
48
|
+
ppt_data({ action: 'preview', deckPath, expectedRevision: 0,
|
|
49
|
+
parameters: { growth: 0.5 } })
|
|
50
|
+
// 或替换已有来源:sourceUpdates:[{id:'sales',format:'csv',content:'项目,收入\n基期,1200'}]
|
|
51
|
+
|
|
52
|
+
// 2. 向用户展示 changes、affectedSlides 与字段前后差异,确认后再保存。
|
|
53
|
+
ppt_data({ action: 'apply', deckPath, expectedRevision: 0,
|
|
54
|
+
parameters: { growth: 0.5 }, confirmed: true, previewToken: preview.token })
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
应用默认 `saveAs:true`,原稿不变,新副本可撤销;`saveAs:false` 仍执行外部成品修改保护。预览凭证绑定完整工程状态、数据与修订,任一变化都应重新预览。`ppt_undo` 同步恢复来源、参数、公式和页面。
|
|
58
|
+
|
|
59
|
+
`ppt_edit` 会保留未修改字段的绑定。用普通文字替换绑定字段会解除该字段绑定;需要继续联动时保留占位符。确认后的静态 PPTX 备注和下载报告附上引用链。可选 AI 预审也会获得页面相关的公式与假设说明,不把来源关联当作事实核验。
|
|
60
|
+
|
|
61
|
+
离线 HTML 的 `scenario.json` 包含 `schemaVersion/deckId/revision/fingerprint/parameters`。导回相同 DSH 工程后预览、确认,再下载匹配的静态 PPTX;也可作为 `ppt_data.scenario` 传入。不可将旧工程参数强套到新副本。
|
|
62
|
+
|
|
63
|
+
跨 harness:在技能目录 `npm install --ignore-scripts` 后,使用 `node scripts/build-deck.mjs --title ... --slides @slides.json --data-model @model.json --out ...`。直接 JS 调用使用 `deck-advanced.mjs` 的 `buildDeckAsync`;同步 `deck-core.buildDeck` 不支持数据模型。
|
|
64
|
+
|
|
65
|
+
## Dependencies
|
|
66
|
+
|
|
67
|
+
CSV parsing uses [csv-parse](https://csv.js.org/parse/api/sync/) 6.1.0 ([MIT](https://github.com/adaltas/node-csv/blob/master/LICENSE)). Formulas are parsed with [jsep](https://github.com/EricSmekens/jsep) 1.4.0 ([MIT](https://github.com/EricSmekens/jsep/blob/main/LICENSE)); the plugin supplies its own restricted evaluator. Dependencies retain their own license notices. Offline HTML embeds the plugin's validated arithmetic representation and runtime, not those parser implementations.
|
|
@@ -1,44 +1,44 @@
|
|
|
1
|
-
# dsh-ppt 输入语法参考(Markdown / 结构化 slides / 动效)
|
|
2
|
-
|
|
3
|
-
只在需要查具体语法时读本文件;常规流程在 SKILL.md。
|
|
4
|
-
|
|
5
|
-
## Markdown 解析规则
|
|
6
|
-
|
|
7
|
-
`ppt_create` 与 `build-deck.mjs` 按以下规则解析 Markdown:
|
|
8
|
-
|
|
9
|
-
- 第一个 `# 标题` 会成为封面标题;其后的段落/列表成为封面副标题来源。
|
|
10
|
-
- 每个 `## 小节`(或更深标题)生成一页:
|
|
11
|
-
- 有 `- ` / `* ` / `1.` 列表 → `bullets` 页;
|
|
12
|
-
- 无列表且无正文 → `section` 过渡页;
|
|
13
|
-
- 有正文段落 → 正文拆句后作为 bullets。
|
|
14
|
-
- 没有标题的纯文本:第一段第一句为封面副标题,后续段落按 5 句一组拆成要点页。
|
|
15
|
-
- 只有一句话:自动生成「封面 → 核心观点 → 结束页」三页。
|
|
16
|
-
- 需要更精细控制时使用结构化 `slides` JSON,不要和 Markdown 混用。
|
|
17
|
-
|
|
18
|
-
## 进阶语法(自动识别)
|
|
19
|
-
|
|
20
|
-
- **表格**:`| 列 | 列 |` 连续行(第二行 `| --- | --- |` 分隔线)→ 独立 `table` 页(主题色表头;每页 8 行数据,长表格自动续页并重复表头;最多 8 列、每格 60 字符,超限先报错)。数据对比优先用表格,别堆要点。
|
|
21
|
-
- **金句**:`>` 引用块 → 独立 `quote` 页;最后一行写 `—— 出处` 会成为署名。
|
|
22
|
-
- **演讲者备注**:`<!-- 备注: 这页要讲的内容 -->`(或 `<!-- note: ... -->`)附着到该页。备注不进正文:HTML 放映按 `S` 呼出备注面板,PPTX 写入原生备注(演示者视图可见)。为汇报/演讲类 deck 主动写备注(口径、数据出处、应答预案)。
|
|
23
|
-
|
|
24
|
-
## 结构化 slides(高级用法)
|
|
25
|
-
|
|
26
|
-
`ppt_create` 的 `slides` 与 CLI `--slides` 接受 JSON 数组:
|
|
27
|
-
|
|
28
|
-
```json
|
|
29
|
-
[
|
|
30
|
-
{ "layout": "cover", "title": "标题", "subtitle": "副标题", "kicker": "开场", "notes": "开场先自我介绍 30 秒" },
|
|
31
|
-
{ "layout": "section", "kicker": "01", "title": "背景" },
|
|
32
|
-
{ "layout": "bullets", "title": "三个论点", "bullets": ["论点一", "论点二", "论点三"] },
|
|
33
|
-
{ "layout": "table", "title": "业绩对比", "rows": [["大区", "营收"], ["华东", "1.2 亿"]], "notes": "强调华东增速" },
|
|
34
|
-
{ "layout": "quote", "title": "慢就是快。", "subtitle": "创始人" },
|
|
35
|
-
{ "layout": "statement", "title": "核心观点一句话", "subtitle": "支撑说明" },
|
|
36
|
-
{ "layout": "closing", "title": "谢谢", "subtitle": "行动号召" }
|
|
37
|
-
]
|
|
38
|
-
```
|
|
39
|
-
|
|
1
|
+
# dsh-ppt 输入语法参考(Markdown / 结构化 slides / 动效)
|
|
2
|
+
|
|
3
|
+
只在需要查具体语法时读本文件;常规流程在 SKILL.md。
|
|
4
|
+
|
|
5
|
+
## Markdown 解析规则
|
|
6
|
+
|
|
7
|
+
`ppt_create` 与 `build-deck.mjs` 按以下规则解析 Markdown:
|
|
8
|
+
|
|
9
|
+
- 第一个 `# 标题` 会成为封面标题;其后的段落/列表成为封面副标题来源。
|
|
10
|
+
- 每个 `## 小节`(或更深标题)生成一页:
|
|
11
|
+
- 有 `- ` / `* ` / `1.` 列表 → `bullets` 页;
|
|
12
|
+
- 无列表且无正文 → `section` 过渡页;
|
|
13
|
+
- 有正文段落 → 正文拆句后作为 bullets。
|
|
14
|
+
- 没有标题的纯文本:第一段第一句为封面副标题,后续段落按 5 句一组拆成要点页。
|
|
15
|
+
- 只有一句话:自动生成「封面 → 核心观点 → 结束页」三页。
|
|
16
|
+
- 需要更精细控制时使用结构化 `slides` JSON,不要和 Markdown 混用。
|
|
17
|
+
|
|
18
|
+
## 进阶语法(自动识别)
|
|
19
|
+
|
|
20
|
+
- **表格**:`| 列 | 列 |` 连续行(第二行 `| --- | --- |` 分隔线)→ 独立 `table` 页(主题色表头;每页 8 行数据,长表格自动续页并重复表头;最多 8 列、每格 60 字符,超限先报错)。数据对比优先用表格,别堆要点。
|
|
21
|
+
- **金句**:`>` 引用块 → 独立 `quote` 页;最后一行写 `—— 出处` 会成为署名。
|
|
22
|
+
- **演讲者备注**:`<!-- 备注: 这页要讲的内容 -->`(或 `<!-- note: ... -->`)附着到该页。备注不进正文:HTML 放映按 `S` 呼出备注面板,PPTX 写入原生备注(演示者视图可见)。为汇报/演讲类 deck 主动写备注(口径、数据出处、应答预案)。
|
|
23
|
+
|
|
24
|
+
## 结构化 slides(高级用法)
|
|
25
|
+
|
|
26
|
+
`ppt_create` 的 `slides` 与 CLI `--slides` 接受 JSON 数组:
|
|
27
|
+
|
|
28
|
+
```json
|
|
29
|
+
[
|
|
30
|
+
{ "layout": "cover", "title": "标题", "subtitle": "副标题", "kicker": "开场", "notes": "开场先自我介绍 30 秒" },
|
|
31
|
+
{ "layout": "section", "kicker": "01", "title": "背景" },
|
|
32
|
+
{ "layout": "bullets", "title": "三个论点", "bullets": ["论点一", "论点二", "论点三"] },
|
|
33
|
+
{ "layout": "table", "title": "业绩对比", "rows": [["大区", "营收"], ["华东", "1.2 亿"]], "notes": "强调华东增速" },
|
|
34
|
+
{ "layout": "quote", "title": "慢就是快。", "subtitle": "创始人" },
|
|
35
|
+
{ "layout": "statement", "title": "核心观点一句话", "subtitle": "支撑说明" },
|
|
36
|
+
{ "layout": "closing", "title": "谢谢", "subtitle": "行动号召" }
|
|
37
|
+
]
|
|
38
|
+
```
|
|
39
|
+
|
|
40
40
|
`layout` 支持 `cover | section | bullets | statement | quote | table | closing | image | image-left | image-right | chart`;每页可选 `notes`,表格用 `rows`(首行为表头)。结构化表格自动分页,备注只放第一页。分页后超过 maxSlides 会报错,最多120页。图文、图表、品牌及按页编辑见 `advanced.md`。
|
|
41
|
-
|
|
42
|
-
## 动效(motion)
|
|
43
|
-
|
|
44
|
-
默认 `motion: on`:HTML 放映有页间淡入与要点逐条入场;PPTX 每页原生淡入转场,`bullets` 页的要点按「点击一次出现一条」放映。交付严肃/打印场景或用户明确要静态时传 `motion: 'off'`(CLI `--motion off`),产物不含任何动画代码。
|
|
41
|
+
|
|
42
|
+
## 动效(motion)
|
|
43
|
+
|
|
44
|
+
默认 `motion: on`:HTML 放映有页间淡入与要点逐条入场;PPTX 每页原生淡入转场,`bullets` 页的要点按「点击一次出现一条」放映。交付严肃/打印场景或用户明确要静态时传 `motion: 'off'`(CLI `--motion off`),产物不含任何动画代码。
|
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
# dsh-ppt 故障排查
|
|
2
|
-
|
|
3
|
-
只在交付异常时读本文件。
|
|
4
|
-
|
|
5
|
-
| 症状 | 处理 |
|
|
6
|
-
| --- | --- |
|
|
7
|
-
| `ppt_create` 不存在 | 本插件未安装;用 `node <skill-dir>/scripts/build-deck.mjs` 裸 CLI 生成同样三件套 |
|
|
8
|
-
| 未知主题 | `ppt_themes` 或 `--list-themes` 看可用 ID;不要猜 |
|
|
9
|
-
| 内容超过 60 页 | 合并论点,或拆成多个 deck;`maxSlides` 默认 60 |
|
|
10
|
-
| PPTX 打不开 | 确认文件完整(zip 头 `PK`);Office 首次打开空白版式属正常,编辑视图可用 |
|
|
11
|
-
| 双语界面 | `lang: bilingual` 只双语化界面;内容双语由 agent 在写作阶段完成 |
|
|
12
|
-
| 放映没有动画 | `motion` 被设为 `off`;默认 `on` 时 HTML 有转场、PPTX 要点逐条点击出现 |
|
|
13
|
-
| HTML 打印要点缺失 | 打印样式已强制显示全部要点;若仍缺失检查浏览器是否屏蔽了动画样式 |
|
|
14
|
-
| 图片、图表或品牌导出缺少依赖 | 插件重新安装;独立技能目录运行 npm install --ignore-scripts 安装 Office Kit 0.21.0 |
|
|
15
|
-
| ppt_render 返回 unavailable | 在插件项目或技能目录安装可选官方 Kit 0.1.5;Windows检查相应VC++v14运行库 |
|
|
16
|
-
| 收据 not-verified | 源PPTX或输出发生变化、缺失、版本不同;用当前PPTX重新渲染,不沿用旧结论 |
|
|
17
|
-
| 修订号冲突 | 重新用ppt_check读取当前工程,再按新revision编辑 |
|
|
18
|
-
| 模板还有待填写 | 补充实际事实/依据/行动;按草稿说明,不作为成品交付 |
|
|
19
|
-
| 渲染报告缺失字体 | 替换为环境和目标机器可用字体,重新生成并逐页检查;未解决需标注字体问题,不能声称已验收 |
|
|
1
|
+
# dsh-ppt 故障排查
|
|
2
|
+
|
|
3
|
+
只在交付异常时读本文件。
|
|
4
|
+
|
|
5
|
+
| 症状 | 处理 |
|
|
6
|
+
| --- | --- |
|
|
7
|
+
| `ppt_create` 不存在 | 本插件未安装;用 `node <skill-dir>/scripts/build-deck.mjs` 裸 CLI 生成同样三件套 |
|
|
8
|
+
| 未知主题 | `ppt_themes` 或 `--list-themes` 看可用 ID;不要猜 |
|
|
9
|
+
| 内容超过 60 页 | 合并论点,或拆成多个 deck;`maxSlides` 默认 60 |
|
|
10
|
+
| PPTX 打不开 | 确认文件完整(zip 头 `PK`);Office 首次打开空白版式属正常,编辑视图可用 |
|
|
11
|
+
| 双语界面 | `lang: bilingual` 只双语化界面;内容双语由 agent 在写作阶段完成 |
|
|
12
|
+
| 放映没有动画 | `motion` 被设为 `off`;默认 `on` 时 HTML 有转场、PPTX 要点逐条点击出现 |
|
|
13
|
+
| HTML 打印要点缺失 | 打印样式已强制显示全部要点;若仍缺失检查浏览器是否屏蔽了动画样式 |
|
|
14
|
+
| 图片、图表或品牌导出缺少依赖 | 插件重新安装;独立技能目录运行 npm install --ignore-scripts 安装 Office Kit 0.21.0 |
|
|
15
|
+
| ppt_render 返回 unavailable | 在插件项目或技能目录安装可选官方 Kit 0.1.5;Windows检查相应VC++v14运行库 |
|
|
16
|
+
| 收据 not-verified | 源PPTX或输出发生变化、缺失、版本不同;用当前PPTX重新渲染,不沿用旧结论 |
|
|
17
|
+
| 修订号冲突 | 重新用ppt_check读取当前工程,再按新revision编辑 |
|
|
18
|
+
| 模板还有待填写 | 补充实际事实/依据/行动;按草稿说明,不作为成品交付 |
|
|
19
|
+
| 渲染报告缺失字体 | 替换为环境和目标机器可用字体,重新生成并逐页检查;未解决需标注字体问题,不能声称已验收 |
|
|
@@ -28,6 +28,7 @@ const HELP = `dsh-ppt —— 一句话 / 一篇文档 → HTML 放映 + PPTX 导
|
|
|
28
28
|
--slides <json> 结构化 slides JSON(可选,与 --content 二选一)
|
|
29
29
|
--template <id> weekly / defense / project / pitch;仅模板会生成草稿
|
|
30
30
|
--brand <json|@path> 品牌颜色、字体、Logo、页脚
|
|
31
|
+
--data-model <json|@path> 可选数字来源、公式与推演假设;配合 --slides
|
|
31
32
|
--edit <deck.json> 修改指定页,配合 --edits <json|@path>
|
|
32
33
|
--undo <deck.json> 撤销最近一次修改
|
|
33
34
|
--check <deck.json> 查看质量报告和页码 / ID
|
|
@@ -76,6 +77,7 @@ export function parseArgv(argv) {
|
|
|
76
77
|
else if (key === '--slides') args.slides = readJson(nextValue())
|
|
77
78
|
else if (key === '--template') args.template = nextValue()
|
|
78
79
|
else if (key === '--brand') args.brand = readJson(nextValue())
|
|
80
|
+
else if (key === '--data-model') args.dataModel = readJson(nextValue())
|
|
79
81
|
else if (key === '--edit') args.edit = nextValue()
|
|
80
82
|
else if (key === '--edits') args.edits = readJson(nextValue())
|
|
81
83
|
else if (key === '--undo') args.undo = nextValue()
|
|
@@ -163,6 +165,7 @@ export async function main(argv = process.argv.slice(2), io = {}) {
|
|
|
163
165
|
overwrite: args.overwrite,
|
|
164
166
|
template: args.template,
|
|
165
167
|
brand: args.brand,
|
|
168
|
+
dataModel: args.dataModel,
|
|
166
169
|
}
|
|
167
170
|
const result = await buildDeckAsync(options)
|
|
168
171
|
log('dsh-ppt 已生成 ' + result.slideCount + ' 页演示文稿:')
|