# PDF 批注修复脚本（pymupdf/fitz）

## 用途
修复已生成的 PDF 合同批注中的颜色不一致和内容问题。

## 使用场景
- workflow 生成的 PDF 批注中 Highlight 和 Text 注解颜色不一致
- 批注内容过于空洞（只说"请核实"不给建议）
- 需要统一所有批注为同一颜色

## 修复脚本

```python
import fitz

UNIFIED_COLOR = [1.0, 1.0, 0.0]  # 统一黄色

doc = fitz.open("input.pdf")

for page_num in range(doc.page_count):
    page = doc[page_num]
    for annot in page.annots():
        # 1. 统一颜色
        current = annot.colors['stroke']
        if current != UNIFIED_COLOR:
            annot.set_colors(stroke=UNIFIED_COLOR)
            annot.update()
        
        # 2. 修复 Text 注解内容（按需）
        if annot.type[0] == 0:  # Text annotation
            content = annot.info.get("content", "")
            if "请核实" in content and "建议" not in content:
                # 替换为有实质内容的建议
                new_content = fix_annotation_content(content)
                rect = annot.rect
                color = annot.colors['stroke']
                page.delete_annot(annot)
                new_annot = page.add_text_annot(rect.tl, new_content)
                new_annot.set_colors(stroke=color)
                new_annot.set_info(title="WB")
                new_annot.update()

doc.save("output.pdf")
doc.close()
```

## 验证
```python
# 验证所有批注颜色一致
doc = fitz.open("output.pdf")
colors = set()
for page in doc:
    for annot in page.annots():
        colors.add(tuple(annot.colors['stroke']))
assert len(colors) == 1, f"Found {len(colors)} different colors"
doc.close()
```

## 注意事项
- pymupdf 的 `annot.info["content"]` 修改后需要 `delete_annot` + `add_text_annot` 重建才能生效
- 直接设置 `annot.info["content"] = new_value` + `annot.update()` 对某些 PDF 不生效
- 颜色统一后必须清 OnlyOffice 缓存：`docker exec nextcloud-onlyoffice-1 bash -c "rm -rf /var/lib/onlyoffice/documentserver/App_Data/cache/files/data/*"`

## 2026-06-29 实证
医疗急救中心救护车采购合同 PDF，14对批注中6对颜色不一致（Highlight 黄色 + Text 红色）。修复后全部统一为黄色。同时修复了2处空洞批注：
- "验收方式未勾选，请选择（1）或（2）" → "验收方式未勾选，建议选择第（1）种方式（买方收货后自行检查验收）"
- "质量保证期月数未填写，请填写具体月数" → "质量保证期月数未填写，请根据招标文件要求填写具体月数"