技能介绍

现场日记为什么容易「写散、验不动、归档对不上」

施工日记往往卡在三条链路上：现场口述和照片分散在聊天里，初稿 DOCX 与验证库字段不一致（参建单位、天气、照片张数）；校验只做「有没有填」，占位符 待补充/TBD 仍被当成完成；同一天重复导入还会把子表和照片叠进库里。本组合技能把 生成 → 验证 → 归档 收成一条可断点续作的数据链路，中间模型统一为 canonical_diary.json。

技能如何工作

三步与边界：

生成：内置 assets/generator/，按 GENERATOR_GUIDE.md 整理现场信息为 spec.json，用 generate_log.py 产出 MD/DOCX 初稿；新建工程时先登记参建四单位并写入 project_config.json，后续日报带 --project-config 自动回填表头。
验证：to_canonical.py 转中间模型，import 写入验证库并跑日期工期、必填、花名册等校验；v1.4 起增加 PLACEHOLDER 级扫描（正文与材料表单元格），「0 问题」才可信。导入按 (project_id, date) upsert，避免重复污染。
归档：导出含嵌入照片的 WORD，以及 CSV/XLSX；可选 Web 复核后签名。章节固定九节（施工生产、材料进场、隐蔽验收、质量处理、设计变更洽商、会议与监理通知、停窝工异常、其他、每日自查清单）；照片 每栏 6 张、支持 caption，天气走单一数据源 weather_common.py 并标注联网/手填来源。

端到端向导 assets/new_diary.py 可交互采集四单位、九节与照片（拷入工程 photos/），--run 串起生成→导入→校验→导出。

适用边界与注意点

负面清单：生成侧不自动判定质量/安全合格、不确认工程量与责任结论；验证侧只校验留痕，有错不替人拍板，缺信息不编造。
校验导入阶段 记录异常但不阻断，需人工在 Web 或 CLI 侧处理。
无监理时自查清单相关项会标 （N/A：无监理）；无材料进场时材料表显示「本日无材料进场」。
验证侧 app.py 默认本地 127.0.0.1:8080，数据本地 SQLite，工程档案不出本机；验证侧标准库实现，生成侧需 python-docx / Pillow / openpyxl。