AIri 全平台部署指南
你是否曾因喜欢的 AI 虚拟角色仅限特定设备使用而感到困扰？本文介绍如何通过简单步骤完成 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 https://github.com/airi-project/airi.git
cd airi
- 安装依赖并启动 Web 服务
pnpm install
pnpm dev:web
Web 端架构基于 Vue.js 和 Vite 构建，核心配置文件为 apps/stage-web/vite.config.ts，你可以通过修改此文件自定义端口或添加代理设置。访问 http://localhost:5173 即可看到 AIri 的 Web 界面。
第二步：Electron 桌面端部署
桌面端提供比 Web 版更丰富的功能，如系统通知、本地文件访问和 GPU 加速渲染。
- 切换到桌面端项目目录
cd apps/stage-tamagotchi
- 安装依赖并开发模式启动
pnpm install
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 浏览器：点击菜单按钮 → "安装应用"
