FEAT: 新增在线词典语境发音词源

Author: echo-loop

TASKS.md

@@ -1,8 +1,37 @@
 # Echo Loop 任务清单
 
-> 最后更新：2026-07-03（官方/播客音频「删除音频」）
+> 最后更新：2026-07-04（AI 词典多词表达新 Prompt 展示对齐）
 > 当前焦点：Android 结束录音闪退（离线 ASR / Silero VAD）——**仍未解决**
 
+## 已完成：AI 词典多词表达新 Prompt 展示对齐
+
+后端 `POST /api/v2/ai/dictionary` 的多词表达 prompt 已精简为 `originalExpression / naturalness / category / pronunciationTips / meanings / similarExpressions / background / learnerTips`；前端同步收敛模型、缓存、展示和测试。
+
+- [x] **联合模型**：`MultiWordDictionaryEntry` 改为镜像 app 前端新 schema；前端不保留 `thinking` / `frequency`，展示与空态只看 learner-facing 字段；旧缓存缺 `queryType` 仍按单词解析，新缓存可用 `originalExpression` 识别多词。
+- [x] **缓存隔离**：`AiDictionarySource` L2 cache type 升级为 `ai_dictionary_v2`，避开旧多词 prompt 结构缓存。
+- [x] **UI**：多词结果保留 `category` 顶部元信息，主要内容区按 `meanings → naturalness → pronunciationTips → similarExpressions → background → learnerTips` 展示非空字段；词典面板长词组标题自动缩小为单行完整显示，不折行、不溢出、不省略；单词结果视图不变。
+- [x] **TTS**：多词表达的 `meanings[].examples` 与 `similarExpressions[].sentence` 纳入词典面板预热顺序。
+- [x] **l10n**：替换旧多词分节文案为新字段标签，并刷新生成文件。
+- [x] **测试**：更新模型解析、L2/L3 缓存、UI 渲染和 TTS 提取用例。
+- [x] **验证**：`flutter analyze` 改动相关 11 个 Dart 文件 0 问题；`flutter test test/models/dictionary/dictionary_entry_test.dart test/models/dictionary/dict_speakable_texts_test.dart test/services/dictionary/ai_dictionary_source_test.dart test/widgets/dictionary/ai_dict_result_view_test.dart` 全过（46 例）。补充验证：`flutter analyze lib/widgets/dictionary/dictionary_panel.dart lib/widgets/dictionary/ai_multi_word_result_view.dart test/widgets/dictionary/dictionary_panel_test.dart test/widgets/dictionary/ai_dict_result_view_test.dart` 0 问题；`flutter test test/widgets/dictionary/dictionary_panel_test.dart test/widgets/dictionary/ai_dict_result_view_test.dart` 全过（23 例）。
+
+  **完成时间**: 2026-07-04
+
+## 已完成：在线词典新增语境/发音/词源源
+
+在线词典源继续沿用 `kWebDictConfigs` 配置驱动机制，新增 6 个网页源：
+
+- [x] **OZDIC**：新增 `ozdic` 源，使用内置 WebView 打开搭配词典词条页，可在词典切换器与设置页启用/禁用。
+- [x] **PlayPhrase**：新增 `playPhrase` 源，使用内置 WebView 打开 `playphrase.me` 搜索页，可在词典切换器与设置页启用/禁用。
+- [x] **YouGlish**：新增 `youglish` 源，使用内置 WebView 打开 YouGlish 英语发音页，可在词典切换器与设置页启用/禁用。
+- [x] **Forvo**：新增 `forvo` 源，使用内置 WebView 打开 Forvo 英语发音页，可在词典切换器与设置页启用/禁用。
+- [x] **WordReference**：新增 `wordReference` 源，使用内置 WebView 打开 WordReference 英英词典页，可在词典切换器与设置页启用/禁用。
+- [x] **Etymonline**：新增 `etymonline` 源，使用内置 WebView 打开词源搜索页，可在词典切换器与设置页启用/禁用。
+- [x] **测试**：更新 `web_dictionary_source_test.dart`，确认 14 个网页源 id 完整且唯一，并覆盖新增源的通用 lookup/URL 编码契约。
+- [x] **验证**：`flutter analyze` 改动文件 0 问题；`flutter test test/services/dictionary/web_dictionary_source_test.dart` 全过。
+
+  **完成时间**: 2026-07-03
+
 ## 已完成：官方/播客音频「删除音频」
 
 官方精选合集与博客（播客）合集的音频 item 下载后无法回收本地占用（这些 item 由后端 / RSS 管理，不能整条删除）。新增「删除音频」菜单项——只删本地音频文件、item 保留、随时可重新下载。

lib/l10n/app_en.arb

@@ -1994,5 +1994,9 @@
   "dictAiWordFamily": "Word Family",
   "dictAiForms": "Word Forms",
   "dictAiEtymology": "Etymology",
-  "dictAiTips": "Tips"
+  "dictAiTips": "Learning Tips",
+  "dictAiMultiNaturalness": "Naturalness",
+  "dictAiMultiPronunciationTips": "Pronunciation",
+  "dictAiMultiSimilarExpressions": "Similar Expressions",
+  "dictAiMultiBackground": "Background Knowledge"
 }

lib/l10n/app_localizations.dart

@@ -7229,8 +7229,32 @@ abstract class AppLocalizations {
   /// No description provided for @dictAiTips.
   ///
   /// In en, this message translates to:
-  /// **'Tips'**
+  /// **'Learning Tips'**
   String get dictAiTips;
+
+  /// No description provided for @dictAiMultiNaturalness.
+  ///
+  /// In en, this message translates to:
+  /// **'Naturalness'**
+  String get dictAiMultiNaturalness;
+
+  /// No description provided for @dictAiMultiPronunciationTips.
+  ///
+  /// In en, this message translates to:
+  /// **'Pronunciation'**
+  String get dictAiMultiPronunciationTips;
+
+  /// No description provided for @dictAiMultiSimilarExpressions.
+  ///
+  /// In en, this message translates to:
+  /// **'Similar Expressions'**
+  String get dictAiMultiSimilarExpressions;
+
+  /// No description provided for @dictAiMultiBackground.
+  ///
+  /// In en, this message translates to:
+  /// **'Background Knowledge'**
+  String get dictAiMultiBackground;
 }
 
 class _AppLocalizationsDelegate

lib/l10n/app_localizations_en.dart

@@ -4079,5 +4079,17 @@ class AppLocalizationsEn extends AppLocalizations {
   String get dictAiEtymology => 'Etymology';
 
   @override
-  String get dictAiTips => 'Tips';
+  String get dictAiTips => 'Learning Tips';
+
+  @override
+  String get dictAiMultiNaturalness => 'Naturalness';
+
+  @override
+  String get dictAiMultiPronunciationTips => 'Pronunciation';
+
+  @override
+  String get dictAiMultiSimilarExpressions => 'Similar Expressions';
+
+  @override
+  String get dictAiMultiBackground => 'Background Knowledge';
 }

lib/l10n/app_localizations_zh.dart

@@ -3893,5 +3893,17 @@ class AppLocalizationsZh extends AppLocalizations {
   String get dictAiEtymology => '词源';
 
   @override
-  String get dictAiTips => '提示';
+  String get dictAiTips => '学习提示';
+
+  @override
+  String get dictAiMultiNaturalness => '自然性';
+
+  @override
+  String get dictAiMultiPronunciationTips => '发音提示';
+
+  @override
+  String get dictAiMultiSimilarExpressions => '相似表达';
+
+  @override
+  String get dictAiMultiBackground => '背景知识';
 }

lib/l10n/app_zh.arb

@@ -1557,5 +1557,9 @@
   "dictAiWordFamily": "词族",
   "dictAiForms": "词形变化",
   "dictAiEtymology": "词源",
-  "dictAiTips": "提示"
+  "dictAiTips": "学习提示",
+  "dictAiMultiNaturalness": "自然性",
+  "dictAiMultiPronunciationTips": "发音提示",
+  "dictAiMultiSimilarExpressions": "相似表达",
+  "dictAiMultiBackground": "背景知识"
 }

lib/models/dictionary/dict_speakable_texts.dart

@@ -6,6 +6,7 @@
 library;
 
 import 'dictionary_lookup_result.dart';
+import 'dictionary_entry.dart';
 
 /// 提取 [result] 中所有可发音英文文本，按弹窗显示顺序：
 /// 单词标题 → 各义项例句 → 常见搭配例句 → 词族例句。
@@ -18,19 +19,30 @@ List<String> dictionarySpeakableTexts(DictionaryLookupResult result) {
   // 单词标题（跨源恒有，标题行 SpeakButton 发此文本）。
   texts.add(result.headword);
 
-  // 仅 AI 源带例句，且各例句均为 _ExampleView 的点击发音目标。
+  // AI 单词源带例句，且各例句均为 _ExampleView 的点击发音目标。
   if (result is AiDictResult) {
-    final entry = result.entry;
-    for (final meaning in entry.meanings) {
-      for (final ex in meaning.examples) {
-        texts.add(ex.sentence);
-      }
-    }
-    for (final expr in entry.commonExpressions) {
-      texts.add(expr.example.sentence);
-    }
-    for (final item in entry.wordFamily) {
-      texts.add(item.example.sentence);
+    switch (result.entry) {
+      case final DictionaryEntry entry:
+        for (final meaning in entry.meanings) {
+          for (final ex in meaning.examples) {
+            texts.add(ex.sentence);
+          }
+        }
+        for (final expr in entry.commonExpressions) {
+          texts.add(expr.example.sentence);
+        }
+        for (final item in entry.wordFamily) {
+          texts.add(item.example.sentence);
+        }
+      case final MultiWordDictionaryEntry entry:
+        for (final meaning in entry.meanings) {
+          for (final ex in meaning.examples) {
+            texts.add(ex.sentence);
+          }
+        }
+        for (final expr in entry.similarExpressions) {
+          texts.add(expr.sentence);
+        }
     }
   }