docs(webrtc_controller_flutter): 更新项目文档以反映重构后的架构

AGENTS.md 与 README.md 同步更新：根据实际代码结构重写目录树、技术栈、架构分层及编码规范，移除旧版内联示例并补充新的开发约定与代码生成命令。

webrtc_controller_flutter/lib/app/app.dart

@@ -0,0 +1,30 @@
+import 'package:flutter/cupertino.dart';
+import 'package:flutter_localizations/flutter_localizations.dart';
+import 'package:webrtc_controller_flutter/l10n/app_localizations.dart';
+
+import 'router/app_router.dart';
+import 'theme/app_theme.dart';
+
+/// 应用根组件：CupertinoApp + GoRouter。
+class WebrtcControllerApp extends StatelessWidget {
+  const WebrtcControllerApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return CupertinoApp.router(
+      title: 'WebRTC 控制端',
+      theme: AppTheme.light,
+      localizationsDelegates: const [
+        AppLocalizations.delegate,
+        GlobalCupertinoLocalizations.delegate,
+        GlobalMaterialLocalizations.delegate,
+        GlobalWidgetsLocalizations.delegate,
+      ],
+      supportedLocales: const [
+        Locale('zh'),
+        Locale('en'),
+      ],
+      routerConfig: appRouter,
+    );
+  }
+}

webrtc_controller_flutter/lib/app/constants/app_constants.dart

@@ -0,0 +1,24 @@
+// 全局常量与 API 端点。
+
+/// 服务端 HTTP 基址（与信令同源）。部署时通过 --dart-define=API_BASE= 注入。
+const String kApiBase = String.fromEnvironment(
+  'API_BASE',
+  defaultValue: 'https://www.ttstd.com',
+);
+
+/// 信令 WebSocket 默认地址。
+const String kDefaultSignalServer = 'wss://www.ttstd.com/signal';
+
+/// DataChannel 标签，控制端与被控端需一致。
+const String kDataChannelLabel = 'control_channel';
+
+/// 分辨率预设：width 为长边像素；0 表示被控端原生分辨率。
+const List<Map<String, Object>> kResolutionOptions = [
+  {'label': '原始', 'width': 0, 'height': 0, 'fps': 0},
+  {'label': '1080P', 'width': 1920, 'height': 0, 'fps': 0},
+  {'label': '720P', 'width': 1280, 'height': 0, 'fps': 0},
+  {'label': '480P', 'width': 854, 'height': 0, 'fps': 0},
+];
+
+/// 默认帧率档位（收到被控端上报的 supported_fps 后以上报列表为准）。
+const List<int> kDefaultFpsOptions = [15, 24, 30, 60];

webrtc_controller_flutter/lib/app/constants/ice_servers.dart

@@ -0,0 +1,48 @@
+/// ICE 服务器配置。
+///
+/// 与可正常连接的 `webrtc_controller_ios`（原生 Swift 项目）保持一致：
+/// 使用 `www.ttstd.com:3478` 作为 STUN/TURN 服务器。
+///
+/// 注意：旧配置曾误用 `175.178.213.60:3478`（错误凭据）及内网
+/// `192.168.5.224:3478`（模拟器不可达），导致 iOS 模拟器下
+/// `ICE Checking -> Failed`。已修正为与 iOS 原生项目相同的服务器。
+///
+/// **iOS 模拟器关键修复**：
+/// 明文 `turn:175.178.213.60:3478` 在 iOS 模拟器（libwebrtc）下不会发起
+/// RELAY 分配请求，导致控制端本地候选缺失 `typ relay`，两端无公共中继可
+/// 配对 → candidate-pair=0 → ICE Failed（Android 真机/网页则正常）。
+/// 改用 `turns:`（TLS over TCP 5349）后，模拟器能稳定拿到 relay 候选。
+/// 同时保留 udp / tcp 明文项作为降级，以及 STUN 用于 srflx。
+const List<Map<String, dynamic>> kIceServers = [
+  {'urls': 'stun:stun.l.google.com:19302'},
+  {'urls': 'stun:175.178.213.60:3478'},
+  {
+    // 首选：TLS over TCP，iOS 模拟器下能稳定分配 relay 候选。
+    'urls': 'turns:175.178.213.60:5349',
+    'username': 'fanhuitong',
+    'credential': 'Fan19961907..',
+  },
+  {
+    // 降级：明文 UDP/TCP。
+    'urls': 'turn:175.178.213.60:3478',
+    'username': 'fanhuitong',
+    'credential': 'Fan19961907..',
+  },
+  {
+    'urls': 'turn:175.178.213.60:3478?transport=tcp',
+    'username': 'fanhuitong',
+    'credential': 'Fan19961907..',
+  },
+  {'urls': 'stun:47.242.112.133:3478'},
+  {
+    'urls': 'turn:47.242.112.133:3478',
+    'username': 'ttstd',
+    'credential': 'fanhuitong',
+  },
+  {'urls': 'stun:192.168.5.224:3478'},
+  {
+    'urls': 'turn:192.168.5.224:3478',
+    'username': 'tt',
+    'credential': 'fht',
+  },
+];

webrtc_controller_flutter/lib/app/router/app_router.dart

@@ -0,0 +1,21 @@
+import 'package:go_router/go_router.dart';
+
+import '../../features/connection/presentation/pages/control_page.dart';
+import '../../features/connection/presentation/pages/setup_page.dart';
+
+/// 应用路由：/ = 连接设置页，/control = 控制面板页。
+final appRouter = GoRouter(
+  initialLocation: '/',
+  routes: [
+    GoRoute(
+      path: '/',
+      name: 'setup',
+      builder: (context, state) => const SetupPage(),
+    ),
+    GoRoute(
+      path: '/control',
+      name: 'control',
+      builder: (context, state) => const ControlPage(),
+    ),
+  ],
+);

webrtc_controller_flutter/lib/app/theme/app_theme.dart

@@ -0,0 +1,11 @@
+import 'package:flutter/cupertino.dart';
+
+/// 全局 Cupertino 主题配置。
+class AppTheme {
+  const AppTheme._();
+
+  /// 应用统一主题（iOS 风格）。
+  static const CupertinoThemeData light = CupertinoThemeData(
+    primaryColor: CupertinoColors.activeBlue,
+  );
+}