guizang-ppt-skill 是什么?

Guizang PPT Skill 是给 Claude Code、Codex、Cursor 等本地 Agent 使用的网页演示技能。它让 Agent 按电子杂志或瑞士国际主义两套规则生成单文件 HTML deck,并附带版式、演讲者模式与检查脚本。

⭐ 20,033 Stars 🍴 1,452 Forks HTML MIT 作者: op7418
来源:github.com/op7418/guizang-ppt-skill 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

项目仍值得保留,因为正式版后又补入演讲者模式,现有页面需要把 v1.1.0 与 main 的边界、文件权限和可选联网配图区分清楚。

来源:github.com/op7418/guizang-ppt-skill/releases/tag/v1.1.0

核心功能

两套视觉系统

Style A 提供 10 种电子杂志版式;Style B 提供 22 种锁定的瑞士风版式和 4 套锚点色。

来源:github.com/op7418/guizang-ppt-skill
单文件 HTML 演示

产物可直接用浏览器打开,支持键盘、滚轮、触屏、索引和低性能静态模式。

来源:github.com/op7418/guizang-ppt-skill
演讲者模式

main 分支包含双窗口预览、备注、计时、自动翻页、激光笔、圈选和观众屏恢复。

来源:github.com/op7418/guizang-ppt-skill
可执行校验器

Node 脚本检查瑞士风版式、图片槽位、危险 SVG、演讲备注和两套模板的运行时同步。

来源:github.com/op7418/guizang-ppt-skill/tree/main/scripts

技术架构

SKILL.md 定义 Agent 工作流;references 保存布局、主题、配图、截图与演讲者模式规则;assets 提供两套 HTML 模板;scripts 下的 Node 校验器检查生成文件。Agent 先澄清需求,再复制模板、填内容、可选生成图片、写备注、运行校验并在浏览器预览。

来源:github.com/op7418/guizang-ppt-skill

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 支持读取 SKILL.md 的本地 Agent支持读取 SKILL.… 用于 npx 安装和校验脚本的 Node.js用于 npx 安装和… 浏览器预览 可选 GPT-Image 2.0 或 GPT-M 2.0 配图可选 GPT-Image… 两套视觉系统 单文件 HTML 演示 演讲者模式 可执行校验器 guizang-ppt-skill 项目本体 核心功能 关键依赖

技术栈

语言HTML/CSS/JavaScript 与 Node.js 校验脚本框架Agent Skill + 自包含浏览器演示运行时
支持读取 SKILL.md 的本地 Agent用于 npx 安装和校验脚本的 Node.js浏览器预览可选 GPT-Image 2.0 或 GPT-M 2.0 配图
本地文件系统与浏览器;核心演示不需要服务器,可选图片生成和远程素材需要网络
来源:github.com/op7418/guizang-ppt-skill

快速上手

先审查仓库的 SKILL.md 与 scripts,再运行 npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill。手动安装可克隆到 ~/.claude/skills/guizang-ppt-skill。首次只提供一份无敏感信息的 Markdown,生成 6 至 8 页 deck;随后在浏览器检查 16:9 布局并运行对应 Node 校验器。
来源:github.com/op7418/guizang-ppt-skill

使用场景

适合线下分享、产品分析、观点演讲和同主题多平台封面。不适合大段表格、信息密集培训课件或多人同时编辑的原生 Office 流程。

来源:github.com/op7418/guizang-ppt-skill

优势与局限

优势

  • 布局、主题、配图和演讲者模式有明确约束
  • 单文件 HTML 便于本地预览和交付
  • 两类校验脚本能拦截部分布局与运行时问题
  • 赞助信息与用户产物有明确隔离说明

局限

  • 宿主 Agent 需要文件写入、shell 和浏览器能力
  • 可选图片生成会把提示词和素材发送给外部模型
  • 静态 HTML 不适合多人协作编辑
  • 最新正式版仍是 v1.1.0,main 的演讲者模式晚于该 release
  • 当前许可证为 AGPL-3.0,嵌入产品前应审查义务
来源:github.com/op7418/guizang-ppt-skill

最新版本

最新正式版是 v1.1.0,发布于 2026-05-15,新增瑞士风工作流、Codex 配图指导和瑞士地图组件。main 在 2026-08-07 又加入演讲者模式,因此 release 与当前文档并不完全相同。

来源:github.com/op7418/guizang-ppt-skill/releases/tag/v1.1.0

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 核对官方 README、SKILL/目录说明、SPONSORS.md、AGPL-3.0 LICENSE、v1.1.0 release 与 main 提交记录  |  limitations: 未安装 skill,未让 Agent 执行其指令,未运行 Node 校验器,未生成图片或 HTML deck,也未做浏览器视觉检查  |  observed_output: 最新正式 release 为 v1.1.0,发布于 2026-05-15;main 最新记录为 2026-08-07,并在 release 之后加入演讲者模式

来源:github.com/op7418/guizang-ppt-skill/releases/tag/v1.1.0

同类项目对比

Marp CLI 把 Markdown 转成 HTML、PDF、PPTX 和图片,并支持固定版本的 CLI、容器及浏览器转换;Guizang PPT Skill 直接让 Agent 修改 HTML 模板,重心是两套视觉系统、配图和演讲者模式。需要可重复的 Markdown 转换与多格式导出时选 Marp;需要 Agent 驱动的强视觉网页演示时再选 Guizang。

来源:github.com/marp-team/marp-cli

总结评价

保留。项目有赞助方和第三方平台入口,但官方明确赞助信息不进入用户产物,也没有项目方订阅、充值或额度转售。使用前应先审查 SKILL.md 和 Node 脚本,并固定版本。

来源:github.com/op7418/guizang-ppt-skill/blob/main/SPONSORS.md

常见问题

Guizang PPT Skill 的 v1.1.0 和 main 有什么区别?

v1.1.0 是 2026-05-15 发布的最新正式版;main 在 2026-08-07 又加入演讲者模式和运行时修复。需要复现时固定 v1.1.0,想用演讲者模式则固定经过审查的 main commit。

安装 Guizang PPT Skill 会运行哪些代码?

npx skills add 会联网取得 skill;生成过程需要宿主 Agent 读写文件并可能执行 shell。瑞士风和演讲者模式校验器是 Node 脚本,运行前应先查看脚本内容。

生成的 HTML PPT 必须联网才能演示吗?

不必。官方模板把核心演示能力放在本地单文件 HTML 中;可选的 GPT-Image 或 GPT-M 配图需要外部模型,远程字体、图片或视频也会带来网络依赖。

Guizang PPT Skill 能直接导出可编辑 PPTX 吗?

官方主交付物是单文件 HTML,没有承诺直接导出可编辑 PPTX。需要 PDF 或 PPTX 工作流时可另评估 Marp CLI,但两者的版式和视觉目标不同。

赞助链接会写进生成的幻灯片吗?

官方 SPONSORS.md 明确说赞助只出现在项目介绍材料,不写入用户生成的 PPT、HTML、封面或配图。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件