跳到主要内容

安装指南

本指南将帮助您在本地安装和运行 AIME Chat。

普通用户安装​

如果您只是想使用 AIME Chat，可以直接下载预编译的安装包，无需进行源码编译。

下载安装包​

请访问 GitHub Releases，根据您的操作系统和 CPU 架构下载对应的安装包：

  • macOS: Apple Silicon（M 系列）选择 arm64，Intel Mac 选择 x64 的 .dmg。macOS 版本暂不支持自动更新。
  • Windows: 下载 .exe 安装程序
  • Linux: 根据机器架构下载 amd64 或 arm64 的 .deb 安装包

安装步骤​

macOS​

  1. 下载 .dmg 文件
  2. 双击打开，将 AIME Chat 拖拽到应用程序文件夹
  3. 在应用程序中启动 AIME Chat
注意

首次启动时，如果系统提示"无法验证开发者"，请在系统偏好设置 > 安全性与隐私中点击"仍要打开"。

macOS 版本暂不支持自动更新。首次安装时如果系统提示文件损坏，请在终端执行：

xattr -cr /Applications/aime-chat.app

然后重新打开 AIME Chat。

Windows​

  1. 下载 .exe 安装程序
  2. 双击运行安装程序
  3. 按照安装向导完成安装
  4. 从开始菜单启动 AIME Chat

Linux​

# x64 / amd64 示例
sudo dpkg -i aime-chat-amd64-linux.deb

# ARM64 示例
sudo dpkg -i aime-chat-arm64-linux.deb

# 如果遇到依赖问题，运行
sudo apt-get install -f

当前源码中的 Linux 打包配置只生成 Debian 安装包，不生成 AppImage。其他 Linux 发行版需要自行处理 .deb 兼容性或从源码构建。

操作系统支持​

操作系统支持版本
macOS10.15+ (Catalina 及以上)
WindowsWindows 10/11
LinuxDebian/Ubuntu 系，x64 或 ARM64

开发者安装​

如果您想参与 AIME Chat 的开发或从源码构建，请按照以下步骤操作。

系统要求​

在开始之前，请确保您的系统满足以下要求：

  • Node.js >= 22.x
  • npm >= 10.x
  • pnpm >= 10.x
  • Git

1. 克隆项目​

git clone https://github.com/DarkNoah/aime-chat.git
cd aime-chat

2. 安装依赖​

推荐使用 pnpm：

pnpm install
提示

首次安装可能需要较长时间，因为需要下载 Electron 和编译原生模块。由于 pnpm 默认可能限制依赖脚本，如果遇到二进制包缺失或原生模块初始化异常，可以执行 pnpm approve-builds 后再重试安装。

3. 开发调试​

当前仓库的开发调试入口以 VSCode 配置为主：

  • 安装依赖后打开 VSCode 调试面板
  • 选择 Electron: Main（需要同时附加主进程与渲染进程时选择 Electron: All）
  • 启动调试任务

也可以使用仓库脚本启动开发环境：

pnpm start

构建生产版本​

在当前平台构建安装包：

pnpm package

打包完成后，安装包会生成在 release/build 目录下。

构建兼容 GLIBC 2.28 的 Linux ARM64 包​

仓库提供了基于 Docker Buildx 的 ARM64 Debian 打包流程，适合在 Apple Silicon Mac 或其他支持 linux/arm64 构建的平台上使用。

前置条件：

  • Docker Desktop/Engine 已启动
  • Docker Buildx 可用
  • 能够访问构建所需的容器镜像与依赖源
pnpm package:linux-arm64

# 需要完全跳过 Docker 构建缓存时
pnpm package:linux-arm64 -- --no-cache

脚本默认检查产物所需的 GLIBC 不高于 2.28、GLIBCXX 不高于 3.4.25，并把 .deb、SHA-256、包信息和 ELF 兼容性报告写入 release/build。

验证边界

兼容性报告用于约束构建产物引用的符号版本，但不能替代在目标 Linux 发行版上的实际安装与启动测试。

数据存储位置​

应用数据默认存储在系统用户目录：

操作系统路径
macOS~/Library/Application Support/aime-chat
Windows%APPDATA%/aime-chat
Linux~/.config/aime-chat

下一步​

安装完成后，您可以：