核心用法
GridTRX 是一款面向 AI Agent 的完整周期双复式记账引擎，将银行 CSV、OFX、QBO 文件转换为可审计的账簿。用户以自然语言指令驱动，Agent 自动完成分类、记账、报表生成全流程。系统提供三层接口：MCP Server（结构化 JSON 工具，20 个工具函数）、CLI（零依赖命令行）、Browser UI（Flask 网页界面），均调用同一数据层，确保一致性。
典型工作流程：
1. 初始化：创建 books.db，内置约 60 个过账科目、5 张标准报表及 60+ 导入规则
2. 导入银行数据：自动应用规则分类，无法识别的交易进入 EX.SUSP 暂记科目
3. 清理暂记：与用户确认模糊交易类别，添加规则后重新导入
4. 验证与报告：生成试算平衡表、资产负债表、损益表，确保借贷平衡
5. 年末结转：执行 rollforward 关闭留存收益，锁定期间，推进会计年度
显著优点
- 完整双复式架构：每笔交易借贷必相等，内置永续留存收益链（IS→NI→RE.CLOSE→RE），符合会计准则
- 本地优先设计：单一 SQLite 文件存储全部数据，支持复制、备份、邮件传输，无云服务依赖
- 多格式兼容：原生支持 CSV、OFX、QBO 银行格式，以及 CaseWare AJE 导出（IIF/Venice/MYOB）
- 确定性输出：金额以整数分存储，显示格式固定（正数=借方，括号=贷方），消除浮点误差
- 三重接口冗余：MCP 为 Agent 首选，CLI 为备用方案，浏览器 UI 供人工复核
潜在局限
- Python 环境依赖：需预装 Python 3.7+，MCP Server 需
pip install mcp，浏览器 UI 需 Flask - 无实时银行连接：依赖手动导入文件，不支持自动同步网银数据
- 暂记清理需人工介入：模糊交易（如 "AMAZON"）必须询问用户，无法自动推断业务场景
- 无批量撤销：误导入需逐条删除交易，无一键回滚机制
- 锁定期限制：锁定日期后的期间无法修改，操作前必须检查
lock_date和fy_end_date
适合人群
- 小型企业主、自由职业者需本地化、低成本记账方案
- 会计代理需批量处理多客户账簿，重视数据可移植性
- AI Agent 开发者需结构化、可审计的财务数据接口
- 对云端财务软件有隐私顾虑，偏好完全离线存储的用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据完整性 | 直接修改 `books.db` 会破坏账本一致性 | 始终通过 MCP 工具或 CLI 操作，禁用文件工具直接访问 |
| 工作区越界 | 操作指定路径外的数据库 | 配置 `GRIDTRX_WORKSPACE` 环境变量，MCP/CLI 强制校验 |
| 期间误操作 | 在锁定期间或会计年度外导入数据 | 导入前执行 `get_info()` 确认 `lock_date` 和 `ceiling` |
| 分类误判 | AI 猜测模糊交易类别导致账目失真 | 严格执行"不猜测"原则，暂记科目 `EX.SUSP` 兜底 |
| 年末结转错误 | 未执行 `rollforward` 导致留存收益断裂 | 会计年度结束时强制执行年末流程，验证报表链完整性 |