Themes for PPT Master
为 PPT Master 提供的编辑设计扩展包：一套包级设计哲学、可扩展的 Style 主题（目前四套）、A4（33 个原型）与 16:9（17 个原型）两套编辑 Layout、一份所有主题共用的图表文法、一套证明效果的 A/B 评测，以及一个展示网站。
目标不是「套模板」，而是让一句简单的需求也能得到有判断、有节奏、可编辑、经得起检查的成品 PPTX。
本包的「主题」只是扩展命名：上游 PPT Master 只有 Brand / Style / Layout / Deck 四种 kind，没有第五种。四套主题都落地为 Style；A4 Editorial 与 16:9 Editorial 是独立 Layout，用本包时按画布与主题组合安装。
里面有什么
另加：
- 16:9 Editorial Layout：17 个 16:9 结构原型，把 A4 的六轨网格与编辑文法搬到屏幕演示上：主张页、注释证据、开放表格、序数时间线、站在刻度上的巨型数字、冲孔铭牌、网格蒙版与错位支柱，没有卡片墙和 KPI 瓷砖。
- A4 Editorial Layout：33 个 A4 结构原型，一个 Master，覆盖双栏阅读、旁注、跨页全景、多图瀑布、解构蒙版、深色数字柱、跨屏沉浸与专题 folio。它只提供结构，可与任意 Style 和 Brand 组合。
- Data Graphics：全主题硬性图表文法——透明绘图区、发丝线、末端直标、一个强调色，拒绝 KPI 卡片、仪表盘与「线条＋彩块」。
- 展示网站：四套编号主题、33 个版式实景索引、示例下载与部署说明。
快速开始
本包是一个标准 Agent Skill（SKILL.md + scripts/），可用于 Claude Code、Codex、WorkBuddy 等支持 Agent Skills 的 agent。它依赖 PPT Master 6.7.x 来跑流程和导出。
一键安装（会把本包和 GitHub 上最新 release 的 ppt-master 并排放进各 agent 的 skills 目录；已装过 ppt-master 的会直接复用）：
python3 scripts/install.py --target all # Claude Code + Codex + WorkBuddy，用户级
python3 scripts/install.py --target codex --scope project
python3 scripts/install.py --target claude --dry-run # 只看会做什么
| Agent | 用户级目录 | 项目级目录 |
|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
| WorkBuddy | ~/.workbuddy/skills/（Windows：%APPDATA%\WorkBuddy\skills\） | .workbuddy/skills/ |
手动安装也可以：把本仓库和 ppt-master 的 skills/ppt-master/ 放进同一个 skills 目录即可。agent 运行时会用 scripts/ensure_ppt_master.py 找 ppt-master；找不到时会先征得你同意，再从 GitHub 下载最新 release。
使用：直接点名本包，不需要写路径，例如：
用 ppt-master-themes 做一本给家长看的 A4 研学手册
用 ppt-master-themes，瑞士国际主义风格，做一份建筑事务所作品集
agent 会用 scripts/list_themes.py 列出主题，选定后交给 ppt-master 安装；没有现成主题的风格会在本包的设计哲学内派生一个方言。
agent 的入口与「一句 brief → 大师级 deck」的判断见 SKILL.md；目录职责、维护命令与验证记录见 MAINTAINING.md。
目录
| 路径 | 作用 |
|---|
themes/<id>/workspace/ | 可安装的 Style 工作区；唯一会被 ppt-master 安装的主题内容 |
themes/<id>/recipes.md | 页面构图与技法参考，不进入安装 |
themes/<id>/examples/ | 完稿 SVG、预览、示例 PPTX、素材来源 |
layouts/a4-editorial/workspace/ | 可安装的 A4 Layout 工作区（33 个原型） |
layouts/ppt169-editorial/workspace/ | 可安装的 16:9 Layout 工作区（17 个原型）；build_prototypes.py 生成原型 |
framework/ | 图表、排版、文案、图片、集成与运行时说明 |
projects/ | 本机生成项目（Git 忽略） |
website/ | 静态展示站与发布审核；不是生成源 |
vibe_images/ | 本机情绪板草稿；不安装、不发布 |
质量与兼容
- 四套 Style 均通过官方
svg_quality_checker.py --template-mode --canonical-authoring；A4 Layout 同样通过（32 个 OK、1 条非阻断提示、0 个错误）。
- 四套主题分别运行
framework/scripts/compat_check.py --theme <id> 均返回 OK，覆盖契约、Style 校验、use_when/avoid_when 与 Theme DNA 字段、两套 Layout 的 template-mode 校验，以及 Style + Layout 组合的 apply_template dry-run。compat_check 是本仓库的维护脚本，上游没有这个命令；PM/scripts/svg_compatibility.py 是导出器内部归一化，也不是工作区校验器。该结果只是冒烟，不等于完整生成验收。
- Boardroom 的 15 页已用 PPT Master 6.7.3 实际生成、导出，并逐页检查封面、图表页、记分页与结束页；NatGeo、Fashion 的
theme.json 记录 6.7.3 为 tested_with_ppt_master；Brand Geometry 只记录了 6.7.3 的兼容性审阅，尚无端到端 tested 版本。
- 上游脚本需要 Python 3.12（系统 3.9 会因
str | None 语法失败）。运行示例：
uv run --python 3.12 --with pillow --with pyyaml python \
"$PM/scripts/svg_quality_checker.py" "$ST/themes/boardroom/workspace/templates" \
--template-mode --canonical-authoring
uv run --python 3.12 --with pillow --with pyyaml python \
"$PM/scripts/svg_quality_checker.py" "$ST/layouts/a4-editorial/workspace/templates" \
--template-mode --canonical-authoring --format a4
uv run --python 3.12 --with pillow --with pyyaml python \
"$ST/framework/scripts/compat_check.py" --pm "$PM"
新增主题
python3 framework/scripts/new_theme.py --id <id> --name "<Name>" --name-zh "<中文名>"
按 Theme Contract 写 theme.json、Style spec、配方与示例；Style frontmatter 只能有 style_id、kind: style、summary、keywords（3–5 个），正文保持 I–VII 七节。完成后跑工作区校验、compat_check 和一次真实生成，再更新网站。
不要新增模板 kind、route 或确认门；不要把身份/结构写进 Style；不要把普通页面称为母版。
网站
npm run build
npm run dev
打开 http://127.0.0.1:6077/。首页按 01—04 编号展开四套主题，以实景图索引全部 33 个 A4 版式，并用“同一个版式，四种语气”展示 17 个 16:9 版式；点击版式可进入 /layouts/?id=… 或 /layouts/169/?id=… 详情，两个实验室都能按主题切换同一页型。极淡的极光背景与点击涟漪会遵循 prefers-reduced-motion。网站零运行时依赖，构建时自动检查内部链接、版式数量、公开图片清单与下载校验值；部署到 Vercel 或 GitHub Pages 的配置见 website/README.md。
许可与素材
代码与文档为 Apache 2.0。Fashion 的 Bodoni Moda / Archivo / Six Caps、NatGeo 的 Playfair Display / Oswald 为 OFL，许可证随字体提供；Brand Geometry 与 Boardroom 使用系统 Georgia/Arial，不分发字体文件。
示例照片的许可以主题为准：NatGeo、Brand Geometry、Boardroom 使用 Wikimedia Commons 的 CC0 文件；Fashion 使用 Unsplash License（可商用，不要求署名，但不是 CC0）。网站公开的风景照片均为 CC0，记录在 website/artwork/photo-sources.json；作者、来源、哈希与处理记录见各主题的 examples/PHOTOS.md。
示例中的品牌、数字与文案均为演示内容，不代表任何真实机构；不使用杂志扫描页、未授权人物肖像或可识别品牌广告图。
