pptpress
PPT 不用等，马上就好。
🥇 全网第一个 DeepSeek Harness PPT 生成插件 🥇
English ·
安装（转发给你的 AI） ·
命令 ·
IR ·
主题 ·
Agent skill ·
ModLens（视觉）
## 交流
欢迎随时提 [issue](https://github.com/liustack/pptpress/issues/new/choose)。也欢迎在 X 关注 **[@liustack](https://x.com/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 文件夹：
```bash
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 回路：
```bash
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 ` | 校验 IR，每条报错都带页码 |
| `render [-o ] [--theme ]` | 渲染出 `.pptx`。省略 `-o` 则写到 `.pptpress//.pptx` |
| `preview [-o ] [--html]` | 每页一张 SVG，外加一个自包含的审阅页。省略 `-o` 则写到 `.pptpress//` |
| `serve ` | 随改动自动刷新的实时预览 |
| `audit ` | 几何审查：溢出、越界、低对比度、重叠 |
| `themes` | 列出 24 套内置主题（24 个 id） |
| `doctor` | 体检这套安装：运行时、skill 副本、可选能力、自检渲染 |
完整命令表见 [`docs/cli.zh-CN.md`](./docs/cli.zh-CN.md)。
## 文档
| 文档 | 适用场景 |
| :-- | :-- |
| [安装手册](./INSTALL.md) | 把安装交给 agent，或检查运行前提 |
| [Agent skill](./skills/pptpress/SKILL.zh-CN.md) | 了解 pptpress 教给 agent 的完整工作流 |
| [CLI 手册](./docs/cli.zh-CN.md) | 查询命令、参数、审查、预览与健康检查 |
| [IR 参考](./docs/ir.zh-CN.md) | 用 JSON 编写 deck、页面、组件与叙事 |
| [主题](./docs/themes.zh-CN.md) | 挑选内置主题，或从自家 PPT 提取品牌 |
| [核心概念](./docs/concepts.md) | 理解主题、版式、组件、叙事与容量模型 |
| [架构](./docs/architecture.md) | 修改渲染链，或新增主题、版式与组件 |
| [Deck 项目](./docs/deck-projects.md) | 用锁定 spec、页面文件、素材与实时审阅制作复杂 PPT |
| [版式选型与 seed](./docs/selection-and-seed.md) | 排查版式为何被选中，或保持多次修订稳定 |
| [对比度系统](./docs/contrast-system.md) | 排查文字颜色、自绘背景与低对比度问题 |
| [测试](./docs/testing.md) | 选择验证命令、检查快照，或修改导出 XML |
| [内部 API](./docs/internal-api.md) | 了解 JavaScript 内部模块为何不承诺 semver 稳定性 |
| [发布手册](./docs/releasing.md) | 准备并发布 npm 版本 |
| [更新日志](./CHANGELOG.md) | 查询各版本的变化 |
## 关注「liustack」
关注微信公众号「liustack」：AI 创业机会、独立开发见解、AI 实战与工具，第一时间推送。微信扫码，或搜一搜「liustack」：
⭐ 如果 pptpress 对你有用，请给[项目](https://github.com/liustack/pptpress)一个 star，并在 X 关注 **[@liustack](https://x.com/liustack)**。这是让更多开发者找到它最直接的方式。
## 致谢
图标原语抽取自 [lucide](https://lucide.dev)（ISC License）。pptpress 本身从一套生产环境的 AI 出 PPT 系统中抽取而来，从第一天起就针对 CJK 排版做了优化（全角标点宽度、中文换行、雅黑优先字体栈、显式东亚字体槽声明）。
## License
[MIT](./LICENSE)