技能介绍

问题：Word 文档难以在群里转发

业委会报告、工作总结、计划通知这类 .docx 文件，内容是齐全的，但实际分发时往往会遇到两种情况：直接发文件，没人愿意打开；截图发，要么被系统截断，要么带上一片白边和打印页脚。更麻烦的是，大多数「美化 Word」的方案都会顺手改写正文，加几句口号、补几个小标题、把段落重新归并成四段式叙事——对业委会报告和正式公文来说，这些改动本身就是事故。

这个技能要解决的就是：保持原文一字不改，只替换呈现方式。

工作机制

核心脚本 scripts/build_infographic.py 直接解析 word/document.xml，只依赖 Python 标准库，不需要 pandoc 或 Word 客户端。分类逻辑是逐块、规则化的：

一、二、三 主章节 → Hero 渐变横幅 + 社区建筑插画
每个主章节自动分配一枚 SVG 图标（checklist / target / task list / shield），颜色随主题
（一）（二） 中文括号编号 → 圆形徽章卡片
卡片内的 1. 2. 3. → 带悬挂缩进的嵌套有序列表
；、、 结尾的条目 → 圆点列表
匹配 执行机构 / 不是权力机构 / 接受全体业主监督 等关键词的段落 → 盾牌框 callout
文末日期与落款单位 → 右对齐签名块

渲染环节由 scripts/render_output.py 一次完成：它用独立的 --user-data-dir 起 Chrome headless，配合 --no-pdf-header-footer 去掉 PDF 页脚里的 file:///... 源文件路径，再用 9000px 高窗截图并交给 crop_border.py 裁掉纯白边，最终产出无边框 PNG 与无脚注 PDF。

内置三套主题：green（清新绿，默认）、blue（商务蓝）、orange（活力橙），通过 --theme 切换，无需手改 CSS 变量。长图可用 scripts/paginate_png.py 按 A4 切分，切点会吸附到章节间的空白处。

适用边界

默认路径 --rich 是严格逐字保真的，AI 不改写、不概括、不添加 slogan 或承诺框、不重排章节、不改专有名词和数字。这份保真度适合法律、归档、业委会等「原文即交付物」的场景。

如果用户明确表示「按你觉得漂亮的方式做」或「AI 自由发挥」，可以走 assets/report_template.html 这条 AI 策展路径：从正文提取 slogan、把段落归入四段式叙事、为卡片命名小标题。但这条路径会重写文案，且不要与 --rich 在同一次运行里混用——动笔前先和用户确认要哪种风格。

另外几个容易踩的坑：PDF 页脚是否真的去掉了要用文本提取校验（PyMuPDF 的 get_text()），不能靠肉眼，也别指望字节搜索；Windows 下 Chrome headless 要传绝对路径的 HTML URL；crop_border.py 和 paginate_png.py 需要 Pillow。HTML 输出是自包含的（CSS 与 SVG 内联），无需联网或装字体。