<p align="center"><strong>dsh-slides</strong></p>
DeepSeek Harness 的幻灯片插件
English | 中文
   !license
给 Agent 一个 make_slides 工具，它就能把一场报告写成一个自包含 HTML 文件——任意浏览器打开、全屏放映、演讲备注只有你自己看得到、Ctrl+P 直接打印成 PDF。要 formats: ["html", "pptx"] 就会同时写一份可编辑的 PowerPoint 文件，演讲备注一并带过去。
这个文件在放映时不加载任何东西：没有 CDN、没有网络字体、没有图床。要联网才能放的片子，就是可能在会场当场翻车的片子。
安装
dsh plugin --profile web add dsh-slides
dsh web然后直接说：「把这些结果做成一个十分钟的报告」。
Agent 拿到了什么
一个工具 make_slides，接收结构化的幻灯片数据，而不是让用户自己再转一遍的 markdown：
| 版式 | 装什么 |
|---|---|
title | 标题、副标题、汇报人。由整体字段自动生成，不需要你自己写一页 |
section | 章节分隔页 |
bullets | 标题写结论，下面列要点，可以配一张图 |
image | 一张图配图注，占满整页 |
quote | 引语加出处 |
不写 layout 就按你填了哪些字段自动判断。
每一页都可以带 notes——演讲备注。它不会出现在幻灯片上，放映时按 S 才显示给汇报人自己看。这正是这个工具的用意：结论放页面上，要讲的话放备注里，Agent 的指令里也是这么要求它的。
要点支持 粗体、*斜体* 和 ` 代码 `。所有内容先转义再套格式，所以内容永远无法往页面里注入标记。
输出格式
formats 默认是 ["html"]。需要合作者改、或者会议系统要求上传时，加上 "pptx"：
| HTML | PPTX | |
|---|---|---|
| 离线放映 | 可以，不加载任何东西 | 可以 |
| 演讲备注 | 放映时按 S | PowerPoint 的备注栏 |
| 打印 PDF | Ctrl+P，一页一张 | 通过 PowerPoint |
| 合作者可编辑 | 不方便 | 可以 |
| 图片 | 用 data: URI 才能完全自包含 | data: URI 会内嵌，链接仍是链接 |
两者出自同一份幻灯片数据和同一套行内格式解析，不会各跑各的。
放映
| 按键 | |
|---|---|
→ ← 空格 | 下一页 / 上一页 |
S | 显示、隐藏演讲备注 |
F | 全屏 |
Home End | 第一页 / 最后一页 |
Ctrl+P | 打印——一页一张、隐藏界面元素，直接出 PDF |
也可以用鼠标：点左边三分之一后退，点其余部分前进。地址栏里带页码，所以链接可以直接指向某一页。
主题
五套做完的样子，而不是一堆可调的属性。选一个，别自己拼。
| 主题 | |
|---|---|
plain | 白底、无衬线、细强调线。默认；退到内容后面 |
ink | 暖白纸底 + 衬线。像一篇印出来的论文，适合组会和答辩 |
midnight | 深蓝底浅字。明亮的房间里，白底片子会糊，这个撑得住 |
slate | 中性灰、无彩色强调。适合让图表承担全部颜色的片子 |
sunrise | 米白底配暖色强调。想说服人的报告可以用这个更轻的调子 |
<p align="center"> <img src="assets/theme-plain.png" width="48%" alt="plain 主题"> <img src="assets/theme-midnight.png" width="48%" alt="midnight 主题"><br> <img src="assets/theme-slate.png" width="48%" alt="slate 主题"> <img src="assets/theme-sunrise.png" width="48%" alt="sunrise 主题"> </p>
字体栈只写系统字体，理由和「不加载任何东西」是同一个。
配置
组合包插入一行（id: slides）。在 profile 的 cordis.patch.yml 里覆盖（patch 会整体替换 config，保留的键要一起写）：
- id: slides
config:
outputDir: slides/ # 幻灯片写到哪里，相对工作区
defaultTheme: plain # plain | ink | midnight | slate | sunrise
promptGuidance: true # 注册写幻灯片的指令
promptOrder: 150说明
- 文件通过
ctx.fs写入，所以沙箱文件系统后端会像管别的工具一样管住这次写入。也正因如此，只有组合里存在文件系统提供者时才会注册这个工具——没有的话工具和指令都不出现，而不是给模型一个必然失败的调用。 ctx.fs只开放文本写入，沙箱后端围栏的也正是这两个变更操作。所以写 pptx 时先用正规的writeText去申请这个路径：后端会施加真实策略，不允许就在任何字节存在之前抛FS_SANDBOX_DENIED；只有它放行的路径才会被填入内容。直接resolve完就写字节等于绕过围栏，因为resolve根本不在被围栏的操作之列。- 图片要你自己提供。用
data:URI 可以让片子完全自包含；用https链接也能放，但放映时就依赖那个站点了。 - 本包只负责渲染，不关心内容从哪来。关心内容的包——比如做学术报告的
dsh-paper-slides——平级安装在旁边，驱动make_slides。
已知限制
- 不支持逐条动画。 一页整体出现。动画和转场这种东西，由 Agent 替你选，往往一眼就能看出是生成的。
- pptx 是一份干净的稿子，不是设计过的稿子。 它把你的内容、主题配色、字体、项目符号和备注带进 PowerPoint，但不会逐像素复刻 HTML 版，也不使用母版和动画。
许可证
MIT