安装指南

前置条件

  • Node.js 18/20/22/24(验证自package.json的engines字段)
  • pnpm(package.json指定onlyBuiltDependencies)
  • Git
  • 构建Android: Android Studio+JDK 17
  • 构建iOS: macOS+Xcode 15+

克隆并启动开发

git clone https://github.com/lingion/AIaW
cd AIaW
pnpm install
npx quasar dev  # localhost:9005，热重载

构建Android APK

npx quasar build -m capacitor -T android
cd src-capacitor/android
./gradlew assembleDebug
# APK: app/build/outputs/apk/debug/

首次构建Gradle会下载SDK和依赖(几分钟)，后续增量构建很快。

构建iOS IPA

npx quasar build -m capacitor -T ios
open src-capacitor/ios/App.xcworkspace
# Xcode: 选择App target→Signing Team→Product→Archive→Distribute

iOS构建必须在macOS上进行。无Mac可用GitHub Actions等CI远程构建。

安装预构建APK

从GitHub Releases下载。Android：开启允许未知来源后安装。iOS：AltStore侧载或Xcode直装(需Apple Developer账号)。

首次启动

完全离线模式——无需注册或登录。直接输入API Key使用。所有数据(对话/密钥/设置)存本地IndexedDB，不上传任何服务器。.env.app中的上游演示URL运行时被忽略(所有*BaseURL常量为undefined)。