设置参考

配置 IfAI 以匹配您的工作流程和偏好的完整指南。

打开设置

方法

方法	快捷键	描述
键盘	Cmd+,（Mac）/ Ctrl+,（Win/Linux）	快速访问
菜单	IfAI > 设置（Mac）/ 文件 > 设置（Win/Linux）	菜单导航
命令栏	Cmd+Shift+P > "设置"	基于搜索

设置类别

AI 提供商

配置 AI 模型和提供商。

云端提供商

OpenAI

• API 密钥：必需
• 基础 URL：https://api.openai.com/v1（默认）
• 模型：GPT-4、GPT-4 Turbo、GPT-3.5 Turbo
• 组织 ID：可选

Anthropic (Claude)

• API 密钥：必需
• 基础 URL：https://api.anthropic.com（默认）
• 模型：Claude 3.5 Sonnet、Claude 3 Opus
• 版本：2023-06-01（默认）

DeepSeek

• API 密钥：必需
• 基础 URL：https://api.deepseek.com（默认）
• 模型：DeepSeek-V3、DeepSeek-Coder

智谱 AI

• API 密钥：必需
• 基础 URL：https://open.bigmodel.cn/api/paas/v4（默认）
• 模型：GLM-4.7、GLM-4.6、GLM-4.5V

Kimi (Moonshot)

• API 密钥：必需
• 基础 URL：https://api.moonshot.cn（默认）
• 模型：Moonshot-v1-8k、Moonshot-v1-32k

本地模型

Ollama

• URL：http://localhost:11434（默认）
• 自动检测模型：是
• 自定义模型：支持

本地模型

详细配置请参见本地模型配置。

AI 设置

设置	选项	默认值	描述
Temperature	0.0 - 2.0	0.7	响应创造力
最大令牌	1 - 128000	4096	最大响应长度
Top P	0.0 - 1.0	0.9	核采样
流式响应	是/否	是	生成时显示响应
上下文消息	0 - 20	5	包含在上下文中的消息

编辑器

自定义编辑体验。

外观

设置	选项	默认值
主题	深色、浅色、高对比度	深色
字体系列	系统字体	Monaco（Mac）、Consolas（Win）
字体大小	10 - 24	14
行高	1.0 - 2.0	1.5
字体连字	是/否	是

功能

设置	选项	默认值
行号	开、关、相对	开
自动换行	开、关	关
小地图	是/否	是
面包屑	是/否	是
渲染空白	是/否	否
括号对颜色	是/否	是

行为

设置	选项	默认值
制表符大小	2、4、8	2
插入空格	是/否	是
自动保存	延迟后、焦点变化时、关	延迟后
自动保存延迟	100 - 10000 ms	1000
保存时格式化	是/否	是

键绑定

选择您喜欢的键盘快捷键方案。

方案	描述
IfAI	默认快捷键，为 IfAI 优化
VS Code	与 VS Code 兼容
IntelliJ IDEA	JetBrains 风格快捷键
Vim	Vim 模式（实验性）

另请参阅

键盘快捷键 完整参考。

终端

配置集成终端设置。

设置	选项	默认值
Shell	默认、自定义	默认
Shell 路径	Shell 的路径	自动检测
字体大小	10 - 24	13
行高	1.0 - 2.0	1.2
光标样式	块、下划线、条	块

文件管理

文件处理设置。

设置	选项	默认值
自动猜测编码	是/否	是
默认编码	UTF-8、UTF-16 等	UTF-8
修剪尾随空白	是/否	否
插入最终换行	是/否	是
排除文件	Glob 模式	.git、node_modules、dist

Git 集成

版本控制设置。

设置	选项	默认值
已启用	是/否	是
自动刷新	是/否	是
提交前确认	是/否	是
签名提交	是/否	否

Agent 设置

配置自主 agent 行为。

设置	选项	默认值
自动批准	是/否	否
自然语言触发	是/否	是
触发置信度	0.0 - 1.0	0.7
最大工具调用	1 - 100	10

RAG 设置

检索增强生成配置。

设置	选项	默认值
自动 RAG	是/否	是
智能 RAG	是/否	是
RAG 模式	自动、手动、始终	自动
最大上下文文件	1 - 20	5

性能

为您的机器优化性能。

设置	选项	默认值
性能模式	平衡、省电、性能	平衡
目标 FPS	30、60、120	60
GPU 加速	是/否	自动
自动降级	是/否	是

配置文件

对于高级用户，可以直接编辑设置。

位置

平台	路径
macOS	~/Library/Application Support/IfAI/settings.json
Windows	%APPDATA%\IfAI\settings.json
Linux	~/.config/IfAI/settings.json

配置示例

{
  "editor": {
    "fontSize": 14,
    "theme": "dark",
    "tabSize": 2,
    "wordWrap": false
  },
  "ai": {
    "provider": "openai",
    "model": "gpt-4",
    "temperature": 0.7,
    "maxTokens": 4096
  },
  "keybindings": "ifai",
  "terminal": {
    "fontSize": 13
  }
}

同步设置

Git 存储

将设置存储在 Git 中以跨机器同步：

# 将设置提交到仓库
git add .vscode/settings.json
git commit -m "添加 IfAI 设置"

导出/导入

设置 > 导出设置 > 保存到文件
设置 > 导入设置 > 从文件加载

重置设置

重置为默认值

设置 > 全部重置设置

选择性重置

1. 打开设置类别
2. 点击"重置为默认值"按钮
3. 确认重置

先备份

重置前请导出设置以保留您的配置。

技巧和窍门

不同用例的推荐设置

Web 开发

{
  "editor": {
    "formatOnSave": true,
    "tabSize": 2
  },
  "ai": {
    "provider": "openai",
    "model": "gpt-4"
  }
}

Python 开发

{
  "editor": {
    "tabSize": 4,
    "insertSpaces": true
  },
  "ai": {
    "provider": "anthropic",
    "model": "claude-3.5-sonnet"
  }
}

本地开发（隐私）

{
  "ai": {
    "provider": "ollama",
    "model": "qwen2.5-coder:3b"
  },
  "rag": {
    "autoRAG": true
  }
}

下一步

• 安装 - 首次设置
• 本地模型配置 - 配置本地模型
• 键盘快捷键 - 自定义键绑定
• 基础使用 - 核心功能和工作流程