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/ 目录下，主要适配手机和平板设备的交互习惯。
