前言¶

在 DeepSeek Harness（DSH）里让智能体生成演示稿时，一个常见问题是：结果可能是图片、HTML 页面或不可编辑的页面，后续无法逐字修改。liustack/pptwise 针对这个问题，把演示内容渲染成真实 PPTX 文件，方便在 PowerPoint 中继续编辑。

DSH 插件生态中的社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。下面介绍 pptwise 的定位、安装方式与基础用法。

这是什么¶

pptwise 是一个面向 DeepSeek Harness 的演示稿生成插件，维护者为 liustack，许可证为 MIT。

它的一句话定位是：生成真实 PowerPoint 文件，而非图片或 HTML。它解决的问题是：让 AI 产出的演示稿进入 PPTX 文件后，仍然可以打开并继续修改。

核心功能¶

1、生成真实 PPTX：输出可编辑的 PowerPoint 文件，而不是图片、HTML 或不可编辑页面。

2、可继续编辑：支持在 PowerPoint 中打开，并继续编辑标题、项目符号、图表柱等元素。

3、本地渲染：支持本地渲染，无需账号，渲染时无需 API key，渲染时不联网。

4、运行环境：支持 Node 22.19+ 或 Bun 运行。

5、命令集：支持 validate、render、preview、serve、audit、themes、layouts、doctor 等命令。

6、IR JSON 渲染：支持将 IR JSON 渲染为 PPTX，并输出每页 SVG 或预览页。

7、可选图库搜索：支持可选图库搜索，需要用户自己的 Pexels key。

安装与启用¶

先确认本机满足运行前提：Node 22.19+ 或 Bun。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证；该插件许可证为 MIT。

已核实资料未提供可直接复制的 dsh plugin add 安装命令。

在 DSH 中发送下面这句，让智能体按 DSH 安装说明执行，并汇报健康检查结果：

Install pptwise following https://raw.githubusercontent.com/liustack/pptwise/main/INSTALL-dsh.md, then run the health check and tell me the result.

经过上面的步骤，安装说明会被交给智能体处理。如果你需要使用可选图库搜索，准备自己的 Pexels key。

典型用法¶

准备一个演示稿 IR 文件 deck.json 后，先做校验：

pptwise validate deck.json

校验通过后，渲染为 PPTX：

pptwise render deck.json -o out/hello.pptx

如果需要逐页查看 SVG，运行：

pptwise preview deck.json -o out/svgs

如果不想安装，也可以直接运行这条示例命令做校验：

npx -y @liustack/pptwise validate deck.json

资料列出的命令还包括 serve、audit、themes、layouts、doctor，可按需运行。

适用场景与注意¶

适合在 DSH 中生成可继续编辑的 PPTX，并且希望渲染过程不依赖账号、API key 或联网的使用者。

使用注意：

1、插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

2、运行前提为 Node 22.19+ 或 Bun。

3、图表和表格数值如需更改，需要让 AI 重建该页。

4、可选图库搜索需要使用用户自己的 Pexels key。

链接与后续¶

GitHub 仓库：https://github.com/liustack/pptwise。社区目录可按 liustack/pptwise 查找；已核实资料未提供可直接粘贴的目录页 URL。

经过上面的安装和渲染步骤，就可以把 AI 生成的演示稿落到 PowerPoint 里继续编辑。