| name | fund-report-processor |
| description | 自动化处理资金日报邮件和数据提取。从邮箱收取资金日报邮件，下载XLSX附件，提取关键财务数据，生成用户指定格式总结并展示趋势图表。🚀v3.1：精简架构版本，Bitwarden集成，完全自动化。⭐标准流程：zero_interaction_runner.py 一键完成所有操作 |
资金日报处理器技能 v3.1 - 精简架构版
🎯 功能概述
这个技能提供完整的资金日报自动化处理流程，现已实现：
- 🔐 零交互操作 - 完全自动化凭据管理
- 🚀 一键运行 - 单个命令完成所有操作
- 🛡️ 安全集成 - Bitwarden 密码管理
- ⚡ 智能缓存 - 会话复用，提升效率
- 🧹 精简架构 - v3.1版本清理冗余脚本，专注核心功能
🛠️ 核心功能
- 🚀 零交互处理 (
zero_interaction_runner.py): 一键完成所有操作
- 🔐 智能凭据管理 (
fully_automated_bitwarden.py): 自动从 Bitwarden 获取凭据
- 📧 邮件收取 (
automated_fund_report_processor_enhanced.py): 自动连接邮箱下载附件
- 📊 数据提取 (
extract_enhanced_data.py): 从XLSX提取50+字段财务数据
- 📋 总结生成 (
generate_user_format.py): 严格按用户格式生成报告
- 📈 图表展示 (
plot_daily_balance.py): 生成每日结余趋势图表
- 📦 批量处理 (
batch_process_fund_reports.py): 支持历史数据批量处理
🎯 使用场景
- 🤖 完全自动化: 定时任务无人值守处理资金日报
- ⚡ 即时处理: 一键获取最新资金日报分析
- 📊 历史分析: 批量初始化和分析历史数据
- 📈 趋势监控: 自动生成和发送资金趋势图表
- 🔒 安全管理: 集中化凭据管理，避免硬编码密码
关键数据字段
- 昨日结余: 前一日的资金余额
- 本日结余: 当日的资金余额
- 资金流入合计: 当日总资金流入金额
- 资金流出合计: 当日总资金流出金额
- 投资理财: 理财账户金额和占比
- USDT资产: 泰达币数字货币资产
- 交易明细: 前5大交易对手方和金额
配置要求
邮箱配置
需要在脚本中配置以下邮箱参数：
🚀 快速开始
零交互模式 (推荐)
python3 zero_interaction_runner.py
Bitwarden 凭据管理
python3 fully_automated_bitwarden.py
python3 automated_fund_report_processor_enhanced.py
传统模式 (手动配置)
export FUND_EMAIL="your_email@example.com"
export FUND_PASSWORD="your_password"
python3 automated_fund_report_processor_enhanced.py
⚙️ 配置方式
🔐 Bitwarden 自动化 (推荐)
系统会自动从 Bitwarden 获取凭据，无需手动配置：
- 自动解锁 Bitwarden vault
- 智能会话管理和缓存
- 跨会话持久化凭据
- 详见
ZERO_INTERACTION_GUIDE.md
📧 手动环境变量 (备选)
export FUND_EMAIL="your_email@example.com"
export FUND_PASSWORD="your_password"
export IMAP_SERVER="imap.exmail.qq.com"
export IMAP_PORT="993"
📋 脚本架构 - v3.1精简版
🚀 一键运行器 (1个)
zero_interaction_runner.py ⭐推荐入口⭐
- 功能: 零交互完全自动化运行器
- 特点: 自动凭据管理 + 完整处理流程 + 图表展示
- 输出: 完整的资金日报分析和图表
🔐 Bitwarden 集成 (1个)
fully_automated_bitwarden.py ⭐核心组件⭐
- 功能: 完全自动化 Bitwarden 凭据管理器
- 特点:
- 使用永久记忆中的主密码自动解锁
- 智能会话文件管理
- 零用户交互凭据获取
- 输出: 自动设置环境变量
FUND_EMAIL、FUND_PASSWORD
📧 数据处理流水线 (4个)
automated_fund_report_processor_enhanced.py ⭐主处理器⭐
- 功能: 增强版自动化处理器，集成 Bitwarden 支持
- 特点:
- 自动尝试从 Bitwarden 加载凭据
- 完整邮件处理和数据提取流程
- 自动去重和历史数据合并
extract_enhanced_data.py ⭐深度分析⭐
- 功能: 增强数据提取器 - 从4字段扩展到50+字段
- 特点:
- 提取13个银行账户详细信息
- 分析交易明细和对手方
- 收支分类统计和外币资产监控
- 投资理财占比分析
- 输出:
fund_enhanced_data.json - 结构化JSON数据
generate_user_format.py ⭐总结生成器⭐
- 功能: 按用户指定格式生成资金日报总结
- 特点:
- emoji标记的重要交易明细
- 核心财务指标、理财占比、USDT资产
- 收入构成分析和趋势总结
- 输出: 格式化总结报告
plot_daily_balance.py
- 功能: 生成每日结余趋势图表
- 输出:
daily_balance_chart.png - 高质量PNG图表
🔄 批量处理工具 (2个)
download_all_fund_reports.py
- 功能: 批量下载历史资金日报邮件
- 输出: XLSX文件保存到
fund_attachments/ 文件夹
batch_process_fund_reports.py
- 功能: 批量处理XLSX文件
- 输出: 历史数据保存到
fund_key_data_history.csv
🛠️ 部署工具 (1个)
install.sh
- 功能: 自动安装所有Python依赖
- 用途: 首次部署时运行
数据文件结构
📁 核心数据文件位置
技能工作目录：/opt/homebrew/lib/node_modules/openclaw/skills/fund-report-processor/
📊 CSV数据文件
fund_key_data_latest.csv - 最新单日数据（每次运行时更新）fund_key_data_clean_history.csv - 完整历史数据（自动去重，推荐使用）fund_key_data_history.csv - 原始历史数据（未去重，批量处理生成）
🚀 增强数据文件
fund_enhanced_data.json - 增强分析数据(50+字段，JSON格式)
📈 图表文件
daily_balance_chart.png - 资金趋势图表（基于历史数据生成）
📁 附件文件夹
fund_attachments/ - XLSX附件存储目录
- 包含所有下载的资金日报Excel文件
- 文件名格式：
资金日报-YYYY.MM.DD_时间戳.xlsx
🔍 快速定位数据
新会话中可以直接访问：
cat /opt/homebrew/lib/node_modules/openclaw/skills/fund-report-processor/fund_key_data_latest.csv
cat /opt/homebrew/lib/node_modules/openclaw/skills/fund-report-processor/fund_key_data_clean_history.csv
cat /opt/homebrew/lib/node_modules/openclaw/skills/fund-report-processor/fund_enhanced_data.json
📊 输出文件
fund_key_data_latest.csv - 最新单日数据fund_key_data_clean_history.csv - 完整历史数据（去重）fund_enhanced_data.json - 增强分析数据（50+字段）daily_balance_chart.png - 资金趋势图表fund_attachments/ - XLSX附件存储目录
📋 依赖库
pandas: 数据处理和CSV操作openpyxl: Excel文件读取matplotlib: 图表生成imaplib: 邮件协议支持
🔗 相关文档
README.md - 项目说明和快速开始ZERO_INTERACTION_GUIDE.md - 完全自动化使用指南CLEANUP_LOG.md - v3.0版本清理记录
📝 关键数据字段
- 昨日结余: 前一日资金余额
- 本日结余: 当日资金余额
- 资金流入合计: 当日总流入金额
- 资金流出合计: 当日总流出金额
- 投资理财: 理财账户金额和占比
- USDT资产: 数字货币资产
- 交易明细: 重要交易对手方和金额
🚀 资金日报处理器 v3.1 - 精简架构版，让财务分析变得轻松简单！
