项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 477
使用教程
环境要求
- Python 运行时(安装器会自动安装 pptx-designer 包)
- 目标 AI 编码助手之一:Claude Code / Codex / OpenCode / DeepSeek Harness
- Windows + PowerShell(安装与渲染脚本为 .py / .ps1)
- 可选渲染依赖:Microsoft PowerPoint,或 LibreOffice + Poppler(pdftoppm)
安装与启动步骤
-
1克隆仓库
README 要求先克隆仓库,所有安装命令都在仓库根目录执行
git clone https://github.com/sunchaokun/PPT-Design-Skill.git cd PPT-Design-Skill -
2一键安装运行时
运行安装器,它会自动安装已发布的 pptx-designer Python 包并复制 skill 到所选编码助手
python installer/install.py --platform all --force -
3检查运行时
确认 Python 环境与 pptx-designer 依赖已就绪,输出无报错即正常
python skill/scripts/check_runtime.py -
4装到指定助手
按需把 skill 单独安装到某个编码助手,可换成 codex / opencode / deepseek-harness
python installer/install.py --platform claude --force -
5安装渲染依赖
桌面渲染器属于系统依赖,需要 PowerPoint 或 LibreOffice+Poppler 时可显式安装
python installer/install.py --render-deps -
6导出并渲染
用渲染脚本把 PPTX 转成 PDF 和 PNG,正式交付前必须做 PNG 视觉检查
powershell -ExecutionPolicy Bypass -File skill/scripts/render_pptx.ps1 -InFile examples/new_examplex/louvre_abudhabi/output/louvre_abudhabi_complete.pptx -OutDir output/louvre-abudhabi-rendered
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--platform | 是 | 选择安装到哪个 AI 编码助手,或 all 表示全部 | claude |
--force | 否 | 强制重新安装或覆盖已有安装 | --force |
--render-deps | 否 | 显式安装桌面渲染相关系统依赖 | python installer/install.py --render-deps |
-InFile / -OutDir | 是 | 渲染脚本的输入 PPTX 路径与输出目录 | -InFile x.pptx -OutDir output/x |
如何确认成功
运行 python skill/scripts/check_runtime.py 无报错,且目标编码助手中已出现该 skill 即安装成功。
常见问题
Q:该选哪种生成模式?
A:交付级、正式汇报默认用 Build Mode(逐页逐元素控制最强);快速探索用 FreeStyle Mode;必须沿用企业模板时用 VI Build Mode。不确定就用 Build Mode。
Q:没有安装 PowerPoint 还能渲染吗?
A:可以。渲染器优先调用 PowerPoint COM,无 PowerPoint 时改用 LibreOffice 生成 PDF,再用 Poppler 的 pdftoppm 转成 PNG。
Q:生成的 PPT 可以继续编辑吗?
A:可以。最终输出是原生可编辑的 PPTX 文件,而不是图片或 PDF,实际生成由已发布的 pptx-designer Python 包负责。
Q:需要手动 pip install 吗?
A:不需要。运行 installer/install.py 时安装器会自动安装已发布的 pptx-designer Python 包。
Q:渲染出的 PDF/PNG 有什么用?
A:用于视觉复核。无论用哪种模式,正式交付前都必须经过 PNG 视觉检查,必要时返工。
注意事项
- README 的 Install 段落说明:必须先克隆仓库,然后在仓库根目录运行安装器。
- 安装器会自动处理 pptx-designer,无需手动安装该 Python 包。
- 桌面渲染依赖属于系统依赖,可用 python installer/install.py --render-deps 显式安装。
- 正式交付前务必完成 PNG 视觉检查,不要直接交付未经复核的结果。
核心亮点
- 内置4万+视觉样式,风格覆盖广,减少从零设计成本
- 输出原生可编辑PPTX,不是图片或PDF,后续修改无障碍
- 提供像素级Build Mode控制,元素位置和层级可精细调整
不足之处
- 依赖特定AI编程助手环境,脱离这些工具后使用门槛较高
- 4万+样式库的实际筛选与匹配效果需更多用户验证
- 文档/社区待观察
适用场景
- 用Claude Code写方案后直接生成可编辑的商务汇报PPT
- 为产品发布会快速产出多套视觉风格的演示稿并挑选
- 在Codex中根据需求文档自动生成带配图的培训课件
替代项目
python-pptx、Marp、Slidev
上一篇:KeyType
下一篇:pymupdf4llm
同类项目推荐
Invoice-Downloader
开源
自动从邮箱抓发票,OCR 识别后一键生成报销 Excel
电子发票整理与报销准备工具:从邮箱批量收集 PDF/OFD/XML 发票,OCR 识别、分类归档并生成···
doctor
开源
把 PDF、扫描件批量转成可提取文本的微服务
A microservice for document conversion at scale
office_oxide
开源
多语言极速解析 Office,比 Python 库快百倍
The fastest Office document library for Python, Rust, Go, JS/TS, C# and WASM. DOCX, ···
guizang-ppt-skill
开源
丢个主题给 AI,马上还你一套杂志级 PPT
AI-agent Skill for generating polished HTML slide decks: editorial magazine and Swis···
meetingly-ai
开源
会议面试实时给答案,屏幕共享看不见
Open-source AI interview assistant and meeting copilot: live answers during Zoom, Go···
MeetingCopilot
开源
会议面试实时转写,悬浮提词给答案
Real-time stealth meeting/interview copilot for Windows - streaming ASR (local FunAS···
docext
开源
无需 OCR,本地快速将文档转为 Markdown,并支持效果评测。
An on-premises, OCR-free unstructured data extraction, markdown conversion and bench···
opensync
开源
把 AI 编程会话同步上云,随时搜、随时导出评测
Cloud-synced dashboards for OpenCode and Claude Code. Track sessions, search with se···
chatgpt-gemini-timeline
开源
给AI对话加文件夹和时间轴,找回历史不费劲
ChatGPT & Gemini:Add Folders, Timeline & Prompts. - 为 ChatGPT & Gemini 添加文件夹、···
