dsh-ppt 0.13.0 → 0.14.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 CHANGED
@@ -4,6 +4,15 @@
4
4
 
5
5
  [历史英文记录](docs/CHANGELOG.en.md)
6
6
 
7
+ ## 0.14.0(2026-10-22)
8
+
9
+ - 成品页新增按需开启的 AI 预审与人机模拟答辩,复用宿主已有模型,不影响直接交付。
10
+ - 预审区分表达、逻辑与证据问题;引用必须匹配所提供的原文。仅表达建议可选中改稿,新增数字没有匹配来源时不提供采纳按钮。
11
+ - 采纳所选修改或备用问答页时另存副本,原稿保留,副本可撤销。旧修订的报告可查看,禁止继续调用和套用。
12
+ - 提供中英文配置、回答输入、取消与提前结束、报告历史和 Markdown 问答 / 材料清单。预审最多 3 次插件调用,答辩最多 5 题、6 次调用;失败不自动重试。
13
+ - 演练只发送选定页面的文字、图表数据、备注及用户补充材料,不带工具或图片文件。验收范围见 [0.14.0 验证记录](docs/validation-0.14.0.md)。
14
+ - PPT 工作台使用当前 DSH 的主题变量,修复深色主题下仍显示浅色面板的问题。
15
+
7
16
  ## 0.13.0(2026-10-20)
8
17
 
9
18
  - **设置面板体验**:新增 Ctrl/⌘+S 保存、Esc 取消或返回、Alt+←/→ 切换页面;HTML 预览 iframe 内同样生效。
package/README.en.md CHANGED
@@ -1,52 +1,54 @@
1
- # dsh-ppt
2
-
3
- [中文](README.md)
4
-
5
- ![dsh-ppt whale girl plugin cover](https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/assets/cover-whale-girl.png)
6
-
7
- Turn source material into an HTML slideshow, editable PPTX and a reusable project.
8
-
1
+ # dsh-ppt
2
+
3
+ [中文](README.md)
4
+
5
+ ![dsh-ppt whale girl plugin cover](https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/assets/cover-whale-girl.png)
6
+
7
+ Turn source material into an HTML slideshow, editable PPTX and a reusable project.
8
+
9
+ Optional **AI review** and **rehearsal** reuse models configured in DSH. Both are off by default: download the finished presentation directly, or explicitly start a bounded rehearsal. Compare proposed wording edits, save selected changes and backup Q&A slides to an undoable copy, and export Q&A with an evidence checklist. See [the rehearsal guide](docs/COACHING.md#english). AI suggestions are not fact checks.
10
+
9
11
  [![npm](https://img.shields.io/npm/v/dsh-ppt)](https://www.npmjs.com/package/dsh-ppt) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-ppt-downloads.svg)](https://www.npmjs.com/package/dsh-ppt)
10
12
 
11
13
  Feedback and contributions are welcome: report [issues](https://github.com/STARDUSTLC666/dsh-ppt/issues) or submit [pull requests](https://github.com/STARDUSTLC666/dsh-ppt/pulls).
12
14
 
13
- ## What it does
14
-
15
- - Create branded decks with text, images, tables and native charts.
16
- - Edit text and images in Settings, reorder, duplicate or delete slides, and undo changes.
17
- - Check quality and optionally render the final PPTX as images or PDF.
15
+ ## What it does
16
+
17
+ - Create branded decks with text, images, tables and native charts.
18
+ - Edit text and images in Settings, reorder, duplicate or delete slides, and undo changes.
19
+ - Check quality and optionally render the final PPTX as images or PDF.
18
20
  - Download Markdown speaker notes with each slide's current title and notes.
19
- - Keyboard support: Ctrl/⌘+S save, Esc cancel or go back, Alt+←/→ switch slides; leaving with unsaved edits prompts first.
20
-
21
- ## Install
22
-
23
- In DSH Desktop, install `dsh-ppt` from the Plugins panel. If the bundled dsh command is available:
24
-
25
- ```bash
26
- dsh plugin --profile desktop add dsh-ppt
27
- ```
28
-
29
- For the web version, replace `desktop` with `web`. Restart DSH after installation.
30
-
31
- ## Start using it
32
-
33
- Ask to turn your material into a deliverable deck with HTML, PPTX and project files. From 0.8.0, use Settings → Presentations to edit projects generated by this plugin, or continue editing the PPTX in PowerPoint or WPS.
34
-
35
- Office changes do not sync back to JSON. Externally changed outputs and legacy projects without integrity records cannot be overwritten. Use **Save a copy** or `ppt_edit(saveAs:true)` to rebuild a new trio from JSON while preserving the originals. The copy does not import Office edits.
36
-
37
- ## Requirements and configuration
38
-
39
- Normal generation does not require Office. Final PPTX rendering uses the optional official LibreOffice Kit; see the guide for dependencies, fonts and installation.
40
-
41
- Detailed configuration, tool arguments and troubleshooting are in the [usage guide](docs/USAGE.en.md). For standalone development, follow the Node requirement in [package.json](package.json).
42
-
43
- ## Documentation
44
-
45
- - [Usage and troubleshooting](docs/USAGE.en.md)
46
- - [Changelog](CHANGELOG.md)
47
- - [Validation scope and history](docs/VALIDATION.md)
48
- - [Report a problem or suggest a feature](https://github.com/STARDUSTLC666/dsh-ppt/issues)
49
-
50
- ## License
51
-
52
- [MIT](LICENSE)
21
+ - Keyboard support: Ctrl/⌘+S save, Esc cancel or go back, Alt+←/→ switch slides; leaving with unsaved edits prompts first.
22
+
23
+ ## Install
24
+
25
+ In DSH Desktop, install `dsh-ppt` from the Plugins panel. If the bundled dsh command is available:
26
+
27
+ ```bash
28
+ dsh plugin --profile desktop add dsh-ppt
29
+ ```
30
+
31
+ For the web version, replace `desktop` with `web`. Restart DSH after installation.
32
+
33
+ ## Start using it
34
+
35
+ Ask to turn your material into a deliverable deck with HTML, PPTX and project files. From 0.8.0, use Settings → Presentations to edit projects generated by this plugin, or continue editing the PPTX in PowerPoint or WPS.
36
+
37
+ Office changes do not sync back to JSON. Externally changed outputs and legacy projects without integrity records cannot be overwritten. Use **Save a copy** or `ppt_edit(saveAs:true)` to rebuild a new trio from JSON while preserving the originals. The copy does not import Office edits.
38
+
39
+ ## Requirements and configuration
40
+
41
+ Normal generation does not require Office. Final PPTX rendering uses the optional official LibreOffice Kit; see the guide for dependencies, fonts and installation.
42
+
43
+ Detailed configuration, tool arguments and troubleshooting are in the [usage guide](docs/USAGE.en.md). For standalone development, follow the Node requirement in [package.json](package.json).
44
+
45
+ ## Documentation
46
+
47
+ - [Usage and troubleshooting](docs/USAGE.en.md)
48
+ - [Changelog](CHANGELOG.md)
49
+ - [Validation scope and history](docs/VALIDATION.md)
50
+ - [Report a problem or suggest a feature](https://github.com/STARDUSTLC666/dsh-ppt/issues)
51
+
52
+ ## License
53
+
54
+ [MIT](LICENSE)
package/README.md CHANGED
@@ -1,52 +1,55 @@
1
- # dsh-ppt
2
-
3
- [English](README.en.md)
4
-
5
- ![dsh-ppt 鲸鱼娘插件封面](https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/assets/cover-whale-girl.png)
6
-
7
- 把材料制作成 HTML 放映、可编辑 PPTX 和可继续修改的工程文件。
8
-
1
+ # dsh-ppt
2
+
3
+ [English](README.en.md)
4
+
5
+ ![dsh-ppt 鲸鱼娘插件封面](https://raw.githubusercontent.com/STARDUSTLC666/dsh-ppt/master/assets/cover-whale-girl.png)
6
+
7
+ 把材料制作成 HTML 放映、可编辑 PPTX 和可继续修改的工程文件。
8
+
9
9
  [![npm](https://img.shields.io/npm/v/dsh-ppt)](https://www.npmjs.com/package/dsh-ppt) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-ppt-downloads.svg)](https://www.npmjs.com/package/dsh-ppt)
10
10
 
11
11
  欢迎使用,遇到问题或有改进建议,请提交 [issues](https://github.com/STARDUSTLC666/dsh-ppt/issues) 和 [PR](https://github.com/STARDUSTLC666/dsh-ppt/pulls)。
12
12
 
13
- ## 功能
14
-
15
- - 生成图文、表格、原生图表和品牌化演示文稿。
16
- - 在设置页编辑文字和图片、调整顺序、复制或删除页面,并支持撤销。
17
- - 提供质量检查与可选的最终 PPTX 图片 / PDF 渲染。
18
- - 下载按页整理的 Markdown 讲稿,保留当前版本的标题与演讲备注。
19
- - 键盘操作:Ctrl/⌘+S 保存、Esc 取消或返回、Alt+←/→ 切换页面;有未保存修改时离开会提示。
20
-
21
- ## 安装
22
-
23
- 桌面版可在「插件」面板按包名 `dsh-ppt` 安装。已配置 dsh 命令时也可使用:
24
-
25
- ```bash
26
- dsh plugin --profile desktop add dsh-ppt
27
- ```
28
-
29
- 网页版把命令中的 `desktop` 改为 `web`。安装后重启 DSH。
30
-
31
- ## 开始使用
32
-
33
- 可说:“把这份材料做成可直接交付的演示文稿,生成 HTML、PPTX 和工程文件。”0.8.0 起可在「设置 → 演示文稿」轻量修改自产工程,也可在 PowerPoint / WPS 中继续编辑 PPTX。
34
-
35
- Office 中的修改不会同步回 JSON。插件检测到成品在外部修改,或旧工程没有校验记录时,会拒绝直接覆盖;可用面板「另存副本」或 `ppt_edit(saveAs:true)` 从 JSON 生成新文件,保留原成品。副本不包含 Office 手工修改。
36
-
37
- ## 依赖与配置
38
-
39
- 普通生成不需要 Office。最终 PPTX 渲染使用可选的官方 LibreOffice Kit;依赖版本、字体环境和安装方法见使用说明。
40
-
41
- 详细配置、工具参数与排错见[使用说明](docs/USAGE.md)。从源码独立开发时,Node 要求以 [package.json](package.json) 为准。
42
-
43
- ## 文档
44
-
45
- - [使用与排错](docs/USAGE.md)
46
- - [更新记录](CHANGELOG.md)
47
- - [验证范围与历史记录](docs/VALIDATION.md)
48
- - [问题反馈与功能建议](https://github.com/STARDUSTLC666/dsh-ppt/issues)
49
-
50
- ## License
51
-
52
- [MIT](LICENSE)
13
+ ## 功能
14
+
15
+ - 生成图文、表格、原生图表和品牌化演示文稿。
16
+ - 在设置页编辑文字和图片、调整顺序、复制或删除页面,并支持撤销。
17
+ - 提供质量检查与可选的最终 PPTX 图片 / PDF 渲染。
18
+ - 下载按页整理的 Markdown 讲稿,保留当前版本的标题与演讲备注。
19
+ - 可选 AI 预审与模拟答辩:复用 DSH 已配置模型,按需提问、比较改稿、另存可撤销副本,并导出问答与待补充材料清单。默认关闭,直接下载成品无需预审。
20
+ - 键盘操作:Ctrl/⌘+S 保存、Esc 取消或返回、Alt+←/→ 切换页面;有未保存修改时离开会提示。
21
+
22
+ ## 安装
23
+
24
+ 桌面版可在「插件」面板按包名 `dsh-ppt` 安装。已配置 dsh 命令时也可使用:
25
+
26
+ ```bash
27
+ dsh plugin --profile desktop add dsh-ppt
28
+ ```
29
+
30
+ 网页版把命令中的 `desktop` 改为 `web`。安装后重启 DSH。
31
+
32
+ ## 开始使用
33
+
34
+ 可说:“把这份材料做成可直接交付的演示文稿,生成 HTML、PPTX 和工程文件。”0.8.0 起可在「设置 → 演示文稿」轻量修改自产工程,也可在 PowerPoint / WPS 中继续编辑 PPTX。
35
+
36
+ Office 中的修改不会同步回 JSON。插件检测到成品在外部修改,或旧工程没有校验记录时,会拒绝直接覆盖;可用面板「另存副本」或 `ppt_edit(saveAs:true)` 从 JSON 生成新文件,保留原成品。副本不包含 Office 手工修改。
37
+
38
+ 成品页下方可主动开启「AI 预审」或「模拟答辩」。前者根据材料模拟质疑与回答,后者由 AI 一次问一题、你来回答。可以先选模型、听众、强度和范围,再决定是否发送。具体流程与调用上限见[演练说明](docs/COACHING.md)。AI 建议不等于事实核验;普通成品生成、编辑和下载仍不要求配置模型。
39
+
40
+ ## 依赖与配置
41
+
42
+ 普通生成不需要 Office。最终 PPTX 渲染使用可选的官方 LibreOffice Kit;依赖版本、字体环境和安装方法见使用说明。
43
+
44
+ 详细配置、工具参数与排错见[使用说明](docs/USAGE.md)。从源码独立开发时,Node 要求以 [package.json](package.json) 为准。
45
+
46
+ ## 文档
47
+
48
+ - [使用与排错](docs/USAGE.md)
49
+ - [更新记录](CHANGELOG.md)
50
+ - [验证范围与历史记录](docs/VALIDATION.md)
51
+ - [问题反馈与功能建议](https://github.com/STARDUSTLC666/dsh-ppt/issues)
52
+
53
+ ## License
54
+
55
+ [MIT](LICENSE)
@@ -0,0 +1,44 @@
1
+ # 可选 AI 预审与模拟答辩
2
+
3
+ 常规流程仍是「提供材料 → 生成 HTML、可编辑 PPTX 和工程 → 预览与下载」。演练不是交付前置条件,也不会自动启动。
4
+
5
+ 在「设置 → 演示文稿」打开工程,成品下载区下方有两个次级入口:
6
+
7
+ | 入口 | 适合做什么 | 调用上限 |
8
+ | --- | --- | --- |
9
+ | AI 预审 | AI 根据所给材料模拟质疑与回答,整理最多 5 条值得处理的问题 | 选择 1–3 轮,最多 3 次插件调用 |
10
+ | 模拟答辩 | AI 一次提一个问题,用户回答后获取反馈及下一题 | 选择 1–5 题,首次出题加每题反馈,最多 6 次插件调用 |
11
+
12
+ 先选择 DSH 已配置的文字模型、听众、温和 / 普通 / 严格的提问强度,以及整个工程或当前页。需要时粘贴补充材料,或导入 TXT / Markdown(最多 20,000 字符,文件最多 100 KB)。开始按钮说明将发送哪些内容和最多调用几次;点击后才发起生成。可用时优先选中生成工程时的模型;旧工程需要自行核对模型。
13
+
14
+ 只发送所选页面的文字、表格 / 图表数据、备注及主动提供的补充材料,不发送图片文件、密钥或工作区文件。模型调用不附带文件、终端等工具。请在开始前检查输入是否适合交给所选模型服务。供应商自身的重试和计费规则仍然适用,次数上限指插件主动发起的调用。
15
+
16
+ ## 如何使用结果
17
+
18
+ - **表达建议**:查看对应页、材料原文和修改前后比较,自行勾选采纳。程序核对原文引用,并阻止缺少数字来源的表达改稿;这不证明内容真实,也不能保证 AI 保留了所有含义。
19
+ - **逻辑问题与证据缺口**:作为待办整理,不会由 AI 自动填入杜撰的实验、数据或引用。请补充真实材料后重跑。
20
+ - **模拟答辩**:输入你的回答,再提交下一步。难度只影响提问方式,不能预测真实评委或客户会如何提问。
21
+ - **备用问答页**:自行选中需要的问答,追加到新副本末尾。页面及备注标明来自演练、需要核对;不会默默扩充原稿。
22
+ - **下载问答与材料清单**:输出 Markdown,包含问题、回答、建议、来源、缺口及模型和调用次数,不导出全部补充材料。
23
+
24
+ 采纳总是另存新副本,原 HTML / PPTX / JSON 的字节保持原样。在副本点击「撤销上次修改」,可一次撤回本次采纳和新增备用页。副本从工程 JSON 生成,不包含 Office 中的手动编辑。
25
+
26
+ ## 取消、历史与恢复
27
+
28
+ 点击「停止」会向模型发送取消信号,保留已完成的结果。被停止或失败的尝试仍占本次调用额度,也可能已产生费用;插件不会自动重试。模型生成最长等待 120 秒。答辩可以点击「结束并整理已有结果」,该操作不调用模型。
29
+
30
+ 报告保存在当前 `DSH_HOME/plugins/dsh-ppt/rehearsals/`,绑定本机工程、稳定页面 ID 和修订内容。每个工程最多保留 20 次,本机共 200 次;到上限后请在历史中删除旧记录,不会自动删除。工程修改后旧报告仍保留,可重新打开最新工程后导出;不能继续旧演练或套用旧建议。丢失响应时可从历史重新打开记录。删除记录不会删除幻灯片成品。
31
+
32
+ 未配置模型时显示配置引导,普通生成与下载照常可用。模型不输出有效 JSON、尝试调用工具、超出输出上限或被中断时,本次记录会暂停,已完成结果保留。历史文件损坏时不覆盖它,其他可读报告仍可访问。
33
+
34
+ ## English
35
+
36
+ Finished files remain the primary output. AI review and rehearsal are optional and never start automatically.
37
+
38
+ Choose a configured DSH text model, audience, difficulty, scope and optional supporting material. Click Start to send selected slide text, table/chart data, notes and the supplied material; image files are excluded. No file or shell tools are offered to the model. No additional account is needed beyond the chosen DSH provider.
39
+
40
+ Review makes up to three plugin calls. Practice asks one question at a time and accepts human answers: one initial question plus feedback for up to five questions, at most six plugin calls. Provider retries and billing rules still apply. You can stop a call or finish early; stopping may still incur a charge, and failed attempts use the current budget. There is no automatic retry.
41
+
42
+ Compare source quotes and proposed edits before adopting them. Only eligible expression suggestions can directly change wording; logic and evidence gaps remain preparation tasks. Exact quote and numeric checks are limited safeguards, not factual certification. Save selected edits and Q&A backup slides to a new copy; the original artifacts remain intact and Undo restores the copy to its pre-adoption content. Copies are generated from JSON and do not import Office edits.
43
+
44
+ Export Q&A, feedback and the evidence checklist as Markdown. Local reports are bound to the source revision. Changed presentations require a new rehearsal; old reports remain readable and exportable after reopening the current project. Keep up to 20 reports per project and 200 total, then delete old reports explicitly. Deleting a report keeps the presentation files.