Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

docs(chart-templates): align authoring guidance with SVG contracts

hugohe3681c19ce068a
diff --git a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md
index 32c38f09..55513a0b 100644
--- a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md
+++ b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md
@@ -77,16 +77,20 @@ font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Micr
### 2.2 字号层级
-| 层级 | 字号 | font-weight | 用途 |
-|------|------|-------------|------|
-| H1 | `34px` | `bold` (700) | 图表主标题 |
-| H2 | `22px` | `600` | 区域标题(如"详细数据") |
-| Body L | `18-20px` | `600` | 关键数值、百分比 |
-| Body M | `15-16px` | `600` | 数据标签、分类名 |
-| Body S | `14px` | 正常 | 副标题、图例、来源 |
-| Caption | `12-13px` | 正常 | 坐标轴刻度、注释 |
+| 层级 | 字号(SVG px 语义) | font-weight | 用途 |
+|------|---------------------|-------------|------|
+| H1 | `30–36` | `700–800` | 图表主标题,按信息密度选择 |
+| H2 | `20–24` | `600–700` | 区域标题(如"详细数据") |
+| Body L | `18–20` | `600–700` | 关键数值、百分比 |
+| Body M | `15–16` | `600` | 数据标签、分类名 |
+| Body S | `13–14` | 正常或 `600` | 副标题、图例、来源 |
+| Caption | `12–13` | 正常 | 坐标轴刻度、注释 |
-> **最小字号下限:12px**。所有文本不得小于 12px。
+表中数值采用 SVG px 语义,但规范创作属性必须使用无单位写法:写
+`font-size="34"`,不得写 `font-size="34px"`。显式 `px` 仅是项目转换器的
+兼容输入,会触发 Checker 归一化建议,不得反向扩散到模板创作。
+
+> **最小字号下限:12**。所有文本不得小于 `font-size="12"`。
### 2.3 同一图表标签的内联格式
@@ -239,7 +243,10 @@ font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Micr
| 页头 | 标题 + 副标题 + 装饰 |
| 装饰集群 | 相关装饰形状(环、球、点) |
-**命名约定**:使用描述性 `id`(如 `card-1`、`step-discover`、`header`、`footer`)。
+**命名约定**:每个顶层语义组必须使用页面内唯一、描述性的 `id`(如
+`card-1`、`step-discover`、`header`、`footer`)。仅用于局部绘制、样式继承
+或几何组织的内部 `<g>` 可以保持匿名;不要把 frame、icon、badge 等实现
+碎片暴露为独立的顶层动画锚点。
### 5.2 viewBox
@@ -379,11 +386,12 @@ expanded 无损表达属于独立合同,不得复制为新模板创作格式
### 排版
- [ ] 无 `font-size < 12` 的文本
+- [ ] `font-size` 使用有限无单位数值;不把 `px` / `pt` 等兼容输入写进模板
- [ ] 需要保持为单一 PPT 文本框的多格式标签使用 inline `<tspan>`;只有这类 inline run 不携带 `x` / `y` / `dy`
-- [ ] 标题 34px、副标题 18px、来源 14px
+- [ ] 标题、副标题、正文、标签与来源按 §2.2 的角色范围形成稳定层级
### 结构
-- [ ] 主要元素有语义化 `<g id="...">`
+- [ ] 每个顶层语义组都有页面内唯一的描述性 `<g id="...">`;内部实现组可匿名
- [ ] `svg_quality_checker.py` 对目标模板通过;通用 SVG 合同不在本清单复述
- [ ] 细关系箭头使用普通 line/path Shape,不含 Connector 或 attachment metadata
- [ ] authored preset 是 helper 输出的完整 compact 原子 `<g>`;无 carrier / preview wrapper / fingerprint,且 metadata / path 未手改
@@ -408,11 +416,19 @@ expanded 无损表达属于独立合同,不得复制为新模板创作格式
### 验证命令
```bash
-# 一键校验
+# 全 catalog:索引、Checker、默认 Shape 路线、原生 Chart/Table 路线
+python3 "skills/ppt-master/scripts/test_svg_quality_checker.py" -k chart_catalog
+
+# 单文件诊断
f="your_chart.svg"
-xmllint --noout "skills/ppt-master/templates/charts/$f" && echo "XML OK" || echo "XML FAIL"
-echo "Old colors:" && grep -c '#2C3E50\|#7F8C8D\|#95A5A6\|#5D6D7E\|#000000' "skills/ppt-master/templates/charts/$f"
-echo "Small fonts:" && grep -c 'font-size="[0-9]"' "skills/ppt-master/templates/charts/$f"
+python3 "skills/ppt-master/scripts/svg_quality_checker.py" \
+ "skills/ppt-master/templates/charts/$f"
+
+# 图表库专用视觉审计(有输出即需人工处理)
+rg -n '#2C3E50|#7F8C8D|#95A5A6|#5D6D7E|#000000' \
+ "skills/ppt-master/templates/charts/$f"
+rg --pcre2 -n 'font-size="(?:[0-9](?:\.[0-9]+)?|1[01](?:\.[0-9]+)?)"' \
+ "skills/ppt-master/templates/charts/$f"
```
---