# 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 导出 · 自动月度 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.7.0
**重要特性**
* 新增 **定时记账**：周期性账单（订阅、房贷、水电、工资等）按规则自动生成流水，支持每日 / 每周 / 每月 / 每年，可暂停、修改、查执行历史
* 新增 **自动月度 Excel**：每月按时自动生成账单 Excel，可邮件发送，无需手动导出
* 新增 **站内通知中心**：双端顶栏铃铛 + 未读徽章，定时记账、Excel 生成等通知统一收口
* 新增 **统计页日支出折线图** + **明细页日合计**
* **设置全面 UI 化**：邮件 SMTP、备份时间、登录方式、自动 Excel 全部在前端「系统设置」配置，改完立即生效，**无需重启容器**
* AI 操作失败时前端会显示具体原因，不再静默卡住
**重要变更**
* ⚠️ WebHook 容器已废弃，邮件能力内置到 server。老用户升级请删除 `docker-compose.yml` 中 `webhook:` 服务块及 `SMTP_*` 等环境变量，在前端「系统设置 → 邮件」重新配置
完整说明：[v2.7.0 更新日志](https://github.com/QingHeYang/EasyAccounts/blob/gh-pages/docs/changelog.md#270-2026-05)
#### v2.6.2
* 新增 [OpenClaw Skills](https://github.com/QingHeYang/EasyAccounts-Skills) 集成（独立 Skill，无需升级容器）
#### 下一版计划
> 我思路比较跳脱，很多情况下不会按照计划来
* 账单导入（目前可通过 [OpenClaw Skills](https://github.com/QingHeYang/EasyAccounts-Skills) 批量导入，原生入口规划中）
* 多账本
* 自定义筛选条件保存
查看完整版本历史：[更新日志](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 自动备份**：在前端「系统设置 → 备份」配置备份时间，备份文件在 `Resource/sql/`
* **页面恢复数据**：直接在前端选择 SQL 备份文件即可恢复，无需手动映射
* **邮件推送**：在前端「系统设置 → 邮件」配置 SMTP，SQL 备份和 Excel 自动发到邮箱
| 
邮件推送
| 
SQL 备份邮件
|
| :---------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------: |
> v2.7.0 起，原 WebHook 容器已废弃，邮件能力内置到 server，所有配置改在前端 UI 完成，**改完立即生效，无需重启**。
#### 开发者友好
* Swagger 接口文档：方便二次开发
* Nginx 文件服务：直接下载生成的文件
| 
Swagger 接口文档
| 
Nginx 文件下载
|
| :-----------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------: |
详见：[项目访问地址](https://mercys-organization-2.gitbook.io/easyaccounts/deploy/deploy#xiang-mu-fang-wen)
***
### 写在最后
这个项目从 2021 年 9 月开始，到现在已经 5 年多了。
我是个旧时代的 Android 工程师，从 2024 年开始大量用 AI 辅助开发（ChatGPT、Copilot、Cursor、Claude...），所以代码注释可能有点糙，请多包涵。
**重要提醒**：一定要保护好 SQL 备份数据，bug 可以修，项目可以重部署，但数据丢了就真没办法了。
这个项目会一直维护下去，因为我自己天天在用。有好点子随时告诉我，合适的话我会加上。
欢迎 Star，遇到问题欢迎提 Issue。项目永久免费开源。
另外我是个社恐，加微信、拉群这种事可能会有点迟疑，不是不想理你，是真的社恐，请多包涵。
**关于贡献**：
* 项目坚持开源，**源码会同步，只是相对发布版本会延迟一段时间**（先在内部跑稳再开源，避免半成品代码误导贡献者或让基于源码二次开发的用户踩坑），想参与贡献的朋友请耐心等待源码仓库更新
* **本项目仅接受 Bug 修复类 PR，暂不接受新功能 PR**：这是对已有用户负责——新功能涉及产品定位与数据模型取舍，需要从全局规划，避免破坏性升级
* 欢迎以下贡献：Bug 修复、Issue 反馈、文档完善、部署测试反馈
* 有功能想法欢迎在 [GitHub Issue](https://github.com/QingHeYang/EasyAccounts/issues) 区讨论，合适的会在后续版本中加入
#### 交流群
欢迎加入 QQ 群交流：817098590
#### 支持项目
如果你愿意支持 EasyAccounts，扫码捐赠的款项我会以 **EasyAccounts** 项目名义转赠至**腾讯公益孤儿救助项目**。
| 
| 
|
| :-----------------------------------------------------------------: | :-----------------------------------------------------------------: |
***
[](https://star-history.com/#QingHeYang/EasyAccounts\&Date)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://mercys-organization-2.gitbook.io/easyaccounts/readme.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.