notrat-ppt-studio

Notrat PPT Studio

Professional PowerPoint production skill for Notrat / agent workflows

使用 Notrat 创建、改编和检查专业 PowerPoint 演示文稿。
支持 图片型 / 原生可编辑型 / 混合可编辑型，以及对象组合与进入 / 强调 / 退出 / 路径动画。
默认 editable，并自觉编排对象动画（无需用户点名）。

---

效果演示

Editable 模式：原生对象动画

元素逐组飞入，标题先入，卡片按阅读顺序依次出现。

Hybrid 模式：氛围背景 + 前景动画

背景为 AI 生成的视觉氛围层，前景文字和图形为可编辑对象，带有进入/强调动画。

💡 运行 node src/demo_build.js 可生成本地 demo PPTX（需先 npm install）。

---

简介

Notrat PPT Studio 是一套面向 Agent 的 PowerPoint 生产规范与运行时。它把文章、报告、方案、数据、讲稿、品牌资料或既有 PPT，转换为结构清晰、视觉统一、可交付的演示文稿。

适用场景：路演、汇报、提案、培训、发布会、产品介绍、从大纲/文章/数据生成可编辑 PPTX、全页视觉大片、对象动画与语义组合、PPTX 结构校验。

---

核心能力

• 叙事优先：先大纲与页角色，再视觉与动画
• 三模式生产：editable（默认）/ hybrid / image
• 自觉对象动画：用户未禁止时，每页主动编排约 3–7 步时间线
• 语义组合：卡片、步骤、标签等按意义成组再动画
• 统一命令网关：准备、调度、装配、动画后处理、校验一条命令面
• 样式模板库：templates/styles/<style-id>/ 12 种可复用视觉系统
• Schema 契约：manifest / job / style 机器可读
• Worker 角色提示：prompts/workers/ 约束子任务输出

---

默认策略（硬规则）

⚠️ 重要：必须使用 @bapunhansdah/[email protected]（动画 fork），不能用标准 pptxgenjs。标准版会忽略 animation 字段，导致所有页面变成静态 PPT。

---

三种输出模式

A. image — 全页图片型

• 每页完整 16:9 位图，适合概念提案、品牌展示、强视觉叙事
• 不能承载对象进入/强调/退出/路径
• 装配命令：assemble

B. editable — 原生可编辑型（默认）

• 标题、正文、形状、表格、图表为原生对象，文本不栅格化
• 对象动画主路径

C. hybrid — 混合可编辑型

• 位图仅作背景/氛围，关键文案与数据在前景原生对象上
• 动画只加在前景；背景保持静态

---

命令网关

python scripts/notrat-ppt.py <command> [args]

默认交付路径

editable/hybrid → animate → validate → 交付
image → prepare → dispatch → result → assemble → 交付

---

Deck 项目约定

<deck_project>/
├── deck.manifest.json        # 项目清单
├── content/                  # 源材料 & 大纲 (outline.json)
├── asset/                    # 品牌素材 (logo, brand-colors)
├── job/                      # 逐页任务 (image 模式)
├── work/                     # 工作区 (candidates/, slides/)
├── state/                    # 运行状态 (run.json)
└── output/                   # 最终 PPTX / PDF

---

动画与组合

对象动画使用 @bapunhansdah/[email protected] 的 animation 字段声明进入/强调/退出效果。语义组合通过 layout.js 的 groupAnchor / groupMember / afterGroup API 实现，多段序列与真实组合走 notrat-ppt.py animate 进行 OOXML 后处理。

---

样式模板

templates/styles/ 下有 12 种可复用样式包：

---

仓库结构

notrat-ppt-studio/
├── SKILL.md                  # Agent 权威工作流契约
├── skill-card.md             # 发布卡片摘要
├── README.md                 # 本文件
├── package.json              # Node 依赖（pptxgenjs fork）
├── requirements.txt          # Python 依赖
├── THIRD_PARTY_NOTICES.md    # 第三方声明
├── _meta.json                # 技能元数据
├── docs/                     # 详细参考文档（13 篇）
├── scripts/
│   └── notrat-ppt.py         # 统一命令网关
├── src/
│   ├── notrat_ppt_studio/    # Python 核心
│   │   ├── core/             # 运行时、状态、样式目录
│   │   ├── pipeline/         # 准备、调度、装配、状态
│   │   ├── media/            # 图像生成与 provider
│   │   └── animation/        # 组合、动画后处理、校验
│   ├── demo_build.js         # 参考实现（8 页 editable demo）
│   └── layout.js             # 布局引擎 + 组合动画 API
├── prompts/workers/          # Worker 角色提示
├── templates/styles/         # 12 种样式包
├── schemas/                  # JSON Schema
├── tests/                    # 测试
└── frontend/                 # 产品网站
    ├── index.html
    └── assets/               # GIF 演示 + Logo

---

快速开始

环境要求

• Python 3.10+（建议 3.12）
• Node.js 18+（用于 pptxgenjs 动画能力与 animation-lab）
• 可选：图像生成 API Key（仅 image / hybrid 背景链路）

安装

pip install -r requirements.txt
npm install

本地自检

python scripts/notrat-ppt.py --help
python scripts/notrat-ppt.py styles validate
npm test

npm scripts

---

文档索引

---

隐私与风险

• 远程图像服务可能收到提示词与经批准的输入素材；敏感数据请先脱敏
• 生成项目会持久化 prompts、图片、状态与输出文件
• 高级动画兼容性必须在目标 PowerPoint / WPS 版本中实机验证
• 本仓库**