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

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

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

為什么美國(guó)代碼在英國(guó)會(huì)"水土不服"

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

美國(guó)會(huì)計(jì)軟件通常把"租金"歸為一類，但英國(guó)VAT規(guī)定：住宅租金零稅率，商業(yè)租金標(biāo)準(zhǔn)稅率20%?；煸谝黄?，季度申報(bào)時(shí)直接報(bào)錯(cuò)。更隱蔽的是"業(yè)務(wù)招待費(fèi)"——英國(guó)VAT完全禁止抵扣進(jìn)項(xiàng)稅，企業(yè)所得稅還要做納稅調(diào)增。美國(guó)開(kāi)發(fā)者沒(méi)經(jīng)歷過(guò)CT600（英國(guó)公司稅申報(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ù)處理說(shuō)明。做自動(dòng)化報(bào)表時(shí)，不再需要硬編碼映射表。

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

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

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

Matt 的做法是把整個(gè)科目表序列化成結(jié)構(gòu)化文本，按賬戶類型過(guò)濾，直接注入 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 說(shuō)這是他從一個(gè)更大的記賬自動(dòng)化項(xiàng)目里拆出來(lái)的"參考數(shù)據(jù)層"——原本只是內(nèi)部工具，發(fā)現(xiàn)社區(qū)確實(shí)需要，才單獨(dú)開(kāi)源。

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

英國(guó)標(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)軗瞥鏊熊?chē)輛相關(guān)費(fèi)用——燃油、保險(xiǎn)、維修、路稅，方便做福利車(chē)（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è)格子，全寫(xiě)進(jìn)了元數(shù)據(jù)。做電子申報(bào)時(shí)，直接讀字段生成XML，不用再查 HMRC 的PDF手冊(cè)。

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

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

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

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

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