panda 
匿名 引言
前两天看到蘇先生开源的家庭账单项目HomeLedger，记账功能已经比较完整，但原项目的UI和UX并不是很好看，同时也有一些逻辑漏洞，再加上虽说原项目支持Openclaw，但没有支持Hermes，于是熊猫fork了一份继续改。
首先感谢原作者蘇先生的开源分享。原项目本身就支持Docker、AI记账和开放API，熊猫是在此基础上继续修改，在fork版本的“关于”页我要也保留了原作者和项目来源，感兴趣的可以去研究研究原项目，熊猫这个主要是到手即用。
原项目：sucraft-hub/homeledger，熊猫维护版：Panda-995/homeledger。
我主要调整了手机端导航、表单布局和按钮尺寸，统一浅色、深色主题以及下拉框、日期选择器、确认弹窗，并修复菜单收不回去、头像撑开页面等问题。
同时，原本的开放API权限过于低了，于是扩展到交易修改、批量操作、账户、预算、订阅等功能，并加上了Hermes支持；备份恢复方面改成了网页上传后自动切换数据库，无需手动换文件或重启容器。也修正了借贷正负号、投资账户校验、月底周期账单和CSV回导类型等问题。
项目部署
项目使用SQLite，一个容器即可运行，毕竟不是专业的财务项目，个人用SQLite完全足够。镜像提供amd64、arm64两种架构，毕竟现在arm架构的NAS原来越多了，毕竟便宜。
部署也很简单，在NAS上新建homeledger文件夹和data子文件夹，将下面的配置保存为 docker-compose.yml，或粘贴到NAS的Compose项目界面：
♾️ text 代码:services:
homeledger:
image: ghcr.io/panda-995/homeledger:latest
container_name: homeledger
user: "0:0"
restart: unless-stopped
environment:
TZ: Asia/Shanghai
SESSION_SECRET: "替换成随机长字符串"
ADMIN_USER: "admin"
ADMIN_PASSWORD: "替换成自己的强密码"
ALLOW_REGISTER: "false"
ports:
- "5111:5111"
volumes:
- ./data:/data先改密码和会话密钥，再启动。密钥可用豆包之类的直接生成。左侧端口可以改，右侧为容器端口，保持5111；数据路径按自己的NAS调整，确认目录有读写权限。
在配置文件所在目录执行docker compose up -d或支持compose的NAS直接部署都可以，随后访问http://NAS内网IP:5111，用配置中的账号密码登录就行。
日常记账
这类记账应用进去第一件事都是先建立账户，这方面这项目非常全面，支持现金、微信零钱、支付宝、信用卡、储蓄卡、投资账户、贷款等，如果是储蓄类型的账户，核对初始余额填上就行。
导入账单的话，目前支持微信和支付宝的流水账单都支持，直接拖拽进去就行，同时如果你之前有其他账单应用的CSV、Json这类数据文件，也可以进行导入，让AI替换一下字段就行。
记账类型上，这项目对于个人用户来说非常友好，消费支出，工资收入，银行卡转账、借出、借入、还款也都有对应类型，这样可以避免把账户之间的资金流动算成收入或消费，甚至还支持AA分账，同时在分类和细分上也做得很全面。
除此之外如果这笔费用可以报销，还可以勾选这个选项，等报销下来可以去点击销账，甚至还有自带的汇率折算，不过这个要自己设置。
订阅管理可以集中记录软件、会员等固定支出，把月付、年付折算成月均成本，并按期生成记账流水，这个是每个月自动执行的，不需要单独去记账了。
除此之外周期账单也是一样，比如房贷、车贷这种就属于周期账单，就可以用他来进行记录，免去了每个月手动记录的操作，但是因为利率和贷款形式的不同，可能存在每个月金额不同的情况，这个目前没办法做到一样。
账本方面，项目支持家庭成员通过邀请码加入共享账本，按角色分配权限；个人账与家庭账也能分别管理，在成员管理中能看到每个成员记账数量和笔数。
最后预算、储蓄目标以及借贷这些也都有专门的位置几率，细分还是很全面的。
单说家庭记账这件事，我觉得这个项目比熊猫之前介绍的都要好用。
AI与助手
没配置模型时，内置规则引擎可处理简单文字，比如“午饭 35 元”，但能力有限，如果没有配置AI，建议多笔消费建议分开记，避免记混。
在“设置 → AI记账”填写OpenAI兼容接口地址、API Key和模型名，开启识别。截图记账还要勾选视觉能力，并确认所选模型确实支持图片，所以建议选择多模态的模型。
配置好之后再输入记账的内容或发送截图，AI会核对金额、日期、账户和分类，识别之后会让你确认再考虑保存，同时也可以用全局浮动助手识别后直接入库。
账本和附件保存在NAS，但云端AI会接收待识别的文字或截图。 在意这部分隐私，可以接本地视觉模型或继续手动记账。
接Hermes、OpenClaw时，在“设置 → 开放 API”生成令牌，为助手配置HOMELEDGER_URL和HOMELEDGER_TOKEN，再安装仓库对应的记账技能包，权限方面比原本放开了很多，除了原版已经有的记账功能，还增加了管理、修改、订阅、周期账单以及数据分析的权限。
除了单纯的使用工具，你还可以让Hermes这些Agent设置定时任务，例如每天晚上十一点发送给你消费日报，每周一发送上一周的周报。
不过助手需要能访问家账簿地址，之后即可通过文字、截图记账和查询记录，所以你的项目地址一定要是公网能访问才行，如果没有公网，那就用穿透工具。
飞牛直装与细节
飞牛可以直接下载原作者项目地址Releases中的fpk文件直接一键安装，熊猫的fork维护版本目前还没上fpk文件，应该下个版本就会上，目前frok版本已经经历了十多二十次更新了，毕竟我自己的账单都转移了。
同时原项目对于手机端、平板这些的适配也没做太深入，于是熊猫针对移动端专门做了优化，目前的界面个人还是很满意的。
全局的图标也从普通符号图标改成了Lucide开源图标库的图标，然后增加了一些交互设计和动效，统一了一下整个项目的美术设计，使其更美观了。
写在最后
单说个人家庭记账这件事，这项目是真的好用，不管是协作、账户种类、记账类型和特色功能，都非常实用，唯一有问题的就是原项目的UI和UX真的一般，很多不协调的地方，再一个就是Hermes不支持以及一些逻辑漏洞。
目前熊猫已经将自己的记账全迁移到这上面了，熊猫也会继续打磨日常操作，也再次感谢蘇先生提供原项目。欢迎给两个仓库点个Star，维护版的问题可以到fork的Issues反馈。
