yzsp-studio/mediakit-shared-suite / ppt
ppt
Unverified飞书幻灯片:创建和编辑幻灯片。创建演示文稿、读取幻灯片内容、管理幻灯片页面(创建、删除、读取、局部替换)。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。
references/style/slide-taxonomy.md
View on GitHub# 设计系统总纲与场景路由
**这是"选定设计系统"这一步的入口。** 一份演示文稿只选一套设计系统,它统一决定这份 deck 的配色、字体、留白、版式等所有视觉决策。
使用方式(三步):
1. **遵守通用规则**:本文「通用规则」适用于全部七个场景的所有页面,与所选场景的风格文档一起生效,但用户指定的模板、排版、品牌规范、配色、字体、参考风格优先于本指南。
2. **判定场景**:根据用户输入选择唯一匹配的主场景。
3. **读取场景文档**:读取该场景对应的风格文档,按其表达重点与方法进行设计。
> **卡片用法的唯一裁决者是设计系统本身,其它任何文档都不得再追加"要不要用卡片"的规则。**
> - 匹配到七个场景之一 → **禁止**用任何卡片,用线条、留白、字号对比替代。
> - 不匹配任何场景 → 回退到兜底设计系统 [`fallback.md`](fallback.md)
> - 用户直接给了模板/品牌规范/配色/字体/参考风格等其他要求 → 以用户为准。
## 第一步:通用规则
> 以下通用规则约束「匹配到具体场景」时的设计。回退到兜底 [`fallback.md`](fallback.md) 时,以兜底文档为准。
### 要求
1. **每页都有明确的读者任务**:这一页要让读者理解什么、相信什么、决定什么或做什么——动手设计前先想清楚。
2. **翻页有节奏**:自行判断是否需要目录页或章节页;读者翻阅时应能感到节奏变化——有的页面一眼看完,有的值得停下细读。
3. **灵活使用图表与形状组合**:当一段信息可以用超出当前图表语法表达能力的复杂图示来呈现时,鼓励灵活用形状等手段构建这种表达,但是shape使用不得出现在封面页、结尾页和章节分割页。
5. **合理使用搜图/生图**:用搜图/生图工具获取图片并放到合适位置。但严禁滥用图片。用户上传的附件里若有可用图片,用在合适的页面上,如果不是用户指定不能用搜图结果放在封面上,封面只支持高质量图。
6. **以用户和主题为准**:用户指定的模板、品牌规范、配色、字体、参考风格和要使用的附件优先于本指南。
7. **来源标注**:涉及外部事实和数据的页面必须标明来源、日期或时间区间、以及口径。来源文本用 `<a href="url">` 超链接指向原始报告或数据页;脚注里引用具体来源时同样用 `<a href="url">` 链接到原始出处,强化专业可信度。
8. **排版均衡分割**:同一层级且同一行横向并列的多卡片/模块/栏目,默认必须采用 等宽均分 布局,保证视觉重心平衡,不允许出现肉眼明显不均的宽度分配。同层级模块的 对齐基线 需统一,包括顶部对齐、底部对齐或内容起始位置对齐。只有在需要通过版面宽度表达内容主次关系时,才允许非等宽布局。
9. **结构化信息必须使用原生表格**:涉及数据对比、指标清单、参数说明、维度拆解、结构化信息呈现时,必须使用 Slides 原生 `<table>` 或合适的图表组件承载,不得在页面文案或 XML 中输出 Markdown 表格(如 `| 字段 | 数值 |`)。Markdown 表格只适合说明文档,不是幻灯片可渲染的结构化组件。
10. **图表专业度**:扇形图、环形图需要保障每一个图例颜色有足够视觉区分度,不能出现一样的颜色,可以用主色组合其他颜色,这是全slides内唯一允许使用主题色和辅助色以外颜色的地方,也可使用slides内主题色不同透明度梯度进行区分。
11. **保障信息区分度** 序号和文字如果字号相同且平行的话之间需要有一个空格;前置小标题(含加粗文字)与后续阐释内容之间需有明确间隔,可通过空格、中文冒号或换行实现。
12. **目录是决定质量的关键**:目录页必须避免“小字堆叠”和“大面积空白”两种问题,章节模块需要均匀铺满页面;若单列排布无法保证舒展和均衡,应自动改为左右双列布局。可以用大字和小字组合,一个章节标题下面辅以小字号说明。章节编号与章节名称不要放在一个文本框内挤在一起。
13. **用户机构配色是配色参考优先级最高的**:如果用户说明了具体的所属比如学校、公司、机构等,需要先执行搜索对应的logo,用对应主色制作ppt要好于用style推荐。
14. **符号使用规范**:必须严格区分全角与半角符号中文语境下统一使用全角中文标点,英文单词、数字、代码、URL、文件路径及技术标识中统一使用半角符号;不得混用或误用,确保表达专业、版式统一、可读性稳定。
### 严格禁止
- **证据边界**:不得编造数据、引用、客户案例、实验结果或来源;素材缺失时,明确标注为占位、假设或待补充信息。
- **经典 AI 套路**:非用户要求严禁用卡片搭建层级或对齐(圆角矩形、矩形卡片、带色条的卡片)——线条、留白和字号对比是更好的方案;严禁把红、紫、黄、绿一股脑堆在同一页的 AI 配色。
- **禁止彩虹色和靠色**:如果不是skill指定参考配色,禁止用大于三种颜色在一个slides内。禁止文字和背景靠色,必须谨慎保障文字能够清晰展示不溶于背景。
- **query里的明亮不代表彩虹**:要求明亮也只能使用三种以内颜色,要合理搭配
- **禁止堆叠目录**:目录页必须避免“小字堆叠”和“大面积空白”两种问题,章节模块需要均匀铺满页面;若单列排布无法保证舒展和均衡,应自动改为左右双列布局。章节编号与章节名称不要放在一个文本框内挤在一起。
- **禁止滥用shape**:禁止在章节页和封面用抽象shape,用高质量图片是更好的选择
- **禁止滥用截图**:如果图片来自于用户附件,图片必须原汁原味使用,不得进行图片切割,应该让排版适应图片而不是图片适应排版。
### 用户上传了 PPTX 模板的用法
**用户上传 PPTX 附件要求"参考"其风格或者用这个模板做ppt时并不是把它当整套模板逐页复用,一旦附件内有pptx并且用户意图是用这个pptx作为模板做ppt时先按以下方法处理后再路由对应的style参考设计原则**:
1. **先看渲染效果,别止步于抠文字**:实际打开样本,截图看清页面真实呈现的视觉效果;只跑xml提取拿到一堆文字不算看懂模板。
2. **提炼一份精简的参考要点,不逐页照搬**,按三类记录可迁移的东西:
- **可迁移的版式手法**:如模板的网格骨架、配色规则、步骤式导航、证据分区等结构性设计。
- **可迁移的风格**:如克制、亲和、严谨,或活动现场感、公务通传感等基调倾向。
- **可迁移的图形语法**:如并列模块、时间轴路径、嵌套层级、取景框等表达手法。
3. **不能修改的东西**:主要字体、背景图片(尺寸跟ppt一样大的视为背景)、模板自带的品牌标识、真实人物/照片、原始文案、专属色值、装饰纹样——这些必须在新设计内保留,但是可以灵活的进行设计。
4. **设计时对应页面类型**:判断内容表达更适配里的哪一类,不要把这点局部经验放大成整套页面的通用规则。
5. 没有合适的可以直接使用的页面时按照合适的设计系统自行搭建。
## 第二步:判定场景
根据用户输入,分析演示文稿的受众和读者任务,判定它所属的场景,并读取对应的风格文档。
> 选择一个主场景。确有必要时可以再加一个辅助场景,但必须以主场景为准。
| 场景类型 | 典型诉求 | 读者任务 | 风格文档 |
|---|---|---|---|
| 分析决策 | 咨询、金融、行业研究、战略、市场机会、商业分析、投资分析 | 比较选项、形成判断、支撑决策 | [`strategy-and-analysis.md`](strategy-and-analysis.md) |
| 商业提案 | 营销方案、销售提案、融资路演、招商/招投资、产品提案、商业计划书 | 理解价值、相信方案、采取行动 | [`business-pitch.md`](business-pitch.md) |
| 管理汇报 | 工作汇报、项目复盘、季度总结、OKR、管理简报、职业培训 | 掌握现状、暴露问题、确认行动 | [`business-review.md`](business-review.md) |
| 学术研究 | 研究生课题、论文答辩、科研项目、开题报告、中期报告、结题/汇报 | 评估问题、方法、证据与贡献 | [`academic-research.md`](academic-research.md) |
| 教育培训 / 知识科普 | K12 课件、教学演示、患者教育、专业科普 | 理解、记住、正确应用或行动 | [`learning-and-training.md`](learning-and-training.md) |
| 技术工程 | 工程方案、架构评审、研发报告、AI / 数据 / 运维 / 安全 | 看清结构、依赖、指标与取舍 | [`technical-presentation.md`](technical-presentation.md) |
| 品牌 / 创意展示 | 品牌故事、设计提案、作品集、文化活动、人物介绍、影片艺术品介绍 | 建立认知、留下记忆、形成认同 | [`brand-storytelling.md`](brand-storytelling.md) |
**兜底**:如果演示文稿明显不属于以上任何场景,不要强行套最接近的一个——回退到兜底设计系统 [`fallback.md`](fallback.md)(信息密度极高的图文卡片布局)。
## 字体系统
除用户明确要求繁体中文、港澳台语境或原文素材本身为繁体外,中文内容默认使用简体中文;不要为营造风格感轻易改写成繁体字,避免字体缺字、fallback 字体不一致或跨端渲染异常。
| 字体名称 | 语种 | 字体类型 | 风格与特点 | 适用场景 |
|---|---|---|---|---|
| 思源黑体 | 中文 | 无衬线(黑体) | 结构规整,屏幕可读性最稳 | 通用、汇报、技术 |
| 思源宋体 | 中文 | 衬线(宋体) | 笔画有对比,端正典雅 | 学术、文化、正式演示 |
| 寒蝉锦书宋 | 中文 | 衬线(细宋) | 纤细修长,书卷气浓 | 文化、品牌、艺术 |
| 寒蝉团圆体 圆体 | 中文 | 圆体 | 圆头笔画饱满,活泼亲和 | 儿童、生活方式、娱乐 |
| 霞鹜 975 圆体 | 中文 | 圆体 | 圆润柔和,克制耐看 | 教育、科普、生活方式 |
| 有字库龙藏体 | 中文 | 书法(毛笔) | 毛笔行楷,笔锋凌厉 | 国风、文化、海报 |
| 楷体 | 中文 | 系统楷书 | 结构端正,免安装 | 传统文化、引文 |
| Inter | 拉丁 | 无衬线 | 屏幕优先,小字号清晰 | 通用、数据密集页 |
| IBM Plex Sans | 拉丁 | 无衬线(工程感) | 机械与人文混合 | 技术、工程、研究 |
| Nunito | 拉丁 | 无衬线(圆角) | 圆角终端,亲和友好 | 教育、科普、消费 |
| Montserrat | 拉丁 | 无衬线(几何) | 招牌风格,大写气场强 | 提案、营销、封面 |
| Josefin Sans | 拉丁 | 无衬线(Art Deco) | 复古装饰风,字面偏小 | 创意、文化 |
| Bebas Neue | 拉丁 | 窄体全大写 | 仅大写,冲击力克制 | 海报、封面 |
| Anton | 拉丁 | 超粗窄体 | 视觉重量最大 | 口号、关键数据、巨字页 |
| Barlow Condensed | 拉丁 | 窄体无衬线 | 微方轮廓,字重齐全 | 技术、工业、数据页 |
| EB Garamond | 拉丁 | 衬线(古典) | 人文气质,长文舒适 | 学术、人文 |
| Lora | 拉丁 | 衬线(书卷) | 笔刷式曲线,书卷气 | 研究、品牌叙事 |
| Merriweather | 拉丁 | 衬线(屏幕优化) | 字形结实,小字号清晰 | 报告、教育 |
| Playfair Display | 拉丁 | 衬线(高对比) | 对比强烈,杂志感 | 品牌、时尚、封面 |
| Roboto Mono | 拉丁 | 等宽 | 中性等宽,数字对齐 | 指标、表格、代码 |
| 源ノ角ゴシック | 日文 | 黑体 | 思源黑体日文版 | 日文页面 |
| 본고딕 | 韩文 | 黑体 | 思源黑体韩文版 | 韩文页面 |
| Times New Roman | 拉丁 | 衬线 | 正式文档默认字体 | 公文、投稿硬性要求 |
## 图表选型通用规则
- **大原则是:优先用原生图表、然后是 shape 组合,最后是 svg 图表**
- **可以使用原生图表来表示的图表**: 原生 `<chart>`**:柱形 / 条形 / 折线 / 阶梯 / 面积 / 饼 / 雷达 / 组合。照抄范例 [`../xml/slides_chart_demo.xml`](../xml/slides_chart_demo.xml);具体视觉规格(配色、去除默认装饰、数据标签、坐标轴)以所选场景文档为准。
- **可以使用 shape 组合来生成的图表**:使用 shape 组合来进行支持,包括:气泡、瀑布、矩形树状、甘特、直方、子弹、金字塔、韦恩图这些,可以直接使用 shape 间的组合来实现图表展示
- **用户要的是专业、好看、高端的 PPT 并且原生图表、shape组合对这种数据展示不够专业时**:走 svg 专业图表:**动手前先跑** `python3 -c "from scripts.gen_svg_charts import chart_help; print(chart_help())"` 一次拿完整调用范式总览(也可 `chart_help(slug)` 拿单张详情;本场景偏好哪几张见对应场景文档「常用 SVG 图」。
- **需要使用到树状图** → SVG 树状图:**动手前先跑** `python3 -c "from scripts.gen_svg_relations import relation_help; print(relation_help())"`;支持范围以当前 manifest 为准,不在文档中硬编码。正式 Slides 必须用 `make_relation_atomized(..., strict_no_embed=True)` 或 CLI `--atomized` 输出可编辑元素,树状图主体不得用 `<embed>`。
- **并列要点、单一数字、纯文字论证 → 不用图**:走所选场景文档的排版语言(大数字、极细线段、字号差、留白),不为了"有图"硬塞。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |