飞牛直装，最好用的个人家庭账本！给HomeLedger改个更顺手的版本
内容提要
熊猫基于苏先生开源的HomeLedger家庭记账项目进行fork改进，优化了手机端导航、表单布局和主题统一，修复菜单、头像等UI问题，扩展开放API权限并新增Hermes支持，改进备份恢复及借贷、周期账单等逻辑。项目采用SQLite和单容器部署，支持多账户、账单导入、订阅与周期账单、家庭共享账本、预算及AI记账，可接入本地或云端模型，飞牛可直装原版。
延伸解读
原版与维护版的选择
文章提到，原版HomeLedger已支持Docker、AI记账和开放API，但UI/UX一般且存在逻辑漏洞，也不支持Hermes。熊猫的fork版优化了移动端界面、扩展了API权限并新增Hermes支持，修复了借贷正负号、周期账单等问题。飞牛用户可直接安装原版fpk，而fork版目前尚未提供fpk，预计下个版本上线。
部署与数据安全要点
项目采用SQLite和单容器部署，镜像支持amd64和arm64架构。部署时需修改默认密码和SESSION_SECRET，数据目录要确保读写权限。备份恢复改为网页上传后自动切换数据库，无需手动替换文件或重启容器。但需注意，若使用云端AI记账，待识别的文字或截图会发送到云端，对隐私敏感的用户可考虑本地模型或手动记账。
AI记账的适用场景与限制
未配置AI模型时，内置规则引擎只能处理简单文字如“午饭 35 元”，多笔消费建议分开记录。配置OpenAI兼容接口后，AI可核对金额、日期、账户和分类，截图记账需模型支持视觉能力。通过开放API，Hermes等助手还能设置定时任务发送消费日报或周报，但要求账本地址公网可访问，否则需使用穿透工具。
Q&A
熊猫为什么对HomeLedger进行fork改进？
熊猫认为原项目UI和UX不够美观，存在逻辑漏洞，且不支持Hermes，因此fork后继续修改，目标是到手即用。
熊猫维护版主要做了哪些改进？
调整了手机端导航、表单布局和按钮尺寸，统一了主题和组件样式，修复了菜单和头像等UI问题；扩展了开放API权限并新增Hermes支持；改进了备份恢复、借贷正负号、投资账户校验、月底周期账单和CSV回导类型等逻辑。
如何部署熊猫维护版的HomeLedger？
在NAS上新建homeledger文件夹和data子文件夹，将提供的docker-compose.yml配置保存或粘贴到Compose项目界面，修改密码和会话密钥后，执行docker compose up -d启动，然后访问http://NAS内网IP:5111登录。
HomeLedger支持哪些账户类型和记账类型？
账户类型支持现金、微信零钱、支付宝、信用卡、储蓄卡、投资账户、贷款等；记账类型包括消费支出、工资收入、银行卡转账、借出、借入、还款，还支持AA分账和报销销账。
如何配置AI记账？
在“设置 → AI记账”中填写OpenAI兼容接口地址、API Key和模型名，开启识别。截图记账需勾选视觉能力并确认模型支持图片，建议选择多模态模型。配置后输入内容或发送截图，AI会核对信息并让你确认后保存。
如何接入Hermes或OpenClaw？
在“设置 → 开放API”生成令牌，为助手配置HOMELEDGER_URL和HOMELEDGER_TOKEN，再安装仓库对应的记账技能包。权限比原版放开很多，增加了管理、修改、订阅、周期账单及数据分析权限。
飞牛NAS可以直接安装HomeLedger吗？
飞牛可以直接下载原作者项目Releases中的fpk文件一键安装。熊猫的fork维护版本目前还没上fpk文件，应该下个版本就会上。
