# AionUi

**Repository Path**: tsingfu/AionUi

## Basic Information

- **Project Name**: AionUi
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-27
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="./resources/aionui_readme_header_0807.png" alt="AionUi Logo" width="100%">
</p>

<p align="center">
  <img src="https://img.shields.io/github/v/release/iOfficeAI/AionUi?style=flat-square&color=32CD32" alt="Version">
  &nbsp;
  <img src="https://img.shields.io/badge/license-Apache--2.0-32CD32?style=flat-square&logo=apache&logoColor=white" alt="License">
  &nbsp;
  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-6C757D?style=flat-square&logo=linux&logoColor=white" alt="Platform">
  &nbsp;
  <img src="https://img.shields.io/badge/Electron-37.2.0-007ACC?style=flat-square&logo=electron&logoColor=white" alt="Electron">
  &nbsp;
  <img src="https://img.shields.io/badge/React-19.1.0-FF6B35?style=flat-square&logo=react&logoColor=white" alt="React">
</p>

---

<p align="center">
  <strong>将命令行体验转换为现代、高效的 AI 聊天界面。</strong>
</p>

<p align="center">
  <a href="./readme.md">English</a> | <strong>简体中文</strong> | <a href="./readme_jp.md">日本語</a> |<a href="https://www.aionui.com" target="_blank">官网</a> | <a href="https://twitter.com/AionUI" target="_blank">Twitter</a>
</p>

## 🚀 **AionUi 可以做什么？**

### 📁 **整理您的文件**
*批量重命名、自动整理、智能分类、文件合并*
<p align="center">
  <img src="./resources/sort_out_folder.gif" alt="文件管理演示" width="800">
</p>

### 📊 **让 Excel 更智能**
*AI 帮你创建、整理、分析、美化 Excel 文件*
<p align="center">
  <img src="./resources/generate_xlsx.gif" alt="Excel 处理演示" width="800">
</p>

### 💬 **同时处理多个任务**
*开多个对话、任务不混乱、记忆独立、效率翻倍*
<p align="center">
  <img src="./resources/multichat-side-by-side.gif" alt="对话管理演示" width="800">
</p>

---

**这只是 AionUi 能力的冰山一角！** 🚀

想要探索更多功能？继续往下看，你会发现 AionUi 还能帮你：
- 🎯 写代码、写文档、分析数据
- 🗂️ 学习新知识、解答问题、翻译文本
- ⚡ 以及更多日常工作和学习场景

## 📋 目录

- [🤔 为什么需要 AionUi？](#-为什么需要-aionui)
- [🚀 AionUi 可以做什么？](#-aionui-可以做什么？)
- [✨ 核心功能](#-核心功能)
  - [💬 更好的聊天体验](#-更好的聊天体验)
  - [🗂️ 文件管理更简单](#-文件管理更简单)
  - [⚡ 开发效率提升](#-开发效率提升)
  - [🔧 设置很简单](#-设置很简单)
- [🚀 快速开始](#-快速开始)
  - [📥 下载](#-下载)
  - [📋 系统要求](#-系统要求)
  - [🔧 安装](#-安装)
  - [🏗️ 构建应用](#️-构建应用)
- [🛠️ 技术栈](#️-技术栈)
- [📁 项目结构](#-项目结构)
- [🎯 使用场景](#-使用场景)
- [🔧 配置](#-配置)
  - [🔑 API 配置](#-api-配置)
  - [🌐 代理配置](#-代理配置)
- [🚀 未来畅想](#-未来畅想)
  - [🤖 多种 AI 助手](#-多种-ai-助手)
  - [🔄 灵活的 AI 模型选择](#-灵活的-ai-模型选择)
  - [🎯 让 AI 智能体触手可及](#-让-ai-智能体触手可及)
- [📄 许可证](#-许可证)
- [🤝 贡献](#-贡献)

---

## 🤔 为什么需要 AionUi？

虽然官方的 Gemini CLI 功能强大，但其命令行界面在日常使用中存在一些限制。AionUi 提供了一个 GUI 替代方案来解决这些关键痛点：

> - 使用 `@` 命令来选择文件比较麻烦
> - 关闭 CLI 窗口后对话就会丢失
> - 命令行界面缺乏自然的聊天交互
> - 单对话模式限制了并行工作流
> - 只能使用 Gemini 模型，无法利用其他优秀的大语言模型

AionUi 为需要更好工作流效率的用户提供了现代界面，同时**打破了单一模型的限制**，让您可以根据不同任务需求选择最适合的 AI 模型。

## ✨ 核心功能

### 💬 **更好的聊天体验**

- **多会话管理** - 同时开多个聊天，互不干扰
- **永久保存** - 所有对话都保存在本地，不会丢失
- **现代界面** - 像微信一样的聊天界面，操作简单
- **多模型支持** - 不只是 Gemini，还能用其他 AI 模型

### 🗂️ **文件管理更简单**

- **文件树浏览** - 像文件夹一样浏览文件，点击就能用
- **文件上传** - 拖拽上传文件，AI 帮你处理
- **代码对比** - 文件修改前后对比，一目了然
- **智能整理** - AI 帮你整理文件夹，自动分类
- **Excel 处理** - AI 帮你创建和修改 Excel 文件

### ⚡ **开发效率提升**

- **函数调用** - 完整的 Gemini API，功能更强大
- **代码渲染** - 代码块显示更美观，格式更清晰
- **工具调度** - 自动选择最合适的工具，不用手动选择

### 🔧 **设置很简单**

- **多平台支持** - 支持 Gemini、OpenAI、ModelScope、OpenRouter 等
- **灵活配置** - 每个平台可以配置多个模型，支持自定义地址
- **登录方便** - 支持 Google 账号登录，不用记 API 密钥
- **自动修复** - 自动检测并修复配置问题，不用手动调试

## 🚀 快速开始

### 📥 下载

准备试用 AionUi？从我们的发布页面下载适合您平台的最新版本：

<p>
  <a href="https://github.com/iOfficeAI/AionUi/releases">
    <img src="https://img.shields.io/badge/下载-最新版本-32CD32?style=for-the-badge&logo=github&logoColor=white" alt="下载最新版本">
  </a>
</p>

### 📋 系统要求

- Node.js >= 16.0.0
- npm >= 8.0.0
- Google Gemini API 密钥 ([获取您的 API 密钥](https://aistudio.google.com/app/apikey))

### 🔧 安装

1. **克隆仓库**

   ```bash
    git clone https://github.com/iOfficeAI/AionUi.git
    cd AionUi
   ```

2. **安装依赖**

   ```bash
   npm install
   ```

3. **配置 API 密钥**

   - 打开应用程序并进入设置
   - 输入您的 Google Gemini API 密钥
   - 支持多种认证方式：Gemini API 密钥、Vertex AI、个人认证

4. **启动应用程序**
   ```bash
   npm start
   ```

### 🏗️ 构建应用

```bash
# 构建 macOS 版本
npm run build-mac --arch=arm64  # Apple Silicon
npm run build-mac --arch=x64    # Intel

# 构建 Windows 版本
npm run build-win

# 构建所有平台
npm run build
```

## 🛠️ 技术栈

- **桌面应用**: Electron 37.2.0
- **前端框架**: React 19.1.0
- **UI 组件库**: Arco Design Web React
- **AI 引擎**: Google Gemini CLI Core
- **样式框架**: UnoCSS
- **构建工具**: Webpack + TypeScript
- **图标库**: IconPark React

## 📁 项目结构

```
AionUI/
├── src/
│   ├── adapter/          # 适配器层
│   ├── agent/           # AI 代理
│   │   └── gemini/      # Gemini AI 集成
│   ├── common/          # 通用模块
│   ├── process/         # 主进程
│   ├── renderer/        # 渲染进程
│   │   ├── components/  # UI 组件
│   │   ├── conversation/# 对话相关
│   │   └── messages/    # 消息处理
│   └── worker/          # 工作进程
├── config/              # 配置文件
├── public/              # 静态资源
└── package.json
```

## 🎯 使用场景

- **代码开发**: 代码审查、重构建议、错误修复
- **文档编写**: 自动文档生成、报告摘要
- **数据分析**: 数据可视化、分析报告
- **项目管理**: 任务规划、进度跟踪
- **学习助手**: 知识问答、概念解释
- **日常办公**: 邮件写作、会议记录、工作总结
- **学习提升**: 外语学习、技能培训、知识整理
- **创意工作**: 文案创作、头脑风暴、灵感收集
- **多模型协作**: 根据任务特点选择最适合的 AI 模型
  - **Gemini**: 代码生成、技术文档
  - **OpenAI**: 创意写作、内容创作
  - **ModelScope**: 中文理解、本地化任务
  - **OpenRouter**: 成本优化、模型对比



## 🔧 配置

### 🔑 API 配置

支持多种认证方式和平台：

1. **Gemini 平台**:
   - Gemini API 密钥: 直接使用 Gemini API
   - Vertex AI: 使用 Google Cloud Vertex AI
   - 个人认证: OAuth 个人认证

2. **其他平台**:
   - **OpenAI 兼容**: 支持任何兼容 OpenAI API 的服务
   - **ModelScope**: 支持阿里云 ModelScope 平台
   - **OpenRouter**: 支持 OpenRouter 聚合平台
   - **自定义平台**: 支持自定义 API 端点和模型

### 🌐 代理配置

支持 HTTP 代理配置，适用于网络受限环境。

## 🚀 未来畅想

我们设想 AionUi 将发展成为一个**通用智能体平台**，让普通用户也能使用强大的 AI 智能体来处理日常工作：

### 🤖 **多种 AI 助手**

- **终端助手**：从 Gemini CLI 开始，以后还会支持更多终端工具
- **浏览器助手**：集成开源的网页自动化工具，帮你处理网页任务
- **统一界面**：所有 AI 助手都用同一个简单的聊天界面
- **轻松发现**：新推出的 AI 助手可以轻松找到并使用

### 🔄 **灵活的 AI 模型选择**

- **多模型支持**：可以用 Gemini、Claude、GPT 等各种 AI 模型
- **随时切换**：想用哪个模型就用哪个，不用改变工作方式
- **独立配置**：每个模型都有独立的设置，互不干扰
- **智能推荐**：根据任务自动推荐最合适的 AI 模型
- **成本对比**：帮你选择性价比最高的模型

### 🎯 **让 AI 智能体触手可及**

我们的目标是让 AI 智能体变得简单易用，让普通用户也能轻松上手。我们相信：

- **简单就是美**：复杂的 AI 功能，用起来应该很简单
- **AI 要懂用户**：不需要用户去适应 AI，而是 AI 来适应用户
- **开源更透明**：优先使用开源的智能体，让大家都能看到代码
- **聊天最自然**：用聊天的方式就能完成复杂的工作

AionUi 旨在弥合强大 AI 能力与日常可用性之间的差距，让复杂的 AI 智能体像与朋友聊天一样简单易用。

---

## 📄 许可证

本项目采用 [Apache-2.0](LICENSE) 许可证。

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

---

## 📊 Star 历史

<p align="center">
  <a href="https://www.star-history.com/#iOfficeAI/aionui&Date" target="_blank">
    <img src="https://api.star-history.com/svg?repos=iOfficeAI/aionui&type=Date" alt="GitHub 星星趋势" width="600">
  </a>
</p>

<div align="center">

**⭐ 如果喜欢就给我们一个星吧**

[报告 Bug](https://github.com/iOfficeAI/AionUi/issues) · [创建功能请求](https://github.com/iOfficeAI/AionUi/issues)

</div>