feat: 实现书签新建、分享新建功能 (#73)

* feat: 实现书签分享功能，包含FAB和完整的创建流程

- 新增 createBookmark API 支持 POST /bookmarks 接口
- 实现 AddBookmarkViewModel 遵循 MVVM 架构模式
- 创建 AddBookmarkScreen 包含表单验证和标签选择
- 在所有书签列表页面添加 Material Design 3 FABs
- 复用 LabelEditDialog 进行标签编辑
- 支持异步书签创建处理 (状态码 202)
- 修复按钮交互问题：统一提交入口和加载状态显示
- 添加完整的单元测试覆盖

🤖 Generated with [Claude Code](https://claude.ai/code)

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

* feat(bookmark): 优化书签列表FAB滚动行为并重构创建书签API

refactor(api): 修改创建书签返回类型为void
style: 移除冗余注释并调整滚动阈值
test: 更新mock文件以匹配API变更

* test(ui): 添加滚动控制器提供者和FAB动画的测试用例

* feat(分享): 添加接收分享内容功能

实现从其他应用接收文本和URL分享的功能，包括：
- 添加receive_sharing_intent依赖
- 配置AndroidManifest.xml接收分享Intent
- 创建ShareIntentService处理分享内容
- 在主布局中显示分享内容悬浮窗
- 升级Java版本至17以支持新功能

* feat(书签): 实现从分享文本中提取URL并自动填充的功能

- 添加处理分享文本的方法，能够提取URL并更新ViewModel
- 修改路由逻辑以支持通过query参数传递分享文本
- 改进表单控制器与ViewModel的双向绑定
- 移除不再使用的ShareOverlay组件
- 添加相关测试用例验证URL提取逻辑

* feat(bookmark): 添加AI标签推荐和自动网页内容获取功能

实现基于OpenRouter API的AI标签推荐功能，包括：
1. 新增WebContentService服务用于获取网页内容
2. 新增AiTagRecommendationRepository处理标签推荐逻辑
3. 扩展AddBookmarkViewModel支持自动获取内容和标签推荐
4. 更新UI展示推荐标签和获取状态
5. 添加相关测试用例

* feat(书签): 添加推荐标签消费状态管理

添加_hasConsumedRecommendations状态控制推荐标签显示逻辑
修复URL输入框错误状态显示问题
添加内容获取和标签推荐失败的错误监听
优化推荐标签UI交互逻辑

* Enhances AddBookmarkViewModel tests

Improves the AddBookmarkViewModel tests by using Mockito code generation for mock classes, instead of manual mock implementations.

Adds tests for AI availability status and URL validation.

Refactors the URL validation tests to await asynchronous operations and fixes form clearing logic.

These changes improve the reliability and coverage of the AddBookmarkViewModel tests.

* feat(ai标签): 添加AI标签设置功能并优化标签推荐逻辑

实现AI标签设置页面，支持选择目标语言
重构标签推荐逻辑，使用系统提示词和JSON格式响应
将翻译设置整合到AI设置页面中

* feat: 添加AI标签目标语言设置功能

- 在设置仓库中添加保存和获取AI标签目标语言的方法
- 实现AI标签设置视图模型，支持语言选择和保存
- 为AI标签推荐仓库添加目标语言支持
- 添加相关单元测试验证功能
- 更新项目规则文档，添加Mockito null safety错误处理说明

* refactor(bookmarks): 重构书签列表存储方式，使用ID列表替代完整模型列表

修改书签视图模型，将直接存储书签模型列表改为存储书签ID列表，通过ID从仓库获取完整模型。这提高了性能并减少了内存占用，同时需要更新相关测试用例以适应新的实现方式。

* refactor(ui): 重构滚动控制器和FAB的共享逻辑

重构LabelEditDialog以支持更灵活的标签选择
简化书签创建API的响应处理
更新测试用例以适应重构后的组件
将ScrollControllerProvider整合到MainLayout中
移除冗余的滚动控制器管理代码

* fix(web_content_service): 完善URL格式验证逻辑

添加对https协议和空主机名的检查，确保URL验证更严格

* refactor(web内容): 引入WebContentRepository替换直接使用WebContentService

将WebContentService的使用重构为通过WebContentRepository接口，遵循仓库模式分离业务逻辑与数据源
更新相关测试和依赖注入配置以适配新的仓库层

* fix: 修复内容获取状态更新逻辑

将_isContentFetched状态更新移到标题更新之前，确保状态及时更新

* feat: 实现全局SnackBar支持并优化书签获取逻辑

添加全局ScaffoldMessengerKey以支持页面导航后显示SnackBar
重构书签获取逻辑使用getCachedBookmark替代直接访问bookmarks列表
更新测试用例以适配新的书签获取方式

* fix: 修复API响应状态码检查及异步标签加载问题

- 在ReadeckApiClient中增加201状态码作为有效响应
- 将标签加载方法改为异步执行
- 更新测试中的虚拟返回值以匹配实际类型

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: shadowfish07

.trae/rules/project_rules.md

@@ -615,3 +615,7 @@ This project uses [semantic-release](https://github.com/semantic-release/semanti
 ### Test-Driven Development (TDD)
 
 This project follows a Test-Driven Development (TDD) approach. All new features or bug fixes should start with writing a failing unit test that describes the desired functionality or reproduces the bug. Only after the test is written should the implementation code be written to make the test pass.
+
+### 注意事项
+
+- 遇到 Mockito null safety 错误时，首先运行 flutter pub run build_runner build

android/app/build.gradle

@@ -34,12 +34,19 @@ android {
     ndkVersion flutter.ndkVersion
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_1_8
-        targetCompatibility JavaVersion.VERSION_1_8
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
 
     kotlinOptions {
-        jvmTarget = '1.8'
+        jvmTarget = '17'
+    }
+    
+    // Use JVM Toolchain to ensure consistency
+    java {
+        toolchain {
+            languageVersion = JavaLanguageVersion.of(17)
+        }
     }
 
     sourceSets {

android/app/src/main/AndroidManifest.xml

@@ -24,6 +24,20 @@
                 <action android:name="android.intent.action.MAIN"/>
                 <category android:name="android.intent.category.LAUNCHER"/>
             </intent-filter>
+            
+            <!-- Intent filter for receiving shared text -->
+            <intent-filter>
+                <action android:name="android.intent.action.SEND" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <data android:mimeType="text/plain" />
+            </intent-filter>
+            
+            <!-- Intent filter for receiving shared URLs -->
+            <intent-filter>
+                <action android:name="android.intent.action.SEND" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <data android:mimeType="text/*" />
+            </intent-filter>
         </activity>
         <!-- Don't delete the meta-data below.
              This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->

android/build.gradle

@@ -3,6 +3,25 @@ allprojects {
         google()
         mavenCentral()
     }
+    
+    // Configure Java toolchain for all subprojects
+    afterEvaluate { project ->
+        if (project.hasProperty('android')) {
+            android {
+                compileOptions {
+                    sourceCompatibility JavaVersion.VERSION_17
+                    targetCompatibility JavaVersion.VERSION_17
+                }
+            }
+        }
+        if (project.hasProperty('kotlin')) {
+            project.tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
+                kotlinOptions {
+                    jvmTarget = '17'
+                }
+            }
+        }
+    }
 }
 
 subprojects {

lib/config/dependencies.dart

@@ -9,6 +9,9 @@ import 'package:readeck_app/data/repository/settings/settings_repository.dart';
 import 'package:readeck_app/data/service/database_service.dart';
 import 'package:readeck_app/data/service/readeck_api_client.dart';
 import 'package:readeck_app/data/service/openrouter_api_client.dart';
+import 'package:readeck_app/data/service/web_content_service.dart';
+import 'package:readeck_app/data/repository/web_content/web_content_repository.dart';
+import 'package:readeck_app/data/repository/ai_tag_recommendation/ai_tag_recommendation_repository.dart';
 import 'package:readeck_app/domain/use_cases/bookmark_operation_use_cases.dart';
 
 import 'package:readeck_app/data/repository/label/label_repository.dart';
@@ -22,6 +25,9 @@ List<SingleChildWidget> providers(String host, String token) {
     Provider(create: (context) => SharedPreferencesService()),
     Provider(create: (context) => ReadeckApiClient(host, token)),
     Provider(create: (context) => DatabaseService()),
+    Provider(create: (context) => WebContentService()),
+    Provider<WebContentRepository>(
+        create: (context) => WebContentRepositoryImpl(context.read())),
     Provider(create: (context) {
       final prefsService = context.read<SharedPreferencesService>();
       final apiClient = context.read<ReadeckApiClient>();
@@ -34,6 +40,12 @@ List<SingleChildWidget> providers(String host, String token) {
       final openRouterClient = context.read<OpenRouterApiClient>();
       return OpenRouterRepository(openRouterClient);
     }),
+    Provider(create: (context) {
+      final openRouterClient = context.read<OpenRouterApiClient>();
+      final settingsRepository = context.read<SettingsRepository>();
+      return AiTagRecommendationRepository(
+          openRouterClient, settingsRepository);
+    }),
     ChangeNotifierProvider(
       create: (context) => MainAppViewModel(
         context.read<SettingsRepository>(),

lib/data/repository/ai_tag_recommendation/ai_tag_recommendation_repository.dart

@@ -0,0 +1,243 @@
+import 'dart:convert';
+import 'package:readeck_app/data/service/openrouter_api_client.dart';
+import 'package:readeck_app/data/service/web_content_service.dart';
+import 'package:readeck_app/data/repository/settings/settings_repository.dart';
+import 'package:readeck_app/main.dart';
+import 'package:result_dart/result_dart.dart';
+
+/// AI标签推荐Repository
+/// 基于网页内容和现有标签，通过OpenRouter API提供智能标签推荐
+class AiTagRecommendationRepository {
+  AiTagRecommendationRepository(
+    this._openRouterApiClient,
+    this._settingsRepository,
+  );
+
+  final OpenRouterApiClient _openRouterApiClient;
+  final SettingsRepository _settingsRepository;
+
+  /// 检查AI标签推荐是否可用
+  bool get isAvailable {
+    final apiKey = _settingsRepository.getOpenRouterApiKey();
+    final selectedModel = _settingsRepository.getSelectedOpenRouterModel();
+    return apiKey.isNotEmpty && selectedModel.isNotEmpty;
+  }
+
+  /// 基于网页内容生成标签推荐
+  ///
+  /// [webContent] - 网页内容
+  /// [existingTags] - 现有的标签列表，用于参考
+  /// [maxTags] - 最大推荐标签数量，默认5个
+  ///
+  /// 返回推荐的标签列表
+  AsyncResult<List<String>> generateTagRecommendations(
+    WebContent webContent,
+    List<String> existingTags, {
+    int maxTags = 5,
+  }) async {
+    if (!isAvailable) {
+      appLogger.w('AI标签推荐功能不可用：未配置API密钥或模型');
+      return Failure(Exception('AI标签推荐功能不可用：请先配置OpenRouter API密钥和模型'));
+    }
+
+    try {
+      appLogger.i('开始生成AI标签推荐 - URL: ${webContent.url}');
+
+      final selectedModel = _settingsRepository.getSelectedOpenRouterModel();
+      final targetLanguage = _settingsRepository.getAiTagTargetLanguage();
+
+      final systemPrompt = _buildSystemPrompt();
+      final userPrompt =
+          _buildUserPrompt(webContent, existingTags, maxTags, targetLanguage);
+
+      appLogger.d('使用模型: $selectedModel');
+      appLogger.d('目标语言: $targetLanguage');
+      appLogger.d('系统提示词长度: ${systemPrompt.length}');
+      appLogger.d('用户提示词长度: ${userPrompt.length}');
+
+      // 最多重试3次
+      for (int attempt = 1; attempt <= 3; attempt++) {
+        appLogger.d('第 $attempt 次尝试生成标签');
+
+        // 调用OpenRouter API
+        final result = await _openRouterApiClient.chatCompletion(
+          model: selectedModel,
+          messages: [
+            {'role': 'system', 'content': systemPrompt},
+            {'role': 'user', 'content': userPrompt},
+          ],
+          temperature: 0.3, // 较低的温度确保结果更加一致和可预测
+          maxTokens: 200, // 限制token数量
+        );
+
+        if (result.isSuccess()) {
+          final response = result.getOrThrow();
+          final tags = _parseTagsFromResponse(response);
+
+          if (tags.isNotEmpty) {
+            appLogger.i('AI标签推荐生成成功，共${tags.length}个标签: ${tags.join(", ")}');
+            return Success(tags);
+          } else {
+            appLogger.w('第 $attempt 次尝试：标签解析失败，AI响应: $response');
+            if (attempt == 3) {
+              return Failure(Exception('AI标签推荐失败：经过3次尝试，无法解析有效的标签'));
+            }
+          }
+        } else {
+          final error = result.exceptionOrNull()!;
+          appLogger.e('第 $attempt 次尝试：API调用失败', error: error);
+          if (attempt == 3) {
+            return Failure(error);
+          }
+        }
+      }
+
+      return Failure(Exception('AI标签推荐失败：经过3次尝试仍然失败'));
+    } catch (e) {
+      appLogger.e('生成AI标签推荐时发生异常', error: e);
+      return Failure(Exception('生成AI标签推荐时发生异常: $e'));
+    }
+  }
+
+  /// 构建系统提示词
+  String _buildSystemPrompt() {
+    // 预留系统提示词占位符，等待后续填充
+    return '''
+Assign the most appropriate label(s) to the provided web page content. You will receive the following inputs: the web page content, a list of existing labels, and the expected label language. If suitable, prioritize using the existing labels. If none of the existing labels fit, generate a new label in the requested language that best describes the web page content.
+
+-  Carefully analyze the web page content to understand its main topics, themes, or purpose.
+-  Compare your understanding with the existing labels and select the most relevant ones.
+-  If no existing label is appropriate, generate a new, concise, and descriptive label in the specified language.
+-  Do not include any explanations or reasoning in your output—only output the final label(s).
+
+# Steps
+
+1. Analyze the provided web page content to identify its main topic or purpose.
+2. Review the list of existing labels.
+3. Select the most relevant existing label(s) that match the content.
+4. If no existing label is suitable, create a new label in the expected language.
+5. Output the label(s) as a JSON array of strings.
+
+# Output Format
+
+Output only a JSON array of strings containing the assigned label(s). Do not include any explanations or additional text.
+
+# Examples
+
+**Example 1**
+
+Input:
+-  Web page content: "[Placeholder for a news article about electric vehicles]"
+-  Existing labels: ["Technology", "Automotive", "Environment"]
+-  Expected label language: "English"
+
+Output:
+["Automotive"]
+
+**Example 2**
+
+Input:
+-  Web page content: "[Placeholder for a tutorial on baking bread]"
+-  Existing labels: ["Cooking", "Technology", "Travel"]
+-  Expected label language: "English"
+
+Output:
+["Cooking"]
+
+**Example 3**
+
+Input:
+-  Web page content: "[Placeholder for a blog about meditation techniques]"
+-  Existing labels: ["Fitness", "Wellness"]
+-  Expected label language: "English"
+
+Output:
+["Wellness"]
+
+**Example 4**
+
+Input:
+-  Web page content: "[Placeholder for a guide to starting a business in China]"
+-  Existing labels: ["Travel", "Technology"]
+-  Expected label language: "English"
+
+Output:
+["Business"]
+
+# Notes
+
+-  Always use the expected label language for any new label.
+-  If multiple existing labels are relevant, output all of them.
+-  The output must be a pure JSON array, without code blocks or extra formatting.
+
+
+''';
+  }
+
+  /// 构建用户提示词，包含目标语言、已存在的标签和网页内容
+  String _buildUserPrompt(WebContent webContent, List<String> existingTags,
+      int maxTags, String targetLanguage) {
+    final buffer = StringBuffer();
+
+    // 目标语言
+    buffer.writeln('# 目标语言');
+    buffer.writeln(targetLanguage);
+    buffer.writeln();
+
+    // 已存在的标签
+    buffer.writeln('# 已存在的标签');
+    if (existingTags.isNotEmpty) {
+      buffer.writeln(existingTags.join(', '));
+    } else {
+      buffer.writeln('无');
+    }
+    buffer.writeln();
+
+    // 网页内容（全文输入，无需截断）
+    buffer.writeln('# 网页内容');
+    buffer.writeln('标题: ${webContent.title}');
+    buffer.writeln('URL: ${webContent.url}');
+    buffer.writeln();
+    buffer.writeln('内容:');
+    buffer.writeln(webContent.content);
+
+    return buffer.toString();
+  }
+
+  /// 从AI响应中解析标签列表
+  /// 只处理JSON数组格式，如: ["Wellness", "Technology"]
+  List<String> _parseTagsFromResponse(String response) {
+    try {
+      // 清理响应文本
+      String cleanResponse = response.trim();
+      appLogger.d('原始AI响应: $cleanResponse');
+
+      // 查找JSON数组的开始和结束位置
+      final startIndex = cleanResponse.indexOf('[');
+      final endIndex = cleanResponse.lastIndexOf(']');
+
+      if (startIndex == -1 || endIndex == -1 || startIndex >= endIndex) {
+        appLogger.w('响应中未找到有效的JSON数组格式');
+        return [];
+      }
+
+      // 提取JSON数组部分
+      final jsonPart = cleanResponse.substring(startIndex, endIndex + 1);
+      appLogger.d('提取的JSON部分: $jsonPart');
+
+      // 解析JSON数组
+      final List<dynamic> jsonList = jsonDecode(jsonPart);
+      final tags = jsonList
+          .cast<String>()
+          .where((tag) => tag.isNotEmpty && tag.length <= 15)
+          .take(8)
+          .toList();
+
+      appLogger.d('JSON格式解析标签结果: $tags');
+      return tags;
+    } catch (e) {
+      appLogger.w('JSON解析失败: $e, 原始响应: $response');
+      return [];
+    }
+  }
+}

lib/data/repository/bookmark/bookmark_repository.dart

@@ -391,6 +391,29 @@ class BookmarkRepository {
     return Failure(result.exceptionOrNull()!);
   }
 
+  /// 创建书签
+  AsyncResult<void> createBookmark({
+    required String url,
+    String? title,
+    List<String>? labels,
+  }) async {
+    appLogger.i('开始创建书签: $url');
+    final result = await _readeckApiClient.createBookmark(
+      url: url,
+      title: title,
+      labels: labels,
+    );
+
+    if (result.isSuccess()) {
+      appLogger.i('书签创建请求已提交，正在异步处理: $url');
+      // 不需要立即添加到缓存，因为书签还在异步处理中
+      return const Success(unit);
+    } else {
+      appLogger.e('书签创建失败: $url', error: result.exceptionOrNull());
+      return Failure(result.exceptionOrNull()!);
+    }
+  }
+
   /// 删除书签
   AsyncResult<void> deleteBookmark(String bookmarkId) async {
     appLogger.i('开始删除书签: $bookmarkId');