城市规划PPT章节与颜色框批注提取

它解决什么问题

控规、用地论证这类汇报 PPT 的复核流程里，领导意见往往不是写在旁边的批注面板里，而是直接以彩色矩形框盖在页面上：橙色方框、品牌色色块、散落在不同页的意见。人工通读几十页材料时，要把这些彩色框逐个挑出来、按章节归堆、再还原成文字大纲，既费时间也容易把地图图例、装饰色块误当成修改意见。这个技能就是把「读 PPT →（按需）按颜色提取批注框 → 按章节归类」这套反复出现的流程固化成可复用能力。

它是怎么工作的

• 核心脚本 scripts/extract.py 零依赖：PPTX 本质是 zip + XML，直接用 zipfile + ElementTree 解析，不依赖 python-pptx，避免联网装库卡死。
• 提取每页文本后，取形状填充色做判断：solidFill/srgbClr 直接读，主题色 schemeClr 会经 theme1.xml 解析成真实 RGB；非中性灰、非近白的填充视为「彩色框」，命中目标色即标注为批注框。
• 章节映射靠优先级：--chapter-keywords > --chapter-pattern > 启发式（取页面最上方、短文本、非彩色框的形状作为页眉）。
• 批注框开关由用户提示词决定：提到「批注 / 意见 / 橙色 / 领导意见 / 审稿 / 校审」等词就开启，命中色标 ⚠批注框(#颜色)，其他彩色块标 ·彩色框(#颜色)；只要求整理正文/做大纲时加 --no-comments，只输出干净正文与章节。

适用边界

• 只识别「填充色」批注框。纯文字批注、无底色或线条框会漏判，需要结合纯文本人工补全。
• 彩色框不等于批注：地图图例、色块装饰同样会进彩色框逻辑，靠颜色甄别。
• 整版图页页面缺少文本页眉时，启发式无法归类，输出里会标 (未识别)，需要用 --chapter-keywords 重跑锁定边界。
• 颜色容差默认 RGB 欧氏距离 60，可覆盖相近色（如 #D25A35 与 #E97132），细节见 references/usage.md。