Guizang PPT Skill

项目简介

一个适配 Claude Code / Codex 等 Agent 环境的网页 PPT 技能。内置两套视觉系统：电子杂志×电子墨水风格与瑞士国际主义风格。可生成单文件 HTML 横向翻页 PPT、PPT 配图和多平台封面，并内置完整的演讲者模式与排练功能。

核心功能

• 双视觉系统：Style A 电子杂志风负责叙事，Style B 瑞士风负责事实表达
• 横向左右翻页：支持键盘方向键、滚轮、触屏滑动、底部圆点和 ESC 索引
• Style A 提供 10 种布局，Style B 提供 22 种锁定版式
• 主题色预设：Style A 5 套电子墨水主题，Style B 4 套瑞士高饱和锚点色
• 可选配图流程：在 Codex 中可用 GPT-Image 2.0 / GPT-M 2.0 生成照片、信息图等并按模板比例插入
• 演讲者模式：内置双窗口观众屏、演讲备注、计时排练、自动翻页和激光笔等现场工具，单文件 HTML 可直接在浏览器打开

适用场景

• 长文章变演讲 PPT：先抽核心观点，再按 6-10 页节奏生成 deck
• 方法论 / 产品分析：用 Style B 瑞士风，优先使用锁定版式和 21:9 主图
• 个人分享 / 观点表达：用 Style A 电子杂志风，保留更强叙事感
• PPT 配图或截图统一风格：生成照片、信息图、流程图、UI 情景图，或把截图重新生成到模板比例

快速开始

• 使用 npx skills add https://github\.com/op7418/guizang\-ppt\-skill --skill guizang-ppt-skill 安装
• 或将仓库克隆到 ~/.claude/skills/guizang-ppt-skill
• 安装后对 Agent 说“帮我基于这篇文章做一份瑞士风 PPT”等请求即可触发
• 打开生成的 HTML 文件后，按右下角 P 进入演讲者模式

部署与要求

• 支持 Claude Code 和 Codex；Cursor 等其他本地 Agent 需能读写文件并执行 shell 命令
• 普通 Chatbot 不推荐，因为没有文件系统和浏览器预览时难以稳定生成完整 deck
• 生成的 HTML deck 不需要构建和服务器，浏览器直接打开即可演示
• 演讲者模式在本地浏览器完成，不依赖实时字幕、云端中继、手机遥控或 AI 教练服务

采用前须知

• 许可证：AGPL-3.0。在使用、修改或分发项目前，请确认其具体条款。
• 不适合大段表格数据、培训课件或需要多人协作编辑的场景。
• 演讲者模式在本地浏览器完成，不提供实时字幕、手机遥控或 AI 排练评分。
• 主题色不允许自定义 hex 值，只能从预设主题中选择。