前言¶

在 DeepSeek Harness（DSH）里做智能体任务时，经常需要把一段 Markdown 内容直接展示出来，例如研究报告、会议记录或课程大纲。已有做法往往是人工排版，或者引入额外前端工程。如果只想要一个结果：一个可以直接在浏览器里打开的单文件 HTML 演示文稿，就需要一个足够轻量的工具插件。

下面介绍 dsh-deck-builder。它由 Blaczz 维护，采用 MIT 许可，是一个 DSH 工具插件：注册 deck_build 工具，把 Markdown 转换为自包含的 HTML 演示文稿，支持主题和键盘导航，不引入依赖，也不修改 DSH 核心。

这是什么¶

dsh-deck-builder 的定位是一个 DSH 工具插件：输入 Markdown，输出单文件 HTML 演示文稿。

它通过 ctx.tools.register 注册 deck_build 工具。生成结果自包含：内联 CSS/JS，无外部资源，不访问网络。

该插件是独立社区插件，不与 DeepSeek Harness 官方从属。

核心功能¶

deck_build 工具接收 Markdown，返回输出路径、幻灯片数量和字节数。

支持三个主题：

• deepseek
• light
• dark

拆分逻辑如下：

1. 优先按 ---、***、___ 分隔。
2. 如果没有这些分隔符，回退到 H1/H2 标题拆分。

Markdown 渲染覆盖：

• 标题
• 段落
• 有序列表
• 无序列表
• 代码块
• 引用
• 粗体/斜体
• 行内代码
• 链接
• 图片

实现路径是零依赖、零核心修改：使用纯函数生成，通过 ctx.tools.register 注册，不使用客户端 bundle，不访问网络，不引入外部资源。

生成逻辑有单元测试覆盖：splitting、rendering、escaping、self-containment。

安装与启用¶

前置条件：

• DSH 可用，且 dsh web 可运行
• Node ≥ 22.19
• pnpm

从 GitHub 安装时执行：

dsh plugin --profile web add "github:Blaczz/dsh-deck-builder#main"

这一步会把插件添加到 web profile。安装后重启 dsh web。

可选 peerDependencies：

@deepseek-ai/cordis >=4.0.1-rc.1 <5.0.0
@deepseek-ai/dsh-tools >=0.1.0-rc.3 <0.2.0

典型用法¶

在 DSH 对话中，直接让智能体构建演示文稿，例如：

Turn this research report into slides using the deepseek theme:
<markdown content>

智能体会调用 deck_build，生成 deck-<title>.html。打开文件后，可以使用：

• ← / → 或空格键切换幻灯片
• f 进入全屏
• 浏览器打印或导出 PDF，每页一张幻灯片

手动调用工具¶

也可以直接调用 deck_build。示例字段如下：

{
  "markdown": "# Title\nbody\n\n---\n\n# Slide 2\nmore",
  "title": "My Deck",
  "theme": "deepseek",
  "outputPath": "slides/my-deck.html"
}

其中：

• markdown：演示文稿内容
• title：演示文稿标题
• theme：主题
• outputPath：输出路径

工具返回输出路径、幻灯片数量和字节数。

适用场景与注意¶

适合以下情况：

• 在 DSH web 场景中使用
• 需要把 Markdown 报告、会议记录、课程大纲转成可分发的单文件 HTML 幻灯片
• 希望输出离线可用、无外部资源
• 希望不修改 DSH 核心，只增加一个工具

注意：

• 插件以当前 DSH 进程权限运行。安装前应检查源码、许可证和依赖范围。
• 该插件由 Blaczz 维护，许可为 MIT © 2026。
• 它是独立社区插件，不与 DeepSeek Harness 官方从属。
• 安装后需要重启 dsh web。

链接¶

GitHub 仓库：https://github.com/Blaczz/dsh-deck-builder

插件目录线索：https://www.skillhub.cn/plugins/Blaczz/dsh-deck-builder