# EasyAccounts
##  EasyAccounts
**开源中文记账软件 · 数据自主可控 · AI 智能助手**
[](https://github.com/QingHeYang/EasyAccounts/stargazers) [](https://github.com/QingHeYang/EasyAccounts/network/members) [](https://github.com/QingHeYang/EasyAccounts/blob/main/LICENSE) [](https://hub.docker.com/r/775495797/easyaccounts-server) 
[📚 文档](https://mercys-organization-2.gitbook.io/easyaccounts/) • [🐳 部署](https://github.com/QingHeYang/EasyAccounts/blob/gh-pages/docs/deploy.md) • [📸 截图](https://github.com/QingHeYang/EasyAccounts/blob/gh-pages/docs/feature-showcase.md) • [📝 历史版本](https://github.com/QingHeYang/EasyAccounts/blob/gh-pages/docs/changelog.md) • QQ群：817098590
***
### 简介
EasyAccounts 是一款**开源中文记账软件**，支持本地 Docker 部署，数据完全自主可控。
新版本集成 **AI 智能助手**，可以通过对话查询、新增、修改流水，还能生成你想要的 Excel 报表。
如果你对互联网上的记账 App 不放心，担心**信息泄露**或**数据丢失**，也许这个项目能满足你的需求。
### 快速了解
| 项目 | 说明 |
| ------- | -------------------------------- |
| 👤 面向受众 | 个人 / 家庭 (不支持团队) |
| 🐳 部署要求 | 会使用 Docker Compose |
| 💻 支持平台 | Linux · Windows · macOS · 飞牛Fnos |
| 📦 资源消耗 | 内存 500-800MB |
### 核心特点
| 功能 | 说明 |
| -------- | ------------------------------------------------ |
| 📝 记账管理 | 账户 · 收支操作 · 二级分类 · 明细流水 |
| 🔍 数据筛选 | 时间 · 账户 · 分类 · 备注 |
| 📊 报表生成 | 月度账单 · 筛选报表 · Excel 导出 |
| 🤖 AI 助手 | 对话记账 · 智能查询 · 图片识别 · MCP (SSE / Streamable-HTTP) |
| 📧 消息推送 | SQL 备份 · Excel 邮件推送 |
| 🔐 安全特性 | 登录认证 · 单点登录 · 数据自主可控 |
### 项目部署
```bash
git clone https://github.com/QingHeYang/EasyAccounts.git
cd EasyAccounts
docker compose up -d
```
启动后访问 `http://你的IP:10669`
详细部署说明：[部署文档](https://github.com/QingHeYang/EasyAccounts/blob/gh-pages/docs/deploy.md) | [GitBook](https://mercys-organization-2.gitbook.io/easyaccounts/)
### 版本动态
#### v2.6.1
* 优化内存使用：从 1GB 左右优化到 500MB 左右
* 新增页面操作恢复数据功能，无需映射 SQL 脚本
* 新增系统公告功能（仅获取云端数据文件用于通知，不会上传任何数据）
#### v2.6.0 （[视频介绍](https://www.bilibili.com/video/BV1BErCBsEMQ)）
**重要特性**
* 新增 PC 端，重构移动端，界面完全重新设计，更符合现代审美
* 支持日间/夜间模式切换
* AI 增加 MCP 功能（SSE / Streamable-HTTP），可使用第三方 AI 工具
* AI 增加图像识别功能（需 VL 大模型支持，普通模型上传图片会导致当前对话作废）
* 账户增加资产与负债属性，现有账户全部转为资产账户，负债账户需要新增
**新增功能**
* 不计入总金额功能完善，内部转账不计入总金额选项拆分成转出不计入与转入不计入（**不计入总金额的确立是为了记录借钱还钱等操作**，信用卡等初始负债请新建负债账户）
* 认证模式优化：固定时间退出 → 滑动时间退出，支持多端登录（可在 compose 中配置）
* AI 工具显示优化，不再显示参数，新增可点击交互工具
* AI 记账/更新会在备注中默认增加 `#AI记账` `#AI更新` 标签，方便溯源
* 总览月度概览标注收入、支出、结余、负收入
* 桌面端总览增加年度收支趋势
* 双端总览增加隐私按钮
* 快记模板备注会默认增加模板名称
* 统计页面图表重构，可快速排除某分类，无需去设置里操作
* 统计-分类统计增加最高最低标注、折线面积图
* 设置页面增加 AI+ 设置（MCP 地址、Token 统计、对话工具数目）
* 设置页面增加系统信息（深浅肤色、认证信息、备份信息、各组件版本号）
* Excel 模板优化：xls → xlsx，收入绿色、支出红色，更直观
**Bug 修复**
* 修复不计入总金额记账出现 500 问题
* 修复 AI 选择一级分类记账导致统计分类找不到明细的问题
* 修复移动端桌面端账户页面不统一问题
**技术特性**
* 前端 JS → TS，vue-cli → Vite，引入 ECharts、Element Plus、Vant
* 后端 Spring 2.x → 3.x，Java 11 → 17
* Agent 框架（koalaq\_hub）优化，引入 FastMCP
* 部署简化：无需复制初始化数据库文件（已内置到 MySQL 镜像）
#### 下一版计划
> 我思路比较跳脱，很多情况下不会按照计划来
* 账单导入
* 定时记账
查看完整版本历史：[更新日志](https://github.com/QingHeYang/EasyAccounts/blob/gh-pages/docs/changelog.md) | [GitBook](https://mercys-organization-2.gitbook.io/easyaccounts/version)
### 功能预览
| 
总览
| 
明细
| 
统计
| 
AI 对话
|
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| 
AI 对话
| 
统计分析
| 
分类设置
|
| :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
查看更多截图：[功能展示](https://github.com/QingHeYang/EasyAccounts/blob/gh-pages/docs/feature-showcase.md)
### 功能说明
#### 记账基础
记账围绕四个维度：**账户**、**收支操作**、**分类**、**明细**
* **账户**：你的钱放在哪，比如现金、银行卡、支付宝
* **收支操作**：钱怎么动的，收入、支出、借入、借出、内部转账（默认已配好，够用）
* **分类**：钱花在哪，支持二级分类，比如「用车」下面可以有「加油」「保险」
* **明细**：每一笔流水记录
记一笔账：选账户 → 选操作 → 选分类 → 填金额 → 保存，搞定。
#### AI 助手
接入大模型 API，支持：
* 对话记账：「昨天午饭花了 25」
* 智能查询：「这个月花了多少」
* 图片识别：拍个小票自动识别
* MCP 功能：支持 SSE / Streamable-HTTP 协议
需要自己配置 API Key，支持多家大模型。
#### 报表导出
两种 Excel 报表：
* **月度账单**：在明细页面生成当月账单
* **筛选账单**：按条件筛选后导出
> 小提示：生成历史月份账单时，账户余额会追溯到当时的金额
#### 数据备份
* **SQL 自动备份**：在 docker-compose.yml 配置 cron 规则，备份文件在 `Resource/sql/`
* **邮件推送**：配置 WebHook 后，SQL 备份和 Excel 都能发到邮箱
| 
邮件推送
| 
SQL 备份邮件
|
| :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
详见：[WebHook 配置说明](https://mercys-organization-2.gitbook.io/easyaccounts/deploy/webhook)
#### 开发者友好
* Swagger 接口文档：方便二次开发
* Nginx 文件服务：直接下载生成的文件
| 
Swagger 接口文档
| 
Nginx 文件下载
|
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
详见：[项目访问地址](https://mercys-organization-2.gitbook.io/easyaccounts/deploy/deploy#xiang-mu-fang-wen)
***
### 写在最后
这个项目从 2021 年 9 月开始，到现在已经 3 年多了。
我是个旧时代的 Android 工程师，从 2024 年开始大量用 AI 辅助开发（ChatGPT、Copilot、Cursor、Claude...），所以代码注释可能有点糙，请多包涵。
**重要提醒**：一定要保护好 SQL 备份数据，bug 可以修，项目可以重部署，但数据丢了就真没办法了。
这个项目会一直维护下去，因为我自己天天在用。有好点子随时告诉我，合适的话我会加上。
欢迎 Star，遇到问题欢迎提 Issue。项目永久免费开源。
另外我是个社恐，加微信、拉群这种事可能会有点迟疑，不是不想理你，是真的社恐，请多包涵。
**关于贡献**：目前新版本还在调试中，源码仓库暂时落后于发布版本，想参与贡献的朋友请耐心等待。
#### 交流群
欢迎加入 QQ 群交流：817098590
#### 支持项目
如果你愿意支持 EasyAccounts，扫码捐赠的款项我会以 **EasyAccounts** 项目名义转赠至**腾讯公益孤儿救助项目**。
|  |  |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
***
[](https://star-history.com/#QingHeYang/EasyAccounts\&Date)