---
last_reviewed: 2026-10-19
---

# src/core — 确定性内核

信息存取、金额匹配、信息校验。不依赖 Flask、Playwright、COM，也不调用任何模型。

| 目录 | 说明 |
|------|------|
| `extraction/` | 缓存读写 + PDF 渲染（页面 PNG、文本层、自动转正） |
| `matching/` | 发票与支付记录按金额匹配；`runner.py` 从会话缓存跑全流程并落盘产物 |
| `validation/` | 声明式完整性校验，规则来自 `config/validation_rules.json` |

## 设计原则

- **零框架依赖**：可单独跑、单独测
- **接口契约**：每个子模块用 `__init__.py` 导出稳定接口
- **裁判不是作者**：`validation` 判定宿主产出的数据是否完整，绝不代替宿主填内容