128 lines
4.4 KiB
Markdown
128 lines
4.4 KiB
Markdown
# VibeCoding — WebRTC 远程控制系统
|
||
|
||
本仓库为多端单体仓库（monorepo）：1 个 Spring Boot 信令服务器 + 1 个后台管理前端 + 1 个 Android 被控端 + 5 个控制端（Android / iOS / Flutter / Web）+ 1 个独立 ADB 回环工具。
|
||
|
||
> 标注 **（待填写）** 的项表示尚未确认，请按实际环境补充。
|
||
|
||
---
|
||
|
||
## 一、WebRTCSignalServer — 信令服务器（Spring Boot）
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 工程类型 | Spring Boot 应用（Maven） |
|
||
| 框架版本 | Spring Boot 4.1.0 |
|
||
| 语言 / JDK | Java 25 |
|
||
| IDE | IntelliJ IDEA 2025.3.1 |
|
||
| 运行端口 | 8080 |
|
||
| 外部依赖 | MySQL（JPA 持久化）、Redis（在线状态 / 频控 / nonce / 踢线广播） |
|
||
| 构建命令 | `mvn clean package` / `mvn spring-boot:run` |
|
||
| 配置入口 | `src/main/resources/application.yml`（敏感项走环境变量） |
|
||
|
||
## 二、WebRTCSignalServerWeb — 后台管理前端（Vue3 + TS）
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 工程类型 | Vue 3 SPA（TypeScript，ESM） |
|
||
| Vue | ^3.5.12 |
|
||
| TypeScript | ^5.6.3 |
|
||
| Vite | ^5.4.10 |
|
||
| Pinia / Vue Router | ^2.2.4 / ^4.4.5 |
|
||
| UI 组件库 | Element Plus ^2.8.4 |
|
||
| Node.js | 24.14.1 |
|
||
| 包管理器 | npm |
|
||
| dev 端口 | 5180 |
|
||
| 命令 | `npm run dev` / `npm run build`（含 `vue-tsc --noEmit`）/ `npm run preview` |
|
||
|
||
## 三、WebRTCControlled — Android 被控端
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 语言 | Java（Java 8） |
|
||
| IDE | Android Studio Panda 4 \| 2025.3.4 Patch 1 |
|
||
| applicationId | `com.ttstd.controlled` |
|
||
| compileSdk | 34 |
|
||
| minSdk | 24 |
|
||
| targetSdk | 34 |
|
||
| Gradle Wrapper | 8.13 |
|
||
| Android Gradle Plugin | 8.13.2 |
|
||
| JDK 版本 | 21 |
|
||
| 签名配置 | 依赖外部 `config.gradle`（`keypub` / `crosshatch` / `zhanxun`），不在仓库内 |
|
||
| 构建命令 | `gradlew.bat assembleDebug`（Windows）/ `./gradlew assembleDebug` |
|
||
|
||
## 四、WebRTCController — Android 控制端
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 语言 | Java（Java 8） |
|
||
| IDE | Android Studio Panda 4 \| 2025.3.4 Patch 1 |
|
||
| applicationId | `com.ttstd.controller` |
|
||
| compileSdk | 34 |
|
||
| minSdk | 24 |
|
||
| targetSdk | 34 |
|
||
| Gradle Wrapper | 8.13 |
|
||
| Android Gradle Plugin | 8.13.2 |
|
||
| JDK 版本 | 21 |
|
||
| 签名配置 | 同被控端，依赖外部 `config.gradle` |
|
||
| 构建命令 | `gradlew.bat assembleDebug`（Windows）/ `./gradlew assembleDebug` |
|
||
|
||
## 五、webrtc_controller_flutter — Flutter 控制端（跨平台）
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 工程类型 | Flutter App（Android + iOS） |
|
||
| Dart SDK | ^3.12.2 |
|
||
| IDE | Android Studio Panda 4 \| 2025.3.4 Patch 1 |
|
||
| Flutter 版本 | （待填写，channel: stable） |
|
||
| Android compileSdk / minSdk / targetSdk | 跟随 Flutter 默认（`flutter.compileSdkVersion` / `flutter.minSdkVersion` / `flutter.targetSdkVersion`，具体值待确认） |
|
||
| Android 编译兼容 | Java 17（jvmTarget 17） |
|
||
| iOS Deployment Target | 13.0 |
|
||
| iOS Swift 版本 | 5.0 |
|
||
| Gradle Wrapper | 8.14 |
|
||
| 依赖管理 | pub（核心：`flutter_webrtc ^1.5.2`） |
|
||
| 命令 | `flutter pub get` / `flutter run` / `flutter analyze` |
|
||
|
||
## 六、webrtc_controller_ios — 原生 iOS 控制端
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 工程类型 | iOS App（UIKit + SwiftUI 混合） |
|
||
| 语言 | Swift 5.0 |
|
||
| iOS Deployment Target | 15.0 |
|
||
| Xcode 版本 | 16 |
|
||
| 依赖管理 | Swift Package Manager（无 CocoaPods） |
|
||
| 关键依赖 | WebRTC（SPM 远程包） |
|
||
| 构建方式 | 用 Xcode 打开 `webrtc_controller_ios.xcodeproj` 运行 |
|
||
|
||
## 七、WebRTCControllerWeb — 网页控制端（Vue3 + JS）
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 工程类型 | Vue 3 SPA（纯 JavaScript，无 TypeScript） |
|
||
| Vue | ^3.4.21 |
|
||
| Vite | ^5.2.0 |
|
||
| 控制指令编码 | protobufjs ^7.3.2（浏览器原生 WebRTC API） |
|
||
| Node.js | v24.14.1 |
|
||
| 包管理器 | npm |
|
||
| dev 端口 | 5173（`/api` 与 `/ws/signal` 代理到信令服务器） |
|
||
| 命令 | `npm run dev` / `npm run build` / `npm run preview` |
|
||
|
||
## ~~八、AdbLoopbackController — ADB 回环控制工具（独立）~~
|
||
|
||
| 项目 | 值 |
|
||
|---|---|
|
||
| 工程类型 | Android App（纯 Java） |
|
||
| 语言 | Java（Java 8） |
|
||
| IDE | Android Studio Panda 4 \| 2025.3.4 Patch 1 |
|
||
| applicationId | `com.ttstd.adbloopback` |
|
||
| compileSdk | 34 |
|
||
| minSdk | 24 |
|
||
| targetSdk | 34 |
|
||
| Gradle Wrapper | 8.13 |
|
||
| Android Gradle Plugin | 8.1.4 |
|
||
| JDK 版本 | 21 |
|
||
| 签名配置 | 依赖外部 `config.gradle`（`keypub`） |
|
||
| 构建命令 | `gradlew.bat assembleDebug`（Windows）/ `./gradlew assembleDebug` |
|
||
|
||
---
|