Cashbook5.0（记米粒-Jimily）部署教程

本教程旨在指导用户如何离线部署 记米粒（英文名Jimily）。通过Docker和Docker Compose，您将能够快速搭建一个本地运行的个人AI记账系统，并体验其AI功能。

Github仓库：https://github.com/dingdangdog/jimily-release
在线体验：https://jimily.oldmoon.top (体验账号密码: jimilydemo / jimily2026)

## 前言

已重构cashbook，集成AI并改名为 Jimily（记米粒）

记米粒与cashbook整体设计完全改变，虽然基础功能还大多保留，但很多设计已经改变，比如两大改变：
1. 不再有账本的概念，每个用户记录的所有流水都在一起统计
2. 不再有支付方式，但增加资金账户的概念，所有收入支出都归入对应的资金账户

**重要提示：由于数据库完全重构，请创建新数据库**

> 小技巧：你可以cashbook和记米粒各部署一个，经过对比后选择喜欢的一个去使用

## 准备工作

在开始部署之前，请确保您的系统已安装以下软件：

*   **Docker:** 用于运行容器。
*   **Docker Compose:** 用于定义和运行多容器Docker应用程序。

## 部署步骤

部署 记米粒 主要分为三个核心步骤：数据库准备、镜像下载和启动以及系统初始化。

### 一、数据库准备

记米粒 需要使用PostgreSQL数据库。

> 如果您不会数据库准备，请自行查找网络教程，下面只进行过程简要介绍：

**需要请自行准备数据库，建议 Postgre17.7 版本数据库**，比如 Docker镜像 `postgres:17.7-alpine`。

请准备好你的数据库连接，便于后续部署软件时修改。

### 二、镜像下载

镜像下载有两种方案

1. 可以直接 从dockerhub或其他镜像站下载 `dingdangdog/jimili`，（运行docker-compose时会自动下载）
2. 无法直接下载时，请自行探索离线上传方案~

  ```bash
  # 一个小提示：离线镜像加载命令 示例
  docker load -i jimili.5.1.3.tar
  ```

加载成功后，您可以使用 `docker images` 命令查看 `jimili:5.1.3` 镜像是否已存在。

3.  **准备 `docker-compose.yaml` 文件：**

创建一个名为 `docker-compose.yaml` 的文件，并将以下内容复制进去。**请务必根据您的实际情况修改 `DATABASE_URL` 和 `NUXT_AUTH_SECRET`。**

```yaml
services:
  main:
    container_name: jimily
    image: dingdangdog/jimily:5.1.3
    restart: always
    # network_mode: "host"
    volumes:
      - ./data:/app/data # 数据挂载到本地
    environment:
      DATABASE_URL: "postgresql://postgres:123456@localhost:5432/jimily?schema=public" # 数据库链接，【账号密码请自行修改，与你的数据库一致！】
      # NUXT_DATA_PATH: "/app/data" # 数据存储位置，现在只有小票图片，没有特别的需求不建议修改，因为与数据卷配置需要同步修改
      NUXT_AUTH_SECRET: "demo2026" # 前台登录加密使用的密钥 【自行修改！】
      NUXT_ENV: "development" # 如果使用公网+域名部署，建议改为 production，修改为 production 后只能通过 https 登录
    ports:
      - 9090:9090

```

4.  **启动记米粒服务：**

在 `docker-compose.yaml` 文件所在的目录，执行以下命令启动 Jimily 服务：

```bash
docker-compose up -d
```

### 三、系统初始化和使用

当所有服务正确启动后，您可以访问 Jimily 的Web界面进行初始化。

1.  **访问记米粒：**

打开您的浏览器，访问 `http://localhost:9090` (如果您修改了端口，请使用您设置的端口)。首次进入您将打开记米粒的初始化页面。

2.  **完成初始化设置：**

  -  根据提示完成基本信息维护。
  -  **创建管理员账号和密码。请务必牢记此管理员账号和密码，因为目前版本忘记密码后无法重置或修改！**

3.  **使用AI功能：**

进入系统后，作为管理员，您可以在 “**AI服务商管理**” 中配置AI服务商和模型。**必须完成这些配置，AI功能才能正常使用。**