fix(flutter): 增加首页服务器设置并更新真机默认地址

lib/core/config/app_config.dart

@@ -4,18 +4,16 @@ import 'package:flutter/foundation.dart';
 
 /// 客户端与后端约定的运行时配置。
 ///
-/// 接口地址的优先级：`--dart-define=API_BASE_URL=...` > 按运行环境判断的默认值。
+/// 接口地址优先级：运行时设置 > `--dart-define=API_BASE_URL=...` > 平台默认值。
 /// 开发机的局域网地址会随网络变化，换网络后改 [devHostBaseUrl] 即可。
 class AppConfig {
   const AppConfig._();
 
-  /// 开发机的局域网地址。真机上的 `127.0.0.1` 指向手机自己，只能走这个地址。
+  /// 真机默认使用的开发机局域网地址。
   ///
   /// 这个地址跟着电脑所在的网络走，换网络后要用
-  /// `ipconfig getifaddr en0` 重新确认并改这里；
-  /// 也可以换成 Bonjour 名字 `http://<LocalHostName>.local:8081`（本机是
-  /// `jiangdeMacBook-Air.local`），换网络不用改，但部分办公网会拦组播解析。
-  static const String devHostBaseUrl = 'http://jiangdeMacBook-Air.local:8081';
+  /// `ipconfig getifaddr en0` 重新确认。默认值只改这一行。
+  static const String devHostBaseUrl = 'http://10.157.242.1:8081';
 
   static const String _loopbackBaseUrl = 'http://127.0.0.1:8081';
 

lib/core/widgets/server_endpoint_dialog.dart

@@ -0,0 +1,128 @@
+// Author: fruit.com.cn
+
+import 'package:flutter/material.dart';
+
+import '../../l10n/app_localizations.dart';
+import '../config/app_config.dart';
+import '../config/server_endpoint.dart';
+import '../theme/app_colors.dart';
+
+/// Opens the debug-only runtime server address editor.
+Future<bool> showServerEndpointDialog(
+  BuildContext context,
+  AppLocalizations l10n,
+) async {
+  final changed = await showDialog<bool>(
+    context: context,
+    builder: (_) => _ServerEndpointDialog(l10n: l10n),
+  );
+  if (changed == true && context.mounted) {
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(l10n.restartToApply)));
+    return true;
+  }
+  return false;
+}
+
+class _ServerEndpointDialog extends StatefulWidget {
+  const _ServerEndpointDialog({required this.l10n});
+
+  final AppLocalizations l10n;
+
+  @override
+  State<_ServerEndpointDialog> createState() => _ServerEndpointDialogState();
+}
+
+class _ServerEndpointDialogState extends State<_ServerEndpointDialog> {
+  late final TextEditingController _controller = TextEditingController(
+    text: AppConfig.apiBaseUrl,
+  );
+  String? _error;
+  bool _saving = false;
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  Future<void> _save() async {
+    final normalized = ServerEndpoint.normalize(_controller.text);
+    if (normalized == null) {
+      setState(() => _error = widget.l10n.invalidServerAddress);
+      return;
+    }
+    setState(() {
+      _saving = true;
+      _error = null;
+    });
+    final saved = await ServerEndpoint.save(normalized);
+    if (!mounted) return;
+    if (!saved) {
+      setState(() {
+        _saving = false;
+        _error = widget.l10n.invalidServerAddress;
+      });
+      return;
+    }
+    Navigator.pop(context, true);
+  }
+
+  Future<void> _restoreDefault() async {
+    setState(() => _saving = true);
+    await ServerEndpoint.clear();
+    if (mounted) Navigator.pop(context, true);
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = widget.l10n;
+    return AlertDialog(
+      title: Text(l10n.serverAddress),
+      content: SingleChildScrollView(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            TextField(
+              key: const Key('server-endpoint-input'),
+              controller: _controller,
+              enabled: !_saving,
+              keyboardType: TextInputType.url,
+              autocorrect: false,
+              decoration: InputDecoration(
+                hintText: l10n.serverAddressHint,
+                errorText: _error,
+                errorMaxLines: 2,
+              ),
+            ),
+            const SizedBox(height: 10),
+            Text(
+              l10n.restartToApply,
+              key: const Key('server-endpoint-restart-hint'),
+              style: const TextStyle(color: AppColors.muted, fontSize: 12),
+            ),
+            const SizedBox(height: 4),
+            TextButton(
+              key: const Key('server-endpoint-restore'),
+              onPressed: _saving ? null : _restoreDefault,
+              child: Text(l10n.restoreDefault),
+            ),
+          ],
+        ),
+      ),
+      actions: [
+        TextButton(
+          onPressed: _saving ? null : () => Navigator.pop(context, false),
+          child: Text(l10n.cancel),
+        ),
+        FilledButton(
+          key: const Key('server-endpoint-save'),
+          onPressed: _saving ? null : _save,
+          child: Text(l10n.saveAddress),
+        ),
+      ],
+    );
+  }
+}