carimbo：面向巴西 NF-e 电子发票的抽取与审批决策 LLM 智能体

核心能力与快速开始

★ 0 · C#

能做什么

将 DANFE PDF 形式的巴西 NF-e 发票抽取为严格类型化记录（发票 v2：开票方、收票方 CNPJ/CPF、14 列行项目、11 个合计栏与分期），金额以受模式约束的十进制字符串传递并在 C# 与 Python 间保持一致的舍入。确定性校验器（Carimbo.Validation）以纯函数方式检查 CNPJ/CPF 校验位、访问密钥校验位、密钥与字段不一致、项目与税额算术、合计、分期和日期合理性，返回 {field, rule_id, expected, actual, severity}。仅在出现错误类发现时触发有界修复循环（默认最多 2 次），修复反馈对标识符、校验位和密钥规则不透露期望值。评测契约定义 success、validation_failed、refused、truncated、schema_invalid、infrastructure_failure 状态，记录每次尝试的输出、发现、token、成本与延迟。响应缓存以请求哈希为键，支持 read_write、read_only、refresh、off 模式，重放可零模型调用且区分已发生成本与名义成本。模型调用以 span 形式记录模型、token、成本与提示版本，可接入本地 Jaeger 查看，trace 不含提示、回答或文档原文。

适用场景

在受监管的金融科技场景中将巴西电子发票（NF-e）批量转成结构化记录，并以确定性规则验证关键字段（如 CNPJ/CPF、44 位访问密钥、税额与合计一致性）。为 LLM 抽取流水线提供可复现评测套件：通过固定夹具、逐案例记录与汇总文件对比不同提示版本、修复预算与缓存模式的效果与成本。用于研究或演示结构化输出、确定性校验与有界修复、幂等执行、重放、追踪与成本归集在票据抽取任务中的工程实践。

项目形态

可直接使用的工具

部署方式

未说明。README 提到本地可通过 compose.yaml 启动 Jaeger v2 运行追踪查看器，以及 git 忽略的本地缓存目录 .cache/llm；未说明生产部署方式。

主要依赖

未完整说明。README 显示使用 C#/.NET 与 Python（xUnit 与 pytest 共享校验向量），依赖 Anthropic SDK 与模型服务（示例中使用 claude-haiku-4-5）；具体运行时版本、硬件与配额限制未说明。

使用限制

定位为个人作品集项目；Milestone 1 仅有 3 个合成案例、1 个模型、每个配置运行一次（n=1），结果不是准确率估计。已完成阶段为 1 和 2，阶段 3 已实现但验证待定，阶段 4 至 6 尚未开始；智能体与持久化执行属于后续里程碑，不在当前路线图内。修复循环未能修复任何案例，44 位访问密钥转录不稳定，README 列出的条码解码等补救措施尚未构建。使用示例模型的 API 会产生费用（各阶段有 US$5 上限、单次运行 US$1.00 上限），成本与限制视所用模型与服务方而定。

许可证

Apache-2.0

最近推送

2026-10-15 22:52

资料检查：2026-10-16 07:00 · 卡片整理：2026-10-16 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证

职业应用

程序员

作为可复用的 LLM 智能体工程参考实现，用于构建结构化输出抽取流水线：将 PDF 文档转为严格类型化记录，并配套确定性校验器、有界修复循环、可复现评测套件、响应缓存重放、幂等与成本归集，供程序员在受监管金融场景中开发与评测文档抽取智能体。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证