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 加载。

字号起点：封面 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 提供结构起点。独立封面按需使用；简历、短备忘录、用户指定页数紧张或已有模板时，标题区即可。

封面用命名页 @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 可作为选项；不编造作者、年份和出处。

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