Actual Budget 中 QFX 文件导入金额处理异常问题分析

问题现象

在 Actual Budget 项目中，用户报告了一个关于 QFX 文件导入的异常现象：当导入信用卡公司的 QFX 文件时，系统将所有交易金额（无论正负）都合并显示在"Amount"列中。这导致信用卡消费（应为负值）被错误地识别为存款（正值），从而影响了账户余额的正确计算。

技术背景

QFX 是一种金融数据交换格式，基于 OFX(Open Financial Exchange)标准。在 QFX 文件中，交易通常通过以下方式标识：

• TRNTYPE 标签：标识交易类型（DEBIT 或 CREDIT）
• TRNAMT 标签：包含交易金额（负值表示支出，正值表示收入）

问题根源分析

经过深入调查，发现问题并非直接源于 QFX 文件解析本身，而是与系统处理 CSV 导入的历史设置有关。具体表现为：

1. 当用户先使用 CSV 导入并启用了"in/out identifier"（收支标识符）功能后
2. 再尝试导入 QFX 文件时，系统会错误地沿用之前的 CSV 导入设置
3. 导致 QFX 文件中的正负金额信息被忽略，所有交易都被视为收入

解决方案

修复该问题的核心思路是：

1. 在文件导入处理逻辑中，明确区分不同文件类型的处理方式
2. 对于 OFX/QFX 文件，应忽略 CSV 特有的"inOutMode"设置
3. 直接从 QFX 文件的 TRNTYPE 和 TRNAMT 标签中读取交易方向和金额

技术实现细节

在 ofx2json.ts 文件中，系统已经实现了将 SGML 格式的 OFX 数据转换为 XML 的功能。正确的处理流程应包括：

1. 解析 QFX 文件头信息，确定文件版本（102 为 SGML 格式，202 为 XML 格式）
2. 对于 SGML 格式，先转换为 XML
3. 提取每笔交易的 TRNTYPE 和 TRNAMT 信息
4. 根据交易类型和金额符号，正确分类为收入或支出

用户应对建议

遇到此问题的用户可以采取以下临时解决方案：

1. 对于受影响的账户，避免混合使用 CSV 和 QFX 导入
2. 如需使用 QFX 导入，可先创建一个新账户进行导入
3. 检查导入预览界面，确保交易金额显示正确后再确认导入

总结

这个问题揭示了金融软件在处理不同文件格式导入时可能出现的边界情况。正确处理各种金融数据格式的细微差别对于保证财务数据的准确性至关重要。Actual Budget 团队已经识别并修复了这一问题，未来版本中将确保 QFX 文件的导入能够正确识别交易方向和金额。