agent-accounting — AI代理记账自动化技能#

面向代账公司的全流程AI自动化工具 从票据采集到金税四期申报一站式覆盖，效率提升50x

概述#

agent-accounting 是一个 AI 驱动的代理记账自动化系统，覆盖企业记账全流程。支持本地OCR模式和百度OCR API双引擎，内置智能分录引擎、三大报表自动生成、金税四期申报对接。

项目路径： C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting\ 入口文件： main.py Python： C:\Users\PC\.workbuddy\binaries\python\envs\default\Scripts\python.exe

---

快速开始#

python

import subprocess, os

PROJECT_DIR = r"C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting"
PYTHON = r"C:\Users\PC\.workbuddy\binaries\python\envs\default\Scripts\python.exe"

def run_accounting(cmd="full"):
    """运行代理记账流程
    cmd: full|demo|ocr|vouchers|reports|tax|risk|filing|baidu_ocr
    """
    result = subprocess.run(
        [PYTHON, "main.py", cmd],
        cwd=PROJECT_DIR,
        capture_output=True,
        text=True,
        timeout=30
    )
    return result.stdout

# 一键完整流程：OCR → 做账 → 申报 → 仪表盘
output = run_accounting("full")
print(output)

# 打开仪表盘
import webbrowser
webbrowser.open(f"file:///{PROJECT_DIR}/demo_data/dashboard.html")

---

功能一：票据 OCR 识别#

bash

# 测试本地OCR识别（无需API Key）
python "C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting\main.py" ocr

支持13类票据：增值税专用发票、增值税普通发票、电子发票、火车票、飞机行程单、出租车票、银行回单、工资单、费用报销单、采购单、销售单、收据、合同。

可选百度OCR API增强（每月500次免费）：

• 申请地址： https://ai.baidu.com/tech/ocr/finance
• 设置环境变量： $env:BAIDU_OCR_API_KEY="xxx" + $env:BAIDU_OCR_SECRET_KEY="yyy"
• 检测状态： python main.py baidu_ocr

---

功能二：自动生成会计分录和凭证#

bash

# 查看凭证列表
python "C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting\main.py" vouchers

智能分录引擎内置50+会计科目表，根据票据类型自动匹配借贷科目，批量生成标准会计凭证，自动验证借贷平衡。

---

功能三：财务报表生成#

bash

# 查看三大报表
python "C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting\main.py" reports

自动生成：试算平衡表、资产负债表、利润表。

---

功能四：税务计算与风险预警#

bash

# 报税计算
python "C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting\main.py" tax

# 风险检测
python "C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting\main.py" risk

覆盖：增值税进销项核算、企业所得税季度预缴、印花税计算；10项金税四期风险指标检测（税负异常/零申报/发票重复/过期等）。

---

功能五：金税四期申报#

bash

# 执行申报流程（含风险预检+XML生成）
python "C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting\main.py" filing

支持第三方申报服务商对接（百望云/航信/企享云）：

• $env:TAX_API_KEY="your_tax_api_key"
• $env:TAX_API_BASE_URL="https://api.your-provider.com/v1"

高风险自动阻止申报，输出修正建议。

---

功能六：完整演示流程#

bash

# 完整演示：OCR → 做账 → 报表 → 申报 → 仪表盘
python "C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting\main.py" full

一步生成完整代理记账周期结果，含交互式HTML仪表盘（KPI卡片、Chart.js图表、凭证明细、申报状态面板）。

---

功能七：可视化仪表盘#

python

# 仪表盘路径
DASHBOARD_PATH = r"C:\Users\PC\WorkBuddy\2026-06-17-11-54-26\agent-accounting\demo_data\dashboard.html"

import webbrowser
webbrowser.open(f"file:///{DASHBOARD_PATH}")

仪表盘包含：KPI卡片（凭证数/票据数/税额/风险等级）、票据分类饼图、费用支出柱状图、凭证汇总表、资产负债表、利润表、申报状态面板、风险预警列表。

---

常见场景处理#

场景：用户说"帮我记一笔账"

1. 使用 core/ocr.py 识别票据
2. 使用 core/engine.py 生成分录和凭证
3. 展示凭证列表供确认

场景：用户说"这个月报税"

1. 运行 main.py tax 计算税额
2. 运行 main.py risk 检测风险
3. 运行 main.py filing 执行申报
4. 展示申报结果

场景：用户说"生成财务报表"

1. 运行 main.py reports 生成三大报表
2. 运行 main.py full 附带生成仪表盘
3. 打开 HTML 仪表盘供查看

场景：用户说"配置百度OCR"

1. 引导用户申请百度OCR API Key
2. 设置环境变量 BAIDU_OCR_API_KEY 和 BAIDU_OCR_SECRET_KEY
3. 运行 main.py baidu_ocr 验证配置

---

模块架构#

text

core/
├── models.py        # 数据模型
├── ocr.py           # 本地OCR（13类票据）
├── baidu_ocr.py     # 百度OCR API（含降级）
├── engine.py        # 智能分录引擎
├── reports.py       # 三大报表生成
├── tax.py           # 税务计算+风险预警
└── golden_tax.py    # 金税四期申报接口
web/
└── dashboard.py     # HTML可视化仪表盘
scripts/
└── generate_demo.py # 演示数据生成器
main.py              # CLI入口

---

环境要求#

• Python 3.10+
• 可选：requests（百度OCR API调用）
• 可选：Pillow（票据图片预处理）
• 可选：openpyxl（Excel导出）