PPTCraftSkill 设计规范拆解:一套能逐条自查的 PPT 排版硬指标

举报
yd_274732647 发表于 2026/11/02 10:19:53 2026/11/02
【摘要】 PPTCraftSkill 的价值不在代码,而在它写死的一整套设计规范:字号换算(pt=px×0.75)、正文≥16px、对比度≥4.5:1、行距 1.5、单页≤14 行、ECharts 三条铁律、10 种版式弹药库,以及「版式>字体>图表>排列>配色」的改造优先级。本文把这些规则逐条拆开,整理成 8 条规范加 1 张可执行自查表,并说明为什么「好看」能被交给 AI 执行。

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 页脚、数据出处

两条硬性约束:

  1. 最小字号下限:正文与标签 ≥16px,注释 ≥11px。低于这个值,投影仪上就开始糊。
  2. 相邻层级字号比 ≥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 渲染器,且单行写出
  1. 用 SVG 渲染器,关掉动画
   { renderer: "svg" }   // 矢量,放大不糊
   animation: false      // 动画会干扰转换与导出
  1. 禁止渐变。areaStyle / itemStyle / lineStyle 一律用半透明纯色,例如 rgba(74,108,140,0.18)。

—— 渐变在转换后容易出现色带断层、渲染不一致;半透明纯色既保留层次感又稳定。

  1. 颜色只用三种来源:#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. 只设 1 个主强调色,多色混用会变花哨。
  2. 深色主题(黑金/工业)更有高级感,但必须保证白色/金色文字对比度 ≥4.5:1。
  3. 内容页拒绝大面积深色底——阅读吃力。深色只用来做卡片点缀。

第 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;文中所有尺寸、色值、比例均为项目内明确写明的规则。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。