Files
ledgerly-docs/guide/download.md
T
rosercode 923d6db5c0 docs: 同步汇账最新功能,新增智能查数、账单关系等文档
对照 ledgerly 自文档上次更新以来的全部改动,补充新功能文档、修正品牌与版本残留,并新增下载与安装页;配图已重新截取并上传 OSS,本地截图目录不纳入版本管理。

变更内容:
- 新增「智能查数」「账单关系」两个使用文档页,并登记侧边栏与总览
- 设置页扩充为八个面板(账号安全、数据库实时进度、外观、导航等)并改为即时保存
- 收支记录补充关系列、批量操作、AI 搜索浮窗、可配置分页与「账单详情」弹窗
- 统计面板补充饼图/渠道图下钻与筛选双向联动;规则管理补充批量删除
- AI 能力补充智能查数与关系命名;新增下载与安装页
- 开发文档同步:AI 13 类调用、数据模型 24 张表、API、前端偏好、构建部署
- 统一「汇账 Ledgerly」品牌与「设置/日志」菜单文案,版本号对齐 0.1
- 截图脚本新增账单详情等场景并更新登记

说明:
- download.md 的 OSS 下载链接保持待发布产物回填,暂不调整
- 已通过 npm run docs:build 与 npm run typecheck:scripts
2026-09-26 21:57:38 +08:00

6.0 KiB
Raw Blame History

下载与安装

本章介绍如何获取「汇账」的安装包并在本机运行。

系统提供两种分发形态:

形态 适用场景 说明
免安装应用(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,保存后自动建表。

更多安装与使用说明见快速开始;自行构建与部署见构建与部署。