财务管理

技能文档

---
name: finance-manager
title: 财务管理
category: 办公效率
description: 个人财务管理与分析工具，支持交易数据提取、支出分析、预算可视化报告生成及个性化理财建议。当用户需要分析消费记录、追踪预算、可视化财务数据、从 PDF 提取交易、计算储蓄率、识别消费趋势、生成财务报告或获取理财建议时触发。触发词：财务分析、消费追踪、预算报告、理财建议、支出分析、账单管理。
---

# 财务管理

个人财务管理综合工具包，处理交易数据、执行财务分析、生成可操作洞察与可视化报告。

## 核心能力

1. **交易数据处理**：从 PDF、CSV 或 JSON 文件提取财务数据
2. **财务分析**：计算关键指标、识别消费模式、追踪储蓄情况
3. **可视化报告**：生成交互式 HTML 报告，含图表与数据看板
4. **预算建议**：基于消费模式提供个性化、可执行的理财建议
5. **趋势分析**：识别消费规律、异常支出与优化空间

## 技能工作流

### 步骤1：数据提取与准备

**PDF 文件：**
```bash
python scripts/extract_pdf_data.py <input.pdf> <output.csv>
```

**CSV/JSON 文件：**
- 确保数据包含以下列：`Date`、`Description`、`Income`（分类）、`Type`、`Amount`
- 日期格式：YYYY-MM-DD 或可解析的日期字符串
- 金额：收入为正数，支出为负数

### 步骤2：财务分析

对交易数据执行综合分析：
```bash
python scripts/analyze_finances.py <transactions.csv> > analysis_output.json
```

**输出内容：**
- 汇总统计（总收入、总支出、净储蓄、储蓄率）
- 消费趋势（日均支出、最大支出 Top5、分类占比）
- 预算建议（基于消费模式的个性化建议）
- 可视化数据（为图表渲染准备的数据结构）

### 步骤3：报告生成

创建带可视化的交互式 HTML 报告：
```bash
python scripts/generate_report.py <analysis_output.json> <report.html>
```

**报告功能：**
- 关键指标汇总看板
- 分类支出交互式饼图
- 收入与支出对比柱状图
- 颜色标识（绿色表示正向、红色表示负向）
- 个性化建议板块
- 响应式设计，适配各类设备

### 步骤4：完整工作流示例

```bash
# 从 PDF 提取数据
python scripts/extract_pdf_data.py finance_data.pdf transactions.csv

# 分析数据
python scripts/analyze_finances.py transactions.csv > analysis.json

# 生成可视化报告
python scripts/generate_report.py analysis.json financial_report.html
```

## 关键指标与基准

### 储蓄率
```
储蓄率 = (总收入 - 总支出) / 总收入 × 100
```

**基准线：**
- 低于 10%：需要改善
- 10-20%：良好
- 20-30%：优秀
- 30% 以上：卓越

### 分类支出指引（占收入比例）
- 住房：25-30%
- 交通：10-15%
- 餐饮：10-15%
- 水电杂费：5-10%
- 储蓄：最低 20%

详细框架与方法论参见 `references/financial_frameworks.md`。

## 分析功能详情

### 汇总统计
- 当期总收入与总支出
- 净储蓄（可为正或负）
- 储蓄率百分比
- 交易笔数
- 覆盖日期范围

### 消费趋势
- 日均支出
- 最大 5 笔支出明细
- 分类占比分布
- 消费时间趋势

### 预算建议

系统基于以下维度生成个性化建议：
- 储蓄率阈值
- 分类支出占比
- 收入多元化
- 预算基准对比

**建议示例：**
- "⚠️ 储蓄率低于 10%，建议减少非必要消费支出。"
- "🍽️ 餐饮支出占总支出 18%，可考虑规划膳食以降低成本。"
- "✅ 储蓄率优秀！财务状况健康，继续保持。"

## 可视化组件

### 分类支出图（环形图）
按分类展示支出占比，配合颜色编码。

### 收入与支出对比图（柱状图）
按月展示收入与支出对比，识别现金流趋势。

### 交互功能
- 悬停提示显示精确数值
- 响应式布局适配屏幕尺寸
- 正向（绿色）与负向（红色）颜色标识

## 使用建议

### 数据质量
- 确保所有交易已正确分类
- 使用一致的分类名称
- 包含完整的日期信息
- 核实金额正负号（收入为正、支出为负）

### 分析频率
- 每月运行一次分析以追踪趋势
- 月末生成报告进行回顾
- 逐月对比识别变化

### 落实建议
- 按潜在影响排定建议优先级
- 基于洞察设定具体、可衡量的目标
- 定期重新运行分析追踪进展

## 依赖项

所有脚本需要 Python 3.7+ 及标准库。额外依赖：

**PDF 提取：**
```bash
pip install pdfplumber --break-system-packages
```

**数据分析：**
```bash
pip install pandas --break-system-packages
```

HTML 报告中的可视化依赖通过 CDN 加载（Chart.js），无需本地安装。

## 文件结构

```
finance-manager/
├── scripts/
│   ├── extract_pdf_data.py     # PDF → CSV 转换
│   ├── analyze_finances.py     # 财务分析引擎
│   └── generate_report.py      # HTML 报告生成器
└── references/
    └── financial_frameworks.md # 详细分析方法论
```

## 自定义

### 添加自定义分类
编辑 `analyze_finances.py` 中的分类定义以匹配你的记账体系。

### 调整阈值
修改 `generate_budget_recommendations()` 函数中的建议阈值以匹配个人目标。

### 自定义报告样式
修改 `generate_report.py` 中的 HTML_TEMPLATE 调整颜色、字体或布局。

## 常见使用场景

**月度回顾：**
"分析我 10 月的消费并生成报告"

**预算优化：**
"我在哪些方面花钱太多了？"

**趋势分析：**
"这个月和上个月相比消费有什么变化？"

**目标设定：**
"我的储蓄率是多少？如何提高？"

**分类洞察：**
"按交易明细拆分我的餐饮支出"

**PDF 处理：**
"从银行对账单 PDF 中提取所有交易记录"

## 参考资料

完整的财务框架、预算指南与分析方法论：
```bash
view references/financial_frameworks.md
```

包含内容：
- 50/30/20 预算法则
- 分类支出基准
- 财务健康指标
- 分析工作流详情
- 可视化最佳实践
- 建议生成逻辑

使用说明

# 财务管理

个人财务管理与分析工具，从交易数据中提取洞察、生成可视化报告并给出理财建议。

## 使用

```bash
# 1. 从 PDF 提取交易数据
python scripts/extract_pdf_data.py bank_statement.pdf transactions.csv

# 2. 执行财务分析
python scripts/analyze_finances.py transactions.csv > analysis.json

# 3. 生成可视化报告
python scripts/generate_report.py analysis.json report.html
```

## 工作原理

1. **数据提取**：从 PDF/CSV/JSON 读取交易记录，统一为标准格式
2. **财务分析**：计算储蓄率、分类占比、消费趋势等关键指标
3. **报告生成**：输出交互式 HTML 报告，含饼图、柱状图与个性化建议

## 依赖

```bash
pip install pdfplumber pandas --break-system-packages
```

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。