告别设备限制：AIri全平台部署攻略（Web/桌面/移动无缝体验）
告别设备限制：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的最便捷方式，无需安装任何软件，通过现代浏览器即可运行。
- 访问应用 打开浏览器访问
http://localhost:5173，即可看到AIri的Web界面。
安装依赖并启动Web服务
pnpm i pnpm dev:web 克隆项目仓库
git clone https://gitcode.com/GitHub_Trending/ai/airi.git cd airi Web端架构基于Vue.js和Vite构建，核心配置文件为apps/stage-web/vite.config.ts，你可以通过修改此文件自定义端口或添加代理设置。
第二步：Electron桌面端部署（功能完整）
桌面端提供比Web版更丰富的功能，如系统通知、本地文件访问和GPU加速渲染。
打包生成可执行文件
pnpm build 安装依赖并开发模式启动
pnpm i pnpm dev 切换到桌面端项目目录
cd apps/stage-tamagotchi 打包完成后，可执行文件将生成在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中配置硬件加速
- 多设备同步 通过配置packages/memory-pgvector/实现不同设备间的对话历史同步。
总结与后续展望
通过本文介绍的方法，你已经成功实现了AIri在Web、桌面和移动设备的全平台部署。这种多端覆盖架构不仅提升了用户体验的连续性，也展示了项目基于Web技术栈的灵活性——从WebGPU加速渲染到WebAssembly性能优化，AIri充分利用现代Web技术实现了跨平台能力。
未来，项目计划进一步增强移动设备的AR功能，允许AIri以虚拟形象出现在现实环境中。你可以通过关注docs/content/zh-Hans/blog/获取最新开发动态，或参与crates/tauri-plugin-mcp/等插件的开发，为多平台支持贡献力量。
现在，打开你部署好的AIri应用，开始与你的虚拟伙伴共度美好时光吧！
