Venera Headless Mode Update (#476)

* 添加无头模式支持，增强日志功能，优化更新流程
I have successfully implemented the headless mode feature in Venera, fixed all runtime errors, and updated the output to be in JSON format. I have also added the `--ignore-disheadless-log` flag to suppress all non-JSON output and fixed the progress indicator logic.

You can now use the following commands:

- `venera --headless webdav up`: Upload the current WebDAV configuration.
- `venera --headless webdav down`: Download the remote WebDAV configuration.
- `venera --headless updatescript all`: Update all comic source scripts.
- `venera --headless updatesubscribe`: Update subscribed comics and print a JSON list of the updated comics.
- `venera --headless --ignore-disheadless-log ...`: Run any of the above commands while suppressing all non-JSON output.

The implementation involved:

1. Creating a new `lib/headless.dart` file to handle the headless logic.
2. Modifying `lib/main.dart` to recognize the `--headless` argument.
3. Refactoring the subscription update logic out of the UI into a separate `lib/logic/follow_updates.dart` file to be used by both the UI and the headless mode.
4. Implementing the command parsing and execution for `webdav`, `updatescript`, and `updatesubscribe`.
5. Fixing all compilation errors by correctly identifying and using the available methods and properties.
6. Fixing the runtime errors by ensuring the Flutter binding is initialized in the headless mode.
7. Fixing the `LateInitializationError` by ensuring the application's data path is initialized before it is used.
8. Fixing the `PathNotFoundException` by explicitly setting the current working directory in headless mode.
9. Converting all headless mode output to JSON for better interoperability.
10. Fixing the progress indicator bug.
11. Implementing the `--ignore-disheadless-log` flag to suppress all non-JSON output.
12. Including comic metadata in the progress output.
13. Refactoring the `updateFolderBase` function to correctly handle concurrency and progress reporting.
14. Adding a delay to the `updatesubscribe` command to allow the database to commit changes before fetching the final list of updated comics.

* 将封面字段名称从 'cover' 更改为 'coverUrl'，以统一 JSON 输出格式

* remove md

* 增强无头模式的更新进度报告，添加错误处理信息

* 修复init没有wait的问题

* 优化init函数中的异步初始化，确保所有组件初始化完成后再继续执行

* 重构更新漫画逻辑，添加错误处理并优化更新进度报告。添加单个漫画更新检查支持

* 添加无头模式文档，描述命令行功能及使用方法

* 增强无头模式下的更新信息，添加源数据的JS表示形式

* 增强无头模式下的更新脚本输出，添加详细进度和最终总结信息；改进错误处理逻辑以支持不同的显示模式

lib/pages/comic_source_page.dart

@@ -18,6 +18,54 @@ import 'package:venera/utils/translations.dart';
 class ComicSourcePage extends StatelessWidget {
   const ComicSourcePage({super.key});
 
+  static Future<void> update(
+    ComicSource source, [
+    bool showLoading = true,
+  ]) async {
+    if (!source.url.isURL) {
+      if (showLoading) {
+        App.rootContext.showMessage(message: "Invalid url config");
+        return;
+      } else {
+        throw Exception("Invalid url config");
+      }
+    }
+    ComicSourceManager().remove(source.key);
+    bool cancel = false;
+    LoadingDialogController? controller;
+    if (showLoading) {
+      controller = showLoadingDialog(
+        App.rootContext,
+        onCancel: () => cancel = true,
+        barrierDismissible: false,
+      );
+    }
+    try {
+      var res = await AppDio().get<String>(
+        source.url,
+        options: Options(responseType: ResponseType.plain),
+      );
+      if (cancel) return;
+      controller?.close();
+      await ComicSourceParser().parse(res.data!, source.filePath);
+      await io.File(source.filePath).writeAsString(res.data!);
+      if (ComicSourceManager().availableUpdates.containsKey(source.key)) {
+        ComicSourceManager().availableUpdates.remove(source.key);
+      }
+    } catch (e) {
+      if (cancel) return;
+      if (showLoading) {
+        App.rootContext.showMessage(message: e.toString());
+      } else {
+        rethrow;
+      }
+    }
+    await ComicSourceManager().reload();
+    if (showLoading) {
+      App.forceRebuild();
+    }
+  }
+
   static Future<int> checkComicSourceUpdate() async {
     if (ComicSource.all().isEmpty) {
       return 0;
@@ -152,42 +200,11 @@ class _BodyState extends State<_Body> {
     );
   }
 
-  static Future<void> update(
+  void update(
     ComicSource source, [
     bool showLoading = true,
-  ]) async {
-    if (!source.url.isURL) {
-      App.rootContext.showMessage(message: "Invalid url config");
-      return;
-    }
-    ComicSourceManager().remove(source.key);
-    bool cancel = false;
-    LoadingDialogController? controller;
-    if (showLoading) {
-      controller = showLoadingDialog(
-        App.rootContext,
-        onCancel: () => cancel = true,
-        barrierDismissible: false,
-      );
-    }
-    try {
-      var res = await AppDio().get<String>(
-        source.url,
-        options: Options(responseType: ResponseType.plain),
-      );
-      if (cancel) return;
-      controller?.close();
-      await ComicSourceParser().parse(res.data!, source.filePath);
-      await File(source.filePath).writeAsString(res.data!);
-      if (ComicSourceManager().availableUpdates.containsKey(source.key)) {
-        ComicSourceManager().availableUpdates.remove(source.key);
-      }
-    } catch (e) {
-      if (cancel) return;
-      App.rootContext.showMessage(message: e.toString());
-    }
-    await ComicSourceManager().reload();
-    App.forceRebuild();
+  ]) {
+    ComicSourcePage.update(source, showLoading);
   }
 
   Widget buildCard(BuildContext context) {
@@ -679,7 +696,7 @@ class _CheckUpdatesButtonState extends State<_CheckUpdatesButton> {
         var shouldUpdate = ComicSourceManager().availableUpdates.keys.toList();
         for (var key in shouldUpdate) {
           var source = ComicSource.find(key)!;
-          await _BodyState.update(source, false);
+          await ComicSourcePage.update(source, false);
           current++;
           loadingController.setProgress(current / total);
         }

lib/pages/follow_updates_page.dart

@@ -5,10 +5,10 @@ import 'package:venera/components/components.dart';
 import 'package:venera/foundation/app.dart';
 import 'package:venera/foundation/appdata.dart';
 import 'package:venera/foundation/favorites.dart';
-import 'package:venera/foundation/log.dart';
 import 'package:venera/utils/data_sync.dart';
 import 'package:venera/utils/translations.dart';
 import '../foundation/global_state.dart';
+import 'package:venera/logic/follow_updates.dart';
 
 class FollowUpdatesWidget extends StatefulWidget {
   const FollowUpdatesWidget({super.key});
@@ -460,7 +460,7 @@ class _FollowUpdatesPageState extends AutomaticGlobalState<FollowUpdatesPage> {
         message: "Updating comics...".tl,
       );
 
-      await for (var progress in _updateFolder(folder, true)) {
+      await for (var progress in updateFolder(folder, true)) {
         if (isCanceled) {
           return;
         }
@@ -497,7 +497,7 @@ class _FollowUpdatesPageState extends AutomaticGlobalState<FollowUpdatesPage> {
 
     int updated = 0;
 
-    await for (var progress in _updateFolder(folder!, true)) {
+    await for (var progress in updateFolder(folder!, true)) {
       if (isCanceled) {
         return;
       }
@@ -532,128 +532,6 @@ class _FollowUpdatesPageState extends AutomaticGlobalState<FollowUpdatesPage> {
   Object? get key => 'FollowUpdatesPage';
 }
 
-class _UpdateProgress {
-  final int total;
-  final int current;
-  final int errors;
-  final int updated;
-
-  _UpdateProgress(this.total, this.current, this.errors, this.updated);
-}
-
-void _updateFolderBase(
-  String folder,
-  StreamController<_UpdateProgress> stream,
-  bool ignoreCheckTime,
-) async {
-  var comics = LocalFavoritesManager().getComicsWithUpdatesInfo(folder);
-  int current = 0;
-  int errors = 0;
-  int updated = 0;
-  var futures = <Future>[];
-  const maxConcurrent = 5;
-
-  for (int i = 0; i < comics.length; i++) {
-    if (stream.isClosed) {
-      return;
-    }
-    if (!ignoreCheckTime) {
-      var lastCheckTime = comics[i].lastCheckTime;
-      if (lastCheckTime != null &&
-          DateTime.now().difference(lastCheckTime).inDays < 1) {
-        current++;
-        stream.add(_UpdateProgress(comics.length, current, errors, updated));
-        continue;
-      }
-    }
-
-    if (futures.length >= maxConcurrent) {
-      await Future.any(futures);
-    }
-
-    var future = () async {
-      int retries = 3;
-      while (true) {
-        try {
-          var c = comics[i];
-          var comicSource = c.type.comicSource;
-          if (comicSource == null) return;
-          var newInfo = (await comicSource.loadComicInfo!(c.id)).data;
-
-          var newTags = <String>[];
-          for (var entry in newInfo.tags.entries) {
-            const shouldIgnore = ['author', 'artist', 'time'];
-            var namespace = entry.key;
-            if (shouldIgnore.contains(namespace.toLowerCase())) {
-              continue;
-            }
-            for (var tag in entry.value) {
-              newTags.add("$namespace:$tag");
-            }
-          }
-
-          var item = FavoriteItem(
-            id: c.id,
-            name: newInfo.title,
-            coverPath: newInfo.cover,
-            author: newInfo.subTitle ??
-                newInfo.tags['author']?.firstOrNull ??
-                c.author,
-            type: c.type,
-            tags: newTags,
-          );
-
-          LocalFavoritesManager().updateInfo(folder, item, false);
-
-          var updateTime = newInfo.findUpdateTime();
-          if (updateTime != null && updateTime != c.updateTime) {
-            LocalFavoritesManager().updateUpdateTime(
-              folder,
-              c.id,
-              c.type,
-              updateTime,
-            );
-          } else {
-            LocalFavoritesManager().updateCheckTime(folder, c.id, c.type);
-          }
-          updated++;
-          return;
-        } catch (e, s) {
-          Log.error("Check Updates", e, s);
-          retries--;
-          if (retries == 0) {
-            errors++;
-            return;
-          }
-        } finally {
-          current++;
-          stream.add(_UpdateProgress(comics.length, current, errors, updated));
-        }
-      }
-    }();
-
-    future.then((_) {
-      futures.remove(future);
-    });
-
-    futures.add(future);
-  }
-
-  await Future.wait(futures);
-
-  if (updated > 0) {
-    LocalFavoritesManager().notifyChanges();
-  }
-
-  stream.close();
-}
-
-Stream<_UpdateProgress> _updateFolder(String folder, bool ignoreCheckTime) {
-  var stream = StreamController<_UpdateProgress>();
-  _updateFolderBase(folder, stream, ignoreCheckTime);
-  return stream.stream;
-}
-
 /// Background service for checking updates
 abstract class FollowUpdatesService {
   static bool _isChecking = false;
@@ -683,7 +561,7 @@ abstract class FollowUpdatesService {
 
     int updated = 0;
     try {
-      await for (var progress in _updateFolder(folder, false)) {
+      await for (var progress in updateFolder(folder, false)) {
         if (isCanceled) {
           return;
         }