fund-report-processor

# 资金日报处理器技能 v3.1 - 精简架构版

## 🎯 功能概述

这个技能提供完整的资金日报自动化处理流程，现已实现：
- 🔐 **零交互操作** - 完全自动化凭据管理
- 🚀 **一键运行** - 单个命令完成所有操作  
- 🛡️ **安全集成** - Bitwarden 密码管理
- ⚡ **智能缓存** - 会话复用，提升效率
- 🧹 **精简架构** - v3.1版本清理冗余脚本，专注核心功能

## 🛠️ 核心功能

1. **🚀 零交互处理** (`zero_interaction_runner.py`): 一键完成所有操作
2. **🔐 智能凭据管理** (`fully_automated_bitwarden.py`): 自动从 Bitwarden 获取凭据
3. **📧 邮件收取** (`automated_fund_report_processor_enhanced.py`): 自动连接邮箱下载附件
4. **📊 数据提取** (`extract_enhanced_data.py`): 从XLSX提取50+字段财务数据
5. **📋 总结生成** (`generate_user_format.py`): 严格按用户格式生成报告
6. **📈 图表展示** (`plot_daily_balance.py`): 生成每日结余趋势图表
7. **📦 批量处理** (`batch_process_fund_reports.py`): 支持历史数据批量处理

## 🎯 使用场景

- **🤖 完全自动化**: 定时任务无人值守处理资金日报
- **⚡ 即时处理**: 一键获取最新资金日报分析
- **📊 历史分析**: 批量初始化和分析历史数据
- **📈 趋势监控**: 自动生成和发送资金趋势图表
- **🔒 安全管理**: 集中化凭据管理，避免硬编码密码

## 关键数据字段

- **昨日结余**: 前一日的资金余额
- **本日结余**: 当日的资金余额  
- **资金流入合计**: 当日总资金流入金额
- **资金流出合计**: 当日总资金流出金额
- **投资理财**: 理财账户金额和占比
- **USDT资产**: 泰达币数字货币资产
- **交易明细**: 前5大交易对手方和金额

## 配置要求

### 邮箱配置
需要在脚本中配置以下邮箱参数：
- `EMAIL`: 邮箱地址 (例如: your_email@example.com)
## 🚀 快速开始

### 零交互模式 (推荐)
```bash
# 一键运行 - 完全自动化，无需任何用户输入
python3 zero_interaction_runner.py
```

### Bitwarden 凭据管理
```bash
# 仅加载凭据到环境变量
python3 fully_automated_bitwarden.py

# 然后运行主处理脚本
python3 automated_fund_report_processor_enhanced.py
```

### 传统模式 (手动配置)
```bash
# 设置环境变量
export FUND_EMAIL="your_email@example.com"
export FUND_PASSWORD="your_password"

# 运行主处理脚本
python3 automated_fund_report_processor_enhanced.py
``...

# 资金日报处理器

自动化处理资金日报邮件和数据提取的工具集。从邮箱收取资金日报邮件，下载XLSX附件，提取关键财务数据（昨日结余、本日结余、资金流入合计、资金流出合计），并保存为CSV格式。支持单次处理、批量历史数据处理和可视化图表生成。

## ✨ 更新记录

### v2.0 - 增强版 (2026-02-21)
- 🆕 **完全自动化处理** - `automated_fund_report_processor_enhanced.py`
- 🔄 **自动去重合并** - 智能处理重复数据
- 📧 **批量邮件下载** - `download_all_fund_reports.py`
- 📊 **批量数据处理** - `batch_process_fund_reports.py`
- 📈 **完整历史数据支持** - 支持处理23天历史数据
- 🎯 **智能数据清理** - 自动去重和数据验证

### v3.1 - 精简架构版 (2026-02-23)
- 🧹 **代码精简** - 移除冗余脚本，优化架构
- 📊 **图表展示优化** - 使用内置工具直接展示图表
- 🔄 **统一凭据管理** - 仅保留完全自动化版本
- ⚡ **性能提升** - 减少依赖，提高执行效率

## 🛠️ 使用方法

### 🚀 快速开始 (推荐 - 零交互)
```bash
# 一键运行 - 完全自动化，无需任何用户输入
python3 zero_interaction_runner.py
```
**说明**: 自动从 Bitwarden 获取凭据，下载最新资金日报，提取数据，无需任何手动操作。

### 🔐 Bitwarden 自动化
```bash
# 仅加载凭据到环境变量
python3 fully_automated_bitwarden.py

# 然后运行任何需要凭据的脚本
python3 automated_fund_report_processor_enhanced.py
```

### ⚙️ 传统方式 (手动配置)
```bash
# 设置环境变量
export FUND_EMAIL="your_email@example.com"
export FUND_PASSWORD="your_password"

# 完全自动化处理
python3 automated_fund_report_processor_enhanced.py
```

## 📋 核心功能

### 1. 数据处理流水线
```bash
# 数据提取
python3 extract_enhanced_data.py input.xlsx

# 格式生成
python3 generate_user_format.py data.csv

# 图表生成
python3 plot_daily_balance.py fund_key_data_clean_history.csv
```

### 2. 批量历史数据
```bash
# 下载所有历史邮件
python3 download_all_fund_reports.py

# 批量处理文件
python3 batch_process_fund_reports.py fund_attachments/

# 生成趋势图表
python3 plot_daily_balance.py fund_key_data_clean_history.csv
```

### 3. 完全自动化流程
```bash
# 完全自动化凭据管理
python3 fully_automated_bitwarden.py

# 一键运行器 (推荐)...