Invoices

核心功能

Invoices skill 是一款专为企业与个人设计的智能发票管理工具，用于处理收到的发票（而非开具发票）。其核心能力覆盖从发票捕获到合规存档的全流程自动化：

核心工作流程

1. 多渠道捕获：支持邮件附件、拍照、PDF 直接导入，原始文件自动存入 inbox/ 待处理队列
2. 智能提取：OCR 识别后自动解析关键字段——供应商名称、发票日期、金额明细、税额、发票编号
3. 数据验证：内置数学校验（税前金额+税额=总额）、重复检测（同一供应商+发票编号触发告警）
4. 自动归档：按 archive/YYYY/MM/ 结构重命名存储，同步更新 entries.json 可搜索索引
5. 供应商标准化：自动将 "HETZNER ONLINE GMBH" 等变体统一为规范名称 "Hetzner"

显著优势

• 合规保障：强制保留原始 PDF 4-6 年（依各国法规），满足审计要求
• 主动预警：48小时未处理提醒、7天内到期付款提醒、金额异常波动检测（>50% 均值）
• 快速检索：结构化元数据索引支持按供应商、金额区间、日期范围多维查询

潜在局限

• OCR 准确性受扫描质量影响，复杂版式发票需人工复核
• 供应商别名库需持续维护，新兴供应商首次识别可能偏差
• 跨境发票的税则解析依赖预设规则库，特殊税制地区可能需本地化配置

适用人群

中小企业财务人员、自由职业者、需要严格票据管理的个人用户。特别适合月均发票量 50-500 张、追求自动化归档且重视税务合规的场景。

常规风险提示

• 敏感财务数据本地存储，需配合系统级加密与定期备份策略
• 自动归档后的文件路径变更可能影响外部引用链接
• 建议每月抽查验证提取准确率，避免累积误差

核心用法

Invoices Skill 专注于接收端发票管理，与创建发票的 invoice skill 形成完整工作流闭环。用户通过邮件附件、拍照或 PDF 上传方式捕获发票后，系统自动执行 OCR 文字识别、字段提取（供应商、日期、金额、税额）、重复检测与税务计算校验，最终按年/月层级归档至本地 ~/invoices/archive/ 目录，并生成可搜索的元数据索引。

操作流程分为五步：捕获文件至 inbox 等待区 → OCR 与字段提取 → 必填项校验与重复检测 → 标准化重命名并归档 → 人工确认数据准确性。所有原始 PDF 永久保留以满足各国 4-6 年不等的法定保存期限。

显著优点

1. 零代码执行风险：纯 Markdown 文档架构，无可执行脚本，从根源消除恶意代码执行可能，六维安全扫描全部满分通过。
2. 合规优先设计：内置法定留存规则、税务计算校验（Base + Tax = Total）、供应商别名标准化，降低企业审计风险。
3. 智能预警体系：覆盖 48 小时未处理提醒、7 天内付款截止预警、单笔金额超均值 50% 异常检测、周期性账单缺失提醒。
4. 离线本地优先：数据完全存储于用户本地，无外部 API 调用，符合 GDPR 隐私要求，避免云端泄露风险。

潜在缺点与局限性

• 功能依赖 AI 解析准确性：OCR 与字段提取效果受原始文件质量影响，复杂版式或手写发票可能需要人工校正。
• 无自动化集成能力：缺乏与邮箱、网银、ERP 系统的自动对接，发票需手动导入触发流程。
• 本地化存储责任：用户需自行承担数据备份、权限控制和长期存储安全，技能本身不提供加密或云同步机制。
• 社区维护不确定性：个人开发者维护模式，更新频率与长期支持存在不确定性，需主动关注版本动态。

适合的目标群体

• 自由职业者与小企业主：需要低成本、合规的发票归档方案，无复杂 ERP 系统预算。
• 个人财税管理用户：希望建立结构化电子发票库，便于年度报税与支出分析。
• 隐私敏感型组织：拒绝 SaaS 财务软件，坚持数据本地化的团队。

使用风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 数据丢失 | 本地单点存储，磁盘故障导致不可逆损失 | 配置加密云备份 + 定期恢复测试 |

| 权限泄露 | 多用户系统下目录权限配置不当 | 设置 600/700 文件权限，启用系统级磁盘加密 |

| 合规偏差 | 各国发票字段要求差异，提取字段可能不满足特定司法管辖区 | 使用前核对 `legal.md` 与当地会计师确认 |

| 维护断档 | 个人开发者项目可能停止更新 | 订阅 ClawHub 更新通知，保留技能文档副本 |

总体而言，Invoices 是一款设计理念清晰、安全架构扎实的个人效率工具，适合重视数据主权与合规安全的小规模场景使用。