前言¶

在 DeepSeek Harness (DSH) 环境中，智能体（Agent）经常需要处理附件或 Markdown 文本，并将其转化为演示文稿。手动转换不仅耗时，且难以保持格式一致性。dsh-ppt-studio 插件旨在解决这个问题，它允许智能体直接将 Markdown 或附件转换为自包含的 HTML 幻灯片、可编辑的 PPTX 文件以及 JSON 清单。

插件简介¶

dsh-ppt-studio 是一个 DSH 插件，由开发者 Huauauaa 维护。其核心功能是利用 Markdown 内容生成演示文稿。该插件采用 MIT 许可证，不属于 DeepSeek 官方组件。

核心功能¶

1. 多格式输出：支持将 Markdown 或附件转换为 HTML 幻灯片、可编辑的 .pptx 文件以及 JSON 清单。
2. 内置主题：提供 data、swiss、velvet、soft、bold 五种内置主题供选择。
3. 语言配置：支持配置默认语言（zh 或 en）。
4. 主控文件支持：允许使用主机本地的 PPTX 主控文件作为模板。
5. 工具集：提供 ppt_create、ppt_themes、ppt_templates 等工具。

安装与启用¶

安装前需确保 Node.js 版本不低于 22。

1. 在本地仓库根目录执行安装命令：

    dsh plugin --profile web add ./

2. 验证配置是否生效：

    dsh --profile web --dump-config

3. 本地测试（无需 Harness）：

    npm run smoke

配置说明¶

安装后，需在 Web 界面的设置面板中进行配置。PPT Studio 位于 settings.section 页面。

• 主题选择：在 HTML 播放器和 PPTX 中选择一种内置主题（如 swiss）。
• 语言设置：设置播放器界面的默认语言（zh 或 en）。
• 保存默认值：将上述设置写入主机的设置文档。
• 主控文件路径：输入主机文件系统中的 .pptx 文件绝对路径或相对路径。该路径必须可被 dsh 进程读取，浏览器无法直接上传文件。

工具使用¶

插件提供三个主要工具：

1. ppt_create：核心工具，用于构建 HTML、PPTX 和 JSON。
   • 参数：
     • title：幻灯片标题。
     • content：Markdown 内容或结构化的 slides 数据。
     • theme：可选，覆盖设置中的主题。
     • lang：可选，覆盖设置中的语言。
     • outputDir：可选，输出目录。
     • fileName：可选，输出文件名。
     • useMaster：可选，是否使用主控文件。
2. ppt_themes：列出所有可用的内置主题。
3. ppt_templates：报告当前默认主题和主控文件的状态。

注意事项与限制¶

1. 插件冲突：该插件与社区现有的 dsh-ppt 插件工具名相同，不能同时安装，两者只能二选一。
2. 主控文件限制：
   • 主控文件仅用于近似映射主题颜色到 HTML，PPTX 生成会追加文本框到主控文件，但不支持映射占位符、图表、动画或备注。
   • 无效的主控文件（路径缺失、非 zip 或缺少必要 XML）会被拒绝。
   • 主控文件路径必须是主机文件系统路径，而非浏览器沙箱路径。
3. 功能缺失：不支持 Slidev、图表生成或自动翻译。
4. 非官方：该插件不隶属于 DeepSeek 官方。

总结¶

dsh-ppt-studio 通过提供 ppt_create 等工具，为 DSH 中的智能体提供了自动生成演示文稿的能力。在需要从 Markdown 快速生成 PPTX 或 HTML 幻灯片时，该插件是一个实用的工具。

• GitHub 仓库
• 插件目录