返回目录
开发工具 技能

expense-capture

ChenneyZhuang/expense-capture

Expense capture skill: receipts to ledger-ready rows without invention — transcribe as shown, flag unclear fields, read tax never derive it, and reconcile count and total before any write.

Stars
0
Forks
0
Issues
0
更新
15 天前

PROJECT TOPICS

项目标签

INSTALL REFERENCE

安装参考

未验证
dsh plugin --profile web add github:ChenneyZhuang/expense-capture

该命令指向仓库当前默认分支;尚无绑定当前 commit 的完整验证结果。

PROJECT README

README

expense-capture 报销捕获

Receipts become ledger rows — with every field traceable to the source image and nothing guessed.

收据变成账本行——每个字段都能追溯到原图,绝不脑补。

Why / 为什么

Expense entry has one expensive failure mode: invention. A misread total, a guessed merchant name, a tax amount assumed from the subtotal — each one is a small reconciliation nightmare and, in an audit, a credibility problem. The discipline is mechanical: transcribe what is visible, flag what is not, reconcile the batch at the end.

报销录入只有一种昂贵的失败:编造。看错总额、猜商家名、从小计倒推税额——每一个都是一次对账噩梦,在审计里是信用问题。纪律是机械的:看见什么抄什么,看不见的标记,最后整体对账。

Field discipline / 字段纪律

Field Rule
date as printed; different formats resolved explicitly
merchant exactly as shown; abbreviations kept, expansions marked as guesses
amount the charged amount as printed; the currency symbol travels with it
currency stated explicitly; mixed-currency batches convert with the rate and rate date shown
tax only when the receipt separates it; assuming tax from a total is a flagged guess
category from the ledger's own category list; unclear cases ask, never improvise

The batch loop / 批处理闭环

  1. Transcribe each receipt into a row, flags inline (unclear: merchant).
  2. Reconcile: row count == receipt count; sum of rows == sum read from the receipts (stated both ways).
  3. Re-verify flagged fields against the image once more before submitting; a flag that cannot be resolved stays a flag for the user.
  4. Ledger writes happen after approval, in the ledger's own format — and a row that fails to write is reported, not retried blind (blind retries create duplicates).

Honest limitations / 如实说明局限

  • Image recognition is the bottleneck: illegible receipts stay flagged, and flags need human eyes.
  • Tax rules differ by jurisdiction; the skill reads what is printed and never computes what should be there — tax advice stays with the accountant.

图片识别是瓶颈:看不清的收据保持标注,标注需要人来解。各地税务规则不同——skill 只读打印出来的,绝不计算"应该有"的;税务问题归会计。

Install / 安装

npx skills add ChenneyZhuang/expense-capture

Per-agent paths: COMPATIBILITY.md. MIT. v0.1.0.

各 agent 安装路径见 COMPATIBILITY.md。MIT 许可,v0.1.0。

CLASSIFICATION EVIDENCE

分类依据

项目类型技能
功能分类开发工具
规则置信度高

系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。当前命中: agent-skills、claude-code。