在 DeepSeek Harness (DSH) 的开发场景中，让智能体直接产出演示文稿是一项常见需求。传统做法通常涉及手动将 Markdown 或文本复制到 PowerPoint，过程繁琐且容易出错。dsh-slides 插件通过一个工具接口，让 Agent 直接生成自包含的 HTML 幻灯片文件，支持离线演示、打印 PDF 以及导出 PPTX。

功能概览

该插件为 DSH Agent 提供了以下能力：

  • 生成自包含 HTML 幻灯片：生成的文件不依赖任何网络资源（无 CDN、无字体、无图床），确保在无网络环境下也能正常演示。
  • 演示与打印：支持全屏演示，演讲者备注（Speaker Notes）仅在按下 S 键时显示，不会出现在屏幕上。支持通过 Ctrl+P 打印为 PDF。
  • 导出 PPTX：支持导出可编辑的 PowerPoint 文件。
  • 预置主题：提供五种完成的主题，无需手动配置样式：plain（默认）、ink、midnight、slate、sunrise。

安装与启用

在 DSH 环境中安装该插件：

dsh plugin --profile web add dsh-slides
dsh web

安装后，Agent 会获得一个 make_slides 工具，用于将结构化数据转化为幻灯片。

使用方式

Agent 接收结构化数据作为输入，支持多种布局类型：

  • title：包含标题、副标题和演讲者信息。
  • section：作为演讲章节的分隔符。
  • bullets：包含标题和要点列表，支持粗体、斜体和代码格式。
  • image：包含图注的图片。
  • quote：带引用来源的引用块。

在对话中，可以直接请求 Agent 生成演示文稿，例如：

“turn these results into a 10-minute talk”

若需要同时生成 HTML 和 PPTX 文件，可指定格式：

“formats: [“html”, “pptx”]”

配置

插件默认插入 id: slides 配置项。如需自定义，可在 DSH 的配置文件（如 cordis.patch.yml）中覆盖：

- id: slides
  config:
    outputDir: slides/       # 幻灯片输出目录
    defaultTheme: plain      # 主题选择：plain | ink | midnight | slate | sunrise
    promptGuidance: true     # 注册提示词引导
    promptOrder: 150

已知限制

  • 不支持增量展示：幻灯片内容会一次性呈现，不支持逐条展开动画。
  • PPTX 限制：导出的 PPTX 是干净的大纲，不包含动画或母版设计，仅保留内容和基本格式。

许可证

该插件采用 MIT 许可证。