人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载本指南面向刚接触 Project AIRI 桌面版的用户以官方文档《데스크톱 빠른 시작桌面版快速开始》源文件为 docs/content/ko/docs/manual/tamagotchi/index.md为主线完整覆盖从安装启动、首次对话、界面认知到窗口布局控制的全过程。读完本文你将掌握 AIRI 桌面版的整套日常操作流程如何完成初始化配置、如何借助「控制岛Controls Island」与系统托盘管理桌面驻留的虚拟角色舞台以及首次对话后应当优先浏览哪些设置页面。安装并启动 AIRI进入首次引导AIRI 桌面版安装完成后首次启动会进入onboarding引导流程。这一环节的目的只有一个配置好至少一个可用的聊天提供者与聊天模型让 AIRI 具备回复消息的能力。从源码结构看引导页由apps/stage-tamagotchi/src/renderer/pages/onboarding.vue实现它直接复用了proj-airi/stage-ui包中的OnboardingScreen组件如果当前构建提供使用分析功能还会额外插入OnboardingStepAnalyticsNotice一步对应代码中的isAnalyticsAvailableInBuild()分支。也就是说引导步骤在不同构建中略有差异这是正常现象。完成引导后AIRI 就能回答你的消息语音合成TTS、语音识别ASR/STT、视觉理解、艺术创作等能力都可以在之后的设置中逐个补充。首次对话完成 7 步引导流程进入欢迎界面后按下列顺序完成初始化在欢迎界面右上角点击地球按钮globe切换界面语言如果界面语言不是你需要的。选择Setup with your provider使用自己的提供者配置想使用 AIRI 官方提供者则选择Sign in登录。选择聊天提供者例如 OpenRouter、OpenAI Compatible、DeepSeek、Ollama、Google Gemini、Anthropic 等。填写 API Key、本地服务地址等必要信息。选择一个聊天模型然后点击Save and Continue保存并继续。回到主角色窗口后点击右下角控制岛中的Expand展开。点击Open Chat打开聊天输入消息并发送。本地使用 Ollama 时的注意事项如果选择在本地运行 Ollama需要注意浏览器同源策略CORS默认情况下Ollama 已允许来自桌面版开发环境 origin和打包后应用 origin的请求因此本地场景通常不需要设置OLLAMA_ORIGINS。只有在请求来自非默认的远程 Web origin 并触发 CORS 错误时才需要把该 origin 精确写入OLLAMA_ORIGINS环境变量然后重启 Ollama。官方文档明确提醒不要使用通配符也不要把 Ollama 暴露到公网。界面构成桌面版的五个主要部分完成首次对话后你会看到桌面版通常由以下五个部分组成主角色窗口Main Character Window桌面驻留型角色舞台支持 Live2D、Spine、VRM、MMD、Tachie 等显示模型。控制岛Controls Island主角色窗口右下角的一小组按钮是日常操作的主要入口。聊天窗口Chat Window从控制岛打开的对话窗口。设置窗口Settings Window配置提供者、档案profile、模型、模块、数据、连接与系统选项。系统托盘菜单System Tray Menu调整窗口大小与位置、打开设置、管理字幕与 Widgets、退出 AIRI。如果主角色窗口被隐藏可以点击 AIRI 的托盘图标或在托盘菜单中选择Show显示将其找回。对应实现位于apps/stage-tamagotchi/src/main/tray/index.ts其中appTray.addListener(click, () toggleWindowShow(...))正是「点击托盘图标唤起主窗口」的底层逻辑。控制岛Controls Island日常使用的核心入口控制岛是桌面版日常交互的「遥控器」集中了最常用的操作。其核心实现位于 apps/stage-tamagotchi/src/renderer/components/stage-islands/controls-island/index.vue文档描述的各按钮都能在其中找到对应的事件通道通过proj-airi/eventa定义于 apps/stage-tamagotchi/src/shared/eventa/index.ts。操作说明源码对应事件/逻辑Expand展开点击后展开更多动作菜单toggleControls()切换expanded状态Open Chat打开聊天打开聊天窗口electronOpenChatOpen settings打开设置配置提供者、模型、模块、档案与系统设置electronOpenSettingsSwitch Profile切换档案切换当前角色卡ControlsIslandProfilePickerRefresh刷新重新加载舞台refreshWindow()window.location.reload()主题切换图标切换浅色/深色主题useTheme().toggleDark()Pin图钉开关「总是置顶Always on top」electronWindowSetAlwaysOnTopEye眼睛切换「自动隐藏 / 始终显示」ControlsIslandFadeOnHoverOpen hearing Controls打开听力控制打开语音输入控制ControlsIslandHearingConfigDrag to move window拖动移动窗口按住左键拖动主角色窗口electronStartDraggingWindow值得注意的实现细节主窗口的置顶状态会在应用启动时通过watch(alwaysOnTop, ..., { immediate: true })立即同步到操作系统而「拖动窗口」在 Linux 上被禁用代码注释说明 Electron 的该方案在 Linux 上不工作取而代之的是drag-region类配合 CSS 拖拽区域。此外控制岛的图标大小由设置项controlsIslandIconSize取值auto | large | small默认auto见 packages/stage-ui/src/stores/settings/controls-island.ts控制——这就是文档中提到的Controls Island Icon Size设置。悬停自动隐藏Hide on hover眼睛图标决定 AIRI 在「完全可交互」与「工作时让路」之间的行为始终显示Always show角色保持可见且可点击。自动隐藏Auto hide当鼠标光标靠近时角色与界面淡出fade让你更容易点击到下方的应用程序。首次开启「自动隐藏」时AIRI 会弹出一段简短说明。如果之后觉得难以点击到 AIRI把光标移到控制岛附近再次点击眼睛图标即可关闭该功能。从源码看这段引导由 apps/stage-tamagotchi/src/renderer/components/stage-islands/controls-island/controls-island-fade-on-hover.vue 实现首次开启时会通过noticeWindowEventa.openWindow打开一个fade-on-hover类型的提示窗口路由/notice/fade-on-hover用户确认acknowledged后才真正启用若用户勾选了「不再提示」则会直接启用。对应的提示页源码位于apps/stage-tamagotchi/src/renderer/pages/notice/fade-on-hover.vue。窗口移动与尺寸调整拖动移动拖动控制岛右下角的移动按钮即可移动主角色窗口。调整尺寸Windows 下可以直接拖动窗口边缘或角落调整大小同时托盘菜单内置了几档常用尺寸右键点击 AIRI 托盘图标。打开Adjust sizes调整尺寸。在Recommended推荐450x600、Full Height全高、Half Height半高、Full Screen全屏中选择一档。同一托盘菜单下的Align to对齐到可以把窗口移动到屏幕中央或四个角落。这些选项并非简单的魔法数字其计算逻辑可以直接在 apps/stage-tamagotchi/src/main/tray/index.ts 中验证推荐尺寸常量RECOMMENDED_WIDTH 450、RECOMMENDED_HEIGHT 600并由此推导出固定宽高比ASPECT_RATIO 450 / 600。全高取当前显示器工作区高度areaHeight宽度按宽高比折算为Math.floor(areaHeight * ASPECT_RATIO)半高则是高度折半后再按比例折算宽度。这也解释了为什么「全高/半高」下的窗口宽度会随屏幕高度变化。对齐到的五个位置中央、左上、右上、左下、右下由resolveAlignedWindowBounds()基于当前显示器workArea与窗口尺寸精确计算并借助AnimatorwindowBoundsAnimateTo实现平滑移动动画。尺寸菜单项以 checkbox 呈现勾选状态由isSizeMatch()/isPositionMatch()实时比对允许 ±2px 的尺寸容差与 ±5px 的位置容差菜单会在窗口resize/move事件时自动重建。首次对话后的推荐设置完成第一次对话后官方文档建议依次浏览以下设置页面Providers提供者新增或修改 Chat聊天、Vision视觉、Speech语音合成、Transcription转录、Artistry艺术创作提供者。Modules模块为意识consciousness、语音合成、听力听觉、视觉、记忆、Discord、Minecraft、Factorio、MCP 等模块选择要使用的服务。Models模型在受支持的 2D/3D 模型之间切换或导入自制的模型。AIRI Card角色卡切换当前角色或创建新的角色卡。System系统设置语言、主题、使用分析选项以及桌面版专用选项。其中部分模块属于实验性质需要本地源码配置或额外的外部服务。完整的配置细节包括角色卡创建、模块逐一说明、连接与 WebSocket、Web 版本功能、FAQ 等请参阅官方完整手册桌面版完整使用说明简体中文版或英文原版 Desktop Manual。延伸阅读仓库中的配套演示视频资源位于 docs/content/public/assets例如tutorial-basic-setup-providers.mp4提供者配置、tutorial-basic-open-chat.mp4打开聊天、tutorial-basic-fade-on-hover.mp4悬停隐藏、tutorial-basic-move.mp4移动窗口、tutorial-basic-resize.mp4调整尺寸可对照本文各小节直观理解操作效果。想深入了解桌面版底层窗口、托盘与事件机制可直接阅读 apps/stage-tamagotchi/src/main/tray/index.ts 与 apps/stage-tamagotchi/src/renderer/components/stage-islands/controls-island/index.vue。赞分享人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载相关推荐Project AIRI 桌面版快速上手从首次引导到控制岛与托盘操作实战Project AIRI 桌面版快速上手从首次引导到控制岛与托盘操作实战 导读 本文以 Project AIRI 桌面版内部代号 Stage Tamago人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端Project AIRI 桌面版快速开始从首次引导、控制岛操作到悬停隐藏的完整上手指南Project AIRI 桌面版快速开始从首次引导、控制岛操作到悬停隐藏的完整上手指南 本篇指南对应 Project AIRI 的桌面端形态 Stage Ta人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端AIRI 桌面版Stage Tamagotchi快速上手从首次配置到日常操控完整指南AIRI 桌面版Stage Tamagotchi快速上手从首次配置到日常操控完整指南 本指南面向首次接触 Project AIRI 桌面版代码内称为 S人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端上一篇Gofile下载工具完全指南从入门到精通下一篇5步攻克音画不同步LosslessCut专业级解决方案指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考