# 引言

前两天看到蘇先生开源的家庭账单项目HomeLedger，记账功能已经比较完整，但原项目的UI和UX并不是很好看，同时也有一些逻辑漏洞，再加上虽说原项目支持Openclaw，但没有支持Hermes，于是熊猫fork了一份继续改。

首先感谢原作者**蘇先生**的开源分享。原项目本身就支持Docker、AI记账和开放API，熊猫是在此基础上继续修改，在fork版本的“关于”页我要也保留了原作者和项目来源，感兴趣的可以去研究研究原项目，熊猫这个主要是到手即用。

原项目：sucraft-hub/homeledger，熊猫维护版：Panda-995/homeledger。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/cb869db1bc25a008f617524a12ab5b61.png)我主要调整了手机端导航、表单布局和按钮尺寸，统一浅色、深色主题以及下拉框、日期选择器、确认弹窗，并修复菜单收不回去、头像撑开页面等问题。

同时，原本的开放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: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调整，确认目录有读写权限。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/8b0acb53f17941f30e21d41226e29f84.png)在配置文件所在目录执行docker compose up -d或支持compose的NAS直接部署都可以，随后访问http\://NAS内网IP:5111，用配置中的账号密码登录就行。

# 日常记账

这类记账应用进去第一件事都是先建立账户，这方面这项目非常全面，支持现金、微信零钱、支付宝、信用卡、储蓄卡、投资账户、贷款等，如果是储蓄类型的账户，核对初始余额填上就行。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/fe470043c6a2b15a3940cadcb6303b77.png)导入账单的话，**目前支持微信和支付宝的流水账单**都支持，直接拖拽进去就行，同时如果你之前有其他账单应用的CSV、Json这类数据文件，也可以进行导入，让AI替换一下字段就行。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/8c93c8f303f1bf7241c36c5b18bbee6d.png)记账类型上，这项目对于个人用户来说非常友好，消费支出，工资收入，银行卡转账、借出、借入、还款也都有对应类型，这样可以避免把账户之间的资金流动算成收入或消费，甚至还**支持AA分账**，同时在分类和细分上也做得很全面。

除此之外如果这笔费用可以报销，还可以勾选这个选项，等报销下来可以去点击销账，甚至还有自带的汇率折算，不过这个要自己设置。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/64d7f57216435a327b4a353d5422df10.png)**订阅管理**可以集中记录软件、会员等固定支出，把月付、年付折算成月均成本，并按期生成记账流水，这个是每个月自动执行的，不需要单独去记账了。

除此之外周期账单也是一样，比如房贷、车贷这种就属于周期账单，就可以用他来进行记录，免去了每个月手动记录的操作，但是因为利率和贷款形式的不同，可能存在每个月金额不同的情况，这个目前没办法做到一样。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/e70880d87a053e05921f294d2d40c0c6.png)账本方面，项目**支持家庭成员**通过邀请码加入共享账本，按角色分配权限；个人账与家庭账也能分别管理，在成员管理中能看到每个成员记账数量和笔数。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/a6e99329d7227c3796e8adacc6a4921f.png)最后预算、储蓄目标以及借贷这些也都有专门的位置几率，细分还是很全面的。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/93c37e0d2cf5e30333d36e09e97e6974.png)单说家庭记账这件事，我觉得这个项目比熊猫之前介绍的都要好用。

# AI与助手

没配置模型时，内置规则引擎可处理简单文字，比如“午饭 35 元”，但能力有限，如果没有配置AI，建议多笔消费建议分开记，避免记混。

在“设置 → AI记账”填写OpenAI兼容接口地址、API Key和模型名，开启识别。**截图记账**还要勾选视觉能力，并确认所选模型确实支持图片，所以建议选择多模态的模型。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/a2e41556cd0c1d460bdbe5d5785c71eb.png)配置好之后再输入记账的内容或发送截图，AI会核对金额、日期、账户和分类，识别之后会让你确认再考虑保存，同时也可以用全局浮动助手识别后直接入库。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/909838ae1f0e405dee5a13665d45ad7a.png)**账本和附件保存在NAS，但云端AI会接收待识别的文字或截图。** 在意这部分隐私，可以接本地视觉模型或继续手动记账。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/731c3718fb06044ecf57e81c2ecb726f.png)接Hermes、OpenClaw时，在“设置 → 开放 API”生成令牌，为助手配置HOMELEDGER\_URL和HOMELEDGER\_TOKEN，再安装仓库对应的记账技能包，权限方面比原本放开了很多，除了原版已经有的记账功能，还增加了管理、修改、订阅、周期账单以及数据分析的权限。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/bdd3c368826c3feb223702ac1895cc59.png)除了单纯的使用工具，你还可以让Hermes这些Agent设置定时任务，例如每天晚上十一点发送给你消费日报，每周一发送上一周的周报。

不过助手需要能访问家账簿地址，之后即可通过文字、截图记账和查询记录，所以你的项目地址一定要是公网能访问才行，如果没有公网，那就用穿透工具。

# 飞牛直装与细节

飞牛可以直接下载原作者项目地址Releases中的fpk文件直接一键安装，熊猫的fork维护版本目前还没上fpk文件，应该下个版本就会上，目前frok版本已经经历了十多二十次更新了，毕竟我自己的账单都转移了。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/12ce75c581437f02632564b1f24c2c33.png)同时原项目对于手机端、平板这些的适配也没做太深入，于是熊猫针对移动端专门做了优化，目前的界面个人还是很满意的。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/446ec7e574c22f8693774487399ca064.png)手机端

全局的图标也从普通符号图标改成了Lucide开源图标库的图标，然后增加了一些交互设计和动效，统一了一下整个项目的美术设计，使其更美观了。

# 写在最后

单说个人家庭记账这件事，这项目是真的好用，不管是协作、账户种类、记账类型和特色功能，都非常实用，唯一有问题的就是原项目的UI和UX真的一般，很多不协调的地方，再一个就是Hermes不支持以及一些逻辑漏洞。

![](https://developer.qcloudimg.com/http-save/yehe-9074736/ed10312c587cbf35c460c47dfef40cbf.png)目前熊猫已经将自己的记账全迁移到这上面了，熊猫也会继续打磨日常操作，也再次感谢蘇先生提供原项目。欢迎给两个仓库点个Star，维护版的问题可以到fork的Issues反馈。![](https://developer.qcloudimg.com/http-save/yehe-9074736/189bd19398a7dc3885a3534fbe856f7e.png)


前两天看到蘇先生开源的家庭账单项目HomeLedger，记账功能已经比较完整，但原项目的UI和UX并不是很好看，同时也有一些逻辑漏洞，再加上虽说原项目支持Openclaw，但没有支持Hermes，于是熊猫fork了一份继续改。

飞牛直装，最好用的个人家庭账本！给HomeLedger改个更顺手的版本

开发工具

新闻资讯

基于开源HomeLedger优化的家庭记账工具，全新UI适配手机端，支持AI记账、Hermes/OpenClaw智能助手、多账户与订阅管理。Docker一键部署，兼容amd64/arm64架构，支持微信支付宝账单导入、共享账本与预算规划。

数据分析

代码解释

数据库

OpenClaw

容器

Docker

SQLite

Agent

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

飞牛直装，最好用的个人家庭账本！给HomeLedger改个更顺手的版本-腾讯云开发者社区-腾讯云

飞牛直装，最好用的个人家庭账本！给HomeLedger改个更顺手的版本

飞牛直装，最好用的个人家庭账本！给HomeLedger改个更顺手的版本

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐