PPTCraftSkill 设计规范拆解:一套能逐条自查的 PPT 排版硬指标
PPTCraftSkill 设计规范拆解:一套能逐条自查的 PPT 排版硬指标
项目地址:https://gitcode.com/agent-best-practices/PPTCraftSkill 本文不讲怎么装、怎么转文件(那部分见另一篇上手教程),只做一件事:把它写在代码里的设计规范逐条拆开,变成你能照着自查的清单。 这些规范不是审美玄学,而是带数值、能验证、可以交给 Agent 执行的硬约束。
为什么值得单独拆"规范"
做 PPT 的人常有两个困惑:
- 为什么自己排的页面"能看",但就是没有别人的"质感"?
- 为什么让 AI 生成的 PPT 总是"糊成一团"——字号小了、灰字看不清、每页都长一个样?
PPTCraftSkill 对这个问题的回答很直接:把"好看"拆成可量化的约束,然后写死。 它在 converter/designer/SKILL.md(97KB)和 knowledge/设计经验.md 里沉淀了一整套规则——字号换算表、对比度下限、密度上限、图表渲染铁律、版式弹药库。
本文把它们整理成 8 条规范 + 1 张自查表。每一条都带具体数值,可以直接拿去改自己的 PPT。
规范一:容器与防溢出——先定死画布
任何版式设计都得先有画布契约。这个项目的约定是:
| 层级 | 尺寸 | 说明 |
|---|---|---|
| 根容器 | 1280 × 720 |
16:9 标准页,固定不可变 |
安全内容区 .content-safe |
1220 × 660 |
四周各留 30px 边距 |
<div class="ppt-slide flex flex-col" type="content">
<div class="content-safe">
<!-- 所有核心内容只允许写在这里面 -->
</div>
</div>
为什么要有 30px 安全边距:投影、裁切、不同播放器都会吃掉边缘。把内容限制在 1220×660 里,投到任何屏幕都不会被切掉——这是"排版事故"最常见的来源,也是最容易预防的一条。
配套的四条禁止(比尺寸更重要):
- ❌ 禁止
overflow-hidden裁剪正文 - ❌ 禁止
text-overflow: ellipsis省略关键信息 - ❌ 禁止
line-clamp折叠内容 - ❌ 禁止缩小字号硬塞
前三条是"藏",第四条是"缩"。正确做法只有一个:超预算就拆页。 拆页是排版上唯一无副作用的扩容手段。
规范二:字号体系——pt = px × 0.75
这套换算表是整个规范的地基。HTML 里写 px,PPT 里是 pt,比例固定 0.75。
| 元素 | HTML (px) | PPT (pt) | 用途 |
|---|---|---|---|
| 页面主标题 | 37 | 28 | 每页唯一的最高层级 |
| 分项标题 | 21–23 | 16–17 | 卡片/区块标题 |
| 正文 | 19 | 14 | 阅读主体 |
| 标签 | 16 | 12 | 类别/关键词 |
| 注释/来源 | 12 | 9 | 页脚、数据出处 |
两条硬性约束:
- 最小字号下限:正文与标签 ≥16px,注释 ≥11px。低于这个值,投影仪上就开始糊。
- 相邻层级字号比 ≥1.2。主标题 37 / 分项 23 / 正文 19 —— 37÷23≈1.6,23÷19≈1.2,刚好压在下限上。
为什么要规定比值? 因为"层级感"不是靠加粗和颜色撑起来的,是靠字号差。两个层级只差 2px,观众根本看不出主次;差 1.2 倍以上,扫一眼就知道谁大谁小。
一条实操建议:如果你发现某页"信息很多但看起来平",先别调配色,先检查字号层级比是否够 1.2。
规范三:对比度——4.5:1 是底线,不是建议
这是最容易做砸、也最容易量化的一条。项目采用 WCAG AA 标准:正文对比度 ≥ 4.5:1。
允许的正文颜色只有两个:
#000000(纯黑)#555757(深灰)
明确禁止 #B5B5B5 及更淡的浅灰做正文或注释。灰色只允许 #898989(中灰),且仅限英文副标题这类辅助信息。
为什么禁浅灰? 因为在你的显示器上,"浅灰字"看起来是"高级的克制";在投影仪、在明亮的会议室、在别人那台偏暗的笔记本上,它就是"看不清"。而 PPT 的主要观看场景恰恰是投影。这条规范本质上是把"美观"从"我的屏幕"拉回到"观众的屏幕"。
一个简单的自查方法:把页面截图后转成灰度图,如果浅色文字和背景分不出界限,就说明对比度不够。
规范四:密度——宁可留白,不要堆满
| 约束 | 数值 |
|---|---|
| 正文行距 | 1.5 |
| 元素间距 | ≥16px |
| 每页核心观点 | 3–6 个 |
| 每卡正文 | ≤2 行(≤40 字) |
| 单页正文总行数 | ≤14 行 |
这套数字背后的逻辑是阅读节奏:一页 PPT 观众平均只看 3–5 秒。3–6 个观点是"能扫完"的上限;每卡 2 行是"能一眼读完"的上限;单页 14 行是"不产生压迫感"的上限。
项目的第一原则写得很直白:可读性 > 美观 > 速度。宁可拆页、留白、精简,绝不为了塞内容缩小字号或堆密度。
换句话说:内容多不是排版的理由,是拆页的理由。
规范五:图表——ECharts 的三条铁律
PPT 里的图表如果做错,往往不是"不好看",而是"导不进/变形/糊"。项目给了三条硬规则:
echarts.init(el, null, { renderer: "svg" }) // ① 必须 SVG 渲染器,且单行写出
- 用 SVG 渲染器,关掉动画
{ renderer: "svg" } // 矢量,放大不糊
animation: false // 动画会干扰转换与导出
- 禁止渐变。
areaStyle/itemStyle/lineStyle一律用半透明纯色,例如rgba(74,108,140,0.18)。
—— 渐变在转换后容易出现色带断层、渲染不一致;半透明纯色既保留层次感又稳定。
- 颜色只用三种来源:
#000000、#555757、以及你的强调色。坐标轴标签、图例、数据标签禁止浅灰。
第 3 条和规范三是一回事:图表里的文字也是文字,一样要过对比度这道关。 很多人的图表"看起来脏",根源就是坐标轴用了浅灰。
规范六:版式——每页不同,且改造有优先级
这是整个项目里最"反直觉"的经验,也是最有价值的一条:
在同一种卡片版式上只改颜色,用户几乎看不出差别,甚至觉得"没啥变化"。
作者做过多版对照后给出了明确的改造优先级:
版式(每页不同) > 字体(衬线/字重) > 图表(时间轴/流程/仪表盘)
> 排列(不对称/装饰/层级) > 配色(最后才碰)
配色排在最后。 这条和直觉相反——大多数人一提到"优化 PPT",第一反应就是换配色方案,而这恰恰是最无效的动作。
十种版式弹药库
别只用一种卡片排版,按内容类型选版式:
| 版式 | 适用 | 手法 |
|---|---|---|
| 封面 hero | 首页 | 大图/大标题 + 副题 + 金句 + 装饰 |
| 目录导航 | 第 2 页 | 编号 01–06 + 英文副标 + 分隔线 |
| KPI 仪表盘 | 数据概览 | 2–3 个大数字 + 定位句 + 要点 |
| 横向时间轴 | 历史/发展 | 中心线 + 圆点 + 年份/事件 |
| 图文不对称 | 详情页 | 一张大图(object-fit: cover)+ 右侧文字要点 |
| 标签云 | 关键词页 | 彩色 Tag 一排 |
| 图标网格 | 清单/分类 | 图标 + 名称 + 一句话,三色顶条 |
| 排名卡 | 榜单 | ①–⑥ 编号 + 名称 + 描述 |
| 流程图 | 路线/步骤 | 节点 + 箭头连接(DAY1/DAY2) |
| 金句结尾 | 收尾 | 大字引言 + 副标 + 装饰 |
一份 10 页的 deck,理想情况是至少用到 6 种不同版式。
规范七:配色——主题化,不是随机换色
配色要贴合主题,并且要有层次(主色 / 辅助色 / 点缀色)。项目里提炼了 5 套可直接复用的色板:
黑金(正式汇报)—— 底 #0F1423,玫红 #EC5F74,金 #FFBA55,蓝 #6096E6,绿 #56CA95,青 #58B6E5,珊瑚 #F18870
深蓝重用体(商务励志)—— 主色 #256090 + 阿里巴巴普惠体
Office 六色(通用安全)—— 深蓝 #1F497D / 蓝 #4F81BD / 红 #C0504D / 绿 #9BBB59 / 紫 #8064A2 / 青 #4BACC6 / 橙 #F79646
旅游活力—— 蓝 #4472C4 / 橙 #ED7D31 / 金 #FFC000 / 绿 #70AD47
古典金陵(文化主题)—— 朱砂红 #B03A2E + 墨绿 #2E5C4A + 金 #C9A06B,底为米白 #F7F3EA
三条使用要点:
- 只设 1 个主强调色,多色混用会变花哨。
- 深色主题(黑金/工业)更有高级感,但必须保证白色/金色文字对比度 ≥4.5:1。
- 内容页拒绝大面积深色底——阅读吃力。深色只用来做卡片点缀。
第 3 条值得展开:深色底在"封面/金句页"上很出效果,但连续几页深底会让人眼睛累。深色是调味料,不是主食。
规范八:字体与实景图——质感的两大来源
字体:被忽略的"质感源头"
同一套配色,标题用宋体还是黑体,气质完全不同:
- 标题衬线:文津宋体
WenJin Mincho Plane 0→ 书卷气,适合国学/文化/古典/高端 - 正文:文源黑体
WenYuan Sans SC/ Noto Sans SC → 可读性好 - 力量感:阿里巴巴普惠体 Heavy 字重(很出效果)
- 高端:思源宋体;现代:等线;通用:微软雅黑
代价要提前知道:中文字体嵌入会让 PPTX 体积从几 MB 涨到几十 MB,这是"字体丰富"的正常成本。不可接受时可以关掉字体嵌入,但要接受换机器打开可能字体回退。
实景图:旅游/展示类必填
<img src="..." style="object-fit:cover; width:100%; height:100%">
<!-- 再叠一层深色压暗渐变,保证文字可读 -->
background: linear-gradient(rgba(20,30,24,0.5), rgba(20,30,24,0.5))
两个经验:
object-fit: cover保证图片不变形且铺满——这是"专业感"最廉价的一招。- 必须压暗。原图直接压字,文字基本读不清;加一层半透明深色,既压得住字又不毁画面。
图源要小心:Bing 图片搜索经常对不上主题(搜"玄武湖"返回寺墙+樱花),且多带图源水印。正式场合请用无版权图源(如 Wikimedia Commons),或让需求方直接提供。
把规范变成一张自查表
生成或改完一页 PPT,照这 8 条过一遍,全过才算合格:
| # | 检查项 | 通过标准 |
|---|---|---|
| 1 | 画布 | 内容全部在 1220×660 安全区内,无裁切/省略/折叠 |
| 2 | 字号 | 正文 ≥16px、注释 ≥11px;相邻层级比 ≥1.2 |
| 3 | 对比度 | 正文 ≥4.5:1;无 #B5B5B5 及更淡的灰 |
| 4 | 密度 | 行距 1.5;每卡 ≤2 行;单页 ≤14 行;观点 3–6 个 |
| 5 | 图表 | SVG 渲染器、animation:false、无渐变、文字非浅灰 |
| 6 | 版式 | 本页版式与相邻页不同;10 页至少 6 种版式 |
| 7 | 配色 | 只有 1 个主强调色;深色底只用于点缀 |
| 8 | 图片 | object-fit:cover + 压暗层;图源可靠无水印 |
为什么这套规范能交给 Agent 执行
这是全文最想说明的一点。"好看"能被交给 AI,前提是它被拆成了可判定的命题。
对比一下:
| 不可执行的指令 | 可执行的规范 |
|---|---|
| "排版要清晰" | 正文 ≥16px,单页 ≤14 行 |
| "颜色别太淡" | 对比度 ≥4.5:1,禁 #B5B5B5 |
| "别太挤" | 行距 1.5,元素间距 ≥16px |
| "版本要丰富" | 10 页至少 6 种版式 |
左边是审美判断,只有人能拍板;右边是布尔判定,Agent 可以逐条自查。PPTCraftSkill 的设计规范之所以值得读,就在于它把左边那列全部翻译成了右边。
配套的还有一条元规则:改造优先级 版式 > 字体 > 图表 > 排列 > 配色。它解决的是"该先改什么"——避免把时间花在最无效的那个维度上。
附录:4 套内置风格速查
| 风格 | 特征 | 适合 |
|---|---|---|
business-classic |
白底 + 品牌红 #D33941,横向直角卡片 |
最通用 |
elegant-narrative |
米色羊皮纸 #f5f4ed + 陶土橙 #c96442 + 宋体标题 + 深炭卡明暗交替 |
最有质感 |
industrial-tech |
纯黑底 + 荧光绿 #76b900,硬朗字体 |
深色硬核 |
tech-minimal |
白/浅灰 + 科技蓝 #0071e3,极简大留白 |
科技产品 |
两个工程注意事项(来自实测):
- 在受限沙箱里渲染时,Chromium 启动可能被"命名管道"限制拦截(
spawn EPERM),需要完整权限。 - HTML 里的 CDN 资源(Tailwind / ECharts / 字体)会被转换器自动映射到本地
assets/,不要手动改成本地路径,改了反而破坏映射。
结语
如果只记一条,记这个:"好看"不是天赋,是一组可以被写下、被检查、被 AI 执行的数值。
字号 19px、对比度 4.5:1、行距 1.5、每卡 2 行、10 页 6 种版式、配色排在最后——把这些当宪法用,你的 PPT 会先跨过"专业"这条线,再去谈风格。
参考资料:项目 README.md、converter/designer/SKILL.md、knowledge/设计经验.md、converter/styles/*.md;文中所有尺寸、色值、比例均为项目内明确写明的规则。
- 点赞
- 收藏
- 关注作者
评论(0)