对照 ledgerly 自文档上次更新以来的全部改动,补充新功能文档、修正品牌与版本残留,并新增下载与安装页;配图已重新截取并上传 OSS,本地截图目录不纳入版本管理。 变更内容: - 新增「智能查数」「账单关系」两个使用文档页,并登记侧边栏与总览 - 设置页扩充为八个面板(账号安全、数据库实时进度、外观、导航等)并改为即时保存 - 收支记录补充关系列、批量操作、AI 搜索浮窗、可配置分页与「账单详情」弹窗 - 统计面板补充饼图/渠道图下钻与筛选双向联动;规则管理补充批量删除 - AI 能力补充智能查数与关系命名;新增下载与安装页 - 开发文档同步:AI 13 类调用、数据模型 24 张表、API、前端偏好、构建部署 - 统一「汇账 Ledgerly」品牌与「设置/日志」菜单文案,版本号对齐 0.1 - 截图脚本新增账单详情等场景并更新登记 说明: - download.md 的 OSS 下载链接保持待发布产物回填,暂不调整 - 已通过 npm run docs:build 与 npm run typecheck:scripts
6.0 KiB
6.0 KiB
下载与安装
本章介绍如何获取「汇账」的安装包并在本机运行。
系统提供两种分发形态:
| 形态 | 适用场景 | 说明 |
|---|---|---|
| 免安装应用(app-image) | 推荐 | 自带精简 Java 运行时,解压即用,无需另装 JDK |
| 可执行 jar | 已有 JDK 21 的环境 | 单个 jar 文件,java -jar 运行 |
每个平台各提供两个版本:
- 个人记账(GUI 版):带图形界面启动器,可在窗口或系统托盘中启停服务、打开浏览器、实时查看日志。
- 后端服务(服务版):命令行启动,适合服务器或后台常驻运行。
下载地址
当前版本:0.0.1-SNAPSHOT。以下均为阿里云 OSS 长期签名地址,有效期至 2036 年。
Windows(x64)
| 版本 | 下载 | 校验 |
|---|---|---|
| 个人记账(GUI) | Ledgerly-windows-x64.zip | sha256 |
| 后端服务 | LedgerlyServer-windows-x64.zip | sha256 |
| 校验清单 | SHA256SUMS |
Linux(x64)
| 版本 | 下载 | 校验 |
|---|---|---|
| 个人记账(GUI) | Ledgerly-linux-x64.tar.gz | sha256 |
| 后端服务 | LedgerlyServer-linux-x64.tar.gz | sha256 |
| 校验清单 | SHA256SUMS |
可执行 jar(跨平台)
需要本机已安装 JDK 21。
| 版本 | 下载 | 校验 |
|---|---|---|
| 普通 jar | ledgerly-0.0.1-SNAPSHOT-jdk21.jar | sha256 |
| 带 GUI 启动器 jar | ledgerly-0.0.1-SNAPSHOT-jdk21-gui.jar | sha256 |
运行
Windows
解压 zip 后进入解压出的目录:
- 个人记账(GUI):双击
Ledgerly.exe,在启动器界面上点击「启动服务」,再点「打开浏览器」。 - 后端服务:运行
LedgerlyServer.exe,会附带控制台窗口显示日志;服务在本机http://localhost:8080提供页面与接口。
Linux
个人记账(GUI):
tar xzf Ledgerly-linux-x64.tar.gz
cd Ledgerly
./bin/Ledgerly
后端服务:
tar xzf LedgerlyServer-linux-x64.tar.gz
cd LedgerlyServer
./bin/LedgerlyServer
可执行 jar
java -jar ledgerly-0.0.1-SNAPSHOT-jdk21.jar
带 GUI 启动器的 jar(需要桌面环境):
java -jar ledgerly-0.0.1-SNAPSHOT-jdk21-gui.jar
默认访问地址为 http://localhost:8080,可在「设置」中修改端口,或运行时用 --server.port=18081 指定。
校验下载文件
建议下载后校验文件完整性(sha256 文件内容即对应压缩包/ jar 的 SHA-256 值)。
Linux:
sha256sum -c Ledgerly-linux-x64.tar.gz.sha256
Windows PowerShell:
Get-FileHash -Algorithm SHA256 .\Ledgerly-windows-x64.zip
# 与 .sha256 文件中的值比对
运行目录与数据
- 配置、日志、数据默认落在程序所在目录;可用
--home=<目录>参数或环境变量LEDGERLY_HOME指定基准目录。 - 首次访问时,页面会引导选择 SQLite(本地单文件,零配置)或 MySQL,保存后自动建表。