FAQs
本文档汇集了 Beancount-Trans 用户最常见的问题。请先根据您的问题类别进行浏览，如果未能找到答案，欢迎通过文末的渠道联系我们。
一、通用问题
这部分问题适用于所有用户。
| 问题 | 解答 |
|---|---|
| Q: Beancount-Trans 是免费的吗？ | A: 是的！Beancount-Trans 是一个完全开源的项目，遵循 MIT 许可证。对于涉及 定制化开发或需要专项技术支持 等高阶需求，欢迎直接通过邮箱 Dai_Haorui@163.com 与我们联系洽谈。 |
| Q: 我的财务数据安全吗？ | A: 安全性是我们的首要考虑。云平台采用严格的数据隔离和加密措施。对于自托管用户，您的数据完全掌握在您自己手中。 |
| Q: 支持哪些账单格式和渠道？ | A: 我们支持支付宝、微信支付以及国内主流银行的 CSV/Excel 格式账单。详细的导出指南，请参阅 各渠道账单文件导出。 |
| Q: 如何反馈问题或提出新功能建议？ | A: 我们非常欢迎您的反馈！最佳方式是在我们的 GitHub Issues 页面创建新的 issue。您也可以发送邮件至 Dai_Haorui@163.com |
二、云平台使用问题
账户与登录
- Q: 忘记密码怎么办？
- Q: 是否支持第三方账号（如 GitHub、Google）登录？
A: 目前已支持 GitHub 账号登录，Google 账号登录功能即将上线，敬请期待！
文件管理
- Q: 上传文件的大小和数量是否有限制？
- Q: 重新上传同一个文件，会生成重复的交易记录吗？
A: 为防止重复记录，系统不允许上传同名文件。如果您将同一份账单以不同的文件名重新上传并解析，系统会将其视为新文件，从而生成重复记录。 解决方法：您可以在账本中
注释掉(include)重复文件，或直接删除导致重复的账单文件。详情请参阅 解析文档 中的相关说明。
解析与映射
- Q: 为什么有些交易解析失败了？
- Q: 我创建了一条新映射规则，为什么旧的账单数据没有自动变更？
A: 映射规则是在解析账单时应用的。对于已解析的数据，您需要重新解析原账单文件，新规则才会生效。
- Q: 一条交易同时匹配了多条映射规则，最终会如何分类？
A: 系统会优先采用优先级（Priority） 最高的规则。如果优先级相同，则会调用 AI 模型进行语义相似度计算，选择分数最高的分类。您可以在 映射文档 中了解详情。
- Q: 想确认默认账户结构或规划新的科目，有没有参考资料？
A: 有的。我们在《账户管理》里整理了根账户、子账户以及常见设计思路，建议在调整映射或解析策略前先阅读。
账本与报表 (Fava)
- Q: 访问 " 平台账本 " 时提示无法连接或超时怎么办？
A: 为节省资源，您的专属 Fava 容器在闲置一段时间后会自动休眠。请稍等几秒钟刷新页面，系统会自动重新唤醒它。
- Q: 能否在手机端查看报表？
A: 可以。Fava 的 Web 界面是响应式的，支持在手机浏览器上查看（操作体验可能不如电脑）。
三、自托管问题
注意：自托管需要您具备一定的服务器运维和 Docker 知识。
部署与安装
- Q: 部署的最低系统要求是什么？（硬件、Docker 版本、操作系统）
- Q: 如何配置域名和 SSL 证书？
- Q: 如何更新到最新版本？
配置与定制
- Q: 如何修改默认的映射规则和忽略规则？
- Q: 如何配置 AI 模型（如 DeepSeek API 密钥）？
- Q: 数据文件（账本、账单）存储在容器的哪个目录？如何备份？
故障排除
- Q: 容器启动失败，如何查看日志？
A: 使用命令
docker compose logs [service-name]来查看特定服务（如beancount-trans-backend）的启动日志，从而定位问题。
- Q: 访问自托管站点出现数据库连接错误怎么办？
- Q: 如何重置管理员密码？
四、仍然需要帮助？
如果本文档未能解决您的问题，您可以通过以下方式联系我们：
- 提交 GitHub Issue:
- 🐛 报告 Bug：请详细描述问题现象、复现步骤和错误日志。
- 💡 提出新功能：清晰地描述您的需求和使用场景。
- 发送邮件：Dai_Haorui@163.com