hermes-skills/skills/legal/contract-reviewer/references/pdf-annotation-fix.md

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

用途

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

使用场景

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

修复脚本

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()

验证

# 验证所有批注颜色一致
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）种方式（买方收货后自行检查验收）"
• "质量保证期月数未填写，请填写具体月数" → "质量保证期月数未填写，请根据招标文件要求填写具体月数"