核心用法
agent-accounting 是一套覆盖代理记账全周期的 AI 自动化技能，通过命令行接口驱动完整业务流程。用户可通过 main.py 执行多种指令模式：full 一键运行完整周期（OCR→做账→报表→申报→仪表盘），ocr/baidu_ocr 进行票据识别，vouchers 生成分录凭证，reports 输出三大报表，tax/risk/filing 完成税务计算、风险检测与金税四期申报。系统集成本地OCR引擎与百度OCR API双模式，支持13类票据识别，内置50+会计科目智能匹配，自动验证借贷平衡。
显著优点
1. 全流程闭环：唯一覆盖"票据采集→智能分录→三大报表→金税四期申报→风险预警"完整链路的自动化工具，无需切换多个系统。
2. 双引擎OCR：本地OCR零成本启动，百度OCR API（每月500次免费）提供高精度增强，支持智能降级。
3. 金税四期深度对接：内置10项风险指标检测（税负异常、零申报、发票重复等），高风险自动拦截并输出修正建议。
4. 可视化仪表盘：自动生成交互式HTML面板，集成KPI卡片、Chart.js图表、凭证明细、申报状态面板。
5. 代账场景优化：针对中小代账公司设计，效率提升50倍，支持批量处理与多客户管理场景。
潜在缺点与局限性
1. 平台锁定风险：项目路径硬编码为 Windows 环境（C:\Users\PC\...），跨平台迁移需手动调整。
2. 外部依赖较重：金税申报依赖第三方服务商（百望云/航信/企享云）API，需额外申请资质与付费。
3. 本地OCR精度限制：13类票据的本地识别准确率可能低于商业OCR服务，复杂票据需人工复核。
4. 环境配置复杂：需配置多项环境变量（BAIDU_OCR_API_KEY、TAX_API_KEY等），新手门槛较高。
5. 法律合规风险：自动化申报涉及税务法律责任，系统拦截逻辑与人工复核机制需严格验证。
适合的目标群体
- 中小代账公司：处理大量中小企业的月度/季度记账与申报需求
- 财务外包服务商：需要标准化、可批量复制的代理记账流程
- 企业财务部门：寻求内部记账自动化改造的中小型企业
- 财税SaaS开发者：可作为底层引擎集成至自有财税平台
常规使用风险
- 数据安全风险：票据图片与财务数据本地存储，需关注磁盘加密与访问权限
- API额度耗尽：百度OCR免费额度用尽后需付费，可能导致识别服务中断
- 申报准确性：税务政策更新频繁，智能分录引擎需持续维护科目规则库
- 性能瓶颈：大批量票据处理时，本地OCR与报表生成可能存在超时风险（默认30秒限制）
- 合规责任：自动化申报结果需人工最终确认，系统风险提示不能替代专业税务师判断