复式记账、增值税跟踪、损益表、资产负债表——所有这些都在本地 SQLite 分类账中，目标是 HMRC 使税务数字化。
每笔交易都平衡到一分钱——借方始终等于贷方
开箱即用的标准英国账户代码 — 映射到 HMRC 类别的资产、负债、股权、收入和支出。根据需要使用自定义帐户进行扩展。
所有数据存储在 ~/.chameleon/accounting/<company>/ledger.db。完全离线运行。多公司支持 - 使用命令标志在实体之间切换。
年终正确设置为 4 月 5 日（英国财政年度为 4 月 6 日至 4 月 5 日）。损益和增值税报告自动跨越正确的期间，无需手动调整日期。
跑步 --forensic 检测不平衡条目、重复引用、增值税不匹配和其他违规行为。结果以结构化 JSON 形式打印以供 AI 审核。
所有报告都将结构化 JSON 输出到标准输出，以便 Chameleon AI 可以用自然语言解析、总结和建议您的财务状况。
会计 WebSocket 桥（acct_ws_bridge.py）通过 Tailscale 网络向移动配套设备和外部仪表板公开账本查询。
标准税率20%
折扣率5%
零税率
豁免
超出范围
该期间的收入与支出。销售额、商品成本、毛利润、运营费用、净利润——全部按账户代码细分。运行与 --report pl.
某个时间点的资产、负债和权益。确认复式记账完整性——资产必须等于负债加权益。运行与 --report bs.
与 HMRC MTD 增值税申报表格式相符的逐栏增值税数字：框 1（销项税）、框 4（进项税）、框 6（净销售）、框 7（净采购）。运行与 --report vat.
符合 HMRC 通知 700 标准的发票 — 打印、保存为 PDF 或一键推送到您的手机
每张发票均包含 HMRC 通知 700 要求的所有字段：唯一的连续发票号、供应商名称和地址、增值税登记号、发票日期、供应日期（供应时间）、客户名称和地址、客户增值税号（如适用）、包含数量和单价的逐项行说明、每行增值税率、净额和增值税小计以及应付总额。什么都没有丢失，什么也没有被猜测。
打开 文件 → 发票 → 公司设置 输入您的注册公司名称、地址、公司门牌号码、增值税号码、电子邮件、电话和银行详细信息。设置保存在每个客户端数据库中 company.json 与分类账一起并在为该客户生成发票时自动加载。
第一次向客户开具发票时，他们的姓名、地址和增值税号将保存到分类账内的联系人表中。在后续发票上，输入客户名称会自动填写其详细信息 - 无需重新输入。联系人可以随时编辑。
来自发票管理器（文件 → 发票...) 选择任何发票并选择： 打印 （打开操作系统打印对话框 - 任何打印机或 PDF 驱动程序）， 保存PDF （通过 Qt 的内置 PDF 导出直接到磁盘），或者 发送至电话 （将发票 HTML 推送到配套应用程序，在其中打开 Android 打印对话框 — 无线打印到任何 AirPrint 或附近的打印机）。
单独的“供应日期”（供应时间）字段 — 与发票日期不同。 HMRC 出于增值税目的要求。默认为今天，但可以根据发票独立编辑。
配套应用程序可以无线打印任何发票。点击任何发票行上的打印图标 — 应用程序从 IDE 获取 HTML，通过 printing 打包，并打开 Android 系统打印对话框。
完整的英国增值税发票的所有 12 个必填字段均已显示并已填充。低费率和零费率线路都有明确的标签。发票编号序列严格单调递增，没有间隙。
| 命令 | 描述 |
|---|---|
python3 chameleon_accounting.py --report pl | 当前纳税年度的损益 |
python3 chameleon_accounting.py --report bs | 截至今日的资产负债表 |
python3 chameleon_accounting.py --report vat | 增值税申报表摘要（MTD 框） |
python3 chameleon_accounting.py --forensic | 异常和完整性扫描 |
python3 chameleon_accounting.py --help | 完整命令参考 |