# PDF 视觉设计规范

先确定文档用途、读者、交付媒介、品牌和内容结构，再决定视觉。继承用户模板时先保持其规范；阅读、裁剪或填表不触发整本重新设计。

## 视觉方向

选择一套与内容相符的排版语言，贯穿封面、标题、表格和页眉。下面是起点，不是行业强制配色：

| 内容与气质 | 主色 | 浅色 | 深色封面或文字 |
| --- | --- | --- | --- |
| 科学、工程、数据分析 | `#2D5F8A` | `#E8F0F8` | `#152C3E` |
| 商业、策略、运营 | `#8A3A2A` | `#F5ECE7` | `#30231F` |
| 医疗、生态、公共服务 | `#2A6B5A` | `#EBF3EF` | `#19382F` |
| 创意、文化、作品集 | `#6B2A35` | `#F5ECEE` | `#29171D` |
| 学术、法律、正式材料 | `#3D4C5E` | `#F1F3F5` | `#202124` |

通常一个主色、深色正文和少量浅色层次就够。强调色用于标题、线条和关键数据；正文保持深色。颜色须有含义，不能只依赖颜色区分类别。文字与背景保持清晰对比，小字尽量达到 7:1；不要把装饰图形的对比度要求与正文混为一谈。

不要把渐变、卡片或深色背景机械地当成专业设计，也不要因旧规范的偏好一概禁止用户明确要求的颜色。内页以打印友好、清晰的信息层级为主；大面积深色更适合少量封面或章节页。

## 字体与尺度

镜像已提供 Noto CJK、宋体、黑体、仿宋、楷体、方正小标宋、微软雅黑、苹方 SC、SF Pro、Arial、Times New Roman 等。选择通常不超过两套视觉字体系统；中文与拉丁字体的必要回退不算额外装饰字体。不要假定宿主机所有字体都存在容器中，也不要从字体 CDN 加载。

| 风格 | 中文正文/标题 | 英文与数字 |
| --- | --- | --- |
| 现代报告 | 苹方 SC / 微软雅黑 / Noto Sans CJK SC | SF Pro / Arial |
| 学术长文 | 宋体 / Noto Serif CJK SC，标题可搭黑体 | Times New Roman |
| 正式公文 | 依用户规范选仿宋、楷体、方正小标宋 | 依模板 |

字号起点：封面 32–48 pt，一级标题 20–24 pt，二级 14–16 pt，三级 11.5–12 pt，正文 10.5–12 pt，图注 8.5–9.5 pt，页眉页脚 8–9 pt。中文正文行高 1.6–1.8；正文过长时先调整结构与分页，不用极小字号硬塞。

A4 内页通常上下 22–28 mm、左右 22–28 mm。段后约 8 pt，章节前约 24–26 pt；选定间距节奏后保持一致。简历可用 15–18 mm 边距，仍需保证可读性和完整内容。

## 六种可复用封面

`assets/design.css` 提供对应 class，`assets/report.html` 提供结构起点。独立封面按需使用；简历、短备忘录、用户指定页数紧张或已有模板时，标题区即可。

| class | 设计方式 | 常见用途 |
| --- | --- | --- |
| `cover-fullbleed` | 整页深底、大标题、短色带、作者日期 | 年报、主题报告 |
| `cover-split` | 42% 色块与 58% 浅色内容区，清晰分割 | 提案、方案 |
| `cover-typographic` | 浅底、展示字体、尺度对比 | 作品、专题材料 |
| `cover-minimal` | 竖线、轻量标题、充分留白 | 简洁文档 |
| `cover-frame` | 细框、居中结构、克制装饰 | 正式报告 |
| `cover-editorial` | 大字背景、强标题、编辑式构图 | 杂志、创意内容 |

封面用命名页 `@page cover`，整页尺寸与纸张一致，`margin: 0`，内容区采用 `border-box`。不要在有页边距的内容区再套 `100vh` 或完整 A4 高度；这会产生裁切和额外空白页。图案用静态 SVG/几何元素；不能让纹理干扰标题。

## 内页

- 标题层级用字号、字重、间距和少量细线区分；标题不能孤立在页底。长章节按语义分段，避免把整节设为不可分页。
- 正文不堆砌仪表盘卡片。报告可用少量重点引言或行动框；学术内容可用定义/定理边线。别用带阴影的网页组件代替正文结构。
- 表格有真实表头、单位和来源。数字右对齐，小数位一致；长表允许跨页并重复表头，避免整张长表 `break-inside: avoid`。学术三线表用 `.three-line`；业务表可用主色表头和浅色交替行。
- 图表比例服从信息：柱线图常用横向，流程图可纵向，页面容纳不下时拆分、调整方向或用横向命名页。不要强制所有图表横向，也不要通过 `overflow:hidden` 掩盖溢出。
- 图表必须有可辨认的标签、单位、图例与图注；图表文字按最终 PDF 尺寸检查。数值须来自实际数据，不能用装饰图冒充统计结果。
- 图片保持比例，注明图注；数据图优先原有 xlsx 图表、静态 SVG 或已提供图片。不生成任意 Matplotlib/Python/Node 代码作为运行入口。
- 代码示例用浅灰底、等宽字体与换行；引用框用细左边线；数学公式用 KaTeX。需要完整 LaTeX 模板时走编译接口。
- 页眉使用章节名称，页脚保持统一页码。目录、图表引用和参考文献使用真实锚点，可点击；分页后核对链接落点。

## 内容与交付

用户的大纲、语言、数字口径和篇幅优先。精确页数通过实际生成与 `--expected-pages` 核对；字数要求按用户范围执行，不默认放宽 20%，不为填页伪造内容。没有必要时不添加封面、目录或参考文献页。

已有材料里的数据注明来源；新增研究、统计、政策等需验证，来源不足就披露不确定性。参考文献格式依用户/机构要求，中文 GB/T 7714 或英文 APA 可作为选项；不编造作者、年份和出处。

逐页核验：文字无缺字/黑块，字号清晰；页面尺寸与边距一致；图文无裁切、重叠；表格跨页合理；公式和引用正确；封面与正文衔接自然；不存在非预期空白页。自动溢出检测只是辅助，不替代实际看图。