pptfast

交流

欢迎随时提 issue。也欢迎在 X 关注 @liustack，聊聊你用 pptpress 做了什么、在哪个 harness 上运行，以及下一版最该解决什么。新版本也会第一时间在那里发布。

亮点

⚡ 跟 AI 说一句，PPT 就好了。 你只管说要讲什么，版面、配色、字号、间距全由引擎排好。同一份内容做十遍是同一份，不用一遍遍重来碰运气。

✏️ 交出来的是真 PPT，不是一张图。 每个标题、每条要点、每根柱子都能在 PowerPoint 里点开改字改色。图表和表格里的数字是例外，换数字让 AI 重做一版。24 套现成风格，也能把你公司现有 PPT 里的配色和字体抽出来直接用。

🔌 装进你正在用的 agent。 一条命令装进 DeepSeek Harness、Claude Code，或任何读 skill 文件夹的 agent（Codex 等），装完就会用。

🔁 改稿不用重新描述一遍。 一条命令打开实时预览网页，用一句话告诉 AI 要改哪里，改完网页自动刷新。

🔒 不用注册、渲染不用配 key、渲染时不联网。 装好就能用，电脑上有 Node 22.19+ 或 Bun 就行。可选的图库搜索用用户自己的 Pexels key。

安装

第一步，交给你的 AI。 把这行话发给它：

按照 https://raw.githubusercontent.com/liustack/pptpress/main/INSTALL.md 安装 pptpress deck 技能，装完跑一遍健康检查，把结果告诉我。

没有第二步。你的 AI 会把 skill 文件夹放到你这个 harness 读取的位置，skill 自带钉死版本的启动器，不需要你手动装 CLI。pptpress 在本地渲染 PPTX：渲染不要 API key、不用注册、无需配置。可选的图库搜索需要用户自己的 Pexels key。唯一前置是 Node 22.19+（或 Bun）。

在 DeepSeek Harness 上换成一条命令。 那里 pptpress 是原生 DSH 插件，不走 skill 文件夹：

npx -y @deepseek-ai/dsh plugin --profile web add @liustack/pptpress@0.21.0

版本号要点名。不点名的话，安装会静默落到一个更旧的版本，拿不到最新能力。npm view @liustack/pptpress version 可查当前版本。插件卡片显示为「pptpress」，把整套生成流程的 skill 注册进 DSH 技能系统，驱动的 CLI 就在插件包自己里面。卸载即移除，不留残余。

快速开始

IR 就是一份描述整份 PPT 内容的 JSON 文件。写一个最小的，跑一遍 validate → render → preview 回路：

cat > deck.json <<'EOF'
{
  "filename": "hello.pptx",
  "theme": { "id": "consulting" },
  "slides": [
    { "type": "cover", "heading": "Hello pptpress", "subheading": "A first deck in ten minutes" },
    { "type": "content", "heading": "Why it works", "components": [
      { "type": "bullets", "items": ["Semantic IR in", "Native DrawingML out", "Every shape stays editable"] } ] },
    { "type": "ending", "heading": "Thanks" }
  ]
}
EOF
pptpress validate deck.json                              # → OK — 3 slides, theme "consulting"
pptpress render deck.json -o out/hello.pptx              # → wrote out/hello.pptx (3 slides, ~24 KB)
pptpress render deck.json -o out/tech.pptx --theme tech  # 同一份 deck，换个主题
pptpress preview deck.json -o out/svgs                   # 每页一张 SVG，供人工目检

只有一条形状规则：cover/chapter/ending 页只有 heading + subheading，组件都放在 content 页上。写混了 validate 会原话告诉你。

不想安装也行：npx -y @liustack/pptpress validate deck.json。源码仓库里则用 node dist/cli.js 代替 pptpress，examples/ 下有现成的 IR 文件可以直接试。

最常用的几条命令：

命令	作用
validate <target>	校验 IR，每条报错都带页码
render <target> [-o <out.pptx>] [--theme <id>]	渲染出 .pptx。省略 -o 则写到 .pptpress/<deck>/<deck>.pptx
preview <target> [-o <dir>] [--html]	每页一张 SVG，外加一个自包含的审阅页。省略 -o 则写到 .pptpress/<deck>/
serve <target>	随改动自动刷新的实时预览
audit <target>	几何审查：溢出、越界、低对比度、重叠
themes	列出 24 套内置主题（24 个 id）
doctor	体检这套安装：运行时、skill 副本、可选能力、自检渲染

完整命令表见 docs/cli.zh-CN.md。

文档

文档	适用场景
安装手册	把安装交给 agent，或检查运行前提
Agent skill	了解 pptpress 教给 agent 的完整工作流
CLI 手册	查询命令、参数、审查、预览与健康检查
IR 参考	用 JSON 编写 deck、页面、组件与叙事
主题	挑选内置主题，或从自家 PPT 提取品牌
核心概念	理解主题、版式、组件、叙事与容量模型
架构	修改渲染链，或新增主题、版式与组件
Deck 项目	用锁定 spec、页面文件、素材与实时审阅制作复杂 PPT
版式选型与 seed	排查版式为何被选中，或保持多次修订稳定
对比度系统	排查文字颜色、自绘背景与低对比度问题
测试	选择验证命令、检查快照，或修改导出 XML
内部 API	了解 JavaScript 内部模块为何不承诺 semver 稳定性
发布手册	准备并发布 npm 版本
更新日志	查询各版本的变化

关注「liustack」

关注微信公众号「liustack」：AI 创业机会、独立开发见解、AI 实战与工具，第一时间推送。微信扫码，或搜一搜「liustack」：

⭐ 如果 pptpress 对你有用，请给项目一个 star，并在 X 关注 @liustack。这是让更多开发者找到它最直接的方式。

致谢

图标原语抽取自 lucide（ISC License）。pptpress 本身从一套生产环境的 AI 出 PPT 系统中抽取而来，从第一天起就针对 CJK 排版做了优化（全角标点宽度、中文换行、雅黑优先字体栈、显式东亚字体槽声明）。

License

MIT