FEAT: 增加网页词典广告过滤开关

Author: echo-loop

TASKS.md

@@ -4,6 +4,8 @@
 
 ## 本次完成
 
+- [x] 移除词典广告过滤说明（2026-10-10）：删除设置页说明及中英文文案；本地化生成、diff 检查通过，未运行测试。完成时间 22:37
+- [x] 扩展网页词典广告过滤规则（2026-10-10）：新增国际与中国广告域名、第三方广告路径和 CSS 隐藏规则；格式化、diff 检查通过，未运行测试。**完成时间**: 2026-10-10 22:17
 - [x] 网页词典新增欧路词典（2026-10-10）：新增可配置网页源 `eudic`，使用欧路英汉词条页 URL，支持词组空格编码；来源自动出现在词典切换器与设置列表，默认可见且可禁用，默认源仍为本地词典。新增 URL、注册表可见性及禁用行为回归测试。两个定向测试文件共 58 项通过，3 个 Dart 文件定向分析通过，`git diff --check` 通过。未运行 `scripts/check.sh`：改动限于网页词典配置与来源可见性，定向检查覆盖相关行为。未运行 Maestro：沙箱内 ADB 守护进程启动失败（`Operation not permitted`），现有首启 smoke flow 会清空应用数据；未在设备验证 WebView 实际加载。**完成时间**: 2026-10-10 19:05
 - [x] 限制共享后台文件下载进度更新频率（2026-10-10）：百度网盘和播客共用的 `BackgroundFileDownloadService` 按任务将应用层进度回调限制为最多每 100ms 一次；初始进度、已知总量下的完成进度，以及任务终态的最终字节数仍会及时发布，失败/异常路径会冲刷最后待发布进度。新增 1000 次突发进度回调回归测试，确认通知被合并且最终字节数保留；完整下载服务测试 10 项通过，改动的 2 个 Dart 文件定向分析通过，`git diff --check` 通过。未运行 `scripts/check.sh`：改动仅限共享下载进度通知，定向测试覆盖修改范围；尚未做真机下载速度前后对比。**完成时间**: 2026-10-10 09:54
 - [x] 定位并压制 ASR 下载进度回调造成的吞吐下降（2026-10-10）：日志中的 App 是 sidecar 优化后重新构建的版本；同 URL 的 Dart/Dio 流式写盘复测为 2.01 秒、约 31.0 MB/s，收到 11,414 个数据块；App 日志为 62,337,248 字节、14.110 秒、约 4.42 MB/s。根因是每个数据块都触发 ASR provider 状态更新，而设置页订阅整个状态；限频前的 10,000 次回调回归用例产生了 10,000 次状态更新。现将 UI 进度状态更新限制为每 100ms 至多一次，100% 仍立即发布。Dio 同 URL 无重定向且无内容编码，直连 curl 复测约 24.9 MB/s。Provider 与设置页定向测试 15 项通过，2 个 Dart 文件定向分析通过，`git diff --check` 通过。未运行 `scripts/check.sh`：改动限于 ASR 进度通知频率，定向测试覆盖相关状态流。**完成时间**: 2026-10-10 09:16

lib/l10n/app_en.arb

@@ -2595,6 +2595,7 @@
   "dictionarySources": "Dictionary Sources",
   "dictionarySourcesDescription": "Disabled dictionaries won't appear in the lookup switcher",
   "dictionaryAutoSpeakOnLookup": "Auto-play Pronunciation",
+  "dictionaryAdFilterTitle": "Block ads in web dictionaries",
   "dictSourceLocal": "Local Dictionary",
   "dictSourceAi": "AI Dictionary",
   "dictSourceCambridge": "Cambridge",

lib/l10n/app_localizations.dart

@@ -9152,6 +9152,12 @@ abstract class AppLocalizations {
   /// **'Auto-play Pronunciation'**
   String get dictionaryAutoSpeakOnLookup;
 
+  /// No description provided for @dictionaryAdFilterTitle.
+  ///
+  /// In en, this message translates to:
+  /// **'Block ads in web dictionaries'**
+  String get dictionaryAdFilterTitle;
+
   /// No description provided for @dictSourceLocal.
   ///
   /// In en, this message translates to:

lib/l10n/app_localizations_en.dart

@@ -5225,6 +5225,9 @@ class AppLocalizationsEn extends AppLocalizations {
   @override
   String get dictionaryAutoSpeakOnLookup => 'Auto-play Pronunciation';
 
+  @override
+  String get dictionaryAdFilterTitle => 'Block ads in web dictionaries';
+
   @override
   String get dictSourceLocal => 'Local Dictionary';
 

lib/l10n/app_localizations_zh.dart

@@ -4984,6 +4984,9 @@ class AppLocalizationsZh extends AppLocalizations {
   @override
   String get dictionaryAutoSpeakOnLookup => '查词时自动播放发音';
 
+  @override
+  String get dictionaryAdFilterTitle => '屏蔽网页词典广告';
+
   @override
   String get dictSourceLocal => '本地词典';
 

lib/l10n/app_zh.arb

@@ -2109,6 +2109,7 @@
   "dictionarySources": "词典源",
   "dictionarySourcesDescription": "关闭的词典不会出现在查词切换器中",
   "dictionaryAutoSpeakOnLookup": "查词时自动播放发音",
+  "dictionaryAdFilterTitle": "屏蔽网页词典广告",
   "dictSourceLocal": "本地词典",
   "dictSourceAi": "AI 词典",
   "dictSourceCambridge": "Cambridge",

lib/models/dictionary/dictionary_settings.dart

@@ -21,36 +21,44 @@ class DictionarySettings {
   /// 查词面板打开或切换到新词时是否自动播放发音
   final bool autoSpeakOnLookup;
 
+  /// 是否在网页词典中启用通用广告过滤
+  final bool adFilteringEnabled;
+
   /// 默认源 id 缺省值
   static const defaultId = 'local';
 
   DictionarySettings({
     this.defaultSourceId = defaultId,
     Set<String> disabledIds = const {},
     this.autoSpeakOnLookup = true,
+    this.adFilteringEnabled = false,
   }) : disabledIds = UnmodifiableSetView(Set.of(disabledIds));
 
   DictionarySettings copyWith({
     String? defaultSourceId,
     Set<String>? disabledIds,
     bool? autoSpeakOnLookup,
+    bool? adFilteringEnabled,
   }) => DictionarySettings(
     defaultSourceId: defaultSourceId ?? this.defaultSourceId,
     disabledIds: disabledIds ?? this.disabledIds,
     autoSpeakOnLookup: autoSpeakOnLookup ?? this.autoSpeakOnLookup,
+    adFilteringEnabled: adFilteringEnabled ?? this.adFilteringEnabled,
   );
 
   Map<String, dynamic> toJson() => {
     'defaultSourceId': defaultSourceId,
     'disabledIds': disabledIds.toList(),
     'autoSpeakOnLookup': autoSpeakOnLookup,
+    'adFilteringEnabled': adFilteringEnabled,
   };
 
   /// 防御性解析：字段缺失/类型不符回退缺省
   factory DictionarySettings.fromJson(Map<String, dynamic> json) {
     final rawDefault = json['defaultSourceId'];
     final rawDisabled = json['disabledIds'];
     final rawAutoSpeak = json['autoSpeakOnLookup'];
+    final rawAdFilteringEnabled = json['adFilteringEnabled'];
     return DictionarySettings(
       defaultSourceId: rawDefault is String && rawDefault.isNotEmpty
           ? rawDefault
@@ -59,6 +67,9 @@ class DictionarySettings {
           ? rawDisabled.whereType<String>().toSet()
           : const {},
       autoSpeakOnLookup: rawAutoSpeak is bool ? rawAutoSpeak : true,
+      adFilteringEnabled: rawAdFilteringEnabled is bool
+          ? rawAdFilteringEnabled
+          : false,
     );
   }
 
@@ -69,13 +80,15 @@ class DictionarySettings {
           runtimeType == other.runtimeType &&
           defaultSourceId == other.defaultSourceId &&
           _setEquals(disabledIds, other.disabledIds) &&
-          autoSpeakOnLookup == other.autoSpeakOnLookup;
+          autoSpeakOnLookup == other.autoSpeakOnLookup &&
+          adFilteringEnabled == other.adFilteringEnabled;
 
   @override
   int get hashCode => Object.hash(
     defaultSourceId,
     Object.hashAllUnordered(disabledIds),
     autoSpeakOnLookup,
+    adFilteringEnabled,
   );
 
   static bool _setEquals(Set<String> a, Set<String> b) =>

lib/providers/dictionary/dictionary_settings_provider.dart

@@ -54,6 +54,12 @@ class DictionarySettingsNotifier extends _$DictionarySettingsNotifier {
     await _persist(state.copyWith(autoSpeakOnLookup: enabled));
   }
 
+  /// 设置网页词典广告过滤开关。
+  Future<void> setAdFilteringEnabled(bool enabled) async {
+    if (state.adFilteringEnabled == enabled) return;
+    await _persist(state.copyWith(adFilteringEnabled: enabled));
+  }
+
   /// 启用/禁用某词典源
   ///
   /// 禁用前校验该源 `canBeDisabled`；禁用当前默认源时默认自动回退。

lib/screens/dictionary_settings_screen.dart

@@ -37,11 +37,21 @@ class DictionarySettingsScreen extends ConsumerWidget {
         ),
         children: [
           Card(
-            child: SwitchListTile(
-              secondary: const Icon(Icons.volume_up_outlined),
-              title: Text(l10n.dictionaryAutoSpeakOnLookup),
-              value: settings.autoSpeakOnLookup,
-              onChanged: notifier.setAutoSpeakOnLookup,
+            child: Column(
+              children: [
+                SwitchListTile(
+                  secondary: const Icon(Icons.volume_up_outlined),
+                  title: Text(l10n.dictionaryAutoSpeakOnLookup),
+                  value: settings.autoSpeakOnLookup,
+                  onChanged: notifier.setAutoSpeakOnLookup,
+                ),
+                SwitchListTile(
+                  secondary: const Icon(Icons.block_outlined),
+                  title: Text(l10n.dictionaryAdFilterTitle),
+                  value: settings.adFilteringEnabled,
+                  onChanged: notifier.setAdFilteringEnabled,
+                ),
+              ],
             ),
           ),
           const SizedBox(height: AppSpacing.m),