山东大学标准试卷排版生成器

解决的问题

期末试卷排版从来不是一件轻松的事。山东大学各学院的试卷有统一的版式要求：A4 纵向、左侧装订线、固定的标题行格式、动态分值栏。人工用 Word 或 LaTeX 逐题排版，光调整对齐和分值汇总就要花大半天。如果需要 A/B/C 多卷，每卷都得重新排一遍，出错概率随卷数线性增长。

核心能力

这个技能把排版工作拆解为数据驱动的流程：题目内容写进 exam_data.json，渲染脚本负责校验和生成 HTML，最后统一导出 PDF。

• 数据与渲染分离：meta 字段控制试卷元信息（学年、学期、课程名），score_structure 定义题型与分值，paperX 数组存放每卷题目。改分值结构只需改 JSON，不必碰模板。
• 自动校验：渲染前检查每卷各题型分值之和与 score_structure 是否一致、总分是否正确、coverage_keywords 是否全部出现在题目的 focus 标签中。错误在生成阶段就被拦下。
• 动态版式：得分栏列数、题型标题、答题提示都根据 score_structure 自动生成，填空题用 stem 单行，简答/计算题用 stem_paragraphs 多段配 answer_points 要点数组。
• A/B 多卷并行：在 paper_codes 中声明卷别，脚本为每卷独立渲染题目页和答案页。

关键步骤

1. 从用户输入提取试卷元信息和题目内容，写入 exam_data.json
2. 运行渲染脚本，脚本自动校验分值、覆盖关键词并生成 A/B 卷 HTML
3. 调用 html_to_pdf.py（依赖 Playwright Chromium）导出 PDF

注意事项

• PDF 导出依赖 Playwright Chromium 环境，需预先安装浏览器二进制
• 模板 CSS 变量（--left-gutter、--page-width、--font-main）可调整版式，但修改前建议备份
• 填空题答案用 answer 字段，主观题用 answer_points，混用会导致渲染异常
• 试卷编号需在 paper_codes 中显式声明，未声明的卷别不会被渲染