常见问题

关于 IfAI 的常见问题和解答。

常规

什么是 IfAI？

**IfAI（若爱）**是一个为 AI 时代设计的 AI 原生代码编辑器。与将 AI 作为事后补充的传统编辑器不同，IfAI 的核心就内置了 AI 能力。

主要功能：

• AI 聊天，用于自然语言编码辅助
• Composer 多文件 AI 编辑
• 本地 LLM 支持以保护隐私
• 符号感知的代码理解
• 支持 35+ 种语言

IfAI 与 VS Code 有何不同？

方面	IfAI	VS Code
AI 集成	内置于核心	基于插件（Copilot）
本地 LLM	原生支持	不支持
多文件 AI	Composer 功能	有限
符号感知	深度代码理解	基本 LSP
性能	目标 120 FPS	60 FPS

IfAI 是开源的吗？

是的！IfAI 在 MIT 许可下发布。源代码可在 GitHub 上获取。

安装和设置

系统要求？

平台	最低	推荐
macOS	11.0+	13.0+ (Apple Silicon)
Windows	Windows 10	Windows 11
Linux	Ubuntu 20.04+	最新 LTS
RAM	8GB	16GB+
存储空间	500MB	2GB+（含本地模型）

如何安装 IfAI？

1. 从发布页面下载
2. 为您的平台安装
3. 启动并配置 AI 提供商

详细说明请参见安装指南。

首次启动设置？

首次启动时，IfAI 将：

1. 显示欢迎导览（2 分钟）
2. 提示配置 AI 提供商
3. 要求选择工作区

您可以跳过导览并稍后在设置中配置。

AI 功能

哪些 AI 模型效果最好？

用例	推荐模型
通用编码	GPT-4、Claude 3.5 Sonnet
中文内容	GLM-4.7
成本效益	DeepSeek-V3
隐私	Qwen2.5-Coder（本地）

我可以使用多个 AI 提供商吗？

可以！在设置中配置多个提供商：

• 设置主要提供商
• 设置后备提供商
• 启用自动切换

IfAI 将根据以下内容自动路由请求：

• 任务复杂度
• 本地模型可用性
• API 速率限制

上下文如何工作？

IfAI 自动包含：

• 当前文件
• 最近查看的文件
• 符号关系
• 项目结构

您可以：

• 添加特定文件："查看 auth.ts 和 api.ts"
• 通过上下文栏删除上下文
• 在设置中调整上下文消息数量

隐私问题？

云端提供商：代码被发送到外部服务器

• 检查提供商隐私政策
• 避免敏感数据（API 密钥、密码）

本地模型：一切保留在您的机器上

• 没有数据离开您的设备
• 最适合敏感项目

私人 AI 请参见本地模型配置。

本地 LLM 要求？

模型	最小 RAM	推荐 RAM
0.5B	2GB	4GB
3B	5GB	8GB
7B	8GB	16GB

Apple Silicon Mac 为本地模型提供最佳性能。

代码编辑

Composer 如何工作？

Composer 是 IfAI 的多文件 AI 编辑：

1. 打开 Composer：Cmd+Shift+K
2. 描述所需的更改
3. AI 跨文件提出更改
4. 审查并接受/拒绝每个更改

详情请参见Composer 指南。

我可以撤消 AI 更改吗？

可以！

• 立即撤消：Cmd+Z
• 关闭后：Git 回退
• Composer：应用前接受/拒绝

版本控制集成？

是的！IfAI 与 Git 集成：

• 文件树中的视觉差异
• 通过命令栏提交
• AI 生成的提交消息

AI: 为这些更改创建提交消息

性能

文件加载缓慢？

可能原因：

• 大型项目索引
• 系统资源不足
• 防病毒扫描

解决方案：

1. 等待初始索引完成
2. 从防病毒软件中排除项目
3. 减少工作区大小

内存使用量高？

正常范围：

• 空闲：~200MB
• 小型项目：~500MB
• 大型项目：1-2GB

如果过高：

1. 重启 IfAI
2. 清除缓存：Cmd+Shift+P > "清除缓存"
3. 关闭未使用的文件
4. 检查内存泄漏

界面卡顿？

解决方案：

1. 检查设置中的性能模式
2. 禁用小地图
3. 减小字体大小
4. 更新到最新版本

故障排查

AI 无响应？

检查：

1. 设置中的 API 密钥
2. 网络连接
3. 提供商状态页面
4. Ollama 正在运行（如果使用本地）

尝试：

1. 切换提供商
2. 使用更简单的提示词测试
3. 检查错误日志：Cmd+Shift+P > "显示日志"

启动时崩溃？

解决方案：

1. 更新到最新版本
2. 重置设置：删除 settings.json
3. 检查系统要求
4. 使用崩溃日志报告问题

符号未索引？

解决方案：

1. 等待索引完成
2. 检查语言是否支持
3. 重新索引：Cmd+Shift+P > "重新索引项目"
4. 验证文件没有语法错误

终端问题？

PATH 未找到：

# 检查 shell 配置
echo $PATH
source ~/.zshrc  # 或 ~/.bashrc

命令不工作：

1. 检查设置中是否配置了 shell
2. 尝试不同的 shell（bash/zsh）
3. 重置终端设置

技巧和窍门

隐藏功能？

• 截图分析：在 AI 聊天中粘贴图片（Cmd+V）
• 文件上下文：AI 读取您提到的文件
• 斜杠命令：/explain、/fix、/test
• 行内 AI：选择代码，按 Cmd+K

高级用户技巧？

1. 自定义键绑定：匹配您的肌肉记忆
2. 混合 AI：本地求速度，云端求质量
3. 上下文优化：包含 3-5 个相关文件
4. Git 集成：在主要 AI 更改之前提交

工作流程优化？

用于开发：

1. 先编写测试
2. 使用 AI 实现
3. 运行测试
4. 使用 AI 修复失败

用于学习：

1. 选择不熟悉的代码
2. 要求 AI 解释
3. 请求示例
4. 用问题迭代

获取帮助

在哪里获得支持？

• 文档：docs.ifai.dev
• GitHub 问题：报告错误
• GitHub 讨论：提问

如何报告错误？

包括：

• IfAI 版本：Cmd+Shift+P > "显示版本"
• 操作系统和版本
• 重现步骤
• 预期与实际行为
• 错误日志（编辑敏感信息）

功能请求？

我们欢迎建议！

1. 先检查现有问题
2. 使用 GitHub 问题
3. 描述用例
4. 解释为什么重要

下一步

• 安装 - 开始使用 IfAI
• 基础使用 - 学习核心功能
• 故障排查 - 解决常见问题