契盾·交易约定核验

使用本发布包中的冻结核心代码处理交易材料。输出事实和核验问题时，必须保留来源标识、来源类型、页码或段落、字符位置与原始 Evidence；不得把推测写成事实，也不得输出法律效力或风险等级结论。

支持范围

抽取以下八个字段：

• contract_party
• payment_receiver
• total_amount
• deposit_ratio
• quantity
• delivery_deadline
• payment_terms
• acceptance_standard

识别以下四类问题：

• CONFLICT：不同来源中可比较字段的规范值不一致。
• UNWRITTEN_COMMITMENT：聊天中的明确承诺未出现在参与核验的正式材料中。
• MISSING_TERM：调用方明确要求检查、但所有材料均未提及的字段。
• AMBIGUOUS：材料提及相关内容，但表达不足以形成明确事实。

工作流程

1. 先确认每份材料的非空 source_id，并由用户或调用上下文显式提供来源角色。只接受 conversation、formal_document 等调用方明确指定的角色；禁止根据文件名、扩展名或内容猜测角色。
2. 纯文本使用 parser.TextBlock 构造来源块，再调用 pipeline.process_blocks()。文本层 PDF 使用 pipeline.process_pdf()；DOCX 正文段落使用 pipeline.process_docx()。
3. 图片先由外部 OCR Engine 产生 ocr_adapter.OCRResult，再经 ocr_adapter.ocr_image() 转成文本块；本发布包不内置 OCR 模型。
4. 合并各来源的 facts 与 ambiguous，调用 pipeline.verify_processed_sources()。required_fields 必须由当前任务明确决定，不得自动假定全部字段必填。
5. 返回明确事实与四类核验结果。展示每条结果时，同时展示其 Evidence；AMBIGUOUS 的 facts 必须保持空列表，只展示其独立 Evidence。

安全边界

• 不补全缺失年份，不把“月底左右”转换为具体日期。
• 不把“尽快付款”转换为固定天数，不把“满意就行”升级为验收标准。
• 不把金额、数量、主体或付款节点的相似表达强行判为相同。
• MISSING_TERM 不伪造 Evidence；已被识别为 AMBIGUOUS 的同字段不得重复报告缺失。
• PDF 仅解析已有文本层；扫描件必须经过外部 OCR。
• DOCX 当前只读取正文段落，明确不读取表格内容。
• 图片适配器只接受 PNG、JPG、JPEG，并要求调用方提供符合 OCREngine 契约的实现。
• 本工具用于材料核验与信息整理，不替代律师、会计师或业务负责人判断。

使用发布包

首次使用先阅读 README.md，按其中步骤安装依赖并运行测试。

• 纯文本多来源示例：examples/verify_text.py
• PDF/DOCX 命令行示例：examples/verify_documents.py
• 核心入口：core/pipeline.py
• 数据结构：core/schemas.py

当输入格式或业务语义超出上述边界时，明确说明当前不支持，并保留原材料，不要增加猜测式规则。