安装指南
本指南介绍如何在系统上安装 IfAI 并完成首次使用配置。
系统要求
支持的平台
| 平台 | 最低版本 | 推荐版本 | 备注 |
|---|---|---|---|
| macOS | 11.0 (Big Sur) | 13.0+ (Ventura+) | 推荐使用 Apple Silicon 以获得最佳性能 |
| Windows | Windows 10 (64位) | Windows 11 | 仅支持 x64 架构 |
| Linux | Ubuntu 20.04、Debian 11、Fedora 35+ | 最新 LTS 版 | 提供 AppImage 格式 |
硬件要求
| 组件 | 最低配置 | 推荐配置 |
|---|---|---|
| 内存 | 8GB | 16GB+ |
| 存储空间 | 500MB（编辑器） | 2GB+（含本地模型） |
| GPU | 无要求 | 可选（用于本地 LLM 加速） |
| CPU | 双核 2.0GHz | 四核 2.5GHz+ |
软件依赖
IfAI 基础使用无需额外软件。如需从源码构建：
- Node.js 18.0+（用于从源码构建）
- Rust 1.70+（用于从源码构建）
- Git（用于克隆仓库）
安装方式
方式一：预构建版本（推荐）
这是开始使用 IfAI 最简单的方式。
macOS
- 从 发布页面 下载最新的
.dmg文件 - 打开下载的
.dmg文件 - 将 IfAI 拖拽到应用程序文件夹
- 从应用程序启动 IfAI
macOS 首次启动
如果看到"无法识别开发者"的警告，请右键点击应用并选择"打开"，然后在对话框中确认。
Windows
- 从 发布页面 下载最新的
.exe安装程序 - 运行安装程序
- 按照安装向导操作
- 从开始菜单启动 IfAI
Windows SmartScreen
如果 Windows Defender SmartScreen 对应用发出警告，请点击"更多信息"，然后选择"仍要运行"。
Linux
- 从 发布页面 下载最新的
.AppImage文件 - 为文件添加可执行权限：bash
chmod +x ifai-*.AppImage - 运行 AppImage：bash
./ifai-*.AppImage
在 Linux 上安装
要将 IfAI 添加到应用程序菜单，可以考虑使用 AppImageLauncher 或手动创建 .desktop 文件。
方式二：从源码构建
适合想要定制或为 IfAI 做贡献的开发者。
前置要求
bash
# 检查 Node.js 版本（必须是 18+）
node --version
# 检查 Rust 版本
rustc --version
# 如果未安装 Rust：
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh构建步骤
bash
# 克隆仓库
git clone https://github.com/peterfei/ifai.git
cd ifai/docs
# 安装依赖
npm install
# 开发模式
npm run dev
# 生产构建
npm run build
# 运行 Tauri 开发环境
npm run tauri:dev构建时间
首次构建可能需要 5-10 分钟，因为 Tauri 需要编译 Rust 后端。
首次启动
首次启动 IfAI 时，您将看到欢迎界面：
┌─────────────────────────────────────────────────────────┐
│ 欢迎使用 IfAI！ │
├─────────────────────────────────────────────────────────┤
│ │
│ 🎯 快速浏览界面功能 │
│ ⚙️ 配置 AI 提供商 │
│ 📂 选择工作区文件夹 │
│ │
│ [ 开始体验 ] [ 跳过教程 ] │
└─────────────────────────────────────────────────────────┘配置步骤
欢迎导览（2 分钟）
- 快速了解 IfAI 的功能
- 学习键盘快捷键
- 理解界面布局
AI 提供商配置
- 选择云端 API 或本地 LLM
- 输入 API 密钥（如使用云端服务）
- 选择首选模型
工作区选择
- 为您的项目选择一个文件夹
- IfAI 将索引您的代码以实现智能功能
验证安装
安装完成后，验证一切正常工作：
检查版本
使用命令栏（Cmd+Shift+P / Ctrl+Shift+P）并输入"IfAI: 显示版本信息"
测试 AI 连接
- 打开 AI 聊天（
Cmd+K/Ctrl+K） - 输入：
你好，能听到我吗？ - 您应该会收到回复
连接问题？
如果 AI 没有响应，请在设置（Cmd+, / Ctrl+,）中检查您的 API 密钥
更新 IfAI
自动更新
IfAI 会在启动时自动检查更新。当有新版本可用时，系统会提示您。
手动更新
- 检查更新：
Cmd+Shift+P> "IfAI: 检查更新" - 下载并安装最新版本
开发构建更新
bash
cd ifai
git pull origin main
npm install
npm run tauri build卸载
macOS
bash
# 首先退出 IfAI
rm -rf /Applications/IfAI.app
# 可选：删除用户数据
rm -rf ~/Library/Application\ Support/IfAIWindows
- 通过"添加或删除程序"卸载
- 可选删除用户数据：
%APPDATA%\IfAI
Linux
bash
# 删除 AppImage
rm ifai-*.AppImage
# 可选：删除用户数据
rm -rf ~/.config/IfAI安装故障排查
macOS："应用已损坏"错误
bash
# 移除隔离属性
xattr -cr /Applications/IfAI.appWindows：安装失败
- 暂时禁用防病毒软件
- 以管理员身份运行安装程序
- 检查 Windows Defender 排除项
Linux：AppImage 无法运行
bash
# 解压并直接运行
./ifai-*.AppImage --appimage-extract
./squashfs-root/ifai构建失败：Rust 错误
bash
# 更新 Rust 工具链
rustup update stable
# 清理后重新构建
cd ifai
rm -rf node_modules
npm install
cargo clean
npm run tauri build下一步
成功安装后：
需要帮助？
如果在安装过程中遇到任何问题，请查看我们的故障排查指南或在 GitHub 上提供建议。