AIri 全平台部署指南:Web、桌面及移动端支持
你是否曾因喜欢的 AI 虚拟角色仅限特定设备使用而感到困扰?想在办公室电脑用浏览器和 AIri 聊天,回家后在桌面端继续未完成的游戏,甚至在通勤时通过手机与她互动?本文将介绍如何通过简单三步完成 AIri 在 Web 浏览器、Electron 桌面端和移动设备的全覆盖部署,让虚拟伙伴随时随地陪伴你。
部署准备:环境与资源检查
在开始部署前,请确保你的环境满足以下基本要求:
- 网络连接稳定(需下载项目资源和依赖)
- Git 工具(用于克隆仓库)
- Node.js 18+ 和 pnpm 包管理器
- 至少 4GB 可用存储空间
项目核心部署资源位于以下路径,建议提前熟悉:
- Web 端源码:apps/stage-web/
- 桌面端源码:apps/stage-tamagotchi/
- 移动端支持:docs/content/public/(包含 PWA 配置)
第一步:Web 浏览器部署(最快体验)
Web 版本是体验 AIri 的最便捷方式,无需安装任何软件,通过现代浏览器即可运行。
克隆项目仓库
git clone [项目仓库地址]
cd airi
安装依赖并启动 Web 服务
pnpm i
pnpm dev:web
访问应用:打开浏览器访问 http://localhost:5173,即可看到 AIri 的 Web 界面。
Web 端架构基于 Vue.js 和 Vite 构建,核心配置文件为 apps/stage-web/vite.config.ts,你可以通过修改此文件自定义端口或添加代理设置。
第二步:Electron 桌面端部署(功能完整)
桌面端提供比 Web 版更丰富的功能,如系统通知、本地文件访问和 GPU 加速渲染。
切换到桌面端项目目录
cd apps/stage-tamagotchi
安装依赖并开发模式启动
pnpm i
pnpm dev
打包生成可执行文件
pnpm build
打包完成后,可执行文件将生成在 dist 目录下,支持 Windows、macOS 和 Linux 系统。桌面端特有的配置文件位于 apps/stage-tamagotchi/electron-builder.yml,可在此自定义应用图标、窗口大小等参数。
第三步:移动设备部署(PWA 支持)
AIri 通过 PWA(渐进式 Web 应用)技术实现移动设备支持,可添加到手机桌面,获得接近原生应用的体验。
- 完成 Web 端部署(确保 Web 服务正常运行)
- 在移动设备上访问 用手机浏览器访问你的 Web 服务地址(如
http://192.168.1.100:5173,需确保手机与电脑在同一局域网)。 - 添加到主屏幕
- Safari 浏览器:点击分享按钮 → "添加到主屏幕"
- Chrome 浏览器:点击菜单按钮 → "安装应用"
移动版特有的触摸优化和响应式布局定义在 apps/stage-web/src/components/ 目录下,主要适配手机和平板设备的交互习惯。

