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 浏览器：点击菜单按钮 → "安装应用"
移动版特有的触摸优化和响应式布局定义在 apps/stage-web/src/components/ 目录下，主要适配手机和平板设备的交互习惯。
部署验证与问题排查
成功部署后，你可以通过以下方式验证各平台功能：
| 平台 | 验证方法 | 常见问题排查 |
|---|---|---|
| Web | 检查控制台是否有报错 | 清除浏览器缓存，确保依赖安装完整 |
| 桌面端 | 测试系统通知和窗口控制 | 检查 electron.vite.config.ts 配置 |
| 移动端 | 测试离线功能和添加到桌面 | 确认 HTTPS 环境或 localhost 访问 |
项目提供了详细的日志系统，Web 端日志可在浏览器控制台查看，桌面端日志位于 ~/.airi/logs/ 目录下。
高级配置：自定义部署优化
如果你需要进一步优化部署效果，可以考虑以下高级配置：
- 自定义模型路径 修改
packages/server-runtime/src/config.ts中的模型路径配置，使用本地 LLM 模型提高响应速度。 - 性能优化
- Web 端：启用
apps/stage-web/public/_headers中的缓存策略 - 桌面端：在
electron-builder.yml中配置硬件加速
- Web 端：启用
- 多设备同步 通过配置
packages/memory-pgvector/实现不同设备间的对话历史同步。
总结与后续展望
通过本文介绍的方法，你已经成功实现了 AIri 在 Web、桌面和移动设备的全平台部署。这种多端覆盖架构不仅提升了用户体验的连续性，也展示了项目基于 Web 技术栈的灵活性——从 WebGPU 加速渲染到 WebAssembly 性能优化，AIri 充分利用现代 Web 技术实现了跨平台能力。
未来，项目计划进一步增强移动设备的 AR 功能，允许 AIri 以虚拟形象出现在现实环境中。你可以通过关注项目文档获取最新开发动态，或参与插件的开发，为多平台支持贡献力量。
现在，打开你部署好的 AIri 应用，开始与你的虚拟伙伴共度美好时光吧！