深化设计审核与整改成稿
适用场景
处理工程类深化设计文件的审核整改全流程：客户提了意见 → 到原文定位并摘录 → 核对客户说法是否有招标/彩页/检测报告依据 → 逐条给整改方案 → 输出可整节入册的正式文案。
不适用：纯排版美化（走 workbuddy-docx）、从零创作新文档、仅做格式转换。
四条硬性红线（MUST，优先于一切）
- 不虚标等级。检测结论为 IP54，不得写成 IP65；报告覆盖 A 项，不得声称覆盖 A+B。差距必须写明或单列说明，即使客户要求"满足"。
- 不把测量报告写成合格。报告"判定依据"与"检验结论"栏为
--时，只能引用实测值（如“实测最大承载 12.5kN”），不得写"判定合格"。 - 不虚构实测结论。未到现场实测，不得写“全部合格”；只能写"以现场实测为准"，或给出带前提条件的结论并注明前提（如“在额定电流不小于 XX A、导线截面不小于 XX mm² 的前提下”）。
- 不编造数据。缺失项一律写
【待提供：数据名称】，可给建议值但须注明"仅为建议，以正式提交数据为准"；规范条款号不确定标⚠️ 待人工核验；不得新增未经核实的条款号。
阶段一：摄取（读得进来）
1.1 按格式选工具
| 文件 | 工具 | 注意 |
|---|---|---|
.docx / .docm / .dotm |
scripts/extract_docx.py |
禁用 python-docx，宏启用文档会抛 content_type 异常 |
.pdf 有文字层 |
scripts/extract_pdf.py |
直接输出文本 |
.pdf 扫描件 |
scripts/extract_pdf.py --render |
渲染 PNG（200dpi）后逐页视觉读取 |
| 网盘 / tdrive | file_download → curl |
首次常报 InvalidAccessKeyId，重取一次链接 |
| 微信临时目录 | 直接读路径 | 路径含中文与空格，务必加引号 |
1.2 建立可定位索引
提取结果必须是带序号的段落/表格行，后续所有"原文定位"以此为准。不猜页码，只用章节名、图号、表号定位。
阶段二：核验（拆客户的话）
对客户提出的每条问题，先在原始依据中反查，再决定怎么改：
- 一致性核对：客户用词与招标原文是否一致。例：客户称“招标要求的某型设备”，而招标技术参数表实际只规定性能指标、未指定型号。核对结论必须写入材料，不得顺着客户的错误表述写。
- 实物核对：客户质疑的参数是否与供货彩页一致（尺寸、功耗、重量、盘位、接口）。
- 覆盖核对：客户要求是否已被既有报告覆盖，覆盖到什么等级/项目（如报告仅覆盖某一性能项，未覆盖耐久性或环境适应性）。
核对结果分三类，逐条标注：成立（须整改） / 表述偏差（按原文纠正） / 已覆盖（引用即可）。
阶段三：整改（给得出方案）
逐条输出四要素：
- 问题诊断：根因 1~2 句 + 严重程度（高/中/低）
- 修改后文本：可直接替换原文的完整表述，数据缺失处用占位符
- 修改说明表：原文（照抄）｜改为（建议）｜依据（规范全称+版本，条款号拿不准标 ⚠️）
- 需人工确认：条款号待核验、需设计出图（写"需设计人员出图确认：图号XX"）
需外部数据的，同步登记《待提供数据清单》：编号 D-XX 与 C-XX 对应，写明数据名称/单位/精度、用途（替换哪个占位符）、建议值与依据、责任方、状态。
阶段四：成稿（交得出去）
用 scripts/make_docx_section.py 生成，遵守：
- 页面：纵向 A4；表格总宽 ≤ 可用宽度 − 0.2cm（脚本自动校验并报错）
- 字体：正文宋体 10.5pt／表格 8.5pt；行距 1.5；首行缩进 2 字符；标题黑体
- 编号：与既有文档衔接、连续不跳号（如 X.Y.1 → X.Y.2 → X.Y.3）
- 去内部话术：正式章节内不得出现"本文件""新增文件""未修改原文档""建议作为内部整改依据"等表述
- 证据：检测报告截图用 200dpi 渲染、宽 13.5cm、配"图 X-Y 内容（报告号 YYYY）"图题，每图单占一页
- 成稿必检：表格宽度、Markdown
**残留、标题是否重复、图题编号是否连续
脚本
| 脚本 | 用法 |
|---|---|
scripts/extract_docx.py |
python3 extract_docx.py <file> [-o out.txt] |
scripts/extract_pdf.py |
python3 extract_pdf.py <file> [--render] [-o dir] [--dpi 200] |
scripts/make_docx_section.py |
作为模块 import，提供 Section 类（标题/段落/表格/图题/保存前校验） |
运行环境
三个脚本依赖 python-docx、pymupdf、lxml。系统 python3 通常缺这些包，优先使用 WorkBuddy 托管环境：
PY=~/.workbuddy/binaries/python/envs/default/bin/python
$PY scripts/extract_pdf.py report.pdf --render
$PY scripts/extract_docx.py design.docx -o /tmp/design.txt
托管环境不存在时，先建独立 venv 再装依赖（勿污染系统环境）：
python3 -m venv ~/.workbuddy/binaries/python/envs/default
~/.workbuddy/binaries/python/envs/default/bin/pip install python-docx pymupdf lxml
参考文件
references/excerpt-rules.md— 摘录四要素、定位口径、剔除规则references/audit-checklist.md— 数量口径、★▲条款、检测能力边界核对清单references/troubleshooting.md— 已知坑与解法（docm、扫描件、网盘、超宽表、**残留等）assets/section-template.md— 正式章节骨架，可按需复制改写
