核心用法
GridTRX 是一款面向 AI 代理的全周期双记账会计引擎，支持将银行 CSV、OFX、QBO 文件转换为可审计的完整账簿。用户以自然语言发起请求（如"做账""导入流水""生成资产负债表"），代理通过 MCP 工具（20 个结构化 JSON 接口）或 CLI 单条命令完成操作。
数据架构：每个客户为一个 SQLite 文件（books.db），所有操作（MCP/CLI/浏览器 UI）均通过统一数据层 models.py 执行，确保一致性。MCP 为首选接口，CLI 为备用方案，浏览器 UI 供人工复核。
标准工作流：
1. 初始化：创建 books.db，内置约 60 个会计科目、5 套报表模板及保留盈余链（IS → NI → RE.CLOSE → BS）。
2. 导入银行数据：import_csv / import_ofx 自动匹配规则，未识别项落入 EX.SUSP 待处理队列。
3. 清理 Suspense：向用户确认模糊交易类别（如"AMAZON"可能为办公用品、库存或个人消费），添加规则后重新导入。
4. 验证与报表：生成试算平衡表（必须借贷相等）、资产负债表、损益表，支持导出 CSV/PDF。
5. 年末结转：rollforward 自动结转保留盈余、锁定历史期间、推进会计年度上限。
关键设计：
- 符号约定：正数 = 借方，括号
(1,500.00)= 贷方，无千位分隔符。 - 金额存储：内部以整数分存储，显示为两位小数美元。
- 科目命名：大小写不敏感，约定全大写，禁用数字代码（如 1010），强制使用描述性名称（如
EX.OFFICE）。 - 安全边界：
GRIDTRX_WORKSPACE环境变量强制限定操作范围，路径越界会被拒绝。
显著优点
- 全本地化：无云端依赖、无 API 调用、无出站网络请求，数据完全由用户掌控。
- AI 原生设计：MCP 工具提供类型化参数与确定性输出，避免文本解析不确定性；CLI 零依赖（Python 3.7+ 标准库即可运行）。
- 审计就绪：强制双记账平衡、保留盈余自动链式结转、锁定期防篡改，满足会计合规要求。
- 灵活导入：支持 CSV、OFX/QBO、CaseWare AJE（IIF/Venice 格式），关键词规则自动分类并支持税码拆分（如 GST 5%）。
- 多重接口：同一数据层支持代理自动化（MCP）、脚本批处理（CLI）、人工复核（浏览器 UI），无缝切换。
潜在缺点与局限性
- 规则维护成本：自动分类依赖人工预设关键词规则，新业务场景需持续迭代规则库。
- 无实时银行连接：仅支持文件式导入，不支持 Open Banking API 或自动同步。
- 单用户架构：SQLite 文件锁机制限制并发写入，不适合多用户同时操作场景。
- 无多币种处理：文档未提及外汇或多币种支持，跨境业务可能受限。
- 恢复粒度粗：无批量撤销功能，误导入需逐条删除后重新导入。
- 依赖环境变量：
GRIDTRX_WORKSPACE为强制前置配置，配置不当将导致服务拒绝启动。
适合人群
- 中小型企业、自由职业者或会计外包服务商，寻求低成本、可审计的本地化记账方案。
- 开发者或 AI 团队，需要将会计能力嵌入自动化工作流（如发票处理、费用报销、月末结账）。
- 对数据主权敏感、拒绝 SaaS 订阅模式的用户。
- 现有会计软件（如 QuickBooks、Xero）的替代或补充，尤其适合批量历史数据迁移与审计场景。
常规风险
- 误分类风险：代理被明确禁止猜测类别，模糊交易若未询问用户直接归类，将导致报表失真；需严格执行 Suspense 队列机制。
- 数据完整性风险：直接修改
books.db文件将破坏审计链；所有写操作必须通过 MCP 工具或 CLI。 - 路径遍历风险：虽通过
GRIDTRX_WORKSPACE限制，但若环境变量被篡改，仍存在越界访问可能。 - 锁定期误操作：年末结转后锁定期自动推进，若未确认数据完整性即锁定，后续调整将受阻。
- 依赖管理风险：MCP 与浏览器 UI 需预装
mcp与flask包，运行时禁止自动安装，环境准备不足将导致功能不可用。 - 备份责任：SQLite 文件便携但用户需自行制定备份策略，单点故障可能导致数据丢失。