1. 项目定位与用途
AionUi 是一个免费、开源、跨平台的桌面 AI 代理协作应用（Cowork app），定位为 AI 代理的工作台。它不仅仅是聊天客户端，而是让多个 AI 代理（如 Claude Code、Gemini CLI、Codex 等）在用户电脑上协同工作的平台。用户可以通过统一的图形界面监控代理的每一步操作，审批关键动作，并安排长期自动化任务。其核心用途是将命令行 AI 代理转化为现代化、高效、可视化的协作工具，提升个人或团队的生产力。
项目档案应用项目
AionUi 免费开源 AI 代理协作平台 - 支持 Claude/Gemini 多模型，24/7 自动化工作，跨平台桌面应用
AionUi 是一个跨平台桌面应用，让 AI 代理直接在您的电脑上工作，支持文件操作、网页浏览、定时任务。内置多模型引擎，无需复杂配置，适合开发、文档处理等场景。本页提供安装、使用指南及技术架构说明。
AI 总结
AionUi 是一个免费开源的跨平台桌面 AI 代理协作应用，内置多模型代理引擎，让 AI 能直接操作本地文件、执行自动化任务，并提供可视化的全程控制与 24/7 无人值守能力。
中文项目介绍
AionUi 是一个面向开发者和专业用户的 AI 代理协作桌面平台。它解决了传统 AI 聊天工具无法直接操作本地文件、执行多步骤自动化任务的局限，通过内置的代理引擎（支持 ACP、AionRS、Gemini CLI、NanoBot 等），让 AI 能够阅读写入文件、浏览网页、使用工具，并在用户监督下自主完成任务。
项目适用于代码编写与审查、文档格式转换、网页信息抓取、定时自动化等场景。其核心特征包括：零配置安装即用、支持 Google 登录或任意 API Key、统一界面管理 12+ 种 AI 代理、提供 WebUI 与 Telegram/Lark/DingTalk 等远程访问方式、以及基于 Cron 的 24/7 无人值守自动化。技术栈基于 Electron + React + TypeScript，采用模块化架构，具备扩展市场和远程代理管理等高级特性。
详细信息与使用说明
2. 解决的问题
传统 AI 聊天工具通常仅限于文本交互，无法直接操作本地文件系统、执行多步骤复杂任务或进行无人值守自动化。AionUi 通过内置的代理引擎解决了这些问题：代理可以读取/写入文件、调用 MCP 工具、浏览网页、生成图像，并在用户审批下执行多步骤任务。同时，它统一了多种异构 AI 代理的接口，避免了用户分别安装和配置多个 CLI 工具的麻烦，实现了‘安装即用’的零门槛体验。
3. 适用场景
主要适用场景包括：1）软件开发中的代码生成、审查与调试；2）文档处理，如 PDF 转 PPT、报告生成；3）网页数据抓取与自动化操作；4）基于 Cron 的定时任务与 24/7 无人值守监控；5）多 AI 模型协同处理复杂工作流。此外，内置的 11+ 专业助手（如 PPTX 生成器、UI/UX Pro Max、3D 游戏助手）可直接用于特定领域任务。
4. 安装方式
安装方式有两种：1）下载预编译包：访问 GitHub Releases 页面，根据操作系统（macOS、Windows、Linux）下载最新版本安装包直接运行；2）源码构建：克隆仓库后，运行 npm install 安装依赖，再执行 npm run make 或 npm run dist 进行打包。仓库中未明确给出通过包管理器（如 brew、apt）一键安装的命令，也未提供 Docker 镜像的详细运行步骤，仅包含 Dockerfile 文件。
5. 使用方式
启动应用：运行 npm start 启动桌面客户端；运行 npm run webui 启动 Web 界面模式（支持远程访问）。首次使用需通过 Google 登录或粘贴任意支持的 API Key 连接 AI 服务。之后可直接选择内置助手或创建自定义代理任务，在聊天界面中查看代理执行过程，并对需要审批的操作进行确认。远程访问可通过 WebUI 或集成 Telegram、Lark、DingTalk 等通道实现，具体配置步骤在仓库中未详细给出。
6. 补充说明与实现特点
实现特点包括：1）多模型 API 客户端旋转池（src/common/api/index.ts），统一管理 OpenAI、Gemini、Anthropic 等客户端，提供容错和轮询；2）模块化代理引擎，支持 ACP、AionRS、Gemini、NanoBot 等多种协议，分别封装在 src/process/agent/ 目录下；3）审批系统（src/common/chat/approval/index.ts）用于管理工具调用和操作授权；4）平台抽象层（src/common/platform/index.ts）自动适配 Electron 与 Node 环境；5）扩展机制支持市场插件和远程代理管理（docs/feature/extension-market 和 remote-agent）；6）测试覆盖包含单元、集成与契约测试（vitest 配置）。仓库中未明确给出性能基准数据或集群部署方案。
思维导图
AionUi 项目结构
核心模块
多模型 API 客户端
聊天与审批系统
平台服务抽象
代理系统
ACP 代理
AionRS 代理
Gemini 代理
NanoBot 代理
平台集成
Electron 主进程
渲染进程 (React)
WebUI 服务
扩展机制
扩展市场
远程代理管理
通道集成 (Feishu/WeCom)
工具与审批
MCP 工具集成
审批存储与流程
事件流处理
常见问题
AionUi 如何安装？支持哪些操作系统？
您可以从 GitHub Releases 下载 macOS、Windows 或 Linux 的预编译安装包直接运行。也支持源码构建：克隆仓库后运行 npm install 和 npm run make 进行打包。仓库中未提供通过包管理器（如 brew）的一键安装命令。
AionUi 支持哪些 AI 模型或代理？
根据 README，AionUi 内置支持 Gemini CLI、Claude Code、Codex、OpenCode、Qwen Code、Goose CLI、Auggie 等 12+ 种 AI 代理，并可通过统一界面管理。技术实现上，API 客户端层封装了 OpenAI、Gemini、Anthropic 的旋转客户端。
AionUi 是免费的吗？是否需要付费？
是的，AionUi 是免费且开源的，采用 Apache-2.0 许可证。您可以使用自己的 API Key 连接服务，无需支付平台费用。但使用第三方 AI 服务（如 Claude、Gemini）可能产生其官方 API 调用费用。
如何远程访问 AionUi？
AionUi 提供 WebUI