前言¶
報銷錄入中存在一種昂貴的失敗模式：編造。看錯總額、猜商家名、從小計倒推稅額——每一個都是一次對賬噩夢，在審計裏是信用問題。expense-capture 通過機械的轉錄紀律，將收據轉化爲賬本行，每個字段都能追溯到源圖像，對不明確字段進行標記，最後進行批次對賬。
插件定位¶
這是一份工作流插件，旨在將收據和發票轉化爲符合賬本格式的行。由 ChenneyZhuang 維護，採用 MIT 許可證。
核心功能¶
該插件主要解決“憑空猜測”數據的問題，具體能力如下：
- 字段轉錄：將收據信息轉錄爲賬本行。
- 數據溯源：每個字段（日期、商戶、金額、貨幣、稅額）都能追溯到源圖像。
- 標記而非猜測：對不明確的字段進行標記，絕不編造數據。
- 批次對賬：覈對行數與收據數量是否一致，覈對行總金額是否等於從收據讀取的總金額。
- 提交前重檢：在提交前再次對照圖像檢查標記字段，無法解決的標記保留。
字段紀律¶
插件遵循嚴格的字段轉錄規則：
- 日期：按打印內容；不同格式需明確解析。
- 商戶：與顯示完全一致，縮寫保留，擴展名標記爲猜測。
- 金額：按打印的收費金額，貨幣符號隨金額。
- 貨幣：明確聲明，支持混合貨幣批次轉換。
- 稅額：僅當收據單獨分離時讀取；假設稅額是標記的猜測。
- 分類：來自賬本自身的分類列表，不清楚的情況詢問用戶，從不即興發揮。
使用流程¶
使用該插件遵循“批處理閉環”：
- 轉錄與標記：將每張收據轉錄爲一行，對不明確字段（如
unclear: merchant）進行內聯標記。 - 批次對賬：覈對行數是否等於收據數量，覈對行總金額是否等於從收據讀取的總金額。
- 重檢提交：在提交前再次對照圖像檢查標記字段，無法解決的標記保留。
- 寫入賬本：批准後寫入賬本。失敗的行會被報告，不會盲目重試（盲重試會產生重複）。
適用場景與注意¶
- 圖片識別瓶頸：看不清的收據會保持標註，這需要人工介入。
- 數據源限制：插件只讀打印內容，絕不計算“應該有”的數據。
- 稅務處理：各地稅務規則不同，稅務建議歸會計處理。
- 運行權限：插件以當前 DSH 進程權限運行。
安裝與啓用¶
執行以下命令即可安裝：
npx skills add ChenneyZhuang/expense-capture
結語¶
expense-capture 通過機械的轉錄紀律和對賬機制，減少了報銷錄入中的編造風險。完整文檔與源碼可訪問插件目錄或 GitHub 倉庫。
