核心用法
Invoice Scan 是一款专业的发票OCR识别与数据提取技能，提供两种运行模式：
Agent-Native模式（推荐）：利用AI内置视觉能力直接解析发票图像，无需API密钥，数据完全本地处理，仅调用formatOutput()进行CSV/Excel格式化导出，适合对隐私敏感的场景。
CLI独立模式：需配置ANTHROPIC_API_KEY，将base64编码的发票图像发送至Anthropic API进行AI视觉提取，适合自动化流水线集成。
主要功能
- 多格式支持：发票、收据、贷记单、借记单、采购订单、送货单等文档类型自动分类
- 全字段提取：抬头信息（买卖双方、税号、银行信息）、明细行（SKU、数量、单价、折扣）、费用项（运费、手续费、保险费）、多币种金额及增值税分项
- 智能校验：自动验证金额计算（数量×单价=行合计、行合计累加=净额、净额+税额=总额，容差±0.02），识别9项核心字段计算质量评分
- 多语言与本地化：支持中英文、俄文、欧洲语言；自动识别各国数字格式（美式1,234.56、欧式1.234,56、法式1 234,56、印度式1,23,456.78）
- 手写与印章处理：识别手写备注、印章/签章类型及文字内容
显著优点
- 隐私可控：Agent-Native模式零外部数据传输，满足GDPR/数据出境合规要求
- 专业schema：基于
canonical-schema.md标准化输出，确保字段完整性和跨系统兼容性 - 灵活的导出格式：JSON自动保存，按需生成CSV或Excel，文件名自动生成（供应商_发票号_日期）
- 质量可量化：0-1质量评分机制，自动标记"良好/部分/差"等级，辅助人工复核决策
潜在缺点与局限
- CLI模式隐私风险：需将发票图像（含供应商/买家名称、地址、IBAN、银行详情、金额等PII）传输至第三方Anthropic服务，需单独评估合规性
- 本地依赖：需Node.js环境及
sharp（图像处理）、xlsx（Excel导出）依赖安装 - 视觉能力边界：极端模糊、严重歪斜、复杂表格布局或极低分辨率图像可能影响提取准确率
- API成本：CLI模式按调用量计费，高频使用需关注用量控制
适合人群
- 企业财务/会计团队：批量发票录入、三单匹配（发票-订单-收货单）自动化
- 中小企业主：快速提取发票信息生成报销凭证或记账数据
- 开发者/DevOps：构建发票自动化处理流水线，集成ERP/财务系统
- 隐私敏感用户：优先选择Agent-Native模式，确保数据不出本地
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露（CLI模式） | 发票图像及PII传输至Anthropic，需配置独立API密钥并设置用量上限 |
| 提取错误 | 复杂版式或低质量扫描可能导致字段遗漏/误读，建议人工复核关键字段 |
| 计算误差 | 自动校验存在±0.02容差，极端 rounding 场景可能误判 |
| 依赖安全 | `sharp`和`xlsx`为社区npm包，需关注供应链安全更新 |
使用前务必阅读references/canonical-schema.md和references/validation-rules.md了解完整字段定义与校验规则。