AionUI 图形工作台
Gemini CLI 用着挺好，就是黑窗口让人头疼？AionUI 就是给 Gemini CLI 套了个图形化外壳——对话、文件编辑、多会话切换，全在一个窗口里。
接入平台填写口径
- Base URL：
https://www.yuzhixiaolongxia.com/（末尾必须带斜杠） - API Key：你的平台令牌（建议从
/console/token复制 Gemini 家族对应的令牌） - Model：例如
gemini-3.1-pro-preview，去 模型广场 复制
AionUI 是什么
AionUI 是 Gemini CLI 的图形化前端。
- 后端跑的还是 Gemini CLI（同样的能力、同样的协议）
- 前端换成了图形界面：左侧会话列表、中间对话区、右侧文件预览 / 编辑器
- 支持多会话并行、文件直接拖进对话、对话历史本地存储
它适合谁：
- 想用 Gemini，但不喜欢命令行
- 经常需要对着文件和 AI 一起改
- 多个对话并行（一个写代码、一个分析文档）
它不适合谁：
- 你压根不用 Gemini（用 Claude 就去用 Claude Code / Cowork）
- 服务器无头环境（AionUI 是桌面 GUI）
安装
macOS
去 AionUI 的 GitHub Releases 页面下载最新的 .dmg，双击安装；或者用 Homebrew：
brew install --cask aionuiWindows
下载 .exe 安装包，双击安装即可。
Linux
下载 .deb（Debian / Ubuntu）或 .AppImage（通用）。
sudo dpkg -i aionui_*.deb找不到下载链接
打开 AionUI 的 GitHub 仓库 → Releases 标签 → 最新版本下面的 Assets 列表，按系统选对应文件。
配置平台接入
第一步：打开设置
启动 AionUI → 右上角设置图标 → LLM Configuration / 模型配置。
第二步：选 Custom Provider
在提供商下拉里选 Custom Endpoint（自定义端点）。
第三步：填三个字段
| 字段 | 填什么 |
|---|---|
| API Endpoint / Base URL | https://www.yuzhixiaolongxia.com/（末尾斜杠不能省） |
| API Key | 你的平台令牌（Gemini 家族） |
| Model | 例如 gemini-3.1-pro-preview |
Gemini 协议的 Base URL 末尾必须带斜杠
https://www.yuzhixiaolongxia.com 和 https://www.yuzhixiaolongxia.com/ 在 Gemini 协议下是两回事。
末尾的 / 是必填的，少一个就会 404 或 model not found。
第四步：保存并测试
保存设置 → 回到主界面新建一个会话 → 发 回复 OK → 看到正常回复就完成了。
进阶用法
多模型切换
在 AionUI 里可以配置多个 Provider，例如同时配 Gemini 3.1 Pro 和 Gemini 3 Flash，对话时随时切换。
文件预览 / 编辑
把文件拖进对话区，AionUI 会在右侧自动开预览面板，支持 PDF、Word、Excel、代码文件、Markdown 等十几种格式。AI 可以直接对文件做摘要、提取、重写。
本地存储
所有对话记录默认存在本地 SQLite 数据库（位置在用户目录下的 .aionui/ 文件夹），完全不上传第三方。
常见问题
404 Not Found
90% 是 Base URL 末尾少了斜杠。改成 https://www.yuzhixiaolongxia.com/ 重试。
model not found
模型 ID 填错。去 模型广场 左侧选 Gemini 家族，右边复制 ID。
401 Unauthorized
令牌问题。回 /console/token 确认：
- 令牌的分组是 Gemini 家族
- 令牌没过期、额度没耗尽
- 复制时没有混入多余空格
想用 Claude / GPT 怎么办
AionUI 主打 Gemini。如果想用 Claude / GPT，建议看 Hermes 或回 AI 工具接入 章节里的 Claude Code / Codex CLI。
上一步：进阶玩法总览 | 下一步：OpenCode 编程助手