前言¶
报销录入中存在一种昂贵的失败模式：编造。看错总额、猜商家名、从小计倒推税额——每一个都是一次对账噩梦，在审计里是信用问题。expense-capture 通过机械的转录纪律，将收据转化为账本行，每个字段都能追溯到源图像，对不明确字段进行标记，最后进行批次对账。
插件定位¶
这是一份工作流插件，旨在将收据和发票转化为符合账本格式的行。由 ChenneyZhuang 维护，采用 MIT 许可证。
核心功能¶
该插件主要解决“凭空猜测”数据的问题，具体能力如下：
- 字段转录：将收据信息转录为账本行。
- 数据溯源：每个字段（日期、商户、金额、货币、税额）都能追溯到源图像。
- 标记而非猜测：对不明确的字段进行标记，绝不编造数据。
- 批次对账：核对行数与收据数量是否一致，核对行总金额是否等于从收据读取的总金额。
- 提交前重检：在提交前再次对照图像检查标记字段，无法解决的标记保留。
字段纪律¶
插件遵循严格的字段转录规则：
- 日期：按打印内容；不同格式需明确解析。
- 商户：与显示完全一致，缩写保留，扩展名标记为猜测。
- 金额：按打印的收费金额，货币符号随金额。
- 货币：明确声明，支持混合货币批次转换。
- 税额：仅当收据单独分离时读取；假设税额是标记的猜测。
- 分类：来自账本自身的分类列表，不清楚的情况询问用户，从不即兴发挥。
使用流程¶
使用该插件遵循“批处理闭环”：
- 转录与标记：将每张收据转录为一行，对不明确字段（如
unclear: merchant）进行内联标记。 - 批次对账：核对行数是否等于收据数量，核对行总金额是否等于从收据读取的总金额。
- 重检提交：在提交前再次对照图像检查标记字段，无法解决的标记保留。
- 写入账本：批准后写入账本。失败的行会被报告，不会盲目重试（盲重试会产生重复）。
适用场景与注意¶
- 图片识别瓶颈：看不清的收据会保持标注，这需要人工介入。
- 数据源限制：插件只读打印内容，绝不计算“应该有”的数据。
- 税务处理：各地税务规则不同，税务建议归会计处理。
- 运行权限：插件以当前 DSH 进程权限运行。
安装与启用¶
执行以下命令即可安装：
npx skills add ChenneyZhuang/expense-capture
结语¶
expense-capture 通过机械的转录纪律和对账机制，减少了报销录入中的编造风险。完整文档与源码可访问插件目录或 GitHub 仓库。
