跳到主要内容

安装指南

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

普通用户安装​

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

下载安装包​

请访问 文档主页，根据您的操作系统下载对应的安装包：

  • macOS: 下载 .dmg 安装包。macOS 版本暂不支持自动更新；首次安装如提示文件损坏，请在终端执行 xattr -cr /Applications/aime-chat.app 后再打开。
  • Windows: 下载 .exe 安装程序
  • Linux: 下载 .AppImage 或 .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​

AppImage 版本（推荐）：

# 添加执行权限
chmod +x aime-chat-x.x.x-linux.AppImage

# 运行应用
./aime-chat-x.x.x-linux.AppImage

Deb 包版本：

# 安装 deb 包
sudo dpkg -i aime-chat-x.x.x-linux.deb

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

操作系统支持​

操作系统支持版本
macOS10.15+ (Catalina 及以上)
WindowsWindows 10/11
LinuxUbuntu 20.04+, Fedora 34+ 等

开发者安装​

如果您想参与 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
  • 启动调试任务

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

pnpm start

构建生产版本​

pnpm package

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

数据存储位置​

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

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

下一步​

安装完成后，您可以：