rosercode
923d6db5c0
对照 ledgerly 自文档上次更新以来的全部改动，补充新功能文档、修正品牌与版本残留，并新增下载与安装页；配图已重新截取并上传 OSS，本地截图目录不纳入版本管理。 变更内容： - 新增「智能查数」「账单关系」两个使用文档页，并登记侧边栏与总览 - 设置页扩充为八个面板（账号安全、数据库实时进度、外观、导航等）并改为即时保存 - 收支记录补充关系列、批量操作、AI 搜索浮窗、可配置分页与「账单详情」弹窗 - 统计面板补充饼图/渠道图下钻与筛选双向联动；规则管理补充批量删除 - AI 能力补充智能查数与关系命名；新增下载与安装页 - 开发文档同步：AI 13 类调用、数据模型 24 张表、API、前端偏好、构建部署 - 统一「汇账 Ledgerly」品牌与「设置/日志」菜单文案，版本号对齐 0.1 - 截图脚本新增账单详情等场景并更新登记 说明： - download.md 的 OSS 下载链接保持待发布产物回填，暂不调整 - 已通过 npm run docs:build 与 npm run typecheck:scripts
4.3 KiB
常见问题
安装与启动
没有数据库能启动吗？
可以。系统支持启动后再配置数据库：未配置时前端会引导进入「初始化数据库」页面，选择 SQLite（零配置）或 MySQL 并保存后即可使用。
前端打包后刷新子路由 404？
使用 bootJar 打包的一体化 jar 已内置 SPA 路由回退：访问 /dashboard 等子路径会由后端回退到 index.html。若自行用 Nginx 托管前端产物，需配置 history 模式回退。
账单导入
支持哪些账单？
支付宝、微信、美团、淘宝、京东、招商银行、交通银行，详见账单类型与获取。
导入后重复了怎么办？
系统按「用户 + 交易号」去重，重复导入同一账单时已存在的记录会被跳过。若已产生重复，可在收支记录中勾选后批量删除。
提示需要解压密码？
部分平台（如美团、部分银行）导出的账单压缩包设有密码。请到导出时的「申请记录」或相应页面查看密码，在解析弹窗中输入。
为什么有些行不能导入？
常见原因：金额或时间字段无法解析、该交易号已存在、或银行 PDF 的余额连续性校验未通过。预览页会显示具体状态。
银行账单没有交易号，会重复吗？
不会。银行流水会以「日期 + 类型 + 金额 + 余额」生成稳定去重键；招商银行 CSV 与 PDF 生成规则一致，可混用。
统计与记录
借款、转账会计入统计吗？
默认计入。建议在记录或导入时将「计入统计」关闭，这类记录会从统计中排除，但仍保留在列表中。
多来源账单如何避免重复统计？
同一笔消费可能同时出现在多个账单中（例如通过微信付款、实际由招商银行卡扣款），若都计入统计会重复。推荐按来源设置「计入统计」：
- 微信、支付宝来源：默认计入（除非有特殊情况）。
- 其他来源（银行、美团、淘宝、京东等）：默认不计入——这些渠道的扣款往往最终走微信/支付宝支付。
- 例外：工资、奖金等明确收入应计入。
可在账单导入预览页用「设为计入 / 设为不计入」批量设置，或在收支记录中逐条切换。
想让备注不显示在界面上？
可在记录行使用「隐藏」功能，备注会显示为 ******，需要时再「查看」或「取消隐藏」。默认这些记录会从收支记录列表与 Excel 导出中排除；如需让其显示，可在「设置 → 外观设置」开启「显示已隐藏备注的记录」。
分类和标签有什么区别？
分类用于区分收支用途（餐饮、交通、工资），是统计的主要维度；标签用于附加自定义维度（报销、旅行、大额消费），一笔记录可有多个标签。
AI 与通知
AI 功能不可用？
请先在「设置 → AI 模型配置」中开启并填写 API Key，然后点「测试连接」验证。
邮箱账单会自动入库吗？
不会。邮箱账单拉取后进入「待处理账单」，需要手动解析、预览并确认后才写入账本。
账单类型识别用 AI 吗？
不使用。邮箱账单的类型由发件人规则确定，结果确定、可预期；识别不出的可在解析时手动选择类型。
到点没有收到提醒？
检查：提醒是否启用、是否配置了启用的渠道、提醒时间是否为 HH:mm 格式。可先点「立即发送」验证渠道配置，并查看发送日志。
账号与数据
忘记密码怎么办？
登录后可在「设置 → 账号安全」中，凭原密码修改密码（也支持一键随机生成新密码）。若已完全忘记密码，当前版本暂未提供自助找回，可在数据库中重置该用户的密码哈希，或新建账号后迁移数据。
数据存在哪里？
- SQLite：默认位于服务运行目录的
data/下，配置文件为config/database.json。 - MySQL：位于所配置的数据库中。
切换数据库会迁移数据吗？
不会。切换后原数据库数据保留，需要自行迁移。
支持哪些界面语言？
简体中文、English、日本語，可在登录页或主界面顶部切换。