finance-tax 0.1.0

中国企业记账报税技能包 - 支持银行流水导入、发票管理、自动记账、财务报表生成和税务申报

🧾 finance-tax — 中国企业记账报税技能包

面向中国中小微企业的智能记账报税 Skill，为 Agent 及其他 AI Agent 提供完整的财务管理能力。

功能特性

• 银行流水导入 — 支持主流银行 Excel 格式，智能列名识别
• 发票管理 — Excel 批量导入，预留 OCR API 接口
• 自动记账 — 智能科目匹配，自动生成复式记账凭证
• 财务报表 — 资产负债表、利润表、现金流量表、科目余额表
• 税务计算 — 增值税、企业所得税、印花税、附加税自动计算
• 中国税务合规 — 支持小规模/一般纳税人，兼容两套会计准则
• Web 数据看板 — 内置专业 Web UI，支持数据展示、查询、图表分析

快速开始

前置要求

• Python 3.11+
• uv 包管理器

安装

# 克隆项目
cd ~/.openclaw/workspace/skills/
git clone <repo-url> finance-tax

# 安装依赖
cd finance-tax
uv sync

# 安装 Web 看板依赖（可选）
uv sync --extra api

初始化

uv run ft init --name "我的公司" --year 2026

基本使用

# 导入银行流水
uv run ft bank import 银行流水.xlsx --bank-name 招商银行

# 导入发票
uv run ft invoice import 发票台账.xlsx

# 审核流水并生成凭证（Agent 工作流）
uv run ft bank list --unprocessed --json-output
uv run ft voucher suggest 1
uv run ft voucher assign 1 --debit "银行存款" --credit "主营业务收入" --post

# 生成报表
uv run ft report balance-sheet --period 2025-03
uv run ft report income --period 2025-03 --start 2025-01

# 计算税费
uv run ft tax vat --period-start 2025-01 --period-end 2025-03
uv run ft tax income --year 2025 --quarter 1

# 启动 Web 数据看板
uv run ft web --port 8000

项目结构

finance-tax/
├── SKILL.md                  # 技能清单（模块索引）
├── README.md                 # 说明文档
├── .clawignore               # 发布排除规则
├── pyproject.toml            # Python 项目配置
├── references/               # 各模块详细文档
│   ├── setup.md              # 初始化配置
│   ├── bank-import.md        # 银行流水导入
│   ├── invoice-manage.md     # 发票管理
│   ├── voucher-generate.md   # 凭证生成
│   ├── report-generate.md    # 报表生成
│   ├── tax-calculate.md      # 税务计算
│   └── account-period.md     # 科目/期间管理
├── data/                     # 基础数据
│   ├── chart_of_accounts_small_enterprise.json
│   ├── chart_of_accounts_enterprise.json
│   └── tax_rules.json
└── src/finance_tax/          # 源代码
    ├── cli.py                # CLI 入口
    ├── config.py             # 配置管理
    ├── database.py           # 数据库管理
    ├── models/               # 数据模型
    ├── import_engine/        # 数据导入引擎
    ├── accounting/           # 会计引擎
    ├── reporting/            # 报表引擎
    ├── taxation/             # 税务引擎
    └── web/                  # Web 看板
        ├── app.py            # FastAPI 后端
        └── static/           # 前端静态文件
            ├── index.html    # SPA 骨架
            ├── css/app.css   # 全局样式
            └── js/           # 模块化 JS
                ├── app.js    # Vue 主入口
                ├── api.js    # API 封装
                ├── utils.js  # 工具函数
                └── views/    # 各视图状态逻辑

技术栈

• 语言: Python 3.11+
• CLI: Click + Rich
• ORM: SQLAlchemy 2.0
• 数据库: SQLite（本地）
• Excel: openpyxl + pandas
• 配置: Pydantic Settings
• Web: FastAPI + Vue 3 + TailwindCSS + ECharts（CDN，无需构建）

许可证

MIT