花开福来 使用指南
花开福来的核心工作流非常简单：从各 APP 看数据 → 整理进标准 Excel → 导入生成当天快照。低维护成本是产品的核心设计。
一、快速上手
- 微信搜索小程序「花开福来」并打开，无需注册登录。
- 首次打开看板为空，两种开始方式任选：
- 「我的 → 设置 → 加载演示数据」体验完整功能（数据为虚构，可随时一键清空）；
- 或使用 Excel 模板 填入自己的真实数据后导入（推荐，见下节）。
- 导入流程：选择文件（支持从微信聊天中选择）→ 解析校验 → 预览 → 确认写入 → 看板立即刷新。
二、Excel 模板：五个 Sheet
模板包含五张表，中英文表名均可识别：
| Sheet | 内容 | 关键列 |
|---|---|---|
账户 Accounts |
账户主数据 | account_id、account_name、institution、account_type、default_currency、include_in_financial_assets … |
资产 Assets |
资产 / 产品主数据（三维分类在此） | asset_id、asset_name、asset_code、product_type、asset_class、market、strategy_tags … |
持仓 Holdings |
账户 × 资产的持有关系 | holding_id、account_id、asset_id、holding_type … |
快照 Snapshots |
金额唯一真相，日常只维护四列 | snapshot_date、holding_id、market_value、currency（其余列可空） |
负债 Liabilities |
负债（独立口径） | liability_id、name、balance、monthly_payment … |
- 枚举值中英文均可，例如资产类别「现金 / 固收 / 权益 / 黄金 / 另类 / 其他 / 受限」、账户类型「银行 / 券商 / 第三方 / 公积金」会自动映射。
- 日期支持
2026-08-15、2026/8/15、2026年8月15日与 Excel 日期单元格。 - 支持币种：人民币 CNY、美元 USD、港币 HKD、欧元 EUR、日元 JPY、英镑 GBP；分析统一折算为人民币。
三、推荐的日常工作流
以「备份与导出」生成的完整 Excel 为底稿，每天只在「快照」表追加新行（日期 + 持仓ID + 市值 + 币种），然后导入。导入会生成当天的新快照，历史数据不受影响。
# 快照表 · 每天新增的行只需要这些
snapshot_date holding_id market_value currency
2026-08-30 H001 128,600.00 CNY
2026-08-30 H002 3,510.25 USD
…
ID 与更新语义（upsert）
- ID 一致 = 同一对象：账户 / 资产 / 持仓按 ID 更新合并，同 ID 重复导入只更新不新建；ID 留空自动生成；持仓不写 ID 时按「账户 + 资产」自动匹配。
- 稀疏行语义（增量更新）：空白字段不覆盖已有数据，只更新显式填写的列。例外：快照的人民币市值留空会清除旧值，避免旧值压过新的原币金额。
重复快照怎么办
同一持仓同一日期存在两条快照时，导入确认界面会让你选择：覆盖 以新数据为准，或 跳过 保留本地已有。同一文件内重复则保留最后一条并提示。
四、校验与报错
校验错误会精确到 Sheet + 行号 + 字段 + 原因（首条数据行 = 第 2 行）。错误必须清零才能导入；警告会展示但不阻断。
- 常见错误：必填列缺失、资产类别非法、市值 / 余额非数字、日期无法解析、引用了不存在的账户 / 资产。
- 常见警告：未知枚举按默认处理、缺汇率按兜底折算、重复快照、日期晚于今天、明细与汇总并存。
五、备份与换机迁移
「我的 → 备份与导出」提供四种格式：Excel 完整备份（可再次导入，零丢失）、CSV、JSON、AI 数据包（当前快照 + 历史摘要 + 分类结果，交给外部 AI 分析用）。
换机：旧手机导出「Excel 完整备份」→ 发送到新手机微信 → 导入，即完整恢复。
想把数据交给 AI 整理或分析？两款官方开源技能见 AI 技能页。