OpenSource-Hub

ppt-master

アプリケーション

hugohe3/ppt-master

AI 从任意文档生成原生可编辑的 PowerPoint 幻灯片。

概要

将 PDF、DOCX、URL、Markdown 等转换为原生可编辑的 PPTX,包含真实形状、图表、动画及配音。本地运行,数据不上传,支持多种 AI 模型与 IDE 集成。

README プレビュー

# PPT Master — AI generates natively editable PPTX from any document\n\n[](https://github.com/hugohe3/ppt-master/releases)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/hugohe3/ppt-master/stargazers)\n[](https://atomgit.com/hugohe3/ppt-master)\n\nEnglish | [中文](./README_CN.md)\n\n\n  This project is kept free and open source with the support of PackyCode and other sponsors.\n\n\n\n  \n    \n    Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our project users: register using this link and enter the promo code ppt-master during recharge to get 10% off.\n  \n\n\n\n  Live Demo ·\n  About Hugo He ·\n  Examples ·\n  FAQ ·\n  Contact\n\n\n\n  \n\n\n\n  ↑ A 12-page natively editable deck, generated end-to-end from a single WeChat article URL using Claude Opus 4.7. No manual design. No image export. Every shape, text box, and chart is clickable and editable in PowerPoint.\n\n\n---\n\nDrop in a PDF, DOCX, URL, or Markdown — get back a **natively editable PowerPoint** with real shapes, real text boxes, and real charts. Not images. Click anything and edit it.\n\n> **Template Replication** — hand the AI any `.pptx` you like and say "replicate it as a template via `/create-template`" — you get a layout set PPT Master can invoke directly. Theme colors, fonts, master/layout structure, reusable images, even sprite-sheet crop relationships are extracted straight from OOXML, so covers, chapter dividers and decoration-heavy pages all reproduce reliably. You're no longer limited to the built-in templates: a company brand deck, a client's winning template, or any high-quality reference can become a private template in your own library. See [Templates Guide →](./docs/templates-guide.md).\n\n> **Animations** — exported decks support **page transitions** and **per-element entrance animations** as real

FAQ (4)

トラブル対応
ppt-master で Python 仮想環境を使用すると、更新スクリプトが 'Tracked local changes detected' で失敗するのはなぜですか?

手動で仮想環境を作成するとCLAUDE.mdファイルが変更され、コミットされていない変更が生じて更新スクリプトを妨げます。修正するには、uvを使用した推奨設定に従ってください。cd ./ppt-master を実行し、次に uv venv .venvsource .venv/bin/activateuv pip install -r requirements.txt を実行します。プロジェクトのCLAUDE.mdは既にLLMに対して.venv/bin/pythonを使用するよう指示しているため、手動での編集は不要です。これにより、更新スクリプトは競合なく動作します。

参照 Issue #111
トラブル対応
PowerPointをSVGに変換する際に、テキストのgradient fillが消えてしまうのはなぜですか?

SVG変換パイプラインにおいて、テキストのグラデーション定義が以前は省略されていました。修正: txbody_to_svg.py を変更して、テキストランから(_build_run() 経由で)<linearGradient> / <radialGradient> を収集し、TextResult.defs に返すようにします。次に slide_to_svg.py を更新して、スライドごとにアキュムレータをリセットし、テキストグラデーション定義を SVG <defs> セクションにマージします。修正後、テキスト要素は url(#gradient-id) のような塗りつぶしを正しく参照します。これらの変更を含む最新のコミットを必ず取得してください。

参照 Issue #143
トラブル対応
npx skills経由でインストールしたppt-masterを使用する際、projectsディレクトリが誤った場所に作成される問題を修正する方法

project_manager.py initを使用する際は、--dirフラグで出力ディレクトリを明示的に指定してください。例: python .agents/skills/ppt-master/scripts/project_manager.py init myproject --dir $(git rev-parse --show-toplevel)/projects。これにより、プロジェクトが.agents/skills/ppt-master/内ではなく、リポジトリのルートに作成されます。

参照 Issue #144
トラブル対応
現在20分以上かかっているAIを活用したPPT生成を高速化する方法は?

速度、品質、コストの間にはトレードオフが存在します。生成時間を短縮するには、品質の低下(例:簡素なページ)を受け入れるか、投資を増やす(より高速で高価なAIモデル、ClaudeやGPT-4などを使用する、または専用リソースを導入する)必要があります。品質を下げれば短時間で基本的なデッキを作成できますが、モデルをアップグレードすれば品質は維持されるもののAPIコストが増加します。追加費用なしで、高品質かつ2~3分での生成を実現する解決策はありません。

参照 Issue #97