Wealthfolio项目CSV导入格式规范解析

在金融资产管理工具Wealthfolio中，正确导入交易记录数据需要遵循特定的CSV格式规范。本文将从技术角度详细解析该格式要求，帮助开发者正确配置数据导入文件。

CSV格式核心要求

Wealthfolio要求导入的CSV文件必须包含7个关键字段，且字段名称必须严格使用小写形式：

1. date - 交易日期
2. symbol - 资产代码/标识符
3. quantity - 交易数量
4. activityType - 交易类型
5. unitPrice - 单位价格
6. currency - 货币类型
7. fee - 交易费用

常见格式问题

许多用户在首次导入时会遇到字段大小写不匹配的问题。虽然文档中有时提到"Date"等首字母大写的字段名，但实际系统仅识别全小写的字段名称。这种设计选择可能是为了保持与后端数据处理系统的一致性。

交易类型说明

activityType字段支持多种交易活动类型，包括但不限于：

• 买入(BUY)
• 卖出(SELL)
• 存款(DEPOSIT)
• 取款(WITHDRAWAL)
• 转入(TRANSFER_IN)
• 转出(TRANSFER_OUT)

不同类型的交易会影响资产组合的计算逻辑。例如，存款和取款会直接影响现金余额，而转入转出则涉及资产在不同账户间的移动。

最佳实践建议

1. 字段顺序：虽然字段顺序理论上不影响导入，但建议按照文档示例的顺序排列，便于检查和维护
2. 日期格式：使用ISO 8601标准格式(YYYY-MM-DD)可确保最佳兼容性
3. 空值处理：对于没有费用的交易，fee字段应填0而非留空
4. 字符编码：推荐使用UTF-8编码保存CSV文件，避免特殊字符问题

用户体验改进

最新版本(v1.0.11)已优化了导入界面的用户体验，现在文档说明会持续显示，即使用户切换到其他应用程序修改CSV文件。这一改进显著提升了数据准备和导入的工作效率。

通过遵循这些规范，用户可以确保交易数据能够被Wealthfolio正确解析和处理，从而获得准确的资产组合分析和可视化结果。