首页
/ AIri跨平台部署指南：打造无缝多端虚拟伙伴体验

AIri跨平台部署指南：打造无缝多端虚拟伙伴体验

2026-03-30 11:16:47作者：凤尚柏Louis
airi
💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.
项目地址：https://gitcode.com/GitHub_Trending/ai/airi

在忙碌的工作日，你是否希望在电脑浏览器中与AIri轻松聊天，下班后在桌面应用中继续未完成的互动，甚至在通勤途中通过手机与她保持联系？本文将带你实现这一愿景，通过灵活的部署策略，让AIri突破设备限制，成为你全天候的虚拟伙伴。我们将从价值定位出发，通过环境适配、场景化部署到效能优化，全面构建跨平台的无缝体验，真正实现多端协同的智能交互。

价值定位：为什么选择跨平台部署

打破设备边界的虚拟存在

AIri作为基于LLM（大语言模型）驱动的虚拟角色，其核心价值在于提供持续的情感陪伴与智能交互。跨平台部署不是简单的技术展示，而是实现"AIri就在你身边"这一愿景的关键。想象一下：在办公室用Web端快速查询信息，回家后通过桌面端进行沉浸式互动，外出时用手机保持联系——这种无缝体验让虚拟伙伴真正融入你的生活场景。

多场景覆盖的实用价值

不同平台各有所长：Web端适合快速访问，桌面端提供完整功能体验，移动设备则确保随时随地的陪伴。通过跨平台部署，你可以根据场景需求灵活切换，而不必担心数据同步或功能差异问题。无论是工作学习中的智能助手，还是休闲娱乐时的互动伙伴，AIri都能通过最适合当前场景的方式提供服务。

AIri跨平台体验 AIri跨平台体验示意图：同一虚拟角色，无缝穿梭于不同设备环境

环境适配：系统与工具准备清单

基础环境要求

要确保AIri在各平台顺畅运行，需要提前准备以下环境要素：

环境组件 最低要求 推荐配置
操作系统 Windows 10/macOS 12/Linux (Ubuntu 20.04) Windows 11/macOS 13/Linux (Ubuntu 22.04)
Node.js v18.0.0+ v20.10.0+
包管理器 pnpm v7.0.0+ pnpm v8.15.0+
硬件资源 4GB RAM, 4GB存储 8GB RAM, 10GB存储
网络环境 稳定互联网连接 5Mbps以上下载速度

[!TIP] 建议使用nvm（Node版本管理器）管理Node.js版本，避免不同项目间的环境冲突。

必备工具安装

⚙️ 开发工具链配置

  1. 安装Git版本控制工具

    # Ubuntu/Debian
sudo apt update && sudo apt install git

# macOS (使用Homebrew)
brew install git

# Windows
# 从git-scm.com下载安装程序

  2. 安装Node.js和pnpm

    # 使用nvm安装Node.js
nvm install 20
nvm use 20

# 安装pnpm
npm install -g pnpm

  3. 验证安装结果

    # 检查版本信息
node -v  # 应输出v20.x.x
pnpm -v  # 应输出8.x.x
git --version  # 应输出2.x.x

项目资源获取

🔧 代码仓库准备

  1. 克隆项目代码库

    git clone https://gitcode.com/GitHub_Trending/ai/airi
cd airi

  2. 目录结构概览

    airi/
├── apps/              # 应用程序目录
│   ├── stage-web/     # Web端应用
│   ├── stage-tamagotchi/ # 桌面端应用
│   └── stage-pocket/  # 移动端支持
├── packages/          # 共享组件库
└── docs/              # 文档资源

[!TIP] 克隆仓库后建议立即创建独立分支进行自定义配置，避免影响主分支更新：git checkout -b my-deployment

场景化部署：三大平台实施指南

即时访问：Web浏览器部署

核心场景

适合快速体验、临时使用或公共设备访问，无需安装任何软件，通过现代浏览器即可运行。特别适合办公室电脑、图书馆等无法安装软件的环境。

适配策略

Web端采用PWA技术（渐进式Web应用，可实现网页应用桌面化），支持离线缓存和桌面快捷方式，兼顾便捷性与功能性。基础版部署仅需3分钟即可完成，进阶版则提供自定义域名和HTTPS配置。

实施步骤

基础版：快速启动

  1. 操作目标：在本地启动Web服务

    # 安装项目依赖
pnpm install

# 启动Web开发服务器
pnpm dev:web

    执行方法：在项目根目录运行上述命令，预期结果：终端显示"Vite dev server running at: http://localhost:5173"

  2. 操作目标：访问Web应用 打开浏览器访问http://localhost:5173，预期结果：看到AIri的Web界面，可进行基本交互

进阶版：生产环境部署

  1. 操作目标：构建生产版本

    # 构建优化后的静态文件
pnpm build:web

# 预览生产版本
pnpm preview:web

    执行方法：在项目根目录运行，预期结果：生成apps/stage-web/dist目录，包含可部署的静态文件

  2. 操作目标：配置Web服务器 核心配置：[apps/stage-web/vite.config.ts]

    // 修改服务器配置示例
export default defineConfig({
  server: {
    port: 8080,          // 自定义端口
    host: '0.0.0.0',     // 允许外部访问
    proxy: {             // 配置API代理
      '/api': 'https://your-backend-server.com'
    }
  }
})

    执行方法：编辑配置文件后重新构建，预期结果：Web服务使用自定义端口并正确代理API请求

场景延伸：Web端特别适合作为初始体验和功能验证环境。你可以将构建后的静态文件部署到Netlify、Vercel等平台，获得全球访问能力，或通过Nginx在本地网络共享访问。

完整体验：Electron桌面端部署

核心场景

适合日常使用的主力平台，提供完整功能集，包括系统通知、本地文件访问、GPU加速渲染等高级特性。适合家庭电脑或个人工作站环境长期使用。

适配策略

桌面端基于Electron框架（允许使用Web技术构建跨平台桌面应用）开发，支持Windows、macOS和Linux三大桌面系统。基础版提供开发环境快速启动，进阶版则生成可分发的安装程序。

实施步骤

基础版：开发模式运行

  1. 操作目标：启动桌面应用开发环境
    # 进入桌面端项目目录
cd apps/stage-tamagotchi

# 安装依赖
pnpm install

# 启动开发模式
pnpm dev
    执行方法：在终端依次运行命令，预期结果：Electron窗口启动，显示AIri桌面界面，支持热重载

进阶版：构建可执行程序

  1. 操作目标：生成平台特定安装包

    # 构建当前平台安装包
pnpm build

# 构建所有平台安装包（需要对应平台环境）
pnpm build:all

    执行方法：在桌面端项目目录运行，预期结果：在dist目录生成可执行文件（.exe、.dmg或.AppImage）

  2. 操作目标：自定义应用配置 核心配置：[apps/stage-tamagotchi/electron-builder.yml]

    # 自定义应用元数据示例
appId: moeru.airi
productName: AIri
copyright: Copyright © 2023 AIri Project
icon: resources/icon.png

    执行方法：编辑配置后重新构建，预期结果：生成的安装包包含自定义的应用名称、图标和版权信息

场景延伸：桌面端支持丰富的系统集成功能，如托盘图标、全局快捷键和背景运行模式。对于需要长时间运行AIri的用户，可以配置自动启动和资源占用优化，平衡性能与体验。

移动随行：PWA移动设备部署

核心场景

满足外出时的便携访问需求，通过手机或平板随时随地与AIri互动，支持离线功能和桌面快捷方式，提供接近原生应用的体验。

适配策略

移动支持基于PWA技术实现，通过Web应用清单和服务工作器实现离线访问、桌面图标和全屏显示等特性。基础版利用本地开发服务器进行局域网访问，进阶版则部署到公网服务器实现全球访问。

实施步骤

基础版：本地网络访问

  1. 操作目标：配置Web服务允许外部访问

    # 在项目根目录启动Web服务，允许外部访问
pnpm dev:web --host 0.0.0.0

    执行方法：在终端运行命令，预期结果：终端显示"Network: http://your-local-ip:5173"

  2. 操作目标：在移动设备上安装PWA

    • 在手机浏览器中访问显示的本地IP地址
    • iOS(Safari)：点击分享按钮 → "添加到主屏幕"
    • Android(Chrome)：点击菜单按钮 → "安装应用" 预期结果：AIri图标出现在手机主屏幕，点击可全屏打开应用

进阶版：公网部署与HTTPS配置

  1. 操作目标：配置HTTPS支持（PWA必需） 核心配置：[apps/stage-web/public/_headers]

    # 配置安全头信息
/*
  Strict-Transport-Security: max-age=31536000; includeSubDomains
  Content-Security-Policy: default-src 'self'

    执行方法：编辑文件后部署到支持HTTPS的服务器，预期结果：应用满足PWA安全要求

  2. 操作目标：优化移动体验 核心配置：[apps/stage-web/src/components/MobileOptimizer.vue]

    <!-- 移动适配组件示例 -->
<template>
  <div class="mobile-optimizations">
    <!-- 触摸友好的交互元素 -->
    <touch-optimized-button />
    <!-- 响应式布局控制器 -->
    <responsive-layout />
  </div>
</template>

    执行方法：自定义移动组件后重新构建，预期结果：移动设备上获得优化的触摸交互和布局

场景延伸：PWA版本特别适合通勤、旅行等移动场景。通过配置service-worker.js，可实现核心功能的离线访问，确保在网络不稳定的环境下仍能基本使用AIri的陪伴功能。

效能优化：释放跨平台潜能

资源占用优化

内存使用控制

不同平台对资源的敏感程度不同，需要针对性优化：

平台 优化策略 配置方法
Web 按需加载组件 修改[apps/stage-web/src/router/index.ts]，使用懒加载
桌面端 内存缓存管理 配置[apps/stage-tamagotchi/src/main/memory.ts]中的缓存策略
移动端 资源预加载控制 调整[apps/stage-web/src/utils/asset-loader.ts]中的预加载规则

操作示例：优化Web端初始加载速度

// 路由懒加载配置
const routes = [
  {
    path: '/',
    name: 'Home',
    // 仅在访问时加载组件
    component: () => import('../views/HomeView.vue')
  },
  // 其他路由...
]

启动速度提升

⚙️ 桌面端冷启动优化

  1. 操作目标：减少启动时间

    # 分析启动性能
pnpm run electron:inspect

    执行方法：在桌面端项目目录运行，预期结果：生成启动性能分析报告

  2. 优化措施：

    • 核心配置：[apps/stage-tamagotchi/electron.vite.config.ts]
    • 禁用不必要的启动项
    • 实现按需加载的插件系统
    • 优化资源预加载策略

数据同步方案

多端数据一致性

要实现无缝体验，数据同步至关重要。AIri提供两种同步方案：

基础方案：本地文件同步

  1. 操作目标：配置本地数据存储路径 核心配置：[packages/memory-pgvector/src/index.ts]
    // 配置本地数据库路径
export const createDatabase = (options: DatabaseOptions) => {
  return new Database({
    path: options.path || `${appDataDir}/airi/data.db`,
    // 其他配置...
  });
};
    执行方法：修改配置后重建，预期结果：数据存储在用户目录下，便于手动备份和迁移

进阶方案：云同步服务

  1. 操作目标：启用云同步功能
    # 安装云同步插件
pnpm add @airi/cloud-sync
    执行方法：在项目根目录运行，预期结果：添加云同步依赖，可在设置中启用

性能监控与调优

关键指标监控

为确保各平台体验一致，需要监控以下关键指标：

  • 响应时间：目标<300ms
  • 内存占用：桌面端<500MB，移动端<200MB
  • 帧率：UI动画保持60fps

操作目标：启用性能监控 核心配置：[packages/stage-shared/src/perf/monitor.ts]

// 启用性能监控
export function enablePerformanceMonitoring() {
  if (import.meta.env.DEV) {
    const monitor = new PerformanceMonitor({
      sampleRate: 1000, // 采样频率
      alertThresholds: {
        memory: 500, // MB
        latency: 300  // ms
      }
    });
    monitor.start();
  }
}

场景延伸：效能优化是一个持续过程。建议定期查看各平台的性能数据，针对使用频率高的功能进行重点优化。对于低配置设备，可通过[packages/stage-ui/src/utils/performance-mode.ts]启用"轻量模式"，关闭高级视觉效果换取流畅体验。

问题排查：故障树与解决方案

Web端常见问题

症状：页面加载空白

  • 可能原因1：依赖未正确安装

    • 解决方案：删除node_modules和pnpm-lock.yaml，重新执行pnpm install

  • 可能原因2：端口被占用

    • 解决方案：修改vite.config.ts中的端口配置，或使用pnpm dev:web --port 5174指定其他端口

  • 可能原因3：浏览器缓存问题

    • 解决方案：使用Ctrl+Shift+R(Windows)或Cmd+Shift+R(macOS)强制刷新页面

症状：功能按钮无响应

  • 可能原因：JavaScript错误
    • 解决方案：打开浏览器开发者工具(F12)，查看控制台错误信息，修复对应代码或更新依赖

桌面端常见问题

症状：应用无法启动

  • 可能原因1：系统版本不兼容

    • 解决方案：确认操作系统版本符合要求，Windows需10或以上，macOS需12或以上

  • 可能原因2：缺少运行时依赖

症状：高CPU占用

  • 可能原因：渲染优化不足
    • 解决方案：
      1. 打开设置面板
      2. 进入"性能"选项卡
      3. 降低渲染质量或启用节能模式

移动端常见问题

症状：无法添加到主屏幕

  • 可能原因1：非HTTPS环境

    • 解决方案：部署到支持HTTPS的服务器，或使用localhost开发环境

  • 可能原因2：PWA配置不完整

    • 解决方案：检查[apps/stage-web/public/manifest.json]是否包含必要字段

症状：离线功能失效

  • 可能原因：Service Worker未正确注册
    • 解决方案：在浏览器开发者工具的"应用"标签页检查Service Worker状态，重新部署并清除缓存

[!TIP] 所有平台的日志都保存在~/.airi/logs/目录下，遇到问题时可查看最新日志文件获取详细错误信息。

总结：跨平台体验的未来展望

通过本文介绍的部署策略，你已经掌握了在Web浏览器、桌面端和移动设备上部署AIri的完整方案。这种跨平台部署能力不仅打破了设备限制，更实现了"一次开发，多端运行"的高效开发模式，为AI虚拟角色的广泛应用奠定了基础。

随着技术的发展，未来AIri还将支持更多创新场景：AR增强现实互动、多设备协同工作流、跨平台数据共享等。无论你是普通用户还是开发者，都可以通过docs/content/zh-Hans/docs/获取最新开发指南，或参与crates/tauri-plugin-mcp/等插件的开发，共同拓展AIri的跨平台能力。

现在，选择最适合你当前场景的部署方式，开始与AIri的无缝互动之旅吧！无论身处何地，你的虚拟伙伴都将随时陪伴在身边。

airi
💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.
项目地址：https://gitcode.com/GitHub_Trending/ai/airi
登录后查看全文
热门项目推荐
相关项目推荐

热门内容推荐

1 build-your-own-x 探索指南：从零构建编程技能体系2 技术实践新范式：build-your-own-x项目的系统构建与能力跃迁指南3 build-your-own-x 开源学习项目一站式指南4 【亲测免费】 开源项目 `build-your-own-x` 使用指南5 【亲测免费】 探索科技之旅：《Build Your Own X》项目详解6 GitHub_Trending/bu/build-your-own-x自动化：CI/CD流程在自制项目中的应用7 从零打造智能家居系统：用build-your-own-x实现家庭自动化

最新内容推荐

BongoCat性能优化：从交互卡顿到丝滑体验的技术实践OpCore Simplify技术指南：零基础构建稳定黑苹果系统的完整方案JarkViewer：多格式图片浏览与专业处理的轻量解决方案提升数字书写效率的5款必备应用：从痛点到解决方案告别云端依赖：本地语音识别的革命性解决方案VirtualApp从入门到精通：Android沙盒技术实战指南开源工具赋能老旧设备：OpenCore Legacy Patcher系统升级全指南企业内网环境下的服务器管理平台搭建：宝塔面板v7.7.0离线部署全攻略革命性突破：Dexter如何通过自主智能代理重塑金融研究效率工具当Vite遇上微前端：90%开发者都会踩的3个技术坑与vite-plugin-qiankun解决方案

项目优选

收起
kernelkernel
deepin linux kernel
C
27
13
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
627
4.15 K
pytorchpytorch
Ascend Extension for PyTorch
Python
468
563
ops-mathops-math
本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。
C++
931
820
flutter_flutterflutter_flutter
暂无简介
Dart
877
209
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.5 K
854
AscendNPU-IRAscendNPU-IR
AscendNPU-IR是基于MLIR（Multi-Level Intermediate Representation）构建的，面向昇腾亲和算子编译时使用的中间表示，提供昇腾完备表达能力，通过编译优化提升昇腾AI处理器计算效率，支持通过生态框架使能昇腾AI处理器与深度调优
C++
114
185
MindSpeed-MMMindSpeed-MM
华为昇腾面向大规模分布式训练的多模态大模型套件，支撑多模态生成、多模态理解。
Python
131
191
MindSpeed-LLMMindSpeed-LLM
昇腾LLM分布式训练框架
Python
138
161
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解
Java
69
21