AionUi 是一个免费、开源的本地图形界面应用程序,专为 Google Gemini CLI 设计。它将命令行界面的功能转化为现代化、易用的图形界面,解决 Gemini CLI 在文件管理、聊天记录保存和多任务处理方面的不足。AionUi 提供多会话聊天、文件树浏览、代码对比视图等功能,特别适合开发者提升工作效率。基于 Electron 和 React 构建,AionUi 支持跨平台运行,安装简单且支持多种认证方式。用户可以通过直观的界面管理文件、调用 Gemini API 功能,并享受流畅的 AI 交互体验。项目采用 Apache-2.0 许可证,欢迎社区贡献。
功能列表
- 多会话聊天:支持多个独立聊天会话,方便用户同时处理不同任务。
- 持久化聊天记录:所有对话自动保存在本地,关闭应用后不会丢失。
- 现代化聊天界面:提供类似消息应用的交互方式,操作直观。
- 可视化文件树:通过图形界面浏览和选择文件,简化文件管理。
- 文件上传:支持拖放上传文件,文件临时存储保证安全。
- 代码对比视图:支持文件修改的侧边对比,便于代码审查。
- Gemini API 集成:支持函数调用,扩展 AI 功能。
- Markdown 渲染:美化代码块和格式化内容显示。
- 简单配置:内置设置界面,支持快速配置 API 密钥。
使用帮助
安装流程
要使用 AionUi,用户需要先完成安装并配置环境。以下是详细步骤:
- 克隆仓库
在终端运行以下命令,下载 AionUi 源代码:git clone https://github.com/office-sec/AionUi.git
然后进入项目目录:
cd AionUi
- 安装依赖
使用 npm 安装必要的依赖项:npm install
- 配置 API 密钥
- 启动应用后,进入“设置”页面。
- 输入 Google Gemini API 密钥。
- 支持三种认证方式:
- Gemini API 密钥:直接输入 Gemini API 密钥。
- Vertex AI:使用 Google Cloud Vertex AI 认证。
- 个人认证:通过 OAuth 进行个人认证。
- 如果网络受限,可在设置中配置 HTTP 代理。
- 启动应用
运行以下命令启动 AionUi:npm start
- 构建应用(可选)
如果需要生成可执行文件,可以运行以下命令:- macOS(Apple Silicon):
npm run build-mac --arch=arm64
- macOS(Intel):
npm run build-mac --arch=x64
- Windows:
npm run build-win
- 所有平台:
npm run build
- macOS(Apple Silicon):
主要功能操作
1. 多会话聊天
- 打开 AionUi 后,点击左侧“新建会话”按钮创建新的聊天窗口。
- 每个会话独立运行,适合同时处理多个任务。例如,一个会话用于代码调试,另一个用于文档生成。
- 聊天记录自动保存,关闭应用后可重新打开继续查看。
2. 文件管理
- 在主界面左侧,点击“文件树”图标查看项目文件夹结构。
- 点击任意文件可将其内容快速加载到聊天窗口,供 AI 分析或处理。
- 支持拖放文件到指定区域,上传后文件会临时存储,处理完成后自动清理。
3. 代码对比视图
- 打开文件后,点击“代码对比”按钮,查看文件修改前后的差异。
- 界面显示侧边对比视图,修改内容高亮显示,适合代码审查和调试。
- 可直接在对比视图中向 AI 提问,获取修改建议。
4. Gemini API 功能调用
- 在聊天窗口中,选择“函数调用”选项,触发 Gemini API 的高级功能。
- 例如,输入“分析代码性能”或“生成测试用例”,AI 会返回详细结果。
- 支持 Markdown 格式,代码块和表格显示清晰。
5. 配置管理
- 在“设置”页面调整界面主题、字体大小或代理设置。
- 支持切换不同语言模型(目前仅支持 Gemini,未来将扩展)。
- 可保存多个 API 密钥,方便在不同模型间切换。
注意事项
- 确保网络连接稳定以访问 Gemini API。
- 检查 API 密钥的有效性,避免认证失败。
- 定期更新 AionUi 以获取最新功能和修复。
应用场景
- 代码开发
开发者可以使用 AionUi 进行代码审查、获取重构建议或修复 bug。例如,上传代码文件后,AI 可分析潜在错误并提供优化方案。 - 文档编写
AionUi 支持自动生成文档或总结报告。用户上传草稿后,AI 可快速生成格式化文档或提炼关键点。 - 数据分析
通过文件上传功能,用户可让 AI 处理数据文件,生成可视化图表或分析报告,适合快速验证数据假设。 - 项目管理
AionUi 可帮助规划任务和跟踪进度。例如,用户输入项目需求,AI 会生成任务清单或时间表。 - 学习辅助
学生或自学者可通过 AionUi 向 AI 提问,获取知识点解释或学习资源推荐。
QA
- AionUi 是否需要联网?
是的,AionUi 需要联网以访问 Gemini API,但聊天记录和文件存储在本地。 - 支持哪些平台?
AionUi 支持 Windows、macOS(包括 Apple Silicon 和 Intel),通过 Electron 实现跨平台兼容。 - 如何获取 Gemini API 密钥?
用户需访问 Google Cloud 平台,创建项目并启用 Gemini API,生成密钥后在 AionUi 设置中输入。 - AionUi 是否免费?
是的,AionUi 是完全免费的开源软件,基于 Apache-2.0 许可证。 - 如何贡献代码?
Fork 项目仓库,创建功能分支,提交更改后推送至远程仓库,然后提交 Pull Request。