dsh-ppt 0.11.0 → 0.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +7 -0
- package/README.en.md +45 -44
- package/README.md +45 -44
- package/docs/USAGE.en.md +196 -196
- package/docs/USAGE.md +215 -211
- package/docs/validation/0.8.0.md +10 -10
- package/lib/client.js +266 -230
- package/lib/workbench.js +18 -4
- package/package.json +1 -1
- package/skills/dsh-ppt/SKILL.md +74 -74
- package/skills/dsh-ppt/package.json +11 -11
- package/skills/dsh-ppt/references/advanced.md +41 -41
- package/skills/dsh-ppt/references/syntax.md +43 -43
- package/skills/dsh-ppt/references/troubleshooting.md +19 -19
- package/skills/dsh-ppt/scripts/deck-advanced.mjs +492 -492
- package/skills/dsh-ppt/scripts/deck-core.mjs +2378 -2378
- package/skills/dsh-ppt/scripts/deck-delivery.mjs +104 -104
- package/skills/dsh-ppt/scripts/deck-render.mjs +270 -270
package/lib/workbench.js
CHANGED
|
@@ -19,6 +19,16 @@ function ordinaryFile(path) {
|
|
|
19
19
|
return readFileSync(path);
|
|
20
20
|
}
|
|
21
21
|
function pathsFor(path) { const base = path.slice(0, -5); return { json: path, html: base + '.html', pptx: base + '.pptx' }; }
|
|
22
|
+
function speakerNotes(manifest) {
|
|
23
|
+
const label = (zh, en) => manifest.language === 'en' ? en : manifest.language === 'bilingual' ? zh + ' / ' + en : zh;
|
|
24
|
+
const heading = (value) => String(value ?? '').replace(/[\r\n]+/g, ' ').trim();
|
|
25
|
+
const sections = manifest.slides.map((slide, index) => {
|
|
26
|
+
const title = heading(slide.title) || label('第 ' + (index + 1) + ' 页', 'Slide ' + (index + 1));
|
|
27
|
+
const notes = typeof slide.notes === 'string' && slide.notes.trim() ? slide.notes : label('(本页未填写演讲备注。)', '(No speaker notes for this slide.)');
|
|
28
|
+
return '## ' + (index + 1) + '. ' + title + '\n\n' + notes;
|
|
29
|
+
});
|
|
30
|
+
return '# ' + heading(manifest.title) + '\n\n' + sections.join('\n\n---\n\n') + '\n';
|
|
31
|
+
}
|
|
22
32
|
function json(status, value) {
|
|
23
33
|
return new Response(JSON.stringify(value), { status, headers: { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' } });
|
|
24
34
|
}
|
|
@@ -215,14 +225,18 @@ export class PptWorkbench {
|
|
|
215
225
|
return denied;
|
|
216
226
|
try {
|
|
217
227
|
const params = new URL(request.url).searchParams, kind = params.get('kind');
|
|
218
|
-
if (!['html', 'pptx', 'json', 'bundle'].includes(String(kind)))
|
|
228
|
+
if (!['html', 'pptx', 'json', 'bundle', 'notes'].includes(String(kind)))
|
|
219
229
|
return fail(400, '不支持此文件类型');
|
|
220
230
|
const { entry, manifest, files } = await this.project(params.get('id'));
|
|
221
231
|
if (String(manifest.revision) !== params.get('revision'))
|
|
222
232
|
return fail(409, '项目已被修改,请重新打开后下载');
|
|
223
233
|
request.signal.throwIfAborted();
|
|
224
234
|
let name, bytes;
|
|
225
|
-
if (kind === '
|
|
235
|
+
if (kind === 'notes') {
|
|
236
|
+
bytes = strToU8(speakerNotes(manifest));
|
|
237
|
+
name = basename(entry.path, '.json') + '-speaker-notes.md';
|
|
238
|
+
}
|
|
239
|
+
else if (kind === 'bundle') {
|
|
226
240
|
const entries = {};
|
|
227
241
|
let total = 0;
|
|
228
242
|
for (const path of Object.values(files)) {
|
|
@@ -250,10 +264,10 @@ export class PptWorkbench {
|
|
|
250
264
|
request.signal.throwIfAborted();
|
|
251
265
|
if ((await this.project(entry.id)).manifest.revision !== manifest.revision)
|
|
252
266
|
return fail(409, '项目已被修改,请重新打开后下载');
|
|
253
|
-
const type = kind === 'bundle' ? 'application/zip' : kind === 'pptx' ? 'application/vnd.openxmlformats-officedocument.presentationml.presentation' : kind === 'html' ? 'text/html; charset=utf-8' : 'application/json; charset=utf-8';
|
|
267
|
+
const type = kind === 'notes' ? 'text/markdown; charset=utf-8' : kind === 'bundle' ? 'application/zip' : kind === 'pptx' ? 'application/vnd.openxmlformats-officedocument.presentationml.presentation' : kind === 'html' ? 'text/html; charset=utf-8' : 'application/json; charset=utf-8';
|
|
254
268
|
return new Response(new Uint8Array(bytes), { headers: {
|
|
255
269
|
'content-type': type, 'cache-control': 'no-store', 'x-content-type-options': 'nosniff',
|
|
256
|
-
'content-disposition': `attachment; filename="presentation.${kind === 'bundle' ? 'zip' : kind}"; filename*=UTF-8''${encodeURIComponent(name)}`,
|
|
270
|
+
'content-disposition': `attachment; filename="presentation.${kind === 'bundle' ? 'zip' : kind === 'notes' ? 'md' : kind}"; filename*=UTF-8''${encodeURIComponent(name)}`,
|
|
257
271
|
} });
|
|
258
272
|
}
|
|
259
273
|
catch (error) {
|
package/package.json
CHANGED
package/skills/dsh-ppt/SKILL.md
CHANGED
|
@@ -1,74 +1,74 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dsh-ppt
|
|
3
|
-
description: "Turn one sentence or a Markdown document into a complete, presentation-ready deck: a standalone HTML web slideshow plus an editable PPTX export, with 5 built-in visual themes (Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type), slide transitions + bullet entrance animations (motion, on by default), and bilingual Chinese/English support. Use when the user asks for a PPT, slides, deck, keynote, 演示文稿, 幻灯片, 汇报, 提案, 路演, 培训材料, or wants to turn a document into a presentation. 中文:把一句话或一篇文档变成完整演示文稿(HTML 网页放映 + PPTX 导出),内置 5 套视觉主题、页间转场与要点入场动画,中英双语。"
|
|
4
|
-
compatibility: "Node ^22.19.0 or >=24.0.0. Images/charts use @office-kit/pptx@0.21.0. Optional PNG/PDF renderer: @deepseek-ai/libreoffice-kit@0.1.3. Cross-harness: copy the full directory and run npm install --ignore-scripts there."
|
|
5
|
-
allowed-tools: "Bash, Read, Write, Edit"
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# dsh-ppt
|
|
9
|
-
|
|
10
|
-
一句话或一篇文档 → 完整演示文稿:**独立 HTML 网页放映 + 可编辑 PPTX**。本文件只做路由与纪律;具体规则按需读取 `references/`。
|
|
11
|
-
|
|
12
|
-
## 触发条件
|
|
13
|
-
|
|
14
|
-
用户要做 PPT / 幻灯片 / 演示文稿 / deck / 汇报 / 提案 / 路演 / 培训材料,或给一句话、一段文字、一篇 Markdown 想变成可放映的演示。
|
|
15
|
-
|
|
16
|
-
## 执行纪律(每次都要遵守)
|
|
17
|
-
|
|
18
|
-
- 一页一个观点;标题是判断句,不是名词短语。
|
|
19
|
-
- 内容语言由你撰写;`lang` 只决定界面文字。
|
|
20
|
-
- 先选主题再构建;不确定就用默认 `data`。
|
|
21
|
-
- 交付前逐项过一遍文末「质量门禁」。
|
|
22
|
-
- 目标是可用成品:先组织真实内容,再调用生成器;未填模板必须标注草稿,不编造缺失事实。
|
|
23
|
-
- 渲染报告缺失字体时,替换为环境和接收方机器可用字体,重新生成并逐页检查;未解决需标注字体问题,不能声称已验收。
|
|
24
|
-
|
|
25
|
-
## 核心流水线
|
|
26
|
-
|
|
27
|
-
1. **Probe 需求**:读入用户的句子/文档,确定听众、目标、语气。一句话输入不要反问,直接按发布场景推断。
|
|
28
|
-
2. **Outline 大纲**:产出 5–12 页大纲(封面 → 问题/背景 → 方案/论点 3–6 页 → 证据 → 行动号召 → 结束页)。
|
|
29
|
-
→ 写大纲与正文前先读 `references/copywriting.md`。
|
|
30
|
-
3. **Theme 主题**:调 `ppt_themes`(DSH)或 `node scripts/build-deck.mjs --list-themes`(跨 harness)。
|
|
31
|
-
→ 拿不准选哪套时读 `references/themes.md` 的情绪决策树。
|
|
32
|
-
4. **Build 生成**:
|
|
33
|
-
- DSH 内:调 `ppt_create`,大纲写成 Markdown 传 `content`(推荐),或传结构化 `slides`。
|
|
34
|
-
- 跨 harness:`node <skill-dir>/scripts/build-deck.mjs --title "标题" --content deck.md --theme data --lang zh --out dist`。
|
|
35
|
-
- 动效默认开(页间转场 + 要点逐条入场);严肃/打印场景传 `motion: 'off'`。
|
|
36
|
-
→ 用表格 / 金句 / 备注 / 结构化 slides 前读 `references/syntax.md`。
|
|
37
|
-
5. **Verify 校验与修正**:调 `ppt_check` 检查具体页;在浏览器操作放映、总览和备注,查看图片/图表。若可选官方引擎可用,调 `ppt_render` 读取最终 PPTX 生成逐页 PNG/PDF,逐页看画面。修正用 `ppt_edit`,以 `expectedRevision` 防冲突;需要时 `ppt_undo`。修改后重新渲染,以收据复核当前文件。文件头/结构通过不等同于视觉验收,静态估算、渲染、视觉检查必须分开说明。
|
|
38
|
-
6. **Deliver 交付**:给用户三个绝对路径,说明 HTML 直接放映(← → 翻页 · F 全屏 · G 总览 · S 备注 · P 打印),PPTX 用 PowerPoint / WPS / Keynote 打开(备注在演示者视图可见,bullets 页放映时逐条点击出现)。DSH 用户也可在「设置 → 演示文稿」修改文字、替换 PNG/JPEG、移动/复制/删除页面、撤销和下载最新文件;已有 JSON 工程先 `ppt_check` 才会出现在项目列表。`ppt_edit.order` 使用每个稳定页面 ID 各一次;`duplicate`、`remove` 使用修改前的页码或稳定 ID,复制保留图片/图表/备注,最终保留 1–120 页。结构与正文修改可合为一次撤销。
|
|
39
|
-
|
|
40
|
-
## 按需装载索引
|
|
41
|
-
|
|
42
|
-
| 何时读 | 文件 | 内容 |
|
|
43
|
-
| --- | --- | --- |
|
|
44
|
-
| 写大纲 / 正文前 | `references/copywriting.md` | 叙事骨架、单页规则、双语规则 |
|
|
45
|
-
| 选主题拿不准 | `references/themes.md` | 5 套主题色板 + 情绪决策树 |
|
|
46
|
-
| 用表格/金句/备注/结构化 slides | `references/syntax.md` | Markdown 解析、进阶语法、slides JSON、motion 开关 |
|
|
47
|
-
| 图片/图表/模板/品牌/编辑/渲染 | `references/advanced.md` | 参数、限制、草稿与成品、收据语义 |
|
|
48
|
-
| 交付异常 | `references/troubleshooting.md` | 症状 → 处理对照表 |
|
|
49
|
-
|
|
50
|
-
## 质量门禁(交付前逐项确认)
|
|
51
|
-
|
|
52
|
-
- [ ] 页数 3–60,首屏是封面,末屏是结束页。
|
|
53
|
-
- [ ] 每页有明确标题;bullets 页 1–8 条,中文每条 ≤ 20 字、英文 ≤ 12 词。
|
|
54
|
-
- [ ] HTML 与 PPTX 使用同一主题,配色一致。
|
|
55
|
-
- [ ] 主题色对比度足够(深底浅字或浅底深字)。
|
|
56
|
-
- [ ] 中文内容无错别字;英文标题用 Title Case。
|
|
57
|
-
- [ ] 最后一页有可执行的行动号召,不只是「谢谢」。
|
|
58
|
-
- [ ] 文件已写到用户工作区,路径为绝对路径。
|
|
59
|
-
- [ ] 没有未填模板;保留真实数据来源,检查每页画面而非只检查生成成功。
|
|
60
|
-
- [ ] 图片嵌入成功,图表与原始数据一致;渲染收据匹配最终 PPTX,说明尚未验证的部分。
|
|
61
|
-
|
|
62
|
-
## 跨 harness 安装
|
|
63
|
-
|
|
64
|
-
把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录,使用 Node `^22.19.0 || >=24.0.0`,在该目录运行 `npm install --ignore-scripts`。纯文本可直接运行;图片/图表/品牌导出需要 Office Kit,PNG/PDF 需另外安装可选官方引擎:
|
|
65
|
-
|
|
66
|
-
| Agent | 技能目录 |
|
|
67
|
-
| --- | --- |
|
|
68
|
-
| DeepSeek Harness | `dsh plugin --profile web add dsh-ppt` |
|
|
69
|
-
| Claude Code | `~/.claude/skills/` |
|
|
70
|
-
| Cursor | `.cursor/skills/` |
|
|
71
|
-
| Gemini CLI | `~/.gemini/skills/` |
|
|
72
|
-
| OpenAI Codex | `~/.codex/skills/` |
|
|
73
|
-
|
|
74
|
-
一次编写,处处可用。
|
|
1
|
+
---
|
|
2
|
+
name: dsh-ppt
|
|
3
|
+
description: "Turn one sentence or a Markdown document into a complete, presentation-ready deck: a standalone HTML web slideshow plus an editable PPTX export, with 5 built-in visual themes (Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type), slide transitions + bullet entrance animations (motion, on by default), and bilingual Chinese/English support. Use when the user asks for a PPT, slides, deck, keynote, 演示文稿, 幻灯片, 汇报, 提案, 路演, 培训材料, or wants to turn a document into a presentation. 中文:把一句话或一篇文档变成完整演示文稿(HTML 网页放映 + PPTX 导出),内置 5 套视觉主题、页间转场与要点入场动画,中英双语。"
|
|
4
|
+
compatibility: "Node ^22.19.0 or >=24.0.0. Images/charts use @office-kit/pptx@0.21.0. Optional PNG/PDF renderer: @deepseek-ai/libreoffice-kit@0.1.3. Cross-harness: copy the full directory and run npm install --ignore-scripts there."
|
|
5
|
+
allowed-tools: "Bash, Read, Write, Edit"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# dsh-ppt
|
|
9
|
+
|
|
10
|
+
一句话或一篇文档 → 完整演示文稿:**独立 HTML 网页放映 + 可编辑 PPTX**。本文件只做路由与纪律;具体规则按需读取 `references/`。
|
|
11
|
+
|
|
12
|
+
## 触发条件
|
|
13
|
+
|
|
14
|
+
用户要做 PPT / 幻灯片 / 演示文稿 / deck / 汇报 / 提案 / 路演 / 培训材料,或给一句话、一段文字、一篇 Markdown 想变成可放映的演示。
|
|
15
|
+
|
|
16
|
+
## 执行纪律(每次都要遵守)
|
|
17
|
+
|
|
18
|
+
- 一页一个观点;标题是判断句,不是名词短语。
|
|
19
|
+
- 内容语言由你撰写;`lang` 只决定界面文字。
|
|
20
|
+
- 先选主题再构建;不确定就用默认 `data`。
|
|
21
|
+
- 交付前逐项过一遍文末「质量门禁」。
|
|
22
|
+
- 目标是可用成品:先组织真实内容,再调用生成器;未填模板必须标注草稿,不编造缺失事实。
|
|
23
|
+
- 渲染报告缺失字体时,替换为环境和接收方机器可用字体,重新生成并逐页检查;未解决需标注字体问题,不能声称已验收。
|
|
24
|
+
|
|
25
|
+
## 核心流水线
|
|
26
|
+
|
|
27
|
+
1. **Probe 需求**:读入用户的句子/文档,确定听众、目标、语气。一句话输入不要反问,直接按发布场景推断。
|
|
28
|
+
2. **Outline 大纲**:产出 5–12 页大纲(封面 → 问题/背景 → 方案/论点 3–6 页 → 证据 → 行动号召 → 结束页)。
|
|
29
|
+
→ 写大纲与正文前先读 `references/copywriting.md`。
|
|
30
|
+
3. **Theme 主题**:调 `ppt_themes`(DSH)或 `node scripts/build-deck.mjs --list-themes`(跨 harness)。
|
|
31
|
+
→ 拿不准选哪套时读 `references/themes.md` 的情绪决策树。
|
|
32
|
+
4. **Build 生成**:
|
|
33
|
+
- DSH 内:调 `ppt_create`,大纲写成 Markdown 传 `content`(推荐),或传结构化 `slides`。
|
|
34
|
+
- 跨 harness:`node <skill-dir>/scripts/build-deck.mjs --title "标题" --content deck.md --theme data --lang zh --out dist`。
|
|
35
|
+
- 动效默认开(页间转场 + 要点逐条入场);严肃/打印场景传 `motion: 'off'`。
|
|
36
|
+
→ 用表格 / 金句 / 备注 / 结构化 slides 前读 `references/syntax.md`。
|
|
37
|
+
5. **Verify 校验与修正**:调 `ppt_check` 检查具体页;在浏览器操作放映、总览和备注,查看图片/图表。若可选官方引擎可用,调 `ppt_render` 读取最终 PPTX 生成逐页 PNG/PDF,逐页看画面。修正用 `ppt_edit`,以 `expectedRevision` 防冲突;需要时 `ppt_undo`。修改后重新渲染,以收据复核当前文件。文件头/结构通过不等同于视觉验收,静态估算、渲染、视觉检查必须分开说明。
|
|
38
|
+
6. **Deliver 交付**:给用户三个绝对路径,说明 HTML 直接放映(← → 翻页 · F 全屏 · G 总览 · S 备注 · P 打印),PPTX 用 PowerPoint / WPS / Keynote 打开(备注在演示者视图可见,bullets 页放映时逐条点击出现)。DSH 用户也可在「设置 → 演示文稿」修改文字、替换 PNG/JPEG、移动/复制/删除页面、撤销和下载最新文件;已有 JSON 工程先 `ppt_check` 才会出现在项目列表。`ppt_edit.order` 使用每个稳定页面 ID 各一次;`duplicate`、`remove` 使用修改前的页码或稳定 ID,复制保留图片/图表/备注,最终保留 1–120 页。结构与正文修改可合为一次撤销。
|
|
39
|
+
|
|
40
|
+
## 按需装载索引
|
|
41
|
+
|
|
42
|
+
| 何时读 | 文件 | 内容 |
|
|
43
|
+
| --- | --- | --- |
|
|
44
|
+
| 写大纲 / 正文前 | `references/copywriting.md` | 叙事骨架、单页规则、双语规则 |
|
|
45
|
+
| 选主题拿不准 | `references/themes.md` | 5 套主题色板 + 情绪决策树 |
|
|
46
|
+
| 用表格/金句/备注/结构化 slides | `references/syntax.md` | Markdown 解析、进阶语法、slides JSON、motion 开关 |
|
|
47
|
+
| 图片/图表/模板/品牌/编辑/渲染 | `references/advanced.md` | 参数、限制、草稿与成品、收据语义 |
|
|
48
|
+
| 交付异常 | `references/troubleshooting.md` | 症状 → 处理对照表 |
|
|
49
|
+
|
|
50
|
+
## 质量门禁(交付前逐项确认)
|
|
51
|
+
|
|
52
|
+
- [ ] 页数 3–60,首屏是封面,末屏是结束页。
|
|
53
|
+
- [ ] 每页有明确标题;bullets 页 1–8 条,中文每条 ≤ 20 字、英文 ≤ 12 词。
|
|
54
|
+
- [ ] HTML 与 PPTX 使用同一主题,配色一致。
|
|
55
|
+
- [ ] 主题色对比度足够(深底浅字或浅底深字)。
|
|
56
|
+
- [ ] 中文内容无错别字;英文标题用 Title Case。
|
|
57
|
+
- [ ] 最后一页有可执行的行动号召,不只是「谢谢」。
|
|
58
|
+
- [ ] 文件已写到用户工作区,路径为绝对路径。
|
|
59
|
+
- [ ] 没有未填模板;保留真实数据来源,检查每页画面而非只检查生成成功。
|
|
60
|
+
- [ ] 图片嵌入成功,图表与原始数据一致;渲染收据匹配最终 PPTX,说明尚未验证的部分。
|
|
61
|
+
|
|
62
|
+
## 跨 harness 安装
|
|
63
|
+
|
|
64
|
+
把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录,使用 Node `^22.19.0 || >=24.0.0`,在该目录运行 `npm install --ignore-scripts`。纯文本可直接运行;图片/图表/品牌导出需要 Office Kit,PNG/PDF 需另外安装可选官方引擎:
|
|
65
|
+
|
|
66
|
+
| Agent | 技能目录 |
|
|
67
|
+
| --- | --- |
|
|
68
|
+
| DeepSeek Harness | `dsh plugin --profile web add dsh-ppt` |
|
|
69
|
+
| Claude Code | `~/.claude/skills/` |
|
|
70
|
+
| Cursor | `.cursor/skills/` |
|
|
71
|
+
| Gemini CLI | `~/.gemini/skills/` |
|
|
72
|
+
| OpenAI Codex | `~/.codex/skills/` |
|
|
73
|
+
|
|
74
|
+
一次编写,处处可用。
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "dsh-ppt-skill",
|
|
3
|
-
"version": "0.7.0",
|
|
4
|
-
"private": true,
|
|
5
|
-
"type": "module",
|
|
6
|
-
"description": "Standalone dsh-ppt skill dependencies for image/chart export",
|
|
7
|
-
"dependencies": { "@office-kit/pptx": "0.21.0" },
|
|
8
|
-
"peerDependencies": { "@deepseek-ai/libreoffice-kit": "0.1.3" },
|
|
9
|
-
"peerDependenciesMeta": { "@deepseek-ai/libreoffice-kit": { "optional": true } },
|
|
10
|
-
"engines": { "node": "^22.19.0 || >=24.0.0" }
|
|
11
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "dsh-ppt-skill",
|
|
3
|
+
"version": "0.7.0",
|
|
4
|
+
"private": true,
|
|
5
|
+
"type": "module",
|
|
6
|
+
"description": "Standalone dsh-ppt skill dependencies for image/chart export",
|
|
7
|
+
"dependencies": { "@office-kit/pptx": "0.21.0" },
|
|
8
|
+
"peerDependencies": { "@deepseek-ai/libreoffice-kit": "0.1.3" },
|
|
9
|
+
"peerDependenciesMeta": { "@deepseek-ai/libreoffice-kit": { "optional": true } },
|
|
10
|
+
"engines": { "node": "^22.19.0 || >=24.0.0" }
|
|
11
|
+
}
|
|
@@ -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` 指定基目录,已有目录追加后缀。引擎不可用/静态错误/显式收据失效返回非零退出码。
|
|
@@ -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
|
+
| 渲染报告缺失字体 | 替换为环境和目标机器可用字体,重新生成并逐页检查;未解决需标注字体问题,不能声称已验收 |
|