全球PyPI倉庫里有超過47萬個(gè)Python包，但英國會計(jì)從業(yè)者找了7年，沒找到一份能直接調(diào)用的標(biāo)準(zhǔn)科目表。

這是開發(fā)者 Matt 在 GitHub 上寫下的原話。他在給英國客戶做AI記賬工具時(shí)，發(fā)現(xiàn)所有現(xiàn)成的會計(jì)庫都是美國標(biāo)準(zhǔn)——GAAP（美國公認(rèn)會計(jì)原則）的科目分類、美國的稅務(wù)代碼、美國的增值稅邏輯。英國特有的VAT（增值稅）處理、HMRC（英國稅務(wù)海關(guān)總署）申報(bào)表單映射，全得自己手工維護(hù)。

于是他花了一個(gè)周末，把英國標(biāo)準(zhǔn)的166個(gè) nominal codes（名義科目代碼）寫成了一個(gè)零依賴的純Python庫：uk-chart-of-accounts。

為什么美國代碼在英國會"水土不服"

英美會計(jì)體系的差異，比英鎊和美元的匯率更難換算。

美國會計(jì)軟件通常把"租金"歸為一類，但英國VAT規(guī)定：住宅租金零稅率，商業(yè)租金標(biāo)準(zhǔn)稅率20%?；煸谝黄穑径壬陥?bào)時(shí)直接報(bào)錯(cuò)。更隱蔽的是"業(yè)務(wù)招待費(fèi)"——英國VAT完全禁止抵扣進(jìn)項(xiàng)稅，企業(yè)所得稅還要做納稅調(diào)增。美國開發(fā)者沒經(jīng)歷過CT600（英國公司稅申報(bào)表）的折磨，根本想不到這一層。

Matt 在文檔里舉了個(gè)例子：代碼7403"業(yè)務(wù)招待費(fèi)"的元數(shù)據(jù)里，直接嵌入了 HMRC VAT Notice 700/65 的引用，以及 CT600 Box 46 的填報(bào)指引。

這不是注釋，是機(jī)器可讀的字段。

調(diào)用 `coa.get(7403).hmrc_box` 返回字符串 `"CT600 Box 46"`，調(diào)用 `.description` 拿到完整的稅務(wù)處理說明。做自動(dòng)化報(bào)表時(shí)，不再需要硬編碼映射表。

給AI記賬工具做的" prompt 外掛"

這個(gè)庫最討巧的設(shè)計(jì)，是 `to_prompt_context()` 方法。

現(xiàn)在所有人都在做大模型+記賬，但有個(gè)臟活躲不掉：怎么讓模型知道"TESCO 15.40 GBP"該進(jìn)哪個(gè)科目？常規(guī)做法是維護(hù)一套 prompt 模板，把科目表貼進(jìn)去?？颇勘砀铝?，模板得跟著改，版本管理噩夢。

Matt 的做法是把整個(gè)科目表序列化成結(jié)構(gòu)化文本，按賬戶類型過濾，直接注入 prompt：

```pythoncontext = coa.to_prompt_context(types=[AccountType.OVERHEAD])prompt = f"""Given this chart of accounts:{context}Categorise this transaction: "TESCO 15.40 GBP""""

模型拿到的是帶VAT稅率、帶HMRC表單映射的完整上下文，不是光禿禿的科目名稱。Matt 說這是他從一個(gè)更大的記賬自動(dòng)化項(xiàng)目里拆出來的"參考數(shù)據(jù)層"——原本只是內(nèi)部工具，發(fā)現(xiàn)社區(qū)確實(shí)需要，才單獨(dú)開源。

166個(gè)代碼背后的合規(guī)細(xì)節(jié)

英國標(biāo)準(zhǔn)科目表的范圍從1000（固定資產(chǎn)）到9999（系統(tǒng)賬戶），Matt 覆蓋了完整的166個(gè)常用代碼。每個(gè)代碼包含6個(gè)字段：名稱、VAT稅率（標(biāo)準(zhǔn)/減免/零稅率/豁免）、稅率百分比、借方增減方向、HMRC表單映射、業(yè)務(wù)標(biāo)簽。

標(biāo)簽系統(tǒng)做得細(xì)。"motor"標(biāo)簽?zāi)軗瞥鏊熊囕v相關(guān)費(fèi)用——燃油、保險(xiǎn)、維修、路稅，方便做福利車（company car）的稅務(wù)調(diào)整。按VAT稅率篩選，能一鍵分離可抵扣和不可抵扣進(jìn)項(xiàng)。

最枯燥的部分是 HMRC 映射。CT600的86個(gè)格子、VAT Return的9個(gè)盒子、FPS/RTI（實(shí)時(shí)報(bào)稅）、EPS（雇主支付摘要）、CIS（建筑業(yè)方案），每個(gè)代碼該進(jìn)哪個(gè)格子，全寫進(jìn)了元數(shù)據(jù)。做電子申報(bào)時(shí)，直接讀字段生成XML，不用再查 HMRC 的PDF手冊。

零依賴、純Python、3.10+支持。安裝命令就一行：`pip install uk-chart-of-accounts`。

GitHub 倉庫的星標(biāo)數(shù)還沒破百，但 Matt 說已經(jīng)收到四大會計(jì)師事務(wù)所的私信——不是要用，是想確認(rèn)"這個(gè)映射關(guān)系你們從哪驗(yàn)證的"。他貼出了 HMRC 官方科目表指南和 VAT Notice 的交叉引用鏈接。

開源社區(qū)有個(gè)經(jīng)典悖論：最該被標(biāo)準(zhǔn)化基礎(chǔ)設(shè)施，往往因?yàn)?太基礎(chǔ)"而沒人愿意維護(hù)。美國有 FASB（財(cái)務(wù)會計(jì)準(zhǔn)則委員會）背書的 XBRL 分類標(biāo)準(zhǔn)，Python 生態(tài)里對應(yīng)庫一抓一把。英國 HMRC 只發(fā)PDF和Excel，開發(fā)者各自為戰(zhàn)，重復(fù)造輪子造了七年。

Matt 的166行代碼（實(shí)際代碼量）算不上一場革命，但它把"查PDF-手工錄入-祈禱別報(bào)錯(cuò)"的循環(huán)，變成了 `pip install` 之后的三行調(diào)用。對于每年要處理超過500萬份CT600申報(bào)的英國中小企業(yè)來說，這個(gè)差距可能就是自動(dòng)化和手工賬的分水嶺。

下一個(gè)被補(bǔ)上的缺口會是什么？澳大利亞的GST科目表，還是印度的GST州際映射？有人在 Matt 的 issue 區(qū)留言：加拿大T2申報(bào)表的科目映射，我周末也寫一個(gè)。