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