Skip to content

FAQ Chinese

瓦砾 edited this page Aug 6, 2026 · 5 revisions

❓ AionUi 常见问题解答

本 FAQ 涵盖了用户在使用 AionUi 时遇到的最常见问题和疑问。

English | 简体中文


🚀 安装与设置

Q: 如何安装 AionUi?

A: AionUi 支持 Windows、macOS 和 Linux。请从我们的 GitHub 发布页面 下载最新版本,并按照您操作系统的安装说明进行操作。

Q: 系统要求是什么?

A:

  • 操作系统: Windows 10+、macOS 10.15+ 或 Linux (Ubuntu 18.04+)
  • 内存: 最低 4GB RAM,推荐 8GB+
  • 存储: 至少 2GB 可用空间
  • 网络: 用于 AI 模型访问的互联网连接

Q: 我可以在较旧的操作系统上运行 AionUi 吗?

A: 由于 AionUi 基于 Electron 架构,需要现代操作系统。我们建议更新到支持的版本以获得最佳体验。


🔑 认证与 API Key

Q: 我需要为所有平台创建 API Key 吗?

A: 不需要,您可以只从一个平台开始。我们建议从 Google Gemini(免费)或 OpenAI(如果您有积分)开始。您可以稍后根据需要添加更多平台。

Q: 如何获取 Google Gemini API Key?

A:

  1. 访问 Google AI Studio
  2. 使用您的 Google 账号登录
  3. 导航到"获取 API Key"并创建新密钥
  4. 复制密钥并粘贴到 AionUi 的 LLM 设置中

Q: 我的 API Key 不工作。我应该检查什么?

A:

  • 验证密钥是否正确复制(没有多余的空格或字符)
  • 检查密钥是否已过期或被撤销
  • 确保您有足够的积分/配额剩余
  • 尝试从平台仪表板重新生成密钥

Q: 我可以为同一平台使用多个 API Key 吗?

A: 可以!AionUi 支持每个平台多个 API Key 并自动轮换。这有助于处理速率限制和提高可靠性。


🤖 AI 模型与代理

Q: AionUi 是什么?

A: AionUi 是一个免费开源的 Cowork 应用,内置 AI Agent - 一个让 AI Agent 在您电脑上与您协同工作的桌面应用。AionUi 内置完整的 AI Agent 引擎,安装即可使用。主要特性包括:

  • 内置 Agent | 零配置 - 完整的 AI Agent 引擎随 AionUi 一同发布,无需另外安装
  • 多 Agent 模式 - 自动检测本机已安装且受支持的 CLI Agent(Claude Code、Codex、Qwen Code、Gemini CLI、Cursor Agent、Hermes、Pi 等),并作为后端使用
  • 自动化任务执行 - AI Agent 可独立执行任务、运行脚本、读写文件、操作工具,自动完成任务
  • 工作流自动化 - 完整的工作流自动化能力,支持文件系统操作和任务自动完成
  • 跨平台支持 - 支持 macOS、Windows 和 Linux
  • 免费开源 - 完整的开源解决方案,无订阅费用

Q: 内置 Agent 和多Agent模式有什么区别?

A: 主要区别:

  • 内置 Agent:由嵌入式 aionrs 引擎驱动,随 AionUi 提供,无需另装外部 CLI;可结合已配置的模型、助手、Skills、MCP、图像工具和定时任务使用。
  • 多 Agent 模式:本机安装了受支持的 CLI Agent 后,AionUi 可以自动检测,并将其作为会话或助手的后端。可用模型、工具、权限、MCP 集成和无人值守模式仍取决于所选 Agent。

Q: 我应该选择哪个代理?

A: 选择建议:

  • 日常使用:内置 Agent 无需另装外部 CLI,是集成度最高的起点。
  • 已经在用其他 CLI: 如果你已经配置好了 Claude Code、Codex、Qwen Code、Cursor 等,可以按助手或会话切换后端,原有的 CLI 鉴权直接复用。
  • 混搭使用: 不同助手可以挂在不同后端上 —— 例如代码相关的助手用 Claude Code,通用助手用内置 Agent。

Q: 如何在不同的 AI 模型之间切换?

A: 三个地方都可以切换:

  • 会话内:点击会话顶部的 Agent / 模型标签,可以即时切到任何已配置的模型。
  • 按助手:在 设置 → 助手 里编辑助手,挑一个不同的后端 Agent + 模型。下次用这个助手开新会话时生效。
  • 按定时任务:创建任务时可以选模型,详情页里也能随时改。

Q: 为什么我看不到图像生成工具?

A: 检查以下配置:


🖼️ 图像生成

Q: 哪些图像生成模型推荐使用?

A: 请选择 AionUi 当前标记为支持图像生成的模型。模型名称、可用性和价格变化较快,请以所选服务商的最新文档为准。

Q: 如何配置图像生成?

A:

  1. 设置具有图像模型的平台(Gemini 或 OpenRouter)
  2. 转到设置 → 工具 → 图像生成
  3. 选择图像生成模型
  4. 使用简单提示测试,如"生成一张日落风景"

Q: 我的图像生成很慢。如何改进?

A:

  • 选择更快的模型(如 Gemini 图像模型)
  • 降低图像分辨率要求
  • 检查您的互联网连接
  • 考虑升级到高级模型以获得更好的性能

🔧 配置与设置

Q: 我的设置存储在哪里?

A: 所有对话都保存在本地:

  • macOS: ~/Library/Application Support/AionUi/
  • Windows: %APPDATA%/AionUi/
  • Linux: ~/.config/AionUi/

Q: 如何备份我的配置?

A:

  1. 手动复制配置文件目录
  2. 导出您的配置文件
  3. 安全存储以备将来恢复

Q: 我可以将 AionUi 重置为默认设置吗?

A: 可以,您可以重置设置:

  1. 完全关闭 AionUi
  2. 删除配置文件夹
  3. 重启 AionUi 以创建新设置

🚨 故障排除

Q: AionUi 无法启动。我应该怎么办?

A:

  1. 检查是否已有另一个实例在运行
  2. 重启您的计算机
  3. 如果问题持续存在,请重新安装 AionUi
  4. 查看我们的 GitHub 问题 了解已知问题

Q: 我收到"API key 无效"错误。

A:

  • 验证密钥是否正确输入
  • 检查密钥是否已过期
  • 确保您有足够的积分
  • 尝试重新生成密钥

Q: 我的对话没有保存。

A:

  • 检查您是否有对 AionUi 数据目录的写入权限
  • 确保有足够的磁盘空间
  • 尝试重启 AionUi

Q: 界面缓慢或无响应。

A:

  • 关闭不必要的应用程序以释放内存
  • 检查您的互联网连接
  • 尝试减少并发对话数量
  • 重启 AionUi

🔄 更新与维护

Q: 如何更新 AionUi?

A:

  • 自动: AionUi 会通知您更新
  • 手动: 从 GitHub 发布页面下载最新版本
  • 设置: 在设置 → 关于中检查更新

Q: 更新会影响我的设置和对话吗?

A: 不会,更新会保留您的设置和对话历史。但是,我们建议在重大更新之前备份重要数据。

Q: AionUi 多久更新一次?

A: 我们定期发布更新,包含新功能、错误修复和改进。关注我们的 GitHub 发布 获取最新更新。


🔒 安全与隐私

Q: 我的数据安全吗?

A:

  • 对话存储在您设备的本地
  • API Key 经过加密并安全存储
  • 未经您同意,我们不会收集个人数据
  • 查看我们的隐私政策了解详细信息

Q: 如何删除我的对话历史?

A:

  1. 手动删除配置文件目录中的对话数据
  2. 或直接删除整个配置文件夹重置所有数据
  3. 重启 AionUi 以应用更改

🤝 社区与支持

Q: 我在哪里可以获得帮助?

A:

  • GitHub Issues: 报告错误和请求功能
  • GitHub Discussions: 提问和分享技巧
  • 文档: 查看我们的综合指南
  • 社区: 加入我们的用户社区获得支持

Q: 我如何为 AionUi 做出贡献?

A:

  • 代码: 为错误修复和功能提交拉取请求
  • 文档: 帮助改进我们的指南和教程
  • 测试: 报告问题并提供反馈
  • 社区: 在讨论中帮助其他用户

Q: AionUi 是开源的吗?

A: 是的!AionUi 完全免费开源,可在 GitHub 上获得。作为免费开源的 Cowork 应用,内置 AI Agent,AionUi 提供:

  • 完整的源代码访问
  • 社区驱动的开发
  • 无订阅费用或隐藏成本
  • 透明的开发过程
  • 我们欢迎社区的贡献

📚 其他资源


还有问题?在 GitHub 上提出问题开始讨论

Clone this wiki locally