常见问题

安装与启动

没有数据库能启动吗？

可以。系统支持启动后再配置数据库：未配置时前端会引导进入「初始化数据库」页面，选择 SQLite（零配置）或 MySQL 并保存后即可使用。

前端打包后刷新子路由 404？

使用 bootJar 打包的一体化 jar 已内置 SPA 路由回退：访问 /dashboard 等子路径会由后端回退到 index.html。若自行用 Nginx 托管前端产物，需配置 history 模式回退。

账单导入

支持哪些账单？

支付宝、微信、美团、招商银行、交通银行，详见账单类型与获取。

导入后重复了怎么办？

系统按「用户 + 交易号」去重，重复导入同一账单时已存在的记录会被跳过。若已产生重复，可在收支记录中勾选后批量删除。

提示需要解压密码？

部分平台（如美团、部分银行）导出的账单压缩包设有密码。请到导出时的「申请记录」或相应页面查看密码，在解析弹窗中输入。

为什么有些行不能导入？

常见原因：金额或时间字段无法解析、该交易号已存在、或银行 PDF 的余额连续性校验未通过。预览页会显示具体状态。

银行账单没有交易号，会重复吗？

不会。银行流水会以「日期 + 类型 + 金额 + 余额」生成稳定去重键；招商银行 CSV 与 PDF 生成规则一致，可混用。

统计与记录

借款、转账会计入统计吗？

默认计入。建议在记录或导入时将「计入统计」关闭，这类记录会从统计中排除，但仍保留在列表中。

多来源账单如何避免重复统计？

同一笔消费可能同时出现在多个账单中（例如通过微信付款、实际由招商银行卡扣款），若都计入统计会重复。推荐按来源设置「计入统计」：

• 微信、支付宝来源：默认计入（除非有特殊情况）。
• 其他来源（银行、美团等）：默认不计入——这些渠道的扣款往往最终走微信/支付宝支付。
• 例外：工资、奖金等明确收入应计入。

可在账单导入预览页用「设为计入 / 设为不计入」批量设置，或在收支记录中逐条切换。

想让备注不显示在界面上？

可在记录行使用「隐藏」功能，备注会显示为 ******，需要时再「查看」或「取消隐藏」。

分类和标签有什么区别？

分类用于区分收支用途（餐饮、交通、工资），是统计的主要维度；标签用于附加自定义维度（报销、旅行、大额消费），一笔记录可有多个标签。

AI 与通知

AI 功能不可用？

请先在「系统设置 → AI 模型配置」中开启并填写 API Key，然后点「测试连接」验证。

邮箱账单会自动入库吗？

不会。邮箱账单拉取后进入「待处理账单」，需要手动解析、预览并确认后才写入账本。

账单类型识别用 AI 吗？

不使用。邮箱账单的类型由发件人规则确定，结果确定、可预期；识别不出的可在解析时手动选择类型。

到点没有收到提醒？

检查：提醒是否启用、是否配置了启用的渠道、提醒时间是否为 HH:mm 格式。可先点「立即发送」验证渠道配置，并查看发送日志。

账号与数据

忘记密码怎么办？

当前版本未提供自助找回。可在数据库中重置对应用户的密码哈希，或新建账号后迁移数据。

数据存在哪里？

• SQLite：默认位于服务运行目录的 data/ 下，配置文件为 config/database.json。
• MySQL：位于所配置的数据库中。

切换数据库会迁移数据吗？

不会。切换后原数据库数据保留，需要自行迁移。

支持哪些界面语言？

简体中文、English、日本語，可在登录页或主界面顶部切换。