AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
docs(readme): recommend Git clone first, add skill-only download fallback
hugohe33380e540e9f4
diff --git a/README.md b/README.mdindex 27edbb23..da4de955 100644--- a/README.md+++ b/README.md@@ -232,11 +232,7 @@ Never used one of these? Don't worry — in this project they play exactly one r### 3. Set Up-**Option A — Download ZIP** (no Git required; best for a quick trial): click **Code → Download ZIP** on the [GitHub page](https://github.com/hugohe3/ppt-master), then unzip.--If you plan to keep using PPT Master and update it over time, use Git clone instead.--**Option B — Git clone** (recommended; requires [Git](https://git-scm.com/downloads) installed):+**Option A — Git clone** (recommended; requires [Git](https://git-scm.com/downloads) installed): the preferred path, since a clone can pull the latest version at any time.```bashgit clone https://github.com/hugohe3/ppt-master.git@@ -249,6 +245,8 @@ Then install dependencies:pip install -r requirements.txt```+**Option B — Download ZIP** (no Git required; best for a quick trial): click **Code → Download ZIP** on the [GitHub page](https://github.com/hugohe3/ppt-master), then unzip, and install dependencies with `pip install -r requirements.txt`. A ZIP has no Git history, so it can't `git pull` — see Updating Later. If that download is too large or fails, grab the skill-only package `ppt-master-skill-*.zip` (~50 MB, fully functional but without the bundled example decks) from the [Releases](https://github.com/hugohe3/ppt-master/releases) page instead.+#### Updating Later**Git clone installs:**diff --git a/README_CN.md b/README_CN.mdindex 4e4bd29a..218445f7 100644--- a/README_CN.md+++ b/README_CN.md@@ -236,17 +236,12 @@ PPT Master 在**任何具备 agent 能力**(可读写文件、执行命令、### 3. 配置项目-**方式 A — 下载 ZIP**(无需安装 Git,适合快速体验):-[GitHub](https://github.com/hugohe3/ppt-master) → **Code → Download ZIP** · [AtomGit](https://atomgit.com/hugohe3/ppt-master) → **克隆/下载 → 下载ZIP**(国内网速更快)--如果你打算长期使用并持续更新,推荐使用下面的 Git clone 方式。--**方式 B — Git clone**(推荐;需先安装 [Git](https://git-scm.com/downloads)):+**方式 A — Git clone**(推荐;需先安装 [Git](https://git-scm.com/downloads)):首选这种方式,因为 clone 可以随时拉取最新版本。```bash# GitHubgit clone https://github.com/hugohe3/ppt-master.git-# AtomGit(国内网速更快)+# AtomGit(中国大陆地区网速更快)git clone https://atomgit.com/hugohe3/ppt-master.gitcd ppt-master```@@ -257,6 +252,11 @@ cd ppt-masterpip install -r requirements.txt```+**方式 B — 下载 ZIP**(无需安装 Git,适合快速体验):+[GitHub](https://github.com/hugohe3/ppt-master) → **Code → Download ZIP** · [AtomGit](https://atomgit.com/hugohe3/ppt-master) → **克隆/下载 → 下载ZIP**(中国大陆地区访问 GitHub 下载不便时用这个,网速更快);解压后同样用 `pip install -r requirements.txt` 装依赖。ZIP 没有 Git 历史,不能自动 `git pull`(更新见下)。++如果完整仓库下载失败、或嫌体积太大,可以改到 [Releases](https://github.com/hugohe3/ppt-master/releases) 页面下载纯技能包 `ppt-master-skill-*.zip`(约 50 MB,功能完整,但不含内置示例 deck)。+#### 日常更新**Git clone 安装:**diff --git a/docs/faq.md b/docs/faq.mdindex a99e350b..fd628d99 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -52,6 +52,15 @@ python3 skills/ppt-master/scripts/update_repo.pyIf the folder is not a Git clone, the script will tell you how to migrate a ZIP install.+## Q: The repo is over 1 GB and my skills tool fails to download it — can I get just the skill?++Yes. The full repository is large (Git history plus bundled example decks and their assets), and that size is baked into the history — it can't be trimmed without breaking the many existing forks. If you only want the skill and not the full repo, use a lightweight path instead:++- **Marketplace CLI**: `npx skills add hugohe3/ppt-master` or Claude Code's `/plugin install` fetch the skill files only (see the Set Up section of the README).+- **Manual download**: grab `ppt-master-skill-*.zip` from the [Releases](https://github.com/hugohe3/ppt-master/releases) page — the skill files only (~50 MB), no full-repo clone.++Either way, run `pip install -r requirements.txt` from the installed location so the post-processing scripts work.+## Q: Can I use AI-generated images in my presentation?Yes. PPT Master includes a built-in image generation script that supports multiple providers (Gemini, OpenAI, FLUX, Qwen, Zhipu, etc.). During the Strategist phase, if you choose "AI generation" for the image approach, the pipeline will automatically generate images based on your content. You can also provide your own images — just place them in the project's `images/` folder.diff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex 0ee0077a..318f4e53 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -52,6 +52,17 @@ python3 skills/ppt-master/scripts/update_repo.py如果当前目录不是 Git clone 版本,脚本会提示你按 ZIP 方式迁移。+## Q: 仓库超过 1 GB,skills 工具下载直接失败——能只拿 skill 吗?++可以。完整仓库确实很大(Git 历史,加上内置的示例 deck 及其素材),而且这个体积是写进历史里的——在不破坏已有大量 fork 的前提下没法瘦身。如果你只想要 skill、不需要完整仓库,用下面的轻量方式:++- **Marketplace CLI**:`npx skills add hugohe3/ppt-master`,或 Claude Code 里的 `/plugin install`,都只拉取 skill 文件(见 README 的「开始设置」一节)。+- **手动下载**:到 [Releases](https://github.com/hugohe3/ppt-master/releases) 页面下载 `ppt-master-skill-*.zip`——只含 skill 文件(约 50 MB),无需 clone 完整仓库。++两种方式装好后,都要在安装目录跑 `pip install -r requirements.txt`,后处理脚本才能工作。++中国大陆地区访问 GitHub 下载不便的话,完整仓库在 [AtomGit](https://atomgit.com/hugohe3/ppt-master) 也有镜像(clone 或下载 ZIP);1 GB 出头的体积在中国大陆地区网络下载一般没问题。+## Q: 能用 AI 生成配图吗?可以。PPT Master 内置了图片生成脚本,支持多个供应商(Gemini、OpenAI、FLUX、通义千问、智谱等)。在策略师阶段选择"AI 生图"方案后,流程会根据内容自动生成配图。你也可以使用自己的图片——只需放到项目的 `images/` 目录下即可。