chore: release v1.0.29

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

client/lib/core/platform/single_instance.dart

@@ -0,0 +1,27 @@
+import 'dart:io';
+
+import 'package:flutter/foundation.dart';
+import 'package:path_provider/path_provider.dart';
+
+// Keep the RAF open so the OS lock stays alive for the lifetime of the process.
+// ignore: unused_element
+RandomAccessFile? _raf;
+
+/// Returns true if this process successfully acquired the single-instance lock.
+/// Returns false if another instance is already running.
+/// On Web / mobile / Linux the function always returns true (no restriction).
+Future<bool> acquire() async {
+  if (kIsWeb) return true;
+  if (!Platform.isWindows && !Platform.isMacOS) return true;
+
+  try {
+    final dir = await getApplicationSupportDirectory();
+    final lockFile = File('${dir.path}/jiu.lock');
+    final raf = await lockFile.open(mode: FileMode.write);
+    await raf.lock(FileLock.exclusive);
+    _raf = raf;
+    return true;
+  } catch (_) {
+    return false;
+  }
+}

client/lib/main.dart

@@ -1,4 +1,5 @@
 import 'dart:async';
+import 'dart:io';
 import 'package:flutter/material.dart';
 import 'package:flutter_localizations/flutter_localizations.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
@@ -6,6 +7,7 @@ import 'package:flutter_web_plugins/url_strategy.dart';
 import 'core/auth/auth_state.dart';
 import 'core/config/app_info.dart';
 import 'core/errors/error_reporter.dart';
+import 'core/platform/single_instance.dart' as single_instance;
 import 'core/router/app_router.dart';
 import 'core/theme/app_theme.dart';
 import 'providers/connectivity_provider.dart';
@@ -27,6 +29,12 @@ void main() {
   runZonedGuarded(
     () async {
       WidgetsFlutterBinding.ensureInitialized();
+
+      if (!await single_instance.acquire()) {
+        runApp(const _AlreadyRunningApp());
+        return;
+      }
+
       await AppInfo.load(); // 从配置文件加载「关于我们」品牌信息
       runApp(const ProviderScope(child: JiuApp()));
     },
@@ -43,6 +51,38 @@ void main() {
   );
 }
 
+class _AlreadyRunningApp extends StatelessWidget {
+  const _AlreadyRunningApp();
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      debugShowCheckedModeBanner: false,
+      home: Builder(
+        builder: (context) {
+          WidgetsBinding.instance.addPostFrameCallback((_) {
+            showDialog<void>(
+              context: context,
+              barrierDismissible: false,
+              builder: (_) => AlertDialog(
+                title: const Text('岩美酒库已在运行'),
+                content: const Text('请勿重复打开，程序已在运行中。\n请在任务栏或 Dock 中找到已打开的窗口。'),
+                actions: [
+                  TextButton(
+                    onPressed: () => exit(0),
+                    child: const Text('确定'),
+                  ),
+                ],
+              ),
+            );
+          });
+          return const Scaffold();
+        },
+      ),
+    );
+  }
+}
+
 class JiuApp extends ConsumerStatefulWidget {
   const JiuApp({super.key});