彩页自动生成小助手

要解决什么问题

产品宣传、投标或内部分享时，素材往往散落在 Word 规格书、PDF 票据、产品照片和截图里。手工拼版成可印刷的多页彩页或单页海报，既要控版心、又要防文字叠压和图片错位，迭代成本很高。本技能把「抽取 → 规划版式 → 生成 PDF → 视觉验收」串成一条可重复的流水线，而不是一次性脚本。

技能如何工作

资产抽取：extract_assets.py 支持 .doc（OLE2）、.docx、.pdf 以及图片目录，输出标准化的 assets.json 与 images/。文本块带类型与页码，图片带尺寸与路径元数据。

版式与配置：根据内容类型（产品参数表、图册、单页海报等）为每页选择 layout（如 cover、param_table、parts_grid、feature_list_2col、text_rich 等），写入 build_config.json。核心原则是 Inspect before deliver——未做 PNG 逐页检查不得交付。

生成与校验：build_brochure.py 用 reportlab 按配置渲染 PDF；preview_pdf.py 将每页转为 PNG，人工或 Agent 用 Read 检查文字重叠、大块空白、图片拉伸、缺图占位、中文缺字等问题，有问题则改 config 后重建。

可选 OCR 视觉管线：vision_extract.py 通过 OpenAI 兼容视觉 API（VISION_BASE_URL / VISION_API_KEY / VISION_MODEL）把单图、目录或 PDF 逐页识别为 build_config.json；layout 非法会 fallback 到 text_rich，位图 path 常需后续人工补全。

适用边界与注意点

• 图片必须与对应文案语义匹配，不能随机塞图；ReportLab 坐标系为左下角原点，调 rect / drawString 时 Y 轴易算错导致重叠。
• 中文 PDF 需指定可用 TTF/TTC；A 股等场景下红涨绿跌配色与西方惯例相反，见技能内 color scheme 说明。
• 视觉识别效果依赖你配置的 API，本技能文档中的 pipeline 可用 --mock 验证 build 链路，真实识图需自行实测。