AIri 多端部署指南
环境准备
在开始部署前，请确保你的环境满足以下基本要求：
- 网络连接稳定（需下载项目资源和依赖）
- Git 工具（用于克隆仓库）
- Node.js 18+ 和 pnpm 包管理器
- 至少 4GB 可用存储空间
项目核心部署资源位于以下路径，建议提前熟悉：
- Web 端源码：apps/stage-web/
- 桌面端源码：apps/stage-tamagotchi/
- 移动端支持：docs/content/public/（包含 PWA 配置）
第一步：Web 浏览器部署
Web 版本是体验 AIri 的最便捷方式，无需安装任何软件，通过现代浏览器即可运行。
克隆项目仓库
git clone <repository_url>
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，可在此自定义应用图标、窗口大小等参数。
第三步：移动设备部署
AIri 通过 PWA（渐进式 Web 应用）技术实现移动设备支持，可添加到手机桌面，获得接近原生应用的体验。
- 完成 Web 端部署（确保 Web 服务正常运行）
- 在移动设备上访问 用手机浏览器访问你的 Web 服务地址（如
http://192.168.1.100:5173，需确保手机与电脑在同一局域网）。 - 添加到主屏幕
- Safari 浏览器：点击分享按钮 → "添加到主屏幕"
- Chrome 浏览器：点击菜单按钮 → "安装应用"
移动版特有的触摸优化和响应式布局定义在 apps/stage-web/src/components/ 目录下，主要适配手机和平板设备的交互习惯。
部署验证与问题排查
成功部署后，你可以通过以下方式验证各平台功能：
| 平台 | 验证方法 | 常见问题排查 |
|---|
