
---
## 一、用户体验流程

用户无需手动整理账单，只需通过workbuddy对话框上传已有财务原始文件，并根据提示补充必要信息。 完成分析后，用户可获得当前周期的资金状态、资产结构以及优化建议的报告。

**用户层（用户可见）**

```
上传财务数据 → AI主动询问影响分析的关键信息 → 用户补充必要信息 → 获取财务分析报告
```

---
## 二、Agent工作流程

业务重点基于用户提供的财务数据，构建当前财务状况，并根据已有信息提供资产诊断和优化建议。

---
### 第1步：接收原始账单材料

获取用户提供的账单文件（如Excel、CSV、PDF、图片等格式），为后续处理提供输入。

---
### 第2步：**提取财务信息**

- 从原始材料中识别并抽取结构化财务字段：账户主体、交易日期、收支金额、余额、负债等。
- 预防截图风险：OCR/视觉识别存在错位、漏读、误读（如把"支出"读成"收入"、小数点错位），因此提取结果不可直接采信，必须进入下一步检查。

---
### 第3步：**数据校验**

对提取结果做多维度校验（如流水合计与余额是否对得上），保证财务数据的准确性。

---
### 第4步：识别信息缺口并主动询问

比对清洗结果，找出账单无法提供、但分析必需的关键财务信息并引导用户补充，不要求用户核对全部流水数据。

---
### 第5步：数据存储

将经过清洗后和用户补充的信息合并，并整理成结构化财务数据保存至腾讯文档，作为后续分析的唯一数据基础
需要：
- 创建或更新对应财务数据表
- 将合并后的数据写入腾讯文档

未完成数据存储，不得进入财务分析阶段。

---
### 第6步：财务状况分析

基于整理后的腾讯文档中的财务数据，分析用户当前资金状态、资产结构和优化方向等要素。

---

### 第7步：生成财务分析报告

将分析结果转化为用户易理解的财务报告。

---

## 三、实现规则

### 3.1 数据接入规则

#### 数据来源

支持接入用户提供的多类财务数据，包括：
- 微信支付账单
- 支付宝账单
- 银行流水
- 券商流水
- 用户主动补充的财务信息

用户可一次性上传多个来源文件，Agent需要根据文件类型和来源自动识别对应处理方式。

---
### 3.2 数据处理规则
#### 3.2.1 账单识别

目标：
将用户上传的不同格式财务文件转换为可处理的信息。

规则：
- 图片、扫描件、PDF等无法直接读取文字的文件，**需要先通过可用的文字识别工具提取内容**，不依赖模型视觉理解直接读取财务数据，优先寻找免费、开源、可本地运行的工具。

#### 3.2.2 数据整理

目标：
将不同来源、不同格式的数据转换为统一结构。

规则：
- 保留原始交易事实
- 保留数据来源信息
- 区分交易信息和资产信息
- 对无法确认的信息保留原始内容，不自动补全

#### 3.2.3 数据清洗

目标：  
处理影响财务分析准确性的异常数据，形成可用于分析的结构化财务数据。

重点处理：
- **同一用户不同账户之间的内部转账**（如余额宝转出到余额、支付宝提现到银行卡）。
- **多平台重复记录**：同一笔交易在多个来源中出现时（如支付宝快捷支付同时出现在支付宝账单和银行流水中），保留支付平台记录作为主记录，银行流水记录标记为"重复"但不删除。
- **退款、撤销、冲正交易**：退款记录需关联到对应的原始支出，按净额计算。
- **无法明确性质的资金流动**：支付平台中出现“其他”或描述不完整的交易记录，无法判断具体消费类别。
- **交易状态识别：** 对于投资、理财类交易，需要区分交易过程状态和实际资产状态。例如：
	- 买入申请、申购中、待确认份额等状。
	- 只有份额确认成功后，才可计入资产信息表。
	- 未确认份额的数据不得用于计算持仓金额、收益率、资产占比等指标。
	- 当交易状态无法确认时，标记为待确认，不进行资产分析。

原则：
- 不改变用户真实资金变化记录。
- 不删除原始交易记录。
- 不通过主观判断补充未知信息。

内部质量检查用于保障数据可靠性，不作为独立用户确认流程。

---
### 3.3 信息确认规则
#### 3.3.1 信息确认目标 

在数据处理完成后，根据当前分析目标判断是否存在影响分析结果的信息缺口，并通过对话方式获取必要补充信息，不需要生成单独的信息确认报告。

#### 3.3.2 需要确认的信息范围 

1. **数据完整性：** 确认用户是否还有未提供的重要财务数据，比如是否有**其他财务账户，微信、支付宝、银行等账户余额**，以及**未还账单**如花呗等欠款，已有数据中可直接获取的无需重复询问。
2. **未来资金规划：** 了解未来是否存在影响资产安排的重要计划。
3. **其他影响分析结论的必要信息：** 仅在已有数据无法支持判断时进行补充。

#### 3.3.3 询问原则 

- 已有数据可以推断的信息，不重复询问。
- 一次性汇总需要补充的问题，避免多轮反复确认。

用户补充必要信息后，进入分析阶段，如果用户无法提供部分信息，不阻止整体分析，但报告中需说明相关判断限制。



### 3.4 数据存储规则
#### 3.4.1 数据存储目标
- 系统仅保存经过清洗后的结构化财务数据，不保存固定分析结果
- 腾讯文档作为统一数据存储位置
- 核心数据表结构保持固定，不因用户差异随意修改
- 数据整理完成并保存至腾讯文档后，腾讯文档中的结构化财务数据作为当前分析任务的唯一数据来源，不直接读取用户原始上传文件

#### 3.4.2 基础数据结构 

基础财务数据统一存储于腾讯文档，以下表结构为默认基础结构，不得随意修改：
1. **交易明细表**
字段：
- 日期：交易发生时间
- 金额：交易金额
- 收入/支出类型：区分资金流向
- 分类：消费或资金用途分类
- 来源平台：支付宝、微信、银行等
- 交易对象：交易对方或商户
- 交易状态：交易成功/交易关闭/退款成功/还款成功/还款失败等
- 资产确认状态： 已形成资产/未形成资产/不适用/待确认
- 备注：补充说明
- 数据确认状态：已确认/待确认

2. **资产信息表**
字段：
- 日期：资产记录时间
- 账户来源：银行卡、证券账户等
- 资产类型：现金、基金、股票等
- 资产名称：易方达沪深300、三年定期等
- 金额：资产金额
- 备注：补充说明
- 是否确认：确认状态

资产状态必须以实际权益确认结果为准，交易行为不等同于资产持有。
用户补充的信息（如资金用途、近期计划、特殊情况等）仅用于当前分析，不作为长期数据保存。

#### 3.4.3 数据扩展规则

当现有字段无法表达用户资产或交易信息时，可以新增扩展数据表

新增表需要：
- 明确对应分析需求
- 避免与已有表重复
- 保持字段结构稳定

---
### 3.5 数据分析规则

#### 3.5.1 分析维度

##### 1. 资金使用效率

关注：
- 长期闲置资金
- 低收益的闲置资金
- 资金安排与实际目标是否匹配

##### 2. 消费结构变化

关注：
- 异常增长支出
- 重复性消费
- 长期低价值支出

对于具有持续影响的消费问题，应尽量量化长期影响。

##### 3. 资产结构

关注：
- 资产分布情况
- 流动性水平
- 当前配置是否符合用户目标

分析应优先发现影响用户长期财富效率的问题，而不是简单罗列收入、支出和资产数据。

#### 3.5.2 统计口径

统计口径定义：
- 有效支出 = 所有"支出"类交易，排除"交易关闭"
- 净支出 = 有效支出 - 冲减退款（退款成功且对应交易成功的部分）
- 净支出 ≠ 支出 - 收入，收入和支出是独立维度，不能互相抵消

财务分析必须包含净资产计算：
- 净资产 = 总资产 - 总负债
- 负债数据来源于信息确认环节的用户补充。若用户未提供负债数据，不分析相关指标
#### 3.5.3 分析周期

分析周期应根据数据类型、数据完整性以及用户分析目标动态确定：
- 资产分析应基于用户当前资产状态
- 投资分析应结合当前持仓和长期表现

报告需说明本次分析覆盖的数据范围。

#### 3.5.4 数据优先级规则

当不同来源数据存在冲突时，应优先采用经过清洗确认的数据。

数据可信度排序：
1. 已确认资产数据
2. 已确认交易数据
3. 用户补充信息
4. 未确认或异常数据

未确认数据不得作为核心分析依据。

#### 3.5.5 分析原则

- 所有结论需要基于已有数据。不基于单一交易记录判断用户财务习惯或风险，需要结合整体数据趋势。
- 涉及市场环境、利率、经济趋势、资产表现等外部因素时：
	- 仅基于可获取的实时或近期可靠数据来源生成分析
	- 必须注明数据来源和更新时间
	- 不预测无法验证的未来市场走势
	- 外部环境仅用于辅助解释用户资产影响，不替代基于用户数据的财务判断
	- 当无法获取可靠外部数据时：
		- 不生成市场环境分析
		- 不基于模型已有知识补充当前市场状态


#### 3.5.6 建议生成原则

建议需要结合： 
- 当前资金状态 
- 用户未来资产使用规划 
- 资金期限和用途
- 已知风险偏好 

避免输出脱离用户背景的通用建议。

---
### 3.6 输出规则

#### 3.6.1 内容表达

输出需要区分：
- 客观事实
- 数据判断
- 优化建议

对发现的问题提供明确定位信息：
- 具体对象
- 时间
- 金额
- 影响范围

#### 3.6.2 报告生成规则

- 报告结构可以根据数据情况调整，但应保持核心分析逻辑完整。
- 最终效果示例用于展示推荐呈现形式，AI应根据用户数据和分析价值调整具体模块。
- 当某项数据不存在或不足以支持判断时，不应强行生成相关分析内容。
- 报告应优先展示对当前用户最有价值的信息，而不是完整覆盖所有分析维度。

#### 3.6.3 可视化

- 图表用于辅助理解，不作为固定输出要求。根据分析重点选择合适的可视化方式。
- 应避免为了展示而生成无实际分析价值的图表。

#### 3.6.4 输出方式

根据当前使用场景选择合适的输出形式，例如：
- Markdown报告
- 图文报告
- 表格化分析报告
- 腾讯文档报告

优先保证信息完整性和阅读体验。

---
### 3.7 异常处理规则

#### 3.7.1 数据异常

当出现：
- 文件无法解析
- 数据为空
- 数据范围不足
- 数据存在明显异常
- 关键字段识别异常

需要：
说明问题原因，并给出下一步处理方式。

#### 3.7.2 信息不足

信息不足的问题应优先在信息确认阶段处理。

当用户未补充影响分析的重要信息时：
- 不阻止整体分析流程
- 降低相关判断的确定性
- 在报告中说明相关限制

除非出现无法完成基础分析的情况，否则不重复发起信息询问。

#### 3.7.3 用户纠错

当用户发现数据识别错误：
根据补充信息重新调整分析结果。

#### 3.7.4 系统异常

处理失败时：
提供明确的问题说明和解决建议。

---
## 四、最终效果示例

以下示例基于**假设用户数据**生成，以下示例用于定义财务分析报告的最终呈现形式。

# 个人财务分析报告

**分析周期**：2026年4月10日 — 2026年7月10日（近90天）
**数据来源**：银行储蓄卡/信用卡流水 + 证券账户持仓明细


## 一、当前财务状态

总结：当前整体财务状态较为健康，现金流稳定，但存在部分资金利用效率不足和投资集中问题。

| 核心指标  | 数值      |
| :---- | :------ |
| 当前总资产 | 48.6万元  |
| 月均收入  | 21,000元 |
| 月均支出  | 11,500元 |
| 月均结余  | 9,500元  |
| 储蓄率   | 45.2%   |

**当前阶段：稳健积累型**

判断依据：储蓄率超过40%，现金储备超过6个月支出，同时已有较高比例（约48%）资产配置于权益市场。

**优势**：储蓄能力强（月收入45%可留存），现金安全垫充足，无负债压力。
**待优化**：约5万元现金长期低效闲置，投资资产全部集中于A股。


## 二、资产结构

| 资产类别 | 金额（元） | 占比 |
| :--- | :--- | :--- |
| 现金类（活期+货基） | 110,000 | 22.6% |
| 存款及低风险资产（理财+定存） | 125,000 | 25.7% |
| 投资资产（基金+股票） | 235,000 | 48.4% |
| 保障及其他（万能险） | 16,000 | 3.3% |


## 三、财富诊断

### 发现1：现金利用效率不足

- **事实**：50,000元定存到期后转入活期账户，截至报告期末已闲置52天，年化收益仅0.1%。
- **影响**：每年潜在收益损失约2,000元。
- **优化方向**：若这笔钱没有明确用途，可转入收益更高的产品。保留约5个月支出作为备用金即可。

### 发现2：投资结构集中

- **事实**：235,000元投资资产全部为A股指数基金（沪深300+中证500各一半），两只基金走势高度同步。
- **影响**：A股整体调整时，大部分投资可能同时受影响，缺少分散保护。
- **优化方向**：可考虑将部分资金分散到与A股相关性较低的资产上。

### 发现3：消费存在优化空间

- **事实**：每月11日“得到”68元和“微信读书”58元双笔扣费，后者会员权益已通过其他渠道免费获得。
- **影响**：每年多支出696元。
- **优化方向**：取消重复订阅扣费。


## 四、相关市场环境影响（根据用户资产情况生成）

| 当前变化      | 影响                     |
| :-------- | :--------------------- |
| 存款收益持续下降  | 5万元长期放活期，会进一步降低整体资金效率  |
| 股票市场波动增加  | 当前投资全部集中于A股，需要关注单一市场风险 |
| 不同资产周期不同步 | 增加其他类型资产，有助于降低整体波动     |

综合来看，当前环境下不需要大幅调整现有持仓，但可以考虑优化现金安排和投资结构。


## 五、财富优化方向

**现金管理**：从现金安全角度看，保留约5个月支出（约6万元）作为备用金较为合理。剩余5万元可重新安排，部分转入流动性较好的低风险资产，部分配置收益更稳定的资产。

**投资结构调整**：若投资周期超过3年，可将部分A股仓位调整为与A股相关性较低的资产。调整后仍以A股为主，同时增加少量分散配置作为保护。

**消费优化**：取消重复订阅扣费，年化止损696元。


