★ FEATURED ARTICLE 引言前两天看到蘇先生开源的家庭账单项目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项目界面services: homeledger: image: ghcr.io/panda-995/homeledger:latest container_name: homeledger user:0:0restart: unless-stopped environment: TZ: Asia/Shanghai SESSION_SECRET:替换成随机长字符串ADMIN_USER:adminADMIN_PASSWORD:替换成自己的强密码ALLOW_REGISTER:falseports: -5111:5111volumes: - ./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反馈。
阅读完成 · 觉得有帮助？
