AionUi命令行工具使用指南：高级用户必备技巧

【免费下载链接】AionUi Free, local, open-source GUI app for Gemini CLI, Claude Code, Codex, Qwen Code, and more — Enhanced Chat UI, WebUI, Multi-Agent & Multi-LLM, MCP Integration | 🌟 Star if you like it! 项目地址: https://gitcode.com/GitHub_Trending/ai/AionUi

AionUi是一款免费、本地运行的开源GUI应用，专为Gemini CLI、Claude Code、Codex、Qwen Code等AI模型打造。它提供增强的聊天界面、WebUI、多智能体和多LLM支持，以及MCP集成功能。本指南将深入探讨AionUi命令行工具的高级使用技巧，帮助高级用户充分利用AionUi的强大功能。

快速安装与基础配置

要开始使用AionUi命令行工具，首先需要克隆仓库并安装依赖：

git clone https://gitcode.com/GitHub_Trending/ai/AionUi
cd AionUi
npm install

安装完成后，你可以通过以下命令启动AionUi：

npm start

AionUi的配置文件位于不同位置，根据作用域分为系统、用户和工作区三个级别：

• 系统设置：/etc/aioncli/settings.json（Linux）、C:\ProgramData\aioncli\settings.json（Windows）或/Library/Application Support/aioncli/settings.json（macOS）
• 用户设置：~/.gemini/settings.json
• 工作区设置：{工作区目录}/.gemini/settings.json

这些配置文件采用JSON格式，可以通过编辑这些文件来自定义AionUi的行为。

高级命令行技巧

文件引用与内容加载

AionUi命令行工具支持通过@符号引用文件，这在处理代码文件时特别有用。例如：

gemini "分析@src/agent/gemini/cli/tools/tools.ts文件的结构"

这个命令会自动加载指定文件的内容，并将其作为上下文传递给AI模型。AionUi会处理文件路径解析、内容读取和截断，确保不会超出模型的上下文限制。

懒加载模式提高效率

对于大型项目，一次性加载所有文件可能会导致性能问题。AionUi提供了懒加载模式，只传递文件路径提示给AI，让AI自主决定何时使用read_file工具读取文件内容：

gemini --lazy-file-loading "分析我的项目结构并提供改进建议"

这种方式可以显著提高处理大型项目时的效率，减少不必要的文件读取和处理。

自定义工具调用

AionUi允许用户通过配置文件自定义工具调用行为。你可以在设置中指定要包含或排除的工具：

{
  "coreTools": ["read_file", "write_file", "execute_command"],
  "excludeTools": ["delete_file"]
}

这个配置指定了核心工具和要排除的工具，这样AI在决策时就只会考虑允许的工具。

多模型集成与切换

AionUi支持多种AI模型，你可以在命令行中直接指定要使用的模型：

gemini --model "google/gemini-2.5-pro" "生成一个React组件示例"

你还可以在设置文件中配置默认模型和模型参数：

{
  "model": "google/gemini-2.5-pro",
  "sampling_params": {
    "temperature": 0.7,
    "top_p": 0.95
  }
}

工作区管理与扩展

AionUi支持多工作区管理，你可以为不同的项目创建独立的工作区：

gemini --workspace ~/projects/my-project "分析当前项目的依赖关系"

此外，AionUi还支持通过扩展来自定义功能。扩展可以在以下位置找到：

• 用户扩展：~/.gemini/extensions
• 工作区扩展：{工作区目录}/.gemini/extensions

你可以通过命令行启用或禁用特定扩展：

gemini --enable-extension "code-review" " review this code"

高级配置与优化

性能优化设置

你可以通过调整设置来优化AionUi的性能：

{
  "autoConfigureMaxOldSpaceSize": true,
  "maxSessionTurns": 50,
  "sessionTokenLimit": 8000
}

这些设置可以帮助AionUi更好地管理内存使用和对话历史，确保在处理大型项目时保持良好的性能。

自定义主题与外观

AionUi支持自定义主题，你可以在设置中定义自己的主题：

{
  "theme": "custom",
  "customThemes": {
    "custom": {
      "primaryColor": "#4a6fa5",
      "secondaryColor": "#8d6e63",
      "backgroundColor": "#f5f5f5",
      "textColor": "#333333"
    }
  }
}

故障排除与高级技巧

日志与调试

当遇到问题时，你可以启用详细日志来帮助诊断：

gemini --debug "你的查询"

日志文件通常位于~/.gemini/logs目录下。

处理大型文件

对于非常大的文件，AionUi提供了自动截断功能，但你也可以手动指定要加载的文件部分：

gemini "分析@src/agent/gemini/cli/atCommandProcessor.ts#L148-L200这段代码"

这种方式可以只加载文件的特定部分，提高处理效率。

使用环境变量

AionUi可以读取环境变量来配置敏感信息，如API密钥：

export GEMINI_API_KEY="your_api_key"
gemini "使用Gemini API生成图像"

你也可以在.env文件中设置这些变量，AionUi会自动加载它们。

通过掌握这些高级技巧，你可以充分利用AionUi命令行工具的强大功能，提高工作效率。无论是处理大型项目、自定义AI行为，还是优化性能，AionUi都能为你提供灵活而强大的支持。

【免费下载链接】AionUi Free, local, open-source GUI app for Gemini CLI, Claude Code, Codex, Qwen Code, and more — Enhanced Chat UI, WebUI, Multi-Agent & Multi-LLM, MCP Integration | 🌟 Star if you like it! 项目地址: https://gitcode.com/GitHub_Trending/ai/AionUi