## 项目概述

AionUi 是一个免费、开源的 24/7 AI 协作（Cowork）桌面应用，旨在让 AI 智能体在用户的计算机上协同工作——读取文件、编写代码、浏览网页、自动化任务。它内置了完整的 AI 智能体引擎，安装即用，无需额外配置 CLI 工具，只需提供任意 API 密钥即可开始使用。AionUi 支持多智能体模式，可集成 Claude Code、Codex、Hermes、OpenClaw 等 20 多种 CLI 智能体，并提供 WebUI 远程访问、定时任务、团队协作等功能。项目采用 Apache-2.0 许可证，使用 TypeScript 开发，基于 Electron 构建，支持 macOS、Windows 和 Linux 平台。

## 核心功能

- **内置智能体**：无需安装 CLI 工具，内置完整 AI 智能体引擎，支持文件读写、网页搜索、图像生成、MCP 工具。
- **多智能体模式**：自动检测并集成 Claude Code、Codex、Gemini CLI、OpenClaw 等 20+ 外部 CLI 智能体，统一界面管理，支持并行会话。
- **团队模式**：Leader 智能体将任务分解并委派给多个 Teammate 智能体并行执行，通过内置 Team MCP Server 协调，共享工作区。
- **办公助手**：内置 21 个专业助手，包括 PPT 创建、Word 文档生成、Excel 数据处理、学术论文写作、财务模型创建等，输出可编辑的 Office 文件。
- **定时任务**：支持 Cron 表达式、固定间隔、一次性触发三种调度模式，实现 24/7 无人值守自动化。
- **远程访问**：通过 WebUI 模式从浏览器访问，支持 Telegram、飞书、钉钉、微信等聊天平台集成。
- **多模型支持**：支持 30+ AI 平台，包括 Gemini、OpenAI、Anthropic、DeepSeek、Ollama 等，以及 NewAPI 网关。
- **技能系统**：三层技能体系（内置、自定义、扩展），支持创建和管理自定义助手与技能。
- **文件管理**：智能文件整理、批量重命名、自动分类、文件合并等自动化操作。
- **预览面板**：支持 PDF、Word、Excel、PPT、代码、Markdown、图片等 10+ 格式的即时预览和编辑。

## 适用与不适用场景

**适用场景：**

- 需要 AI 智能体在本地文件系统上执行多步骤任务的用户（如代码编写、文档处理、数据分析）。
- 希望统一管理多个 CLI 智能体（Claude Code、Codex 等）的开发者。
- 需要 24/7 无人值守自动化任务（如定时报告生成、数据聚合）的场景。
- 需要从手机或远程设备访问和控制 AI 智能体的用户。
- 需要生成 PPT、Word、Excel 等办公文档的办公人员。

**不适用场景：**

- 仅需简单聊天问答的用户（AionUi 更侧重于任务执行和文件操作）。
- 对数据隐私要求极高、不允许任何本地数据存储的场景（AionUi 数据存储在本地 SQLite，但需注意 API 调用会发送数据到所选模型提供商）。
- 需要图形化界面进行复杂图像编辑的用户（AionUi 的图像生成功能基于 Gemini，编辑能力有限）。
- 无头服务器部署时，需要额外配置 Xvfb 虚拟显示，且 WebUI 模式不支持应用内浏览器功能。

## 技术架构与依赖

AionUi 采用 Electron 多进程架构，主要分为渲染进程（React UI）、主进程（Node.js/Electron 业务逻辑）和预加载脚本。后端由 AionCore（Rust 编写）提供本地服务，通过 IPC 与前端通信。

**主要技术栈：**

- **Electron**：跨平台桌面框架
- **React 19**：UI 框架
- **TypeScript**：类型安全
- **Vite**：构建工具（electron-vite）
- **UnoCSS**：原子 CSS 引擎
- **better-sqlite3**：本地数据库
- **Rust**：AionCore 后端
- **ACP (Agent Client Protocol)**：与外部 CLI 智能体通信的协议
- **MCP (Model Context Protocol)**：工具服务管理

**开发依赖：** Node.js 22+、bun、Rust stable + Cargo、Python 3.11+、prek。

## 安装与快速开始

**系统要求：**

- macOS 10.15+ / Windows 10+ / Linux (Ubuntu 18.04+ / Debian 10+ / Fedora 32+)
- 内存 4GB+（推荐）
- 存储空间 500MB+

**安装步骤：**

1. 从 [GitHub Releases](https://github.com/iOfficeAI/AionUi/releases) 下载对应平台的安装包（macOS/Windows/Linux）。
2. 运行安装程序完成安装。
3. macOS 用户也可通过 Homebrew 安装：`brew install aionui`。

**快速开始（3 步）：**

1. 安装 AionUi。
2. 输入任意 API 密钥（如 Gemini、OpenAI、Anthropic 等）。
3. 开始与内置 AI 智能体协作。

## 典型使用方法

**1. 文件管理：** 让智能体整理杂乱的下载文件夹、批量重命名照片、合并多个文档。

**2. Excel 数据处理：** 让智能体分析销售数据、生成月度报告、清洗和格式化 Excel 文件。

**3. 文档生成：** 使用 PPT 助手创建演示文稿，使用 Word 助手撰写论文或合同，使用 Excel 助手生成数据表格。

**4. 定时任务：** 设置每日天气报告、每周销售数据汇总、每月备份文件整理等自动化任务。

**5. 多智能体协作：** 在团队模式下，让 Leader 智能体分解任务并委派给多个 Teammate 智能体并行执行。

**6. 远程访问：** 通过 WebUI 模式从手机或平板浏览器访问和控制智能体，或通过 Telegram、飞书等聊天平台交互。

## 配置与部署要点

**配置要点：**

- **API 密钥**：在设置中输入所选平台的 API 密钥，支持 30+ 平台。
- **MCP 工具**：在设置中配置 MCP 服务器，统一管理工具服务。
- **WebUI 模式**：通过 `--webui` 参数启动，支持 `--remote` 允许远程访问，默认端口 25808。
- **定时任务**：支持 Cron 表达式（带时区）、固定间隔、一次性触发，可绑定会话。
- **代理配置**：支持 PAC 文件自动回退，适用于服务器部署场景。

**部署要点：**

- **无头服务器**：需安装 Xvfb 虚拟显示，使用 `xvfb-run` 启动。
- **远程访问**：可通过公网 IP、ngrok 隧道或 SSH 隧道。
- **环境变量**：`AIONUI_PORT`、`AIONUI_ALLOW_REMOTE`、`AIONUI_HOST` 可自定义 WebUI 行为。
- **密码重置**：使用 `--resetpass` 命令重置 WebUI 管理员密码。

## 限制、风险与许可证

**限制：**

- 应用内浏览器功能在 WebUI 模式下不可用（无 Electron `<webview>` 和 CDP 端口）。
- 部分 CLI 智能体（如 Codex、Gemini）不支持免确认模式。
- 会话中动态添加技能的支持取决于底层智能体的扫描机制，并非所有智能体都支持。

**风险：**

- 智能体操作文件系统时需用户审批，但开启免确认模式后可能执行敏感操作，需谨慎使用。
- 应用内浏览器控制通道默认开启，本机其他程序理论上可操作浏览器页面（仅限本机）。
- API 调用会将数据发送到所选模型提供商，用户需注意数据隐私。

**许可证：** Apache-2.0。

## 官方链接

- GitHub 仓库：https://github.com/iOfficeAI/AionUi
- 官方文档：https://www.aionui.com
- 发布页面：https://github.com/iOfficeAI/AionUi/releases
- 问题反馈：https://github.com/iOfficeAI/AionUi/issues
- 社区讨论：https://github.com/iOfficeAI/AionUi/discussions
- Discord：https://discord.gg/2QAwJn7Egx
- Twitter/X：https://twitter.com/AionUI

## 信息来源和分析时间

- 信息来源：GitHub 仓库 README、CHANGELOG、文档目录（docs/）、PRD 文档。
- 分析时间：2026-08-10（基于最新发布版本 v2.1.53 的日期）。