Metadata-Version: 2.4
Name: finance-tax
Version: 0.1.0
Summary: 中国企业记账报税技能包 - 支持银行流水导入、发票管理、自动记账、财务报表生成和税务申报
License: MIT
Keywords: accounting,agent,bookkeeping,china,finance,tax
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Accounting
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: openpyxl>=3.1
Requires-Dist: pandas>=2.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: pydantic>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: sqlalchemy>=2.0
Requires-Dist: urllib3>=2.0
Provides-Extra: api
Requires-Dist: fastapi>=0.110; extra == 'api'
Requires-Dist: uvicorn>=0.29; extra == 'api'
Provides-Extra: dev
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Provides-Extra: ocr
Requires-Dist: httpx>=0.27; extra == 'ocr'
Description-Content-Type: text/markdown

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

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

## 功能特性

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

## 快速开始

### 前置要求

- Python 3.11+
- [uv](https://docs.astral.sh/uv/) 包管理器

### 安装

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

# 安装依赖
cd finance-tax
uv sync

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

### 初始化

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

### 基本使用

```bash
# 导入银行流水
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
