| name | ppt-scene-graph |
| description | PPT 视觉场景图 + 美化/创建流水线。从 PPTX 提取结构化布局数据(元素树、空间关系、布局模式),并提供一键美化、从大纲创建演示文稿能力。内置 DesignHub 设计系统,支持多种主题。完全独立,无需外部 python-pptx 依赖(已 vendor)。 |
| version | 2.0.0 |
| license | MIT |
PPT Scene Graph — OpenClaw Skill
Visual Scene Graph for PowerPoint + Unified Production Pipeline
让 AI 看到并理解幻灯片布局,同时提供完整的美化/创建能力。
核心能力
| 能力 | 说明 | 状态 |
|---|
| 🎨 PPT 美化 | 一键应用设计主题,自动调整字体/颜色/间距 | ✅ |
| 🏗️ 从零创建 | 基于大纲 YAML/JSON 自动生成完整演示文稿 | ✅ |
| 🔍 场景图解析 | 提取元素树、空间关系、布局模式 | ✅ |
| 📊 质量评估 | 评分 PPT 设计质量(对比度、对齐、一致性) | ✅ |
| 🎯 智能检测 | 自动识别封面/章节/内容/结尾等幻灯片类型 | ✅ |
设计系统(内置主题)
| 主题 | 风格 | 适用场景 |
|---|
designhub_warm | 温暖希望系(奶油白 + 暖红 + 生命绿) | 学生/公众演讲、情感叙事 |
designhub_pro | 专业商务系(深蓝 + 金) | 企业汇报、商务演示 |
projection | 投影优化系(高对比度、大字体) | 大型会场投影 |
快速开始
1. 美化现有 PPT
from ppt_scene_graph import beautify
beautify("input.pptx", theme="designhub_warm", output_path="output.pptx")
beautify("input.pptx", add_page_numbers=False)
2. 从大纲创建 PPT
from ppt_scene_graph import create_from_outline
from ppt_scene_graph.pipeline import SlideSpec, OutlineSpec
outline = OutlineSpec(
title="我的演示",
subtitle="副标题",
slides=[
SlideSpec(type='cover', title="封面标题", subtitle="封面副标题"),
SlideSpec(type='section', title="1. 第一章"),
SlideSpec(type='content', title="内容页", body=["要点1", "要点2", "要点3"]),
SlideSpec(type='ending', title="谢谢", subtitle="Q&A"),
]
)
create_from_outline(outline, theme="designhub_warm", output_path="output.pptx")
3. 解析场景图
from ppt_scene_graph import parse_slide
slide_data = parse_slide("presentation.pptx", slide_idx=0)
print(slide_data)
4. 评估 PPT 质量
from ppt_scene_graph import evaluate
report = evaluate("presentation.pptx")
print(report)
CLI 使用
python -m ppt_scene_graph.pipeline beautify input.pptx -t designhub_warm -o output.pptx
python -m ppt_scene_graph.pipeline create --outline outline.yaml -o output.pptx
python -m ppt_scene_graph.pipeline evaluate input.pptx
技术架构
依赖管理
✅ 完全独立 — 无需外部 python-pptx 依赖
python-pptx (MIT) 已 vendor 到 ppt_scene_graph/vendor/pptx/
- 安装 skill 后即可使用,无需
pip install python-pptx
项目结构
ppt-scene-graph-opensource/
├── ppt_scene_graph/
│ ├── __init__.py # 导出 API + vendor 路径设置
│ ├── pipeline.py # 美化/创建/评估流水线
│ ├── design.py # DesignSystem 设计系统
│ └── vendor/ # Vendored 依赖
│ ├── __init__.py
│ └── pptx/ # python-pptx 源码 (MIT)
├── SKILL.md # OpenClaw Skill 定义
├── README.md # 使用文档
├── DESCRIPTION.txt # 简短描述(347 字符)
├── LICENSE # MIT License
└── scripts/ # OpenClaw 调用脚本(可选)
├── beautify.py
├── create.py
└── evaluate.py
集成到 OpenClaw
安装方式
cp -r ppt-scene-graph-opensource ~/.qclaw/skills/ppt-scene-graph
ln -s $(pwd)/ppt-scene-graph-opensource ~/.qclaw/skills/ppt-scene-graph
在 OpenClaw 中使用
from ppt_scene_graph import beautify, create_from_outline, evaluate
beautify(upload_path, theme="projection", output_path=output_path)
outline = build_outline_from_user_input(user_prompt)
create_from_outline(outline, output_path=output_path)
设计理念
This is infrastructure code. It works. Skill-ified and ready to use. If you have questions, just ask the agent.
已完成 Skill 化 (v2.0.0)
- ✅ 完全独立 —
python-pptx (MIT) 已 vendor 到 ppt_scene_graph/vendor/pptx/
- ✅ 零外部依赖 — 安装 skill 后即可使用,无需
pip install python-pptx
- ✅ 标准结构 — 包含
SKILL.md, README.md, scripts/, vendor/
核心原则
- ✅ 规则驱动 — 基于启发式规则,无需模型
- ✅ 可预测 — 确定性的输出,便于调试
- ✅ 投影友好 — 高对比度、大字体、安全的配色方案
有问题?
- 📖 读
README.md(完整使用文档)
- 🧪 运行
python test_skill_simple.py(验证安装)
- 🤖 直接问智能体(OpenClaw Agent 已加载此 skill,支持自然语言交互)
许可证
MIT — 自由使用、修改、分发
致谢
- Steve Canny —
python-pptx 原作者
- DesignHub — 设计系统灵感来源
- McKinsey/PPTAgent/html-ppt-skill/pptx — 主题预设聚合来源
更新日志
v2.0.0 (2026-05-30)
- 🎉 Skill 化 — 改造为独立 OpenClaw Skill
- 📦 Vendor python-pptx — 移除外部依赖,完全独立
- 📝 重写文档 — SKILL.md + README.md
- ✨ 保留所有原有功能 — 美化/创建/评估/解析
v1.0.0 (原始版本)
- 初始版本(基于 python-pptx 外部依赖)