学习目标:学会安装并运行AionUi,使用图形界面与内置的Gemini CLI等AI工具交互,并体验其核心的WebUI访问、文件管理和多会话功能。
前置知识
需要会下载文件、解压压缩包、运行应用程序等基础操作。
部分AI模型(如Gemini)需要联网才能使用。
非必须,但如果你已安装,AionUi能自动检测并提供统一界面。没有安装也能直接使用内置的Gemini CLI。
学习步骤
环境准备与安装
15-30分钟下载AionUi
访问项目GitHub页面(iOfficeAI/AionUi)的Releases部分,根据你的操作系统(Windows/macOS/Linux)下载最新的安装包或可执行文件。
Windows用户通常下载.exe文件,macOS下载.dmg,Linux下载.AppImage或对应包。
安装与首次运行
运行下载的安装程序,或直接启动可执行文件。首次启动后,熟悉主界面布局。
如果系统有安全提示(如macOS的“无法验证开发者”),请根据系统指引允许运行。首次启动可能需要一点时间初始化。
快速入门:第一次对话
20-30分钟启动内置AI(Gemini CLI)
在AionUi主界面,确认已选择或自动检测到“Gemini CLI”作为当前模型。如果提示需要API密钥,你可能需要先获取并配置Gemini API Key(项目内置的Gemini CLI可能已包含基础访问权限,具体看版本说明)。
关注界面提示,如果内置模型可用,通常可以直接开始聊天。
进行第一次对话
在聊天输入框,用自然语言向AI提问,例如:“帮我写一个简单的Python函数来计算斐波那契数列”。体验发送、接收回复的过程。
首次回复可能需要一些时间,取决于网络和模型加载情况。
体验多会话
尝试新建一个会话(通常有“New Chat”或“+”按钮),在新会话中问另一个问题。观察两个会话是否独立,互不干扰。
这是AionUi的核心优势之一,可以同时进行多个不同主题的对话。
核心功能初探
30-45分钟体验WebUI访问(本地)
在AionUi的设置中,找到“WebUI设置”或类似选项,启用本地WebUI服务。记下显示的本地地址(如 http://localhost:端口号)。在同一局域网下的另一台设备(如手机)的浏览器中输入该地址,尝试访问AionUi界面。
这能让你在任何设备上通过浏览器使用AionUi。确保电脑防火墙允许该端口的连接。
使用预览面板
让AI生成一些有格式的内容,例如:“用Markdown格式写一份会议纪要”。在AI回复后,尝试点击“预览”或类似按钮,查看生成的Markdown内容的渲染效果。
支持PDF、代码、Markdown等多种格式的即时预览,无需打开其他软件。
浏览AI助手库
在主界面或侧边栏找到“AI Assistants”或“技能”入口,浏览内置的10多个专业助手(如PPT生成器、PDF转换器等)。选择一个你感兴趣的助手(如“PPTX Generator”),点击进入并尝试根据简单提示使用它。
每个助手专注于特定任务,可以极大提升效率。首次使用某个助手可能需要加载相关技能。
推荐资源
本项目最核心的文档,包含了功能介绍、对比、快速导航等。特别是“Remote Internet Access Tutorial”(远程访问教程)链接,如果你想配置公网访问,这是必看内容。
遇到问题时可以加入社区提问,开发者和其他用户可能会提供帮助。README顶部提供了加入链接。
项目官方网站,可能包含更结构化的文档、博客或更新日志。
常见错误与避坑指南
启动后找不到或无法使用AI模型
1) 确认网络连接正常;2) 检查设置中是否已正确选择并配置了某个模型(如Gemini);3) 如果是使用需要API Key的模型(如OpenAI),确保已在对应位置正确填写了有效的API Key;4) 尝试重启AionUi。
WebUI无法在手机/其他电脑上访问
1) 确保运行AionUi的电脑和访问设备在同一个局域网(Wi-Fi)下;2) 检查AionUi中WebUI服务是否已启用,并记对IP地址和端口;3) 暂时关闭电脑的防火墙或杀毒软件试试(完成后记得重新打开);4) 先尝试用运行AionUi的电脑本身的浏览器访问 localhost:端口,确认服务本身是否正常。
认为必须安装所有命令行工具(如Claude Code)才能用
AionUi内置了Gemini CLI,可以直接使用。其他工具(Claude Code等)是“如果已安装,则自动集成”,并非必需。新手完全可以只使用内置功能。
忽略本地存储位置
AionUi的对话和文件默认保存在本地。如果你需要备份或迁移数据,记得在设置或文档中查找本地数据存储路径,避免重装系统后数据丢失。
下一步探索
1. 配置远程公网访问:按照教程设置,实现随时随地通过互联网访问你的AionUi。 2. 集成更多AI模型:尝试在设置中添加并配置OpenAI、Claude、Ollama(本地模型)等,体验多模型切换。 3. 探索高级助手:深度使用“文件智能管理”、“PPTX生成器”等专业助手,完成实际办公任务。 4. 尝试自定义技能:如果你有编程基础,可以学习在`skills/`目录下创建自己的技能,扩展AI能力。 5. 参与社区:在Discord或微信群分享你的使用经验,或向开发者反馈问题。
相关项目推荐
freeCodeCamp/freeCodeCamp
freeCodeCamp.org开源代码库与课程体系,免费学习数学、编程与计算机科学
kamranahmedse/developer-roadmap
提供交互式学习路线图、指南和其他教育内容,帮助开发者在职业生涯中成长。
openclaw/openclaw
属于你个人的AI助手。全操作系统支持。全平台兼容。龙虾之道。🦞
vuejs/vue
此仓库为Vue 2版本。Vue 3版本请访问https://github.com/vuejs/core
microsoft/vscode
Visual Studio Code
n8n-io/n8n
具备原生AI能力的公平代码工作流自动化平台。支持可视化构建与自定义代码,可选自托管或云端部署,集成400多种服务。