1
MaterialApp(                    // ← 根 Widget
2
  home: Scaffold(               // ← 页面骨架
3
    appBar: AppBar(             // ← 顶栏
4
      title: Text('Lumi Hub'),
5
    ),
6
    body: Column(               // ← 垂直布局
7
      children: [
8
        Text('Hello'),          // ← 文本
9
        ElevatedButton(         // ← 按钮
10
          onPressed: () {},
11
          child: Text('Click'),
12
        ),
13
      ],
14
    ),
15
  ),
16
)

1
class AuthWrapper extends StatelessWidget {
2
  const AuthWrapper({super.key});
3

4
  @override
5
  Widget build(BuildContext context) {
6
    final bootstrap = context.watch<BootstrapService>();
7
    final ws = context.watch<WsService>();
8

9
    // 根据状态决定显示哪个页面
10
    if (!bootstrap.isReady) {
11
      return const BootstrapScreen();   // 启动中 → 启动屏
12
    }
13
    if (!ws.isAuthenticated) {
14
      return const AuthScreen();        // 未登录 → 登录屏
15
    }
16
    return const ChatScreen();          // 已登录 → 聊天屏
17
  }
18
}

1
// 第一部分：Widget（不可变的配置）
2
class ChatScreen extends StatefulWidget {
3
  const ChatScreen({super.key});
4

5
  @override
6
  State<ChatScreen> createState() => _ChatScreenState();
7
  //                                 ^^^^^^^^^^^^^^^^^
8
  //               创建对应的 State 对象
9
}
10

11
// 第二部分：State（可变的状态 + 构建逻辑）
12
class _ChatScreenState extends State<ChatScreen> {
13
  // 可变状态
14
  int _counter = 0;
15

16
  // 修改状态
17
  void _increment() {
18
    setState(() {     // ← 通知框架"状态变了，请重建 UI"
19
      _counter++;
20
    });
21
  }
22

23
  // 构建 UI
24
  @override
25
  Widget build(BuildContext context) {
26
    return Text('Count: $_counter');
27
  }
28
}

1
class _LumiAppState extends State<LumiApp> with WindowListener, TrayListener {
2
  bool _isClosing = false;
3
  final GlobalKey<NavigatorState> _navigatorKey = GlobalKey<NavigatorState>();
4

5
  // ② initState：注册平台监听器
6
  @override
7
  void initState() {
8
    super.initState();
9
    if (!kIsWeb && Platform.isWindows) {
10
      windowManager.addListener(this);     // ← 窗口事件监听
11
      trayManager.addListener(this);       // ← 托盘事件监听
12
      _initTray();                         // ← 初始化托盘图标
13
    }
14
  }
15

16
  // ⑦ dispose：移除平台监听器
17
  @override
18
  void dispose() {
19
    if (!kIsWeb && Platform.isWindows) {
20
      trayManager.removeListener(this);    // ← 移除托盘监听
21
      windowManager.removeListener(this);  // ← 移除窗口监听
22
    }
23
    super.dispose();
24
  }
25

26
  // ④ build：构建 MaterialApp
27
  @override
28
  Widget build(BuildContext context) {
29
    final settings = context.watch<AppSettings>();
30
    return MaterialApp(
31
      navigatorKey: _navigatorKey,
32
      title: 'Lumi Hub',
33
      themeMode: ThemeMode.system,
34
      theme: AppTheme.light(fontFamily: settings.fontFamily),
35
      darkTheme: AppTheme.dark(fontFamily: settings.fontFamily),
36
      home: const AuthWrapper(),
37
    );
38
  }
39
}

1
class _ChatScreenState extends State<ChatScreen> {
2
  // 控制器（需要在 dispose 中销毁）
3
  final TextEditingController _input = TextEditingController();
4
  final ScrollController _scroll = ScrollController();
5
  final FocusNode _focusNode = FocusNode();
6

7
  // 订阅（需要在 dispose 中取消）
8
  StreamSubscription? _authSubscription;
9
  VoidCallback? _wsListener;
10

11
  // 状态字段
12
  bool _isSelectionMode = false;
13
  bool _pendingInitialBottom = true;
14
  int _lastMessageCount = 0;
15

16
  // ② initState：订阅 + 添加监听
17
  @override
18
  void initState() {
19
    super.initState();
20
    // ↓ 用 addPostFrameCallback 延迟到第一帧后，此时 context 可用
21
    WidgetsBinding.instance.addPostFrameCallback((_) {
22
      final ws = context.read<WsService>();
23
      _authSubscription = ws.authRequests.listen(_handleAuthRequest);
24
      _wsListener = () {
25
        if (!mounted) return;     // ← 安全检查
26
        // ... 处理消息列表变化 ...
27
      };
28
      ws.addListener(_wsListener!);
29
    });
30
    _scroll.addListener(_onScrollMaybeLoadOlder);
31
  }
32

33
  // ⑦ dispose：清理一切
34
  @override
35
  void dispose() {
36
    final ws = context.read<WsService>();
37
    if (_wsListener != null) {
38
      ws.removeListener(_wsListener!);    // ← 移除 ChangeNotifier 监听
39
    }
40
    _authSubscription?.cancel();          // ← 取消 Stream 订阅
41
    _input.dispose();                     // ← 销毁文本控制器
42
    _scroll.dispose();                    // ← 销毁滚动控制器
43
    _focusNode.dispose();                 // ← 销毁焦点节点
44
    super.dispose();
45
  }
46
}

1
// ✅ 正确：在 setState 内修改状态
2
setState(() {
3
  _counter++;
4
  _name = 'new name';
5
});
6

7
// ✅ 也正确：先修改，再调 setState
8
_counter++;
9
_name = 'new name';
10
setState(() {});  // 空的也行，只是通知框架"该重建了"
11

12
// ❌ 错误：在 build 方法中调用 setState
13
@override
14
Widget build(BuildContext context) {
15
  setState(() { _x = 1; });  // 无限循环！
16
  return Text('$_x');
17
}
18

19
// ❌ 错误：在 dispose 后调用 setState
20
@override
21
void dispose() {
22
  super.dispose();
23
  setState(() {});  // 崩溃！State 已经没了
24
}