前言¶

DSH（DeepSeek Harness）采用“一切皆插件”的理念，构建了一个可扩展的技能与工具生态。在开发与演示场景中，手动制作 PPT 或网页演示往往耗时且繁琐。dsh-ppt 插件直接解决这一痛点：它允许用户通过一句话、一段文字或 Markdown 文档，直接生成可直接放映的 HTML 网页与可编辑的 PPTX 文件。

该插件由 STARDUSTLC666 维护，采用 MIT 协议。它利用纯 Node.js 实现，零运行时依赖，确保了跨平台（Windows / macOS / Linux）的兼容性。插件不仅提供 DSH 技能注册，还支持裸 SKILL.md 跨 harness 使用。

核心能力¶

该插件提供以下核心功能：

• 双格式输出：生成 HTML 网页放映文件与 PPTX 演示文稿文件。
• 工具集：
  • ppt_create：根据输入内容生成演示文稿。
  • ppt_themes：列出内置主题。
• 页型支持：内置 7 种页型，包括封面、章节、要点、核心观点、金句、表格、结束页。
• 演讲者备注：支持 Markdown 中的备注注释（<!-- 备注: ... -->）。在 HTML 模式下按 S 键呼出，在 PPTX 模式下生成原生备注页。
• 动效支持：支持页间转场与要点入场动画，默认开启，可通过配置关闭。
• Markdown 识别：自动识别表格、引用块、备注注释，并映射为对应页型。

安装与启用¶

在 DSH 环境中安装插件：

dsh plugin --profile web add dsh-ppt

安装完成后，重启 Web 服务即可使用 ppt_create 和 ppt_themes 工具。

使用方法¶

DSH 技能内使用¶

1. 查看内置主题：

    ppt_themes

2. 创建演示文稿：

    ppt_create {
      title: "把会议减半",
      content: "# 问题\n- 周会太多\n\n# 方案\n- 异步决策",
      theme: "data",
      lang: "zh"
    }

裸 CLI 构建（跨 Harness）¶

将 skills/dsh-ppt/ 复制到任意 Agent Skills 目录，使用以下命令构建：

node <skill-dir>/scripts/build-deck.mjs \
  --title "产品发布" \
  --content deck.md \
  --theme data \
  --lang zh \
  --out dist/deck

输出说明¶

执行命令后，会生成“三件套”文件：

文件命名规则：如果同名文件已存在，新文件会追加 -1、-2 后缀。只有显式传递 overwrite: true（CLI 为 --overwrite）才会覆盖。

内置主题¶

插件复用 hyperframes 视觉风格库，内置 5 套主题：

• data：数据漂移（默认，未来/沉浸）
• swiss：瑞士脉冲（精准/理性）
• velvet：天鹅绒标准（高级/克制）
• soft：柔和信号（温暖/人本）
• bold：极繁大字（大声/动能）

技术限制与兼容性¶

• Node 版本要求：需要 Node.js 22.19.0 及以上的 22.x，或 24 及以上。
• 兼容性验证：已在官方 @deepseek-ai/dsh@0.1.5-rc.1 上验证通过。
• PPTX 生成机制：PPTX 采用空白版式 + 文本框实现，暂不生成智能母版占位符。在 PowerPoint / WPS 中可正常编辑文字。
• 内容限制：暂不支持图表与图片。bilingual 模式仅双语化播放器界面，不自动翻译内容。
• 一句话输入：如果输入仅有一句话，会自动生成“封面 → 核心观点 → 结束页”的三页最小结构。

总结¶

dsh-ppt 提供了一条从文本到演示文稿的快速流水线。对于需要频繁制作演示文稿的开发者或产品经理，该插件通过纯 Node 实现、无外部依赖的特性，降低了工具链的复杂度，同时通过双格式输出（HTML 与 PPTX）兼顾了在线放映与线下编辑的需求。

GitHub 仓库