diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9e076a3..40e339c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -49,15 +49,27 @@
 
 ---
 
-## [0.7.0] - TBD
+## [0.7.0] - 2026-03-23
 
-> 規劃範圍：PR40 ~ PR58（依 roadmap）。
+> 範圍：PR10 ~ PR39
 
-### Refactoring
-- non-UI 核心 pipeline 拆分（lm_translator/lang_merge_content/FTB/KubeJS/MD/jar_processor）。
-- `plugins/shared` 進一步收斂。
-- `services_impl` lifecycle 抽共用 task runner。
-- UI：先補 view characterization tests，再拆大型 view（cache_view/extractor_view/translation_view/config/rules）。
+### Features
+- FTB Quest 翻譯進度條驗證報告（`step6 progress bar validation report`），新增 FTB Quest 抽取格式完整性驗證。
+
+### Improvements
+- **翻譯視圖日誌區**：深色 Container 背景替代 styled_card；ListView 移除無效 bgcolor 參數；初始化提示文字；日誌自動滾到底。
+- **KubeJS 翻譯 Pipeline**：OpenCC 簡→繁轉換延伸至 `client_scripts` 來源值；跳過 ASCII 藝術字（█▓▒░）；`skip_chinese=False` 邏輯修正；新增 `item.kubejs.*` 翻譯記憶匹配。
+- **翻譯進度**：FTB 進度改以檔案數均勻推進（非 chunk 數）。
+
+### Bug Fixes
+- `scroll_to(end=True)` → `scroll_to(offset=1.0)`（Flet 0.28.3 API 相容）。
+- `log_presenter._entry_color` 移除錯誤 hex 前綴拼接，正確使用 `Colors` enum 的 `.value`。
+- `kubejs_translator_clean.py` 補回 `import json`（`jq` 依賴）。
+- CI：修復 lint F401（`threading` import 移除又恢復）；Ruff format 6 個檔案。
 
 ### Tests
-- 新增多顆 focused tests + characterization tests，讓後續 UI/core 重構不再盲飛。
+- 3 個 `test_translation_view_characterization.py` characterization tests 新增（翻譯視圖行為迴歸保護）。
+
+---
+
+## [0.6.0] - 2026-03-12
diff --git a/app/logging/log_presenter.py b/app/logging/log_presenter.py
index 57cff69..58fdc02 100644
--- a/app/logging/log_presenter.py
+++ b/app/logging/log_presenter.py
@@ -122,7 +122,7 @@ def _sync_tail(
         entries: Sequence[LogEntry],
     ) -> List[LogEntry]:
         """Tail 模式：全量替換為最後 N 筆。"""
-        tail = list(entries[-self.tail_lines:]) if entries else []
+        tail = list(entries[-self.tail_lines :]) if entries else []
         list_view.controls.clear()
         for entry in tail:
             color = self._entry_color(entry)
@@ -137,10 +137,10 @@ def _entry_color(self, entry: LogEntry) -> str:
         """根據 entry 等級取得顏色。"""
         if not self.colorize:
             color = self.default_color
-            # 預防：若不是有效 hex 格式，主動加上 #
-            if not color.startswith("#"):
-                return f"#{color}"
-            return color
+            # Colors enum → 取 .value；hex string 直接用；其他嘗試 str()
+            if hasattr(color, "value"):
+                return color.value  # Colors enum → "grey100"
+            return str(color)
         return "#" + get_level_color(entry.level)
 
     def _truncate(self, list_view: ft.ListView) -> None:
diff --git a/app/views/lm_view.py b/app/views/lm_view.py
index 69215f6..e4f734d 100644
--- a/app/views/lm_view.py
+++ b/app/views/lm_view.py
@@ -23,6 +23,7 @@
     load_config().get("lm_translator", {}).get("lm_translate_folder_name", "LM翻譯後")
 )
 
+
 class LMView(ft.Column):
     """LM 翻譯頁（風格對齊 Translation/Extractor）。"""
 
@@ -74,9 +75,7 @@ def __init__(self, page: ft.Page, file_picker: ft.FilePicker):
         )
 
         # 狀態與日誌
-        self.status_chip = ft.Chip(
-            label=ft.Text("尚未開始"), bgcolor=theme.GREY_200
-        )
+        self.status_chip = ft.Chip(label=ft.Text("尚未開始"), bgcolor=theme.GREY_200)
         self.progress_bar = ft.ProgressBar(
             value=0, height=8, bgcolor=theme.GREY_200, color=theme.BLUE
         )
@@ -274,6 +273,7 @@ def loop():
                 logs = snap.get("logs", []) or []
                 try:
                     self.log_presenter.sync(self.log_view, logs)
+                    self.log_view.scroll_to(offset=1.0)
                 except Exception as e:
                     log_debug(f"LM log presenter sync failed: {e}")
 
diff --git a/app/views/translation/translation_actions.py b/app/views/translation/translation_actions.py
index 17aee7f..df224fc 100644
--- a/app/views/translation/translation_actions.py
+++ b/app/views/translation/translation_actions.py
@@ -204,7 +204,7 @@ def start_ui_timer(view):
         mode="tail",
         tail_lines=ui_cfg.get("tail_lines", 250),
         colorize=False,  # Translation 目前只有灰白色，保持現有外觀
-        default_color=str(ft.Colors.GREY_100),
+        default_color=ft.Colors.GREY_100,
     )
 
     def loop():
@@ -225,6 +225,8 @@ def loop():
             try:
                 # PR3：presenter.sync() 內部處理 tail rebuild + 顏色
                 presenter.sync(view.log_view, logs)
+                # sync() 會 clear() + 重新加入所有 item，手動滾到最底部
+                view.log_view.scroll_to(offset=1.0)
             except Exception as e:
                 log_warning(f"更新日誌視圖失敗: {e}")
             status = (snap.get("status") or "").upper()
diff --git a/app/views/translation_view.py b/app/views/translation_view.py
index 351c84a..7712420 100644
--- a/app/views/translation_view.py
+++ b/app/views/translation_view.py
@@ -4,10 +4,9 @@
 維護注意：本檔案的函式 docstring 用於維護說明，不代表行為變更。
 """
 
-
-import threading
-
 import flet as ft
+import threading  # noqa: F401
+
 from app.ui import theme
 from translation_tool.utils.log_unit import log_info
 
@@ -49,6 +48,7 @@
 except Exception:
     TaskSession = None
 
+
 class TranslationView(ft.Column):
     """翻譯工作台：FTB / KubeJS / Markdown 三流程統一入口。"""
 
@@ -69,17 +69,16 @@ def __init__(self, page: ft.Page, file_picker: ft.FilePicker):
         self._ui_timer_running = False
 
         # 右側共用狀態與日誌
-        self.status_chip = ft.Chip(
-            label=ft.Text("尚未開始"), bgcolor=theme.GREY_200
-        )
+        self.status_chip = ft.Chip(label=ft.Text("尚未開始"), bgcolor=theme.GREY_200)
         self.progress = ft.ProgressBar(
             value=0, height=8, bgcolor=theme.GREY_200, color=theme.BLUE
         )
+        # 初始提示文字，避免 ListView 空白時透明顯現深灰背景
         self.log_view = ft.ListView(
             expand=True,
             spacing=4,
             auto_scroll=True,
-            bgcolor="#1e1e1e",  # 與 Container 背景一致，解決透明導致灰色圖塊問題
+            controls=[ft.Text("等待翻譯開始...", size=13, color=theme.GREY_100)],
         )
 
         header = ft.Row(
@@ -125,17 +124,13 @@ def __init__(self, page: ft.Page, file_picker: ft.FilePicker):
                         spacing=10,
                     ),
                 ),
-                styled_card(
-                    title="執行日誌",
-                    icon=ft.Icons.RECEIPT_LONG,
+                ft.Container(
                     expand=True,
-                    content=ft.Container(
-                        expand=True,
-                        bgcolor="#1e1e1e",
-                        border_radius=8,
-                        padding=10,
-                        content=self.log_view,
-                    ),
+                    bgcolor="#1e1e1e",
+                    border_radius=8,
+                    border=ft.border.all(1, theme.GREY_800),
+                    padding=10,
+                    content=self.log_view,
                 ),
             ],
             expand=True,
@@ -199,7 +194,13 @@ def _action_row(
         trailing: list[ft.Control] | None = None,
     ) -> ft.Control:
         """建立操作按鈕列 UI"""
-        return build_action_row(view=self, on_start=on_start, on_dry_run=on_dry_run, on_reset=on_reset, trailing=trailing)
+        return build_action_row(
+            view=self,
+            on_start=on_start,
+            on_dry_run=on_dry_run,
+            on_reset=on_reset,
+            trailing=trailing,
+        )
 
     # ------------------------------------------------------------------
     # Tab builders
diff --git a/translation_tool/core/kubejs_translator_clean.py b/translation_tool/core/kubejs_translator_clean.py
index 7123145..76bf25a 100644
--- a/translation_tool/core/kubejs_translator_clean.py
+++ b/translation_tool/core/kubejs_translator_clean.py
@@ -8,10 +8,12 @@
 
 from pathlib import Path
 from typing import Any, Callable
+import json
 import re
 
 _LANG_REF_RE = re.compile(r"^\{.+\}$")
 
+
 def is_filled_text_impl(v: Any) -> bool:
     """判斷是否為有實質內容的文字。"""
     if not isinstance(v, str):
@@ -23,7 +25,10 @@ def is_filled_text_impl(v: Any) -> bool:
         return False
     return True
 
-def deep_merge_3way_flat_impl(tw: dict, cn: dict, en: dict, *, safe_convert_text_fn: Callable[[str], str]) -> dict:
+
+def deep_merge_3way_flat_impl(
+    tw: dict, cn: dict, en: dict, *, safe_convert_text_fn: Callable[[str], str]
+) -> dict:
     """扁平 KubeJS 三語 merge：tw > cn->tw > en。"""
     out = {}
     keys = set(tw.keys()) | set(cn.keys()) | set(en.keys())
@@ -45,6 +50,7 @@ def deep_merge_3way_flat_impl(tw: dict, cn: dict, en: dict, *, safe_convert_text
 
     return out
 
+
 def prune_en_by_tw_flat_impl(en_map: dict, tw_available: dict) -> dict:
     """剪掉 tw 已有內容的 en key。"""
     out = {}
@@ -54,6 +60,7 @@ def prune_en_by_tw_flat_impl(en_map: dict, tw_available: dict) -> dict:
         out[k] = v
     return out
 
+
 def clean_kubejs_from_raw_impl(
     base_dir: str,
     *,
@@ -68,7 +75,7 @@ def clean_kubejs_from_raw_impl(
     log_info_fn: Callable[..., None],
 ) -> dict:
     """實作：將 KubeJS 原始 lang 檔（en_us/zh_cn/zh_tw）做三方合併，產出待翻譯 en_us 與完成品 zh_tw。
-    
+
     Args:
         base_dir: Modpack 根目錄。
         output_dir: 輸出根目錄（預設 base_dir/Output）。
@@ -85,9 +92,19 @@ def clean_kubejs_from_raw_impl(
     """
     base = Path(base_dir).resolve()
     out_root = Path(output_dir).resolve() if output_dir else (base / "Output")
-    raw_root = Path(raw_dir).resolve() if raw_dir else (out_root / "kubejs" / "raw" / "kubejs")
-    pending_root_p = Path(pending_root).resolve() if pending_root else (out_root / "kubejs" / "待翻譯" / "kubejs")
-    final_root_p = Path(final_root).resolve() if final_root else (out_root / "kubejs" / "完成" / "kubejs")
+    raw_root = (
+        Path(raw_dir).resolve() if raw_dir else (out_root / "kubejs" / "raw" / "kubejs")
+    )
+    pending_root_p = (
+        Path(pending_root).resolve()
+        if pending_root
+        else (out_root / "kubejs" / "待翻譯" / "kubejs")
+    )
+    final_root_p = (
+        Path(final_root).resolve()
+        if final_root
+        else (out_root / "kubejs" / "完成" / "kubejs")
+    )
 
     pending_root_p.mkdir(parents=True, exist_ok=True)
     final_root_p.mkdir(parents=True, exist_ok=True)
@@ -101,13 +118,60 @@ def clean_kubejs_from_raw_impl(
         else:
             other_jsons.append(p)
 
+    # 建立 zh_tw lookup table：用於過濾 client_scripts/*.json
+    # 已翻譯的 key（有 zh_tw 對應）→ skip；未翻譯 → 保留到 pending
+    tw_lookup: dict[str, str] = {}
+    if final_root_p.exists():
+        for tw_file in final_root_p.rglob("zh_tw.json"):
+            tw_data = read_json_dict_fn(tw_file)
+            if tw_data:
+                tw_lookup.update(tw_data)
+    # 同時從 raw_root 的 lang/zh_tw.json 讀取（確保新翻譯也被納入）
+    for tw_file in raw_root.rglob("zh_tw.json"):
+        tw_data = read_json_dict_fn(tw_file)
+        if tw_data:
+            tw_lookup.update(
+                deep_merge_3way_flat_impl(
+                    tw_data, {}, {}, safe_convert_text_fn=safe_convert_text_fn
+                )
+            )
+
     copied_other = 0
     for p in other_jsons:
         rel = p.relative_to(raw_root)
         dst = pending_root_p / rel
         dst.parent.mkdir(parents=True, exist_ok=True)
-        dst.write_bytes(p.read_bytes())
-        copied_other += 1
+
+        if "client_scripts" in str(p):
+            # 對 client_scripts/*.json 做三語合併比對過濾
+            # client_scripts JSON key 格式：tooltips.js|modid:item.tooltip.0
+            # zh_tw.json key 格式：modid:item（無 .tooltip.N 後綴）
+            # → 需剝除前綴與 .tooltip.N 後綴才能正確比對
+            data = read_json_dict_fn(p)
+            if data:
+                filtered = {}
+                for k, v in data.items():
+                    # 解析 key：去掉前綴 tooltips.js| 和 .tooltip.N 後綴
+                    lookup_key = k.split("|", 1)[-1] if "|" in k else k
+                    lookup_key = re.sub(r"\.tooltip\.\d+$", "", lookup_key)
+                    lookup_key = re.sub(r"\[.*?\]", "", lookup_key).strip()
+                    # 有 zh_tw 翻譯 → skip（視為 cache hit）；無 → 保留
+                    if lookup_key and lookup_key not in tw_lookup:
+                        # ✅ 對簡體中文值做 OpenCC 轉換（s2tw），轉為繁體中文
+                        v_converted = safe_convert_text_fn(v)
+                        filtered[k] = v_converted
+                if filtered:
+                    dst.write_text(
+                        json.dumps(filtered, indent=2, ensure_ascii=False), "utf-8"
+                    )
+                    copied_other += 1
+                # else: 全部被過濾，不寫入也不計入 copied_other
+            else:
+                dst.write_bytes(p.read_bytes())
+                copied_other += 1
+        else:
+            dst.write_bytes(p.read_bytes())
+            copied_other += 1
 
     groups: dict[Path, dict[str, Path]] = {}
     for p in lang_files:
@@ -123,14 +187,18 @@ def clean_kubejs_from_raw_impl(
         cn = read_json_dict_fn(files_map.get("zh_cn"))
         tw = read_json_dict_fn(files_map.get("zh_tw"))
 
-        log_debug_fn(f"[KubeJS-CLEAN-DBG] group={group_dir} | en={len(en or {})} cn={len(cn or {})} tw={len(tw or {})}")
+        log_debug_fn(
+            f"[KubeJS-CLEAN-DBG] group={group_dir} | en={len(en or {})} cn={len(cn or {})} tw={len(tw or {})}"
+        )
 
         has_twcn = bool(cn or tw)
         rel_group = group_dir.relative_to(raw_root)
 
         if en:
             if has_twcn:
-                available_tw = deep_merge_3way_flat_impl(tw, cn, {}, safe_convert_text_fn=safe_convert_text_fn)
+                available_tw = deep_merge_3way_flat_impl(
+                    tw, cn, {}, safe_convert_text_fn=safe_convert_text_fn
+                )
                 pending_en = prune_en_by_tw_flat_impl(en, available_tw)
             else:
                 pending_en = en
@@ -141,7 +209,9 @@ def clean_kubejs_from_raw_impl(
                 pending_lang_written += 1
 
         if has_twcn:
-            merged_tw = deep_merge_3way_flat_impl(tw, cn, {}, safe_convert_text_fn=safe_convert_text_fn)
+            merged_tw = deep_merge_3way_flat_impl(
+                tw, cn, {}, safe_convert_text_fn=safe_convert_text_fn
+            )
             dst_tw = final_root_p / rel_group / "zh_tw.json"
             write_json_fn(dst_tw, merged_tw)
             merged_lang_written += 1
diff --git a/translation_tool/plugins/ftbquests/ftbquests_lmtranslator.py b/translation_tool/plugins/ftbquests/ftbquests_lmtranslator.py
index b962ae6..af9262c 100644
--- a/translation_tool/plugins/ftbquests/ftbquests_lmtranslator.py
+++ b/translation_tool/plugins/ftbquests/ftbquests_lmtranslator.py
@@ -59,6 +59,7 @@
 # Smart 翻譯轉接器（資料格式轉換）
 # -------------------------
 
+
 def map_to_items(
     mapping: Dict[str, Any],
     cache_type: str,
@@ -109,6 +110,7 @@ def map_to_items(
 
     return items
 
+
 def count_translatable_keys(mapping: Dict[str, Any]) -> int:
     """
     計算 mapping 中「實際可翻譯的字串數量」。
@@ -124,6 +126,7 @@ def count_translatable_keys(mapping: Dict[str, Any]) -> int:
     """
     return sum(1 for _, v in mapping.items() if isinstance(v, str) and v.strip())
 
+
 @dataclass
 class DryRunStats:
     """
@@ -141,6 +144,7 @@ class DryRunStats:
     cache_miss: int = 0  # 實際需翻譯數
     per_file: list[dict] = None  # 每個檔案的明細
 
+
 # -------------------------
 # Public API (callable from pipeline)
 # -------------------------
@@ -293,7 +297,7 @@ def _count_one(src: Path) -> Tuple[Path, int]:
         )
 
     if global_total_to_translate == 0:
-        set_prog(1.0)
+        set_prog(0.99)  # 避免瞬間跳 1.0，讓 UI 停留在即將完成的視覺效果
 
     # ---- Translate per file (shared loop + cache) ----
     translated_done = 0  # ✅ 只算 API 翻譯完成（主進度分子）
@@ -387,8 +391,8 @@ def _writer(file_id: str) -> None:
             if len(all_cached_items) < 2000:
                 all_cached_items.extend(cached_items[: 2000 - len(all_cached_items)])
 
-            translated_done += miss
-            set_prog(min(translated_done / max(global_total_to_translate, 1), 1.0))
+            # 以檔案數取代翻譯量為進度分母，避免翻譯量分佈不均造成視覺跳躍
+            set_prog(min(idx / len(per_file_counts), 1.0))
 
             log_info(
                 f"🧪 [測試模式] 進度：{idx}/{len(per_file_counts)}\n"
diff --git a/translation_tool/plugins/kubejs/kubejs_tooltip_extract.py b/translation_tool/plugins/kubejs/kubejs_tooltip_extract.py
index 8a6d8cf..36b2344 100644
--- a/translation_tool/plugins/kubejs/kubejs_tooltip_extract.py
+++ b/translation_tool/plugins/kubejs/kubejs_tooltip_extract.py
@@ -10,28 +10,31 @@
 from collections import defaultdict
 from pathlib import Path
 
-from translation_tool.utils.log_unit import( 
-    log_info, 
-    log_error, 
-    log_warning, 
-    log_debug, 
-    )
+from translation_tool.utils.log_unit import (
+    log_info,
+    log_error,
+    log_warning,
+    log_debug,
+)
+
 
 def resolve_kubejs_root(input_dir: str, *, max_depth: int = 4) -> str:
     """
     自動解析並尋找 KubeJS 根目錄。
-    
+
     搜尋策略：
     1. 檢查輸入路徑是否本身就是 kubejs/。
     2. 檢查輸入路徑的正下方是否有 kubejs/。
     3. 遞迴搜尋子目錄（受限於 max_depth），尋找名為 kubejs 的目錄。
-    
+
     :param input_dir: 使用者選取的路徑。
     :param max_depth: 最大向下搜尋深度，避免掃描過多無關目錄（如大型模組包根目錄）。
     :return: 找到的 KubeJS 絕對路徑字串；若找不到則回傳原輸入路徑。
     """
-    log_debug(f"開始解析 KubeJS 根目錄，輸入路徑: '{input_dir}'，最大搜尋深度: {max_depth}")
-    
+    log_debug(
+        f"開始解析 KubeJS 根目錄，輸入路徑: '{input_dir}'，最大搜尋深度: {max_depth}"
+    )
+
     try:
         base = Path(input_dir).resolve()
     except Exception as e:
@@ -51,7 +54,7 @@ def resolve_kubejs_root(input_dir: str, *, max_depth: int = 4) -> str:
 
     # 3) 情境 C：往下遞迴搜尋
     log_debug(f"直接路徑未匹配，開始在深度 {max_depth} 內搜尋子目錄...")
-    
+
     base_parts = len(base.parts)
     best_match = None
 
@@ -60,13 +63,13 @@ def resolve_kubejs_root(input_dir: str, *, max_depth: int = 4) -> str:
         for p in base.rglob("*"):
             if not p.is_dir():
                 continue
-            
+
             # 計算目前深度 (相對於 base)
             current_depth = len(p.parts) - base_parts
-            
+
             if current_depth > max_depth:
                 continue
-                
+
             if p.name.lower() == "kubejs":
                 best_match = p
                 log_info(f"搜尋成功：在深度 {current_depth} 處找到 KubeJS -> {p}")
@@ -81,8 +84,10 @@ def resolve_kubejs_root(input_dir: str, *, max_depth: int = 4) -> str:
     log_warning(f"在指定深度範圍內找不到 'kubejs' 目錄。回傳原始路徑: {base}")
     return str(base)
 
+
 # ---------- 工具 ----------
 
+
 def to_json_name(filename: str) -> str:
     """
     將檔名後綴統一轉換為 .json。
@@ -95,31 +100,35 @@ def to_json_name(filename: str) -> str:
         result = filename
     else:
         result = filename + ".json"
-    
+
     log_debug(f"檔名轉換: '{filename}' -> '{result}'")
     return result
 
+
 def strip_quotes(s: str) -> str:
     """
     移除字串前後成對的單引號或雙引號。
     """
     s = s.strip()
     if len(s) >= 2:
-        if (s.startswith("'") and s.endswith("'")) or (s.startswith('"') and s.endswith('"')):
+        if (s.startswith("'") and s.endswith("'")) or (
+            s.startswith('"') and s.endswith('"')
+        ):
             stripped = s[1:-1]
             log_debug(f"已脫殼引號: {s} -> {stripped}")
             return stripped
     return s
 
+
 def split_js_args(s: str) -> list[str]:
     """
     解析 JS 函式參數字串，能正確處理逗號分隔，並忽略括號 ()、中括號 []、大括號 {} 以及引號內的逗號。
-    
-    例如: 'item.of("mt:pipe", {lvl:1}), 5' 
+
+    例如: 'item.of("mt:pipe", {lvl:1}), 5'
     會被拆分為 ['item.of("mt:pipe", {lvl:1})', '5']
     """
     log_debug(f"開始拆解 JS 參數字串: {s}")
-    
+
     args = []
     buf = ""
     depth = 0
@@ -157,11 +166,14 @@ def split_js_args(s: str) -> list[str]:
         args.append(buf.strip())
 
     if depth != 0:
-        log_warning(f"JS 參數解析可能異常：括號未對齊 (剩餘深度: {depth})，原始字串: {s}")
+        log_warning(
+            f"JS 參數解析可能異常：括號未對齊 (剩餘深度: {depth})，原始字串: {s}"
+        )
 
     log_debug(f"參數拆解完成，取得 {len(args)} 個參數")
     return args
 
+
 def extract_array_strings(arr: str) -> list[str]:
     """
     使用正則表達式從字串中提取所有被引號包圍的內容。
@@ -175,22 +187,24 @@ def extract_array_strings(arr: str) -> list[str]:
         log_error(f"提取陣列字串時發生錯誤: {str(e)}")
         return []
 
+
 # ---------- Patchouli 指令過濾 ----------
 _PATCHOULI_COMMAND_ONLY = re.compile(
     r"^\{[a-zA-Z0-9_:-]+(?::[^\s{}]+)?(?:\s+[a-zA-Z0-9_:-]+:[^{}\s]+)*\}$"
 )
 
+
 def is_patchouli_command_only(s: str) -> bool:
     """
     判斷字串是否整段僅由 Patchouli 指令組成（例如：$(br)、$(l:...)、$(img) 等）。
     這通常用於過濾不需要進行翻譯處理的文本行。
-    
+
     True  = 整段都是指令，無需翻譯。
     False = 包含一般文字或非指令內容。
     """
     # 預處理：去除空白並確保不是 None
     clean_s = (s or "").strip()
-    
+
     if not clean_s:
         # 空字串不視為指令
         return False
@@ -198,21 +212,23 @@ def is_patchouli_command_only(s: str) -> bool:
     # 進行全文匹配
     # 使用 fullmatch 確保字串從頭到尾都符合 Patchouli 指令格式
     is_match = bool(_PATCHOULI_COMMAND_ONLY.fullmatch(clean_s))
-    
+
     if is_match:
         # 如果整段都是指令，用 debug 紀錄即可，避免干擾主要資訊
         log_debug(f"偵測到純 Patchouli 指令段落，將跳過翻譯: '{clean_s}'")
-    
+
     return is_match
 
+
 # ---------- Lang Key 過濾 ----------
 # 例: tooltip.xxx.yyy / item.kubejs.fake_mob_masher / block.modid.name ...
 _LANG_KEY_LIKE = re.compile(r"^(?:[a-z0-9_]+)(?:\.[a-z0-9_]+)+$")
 
+
 def is_lang_key_like(s: str) -> bool:
     """
     判斷字串是否「像」一個 Minecraft 的翻譯鍵（Translation Key）。
-    
+
     目的：過濾掉如 'item.minecraft.iron_ingot' 這種 key，避免將其視為一般句子進行翻譯。
     判斷基準：
     1. 不得為空。
@@ -234,12 +250,13 @@ def is_lang_key_like(s: str) -> bool:
 
     # 進行正規表示式匹配
     is_key = bool(_LANG_KEY_LIKE.fullmatch(s))
-    
+
     if is_key:
         log_debug(f"跳過翻譯 Key: '{s}' (符合 Key 格式條件)")
-    
+
     return is_key
 
+
 def is_lang_key_ref_like(s: str) -> bool:
     """
     過濾純引用格式：
@@ -253,10 +270,11 @@ def is_lang_key_ref_like(s: str) -> bool:
         return False
     return bool(re.fullmatch(r"\{[^{}]+\}(?:\n\{[^{}]+\})*", t))
 
+
 def clean_text(s: str) -> str:
     """
     清理文本中的雜質，主要針對 Minecraft 的特殊格式。
-    
+
     1. 移除 Minecraft 內建的顏色碼與格式碼（如 §a, §l, §r 等）。
     2. 移除字串前後的贅餘空白。
     """
@@ -271,38 +289,41 @@ def clean_text(s: str) -> str:
     # 只有在真的有變動時才紀錄 debug log，避免 Log 檔案過於混亂
     if original != cleaned:
         log_debug(f"文字清理完成: '{original}' -> '{cleaned}'")
-        
+
     return cleaned
 
+
 _RE_SKIP_KUBEJS_TOOLTIP_EXPR = re.compile(
     r"^\s*(Text\.translate|Text\.of|Component\.translatable|Component\.translate|Component\.literal)\s*\(",
     re.S,
 )
 
+
 def should_skip_kubejs_tooltip_expr(expr: str) -> bool:
     """第二參數如果是 Text.translate(...) 這種，代表語言 key 引用，不要抽去翻譯。"""
     return bool(_RE_SKIP_KUBEJS_TOOLTIP_EXPR.match((expr or "").strip()))
 
+
 def extract_js_string_call(text: str, start: int) -> str | None:
     """
     從指定的起始位置開始，解析並提取第一個出現的 JavaScript 字串內容。
     支援處理單引號、雙引號以及轉義字元（如 \\' 或 \\"）。
-    
+
     通常用於解析：Text.of( '內容' ) 或 Text.red( "內容" )
-    
+
     :param text: 原始腳本文字內容。
     :param start: 開始搜尋的索引位置（通常是左括號 '(' 的下一個位置）。
     :return: 提取到的字串內容（不含兩側引號）；若找不到完整字串則回傳 None。
     """
     log_debug(f"開始提取 JS 字串參數，起始索引: {start}")
-    
+
     i = start
     quote = None
     escaped = False
     buf = ""
 
     text_len = len(text)
-    
+
     # 檢查起始位置是否合法
     if start >= text_len:
         log_warning(f"提取位置超出範圍: start={start}, text_length={text_len}")
@@ -314,7 +335,7 @@ def extract_js_string_call(text: str, start: int) -> str | None:
         # 狀態 A: 已經進入引號範圍內
         if quote:
             buf += ch
-            
+
             if escaped:
                 # 前一個字元是 \，所以無論這個字元是什麼都當作一般文字處理
                 escaped = False
@@ -327,60 +348,76 @@ def extract_js_string_call(text: str, start: int) -> str | None:
                 result = buf[:-1]  # 去掉最後一個被加入 buf 的結尾引號
                 log_debug(f"成功提取字串參數: '{result}'")
                 return result
-        
+
         # 狀態 B: 還在尋找字串的開頭引號
         else:
             if ch in ("'", '"', "`"):
                 quote = ch
                 log_debug(f"偵測到字串起始引號: {quote}")
-        
+
         i += 1
 
     # 如果跑完迴圈都沒 return，代表字串沒閉合
-    log_warning(f"字串解析未完成（可能缺少結尾引號）。目前緩存: '{buf}'，起始位置: {start}")
+    log_warning(
+        f"字串解析未完成（可能缺少結尾引號）。目前緩存: '{buf}'，起始位置: {start}"
+    )
     return None
 
-def should_skip_text(text: str) -> bool:
+
+def should_skip_text(text: str, *, skip_chinese: bool = True) -> bool:
     """
     判斷該段文字是否應該跳過翻譯流程。
-    
+
     此函式整合了多種過濾機制，包含：
     1. 空白/無內容過濾。
     2. Patchouli 指令過濾。
     3. Minecraft 翻譯鍵（Lang Key）過濾。
-    4. 已翻譯（包含中文字元）內容過濾。
-    
+    4. 已翻譯（包含中文字元）內容過濾（可透過 skip_chinese 參數控制）。
+
     :param text: 待檢查的原始字串。
+    :param skip_chinese: 是否跳過含中文的文字（預設 True）。
+        - True 時：含中文視為「已翻譯」而跳過（用於 en_us 來源檔案）
+        - False 時：保留中文（用於 KubeJS .js 檔案，需要三語合併比對）
     :return: bool, True 表示應跳過（不翻譯），False 表示需要翻譯。
     """
     # 進行初步清理
     t = clean_text(text)
-    
+
     # 情況 1：清理後為空
     if not t:
         # 這裡不特別紀錄 Log，因為空行很常見
         return True
-    
+
     log_debug(f"正在評估文字是否跳過: '{t}'")
-    
+
     # ✅ 情況 2：跳過純 Patchouli 指令 (如 $(br), $(img:...) )
     if is_patchouli_command_only(t):
         log_debug(f"跳過判定: 純指令段落 -> '{t}'")
         return True
-    
+
     # ✅ 情況 3：跳過看起來像翻譯 Key 的內容 (如 item.minecraft.dirt)
     if is_lang_key_like(t):
         log_debug(f"跳過判定: 翻譯鍵格式 (Key-like) -> '{t}'")
         return True
-    
+
     # ✅ 情況 4：跳過純引用格式（如 {xxx}\n{yyy}）
     if is_lang_key_ref_like(t):
         log_debug(f"跳過判定: 純引用格式 -> '{t}'")
         return True
 
-    # ✅ 情況 5：跳過已包含中文字元的文字（視為已翻譯完成）
-    # 使用 Unicode 範圍 \u4e00-\u9fff 判定常用漢字
-    if re.search(r"[\u4e00-\u9fff]", t):
+    # ✅ 情況 5（通用）：跳過主要由 ASCII block art 字元組成的文字
+    # █ ▓ ▒ ░ ■ □ ● ○ 等視覺裝飾字元，不需要翻譯
+    # 此檢測無視 skip_chinese 設定（block art 與語言無關）
+    block_chars = set("█▓▒░▪▫●○◌■□▪▸▹◆◇★☆")
+    block_count = sum(1 for c in t if c in block_chars)
+    if block_count > 0 and block_count / max(len(t), 1) > 0.5:
+        log_debug(f"跳過判定: ASCII block art（{block_count}/{len(t)}） -> '{t}'")
+        return True
+
+    # ✅ 情況 6：只有 skip_chinese=True 時才跳過含中文的文字
+    # - KubeJS .js 檔案（skip_chinese=False）：保留中文，用於三語合併比對
+    # - 一般 en_us 來源檔案（skip_chinese=True）：含中文視為「已翻譯」而跳過
+    if skip_chinese and re.search(r"[\u4e00-\u9fff]", t):
         log_debug(f"跳過判定: 偵測到中文字元（已翻譯） -> '{t}'")
         return True
 
@@ -388,11 +425,12 @@ def should_skip_text(text: str) -> bool:
     log_debug(f"確定需要翻譯: '{t}'")
     return False
 
+
 def extract_call_args(text: str, start: int) -> str | None:
     """
     從指定的起始位置開始，提取括號 '()' 內的所有內容。
     支援嵌套括號處理（例如：.add(item, Text.of(Text.red('...')))）。
-    
+
     :param text: 原始文字內容。
     :param start: 左括號 '(' 之後的第一個字元索引。
     :return: 括號內的完整字串；若括號未閉合則回傳 None。
@@ -419,14 +457,17 @@ def extract_call_args(text: str, start: int) -> str | None:
     log_warning(f"括號解析失敗：未找到匹配的閉合括號。起始位置: {start}")
     return None
 
-def extract_itemevents_tooltips(content: str, file_name: str, extracted: dict, auto_id: int) -> int:
+
+def extract_itemevents_tooltips(
+    content: str, file_name: str, extracted: dict, auto_id: int
+) -> int:
     """
     解析 KubeJS 的 ItemEvents.tooltip 腳本，提取其中的文字內容。
-    
+
     支援格式範例：
     - event.add('minecraft:dirt', Text.of('Hello'))
     - event.add(['item1', 'item2'], Text.red('Warning'))
-    
+
     :param content: 腳本檔案的全文內容。
     :param file_name: 目前處理的檔案名稱（用於生成 Key）。
     :param extracted: 存放提取結果的字典（Key-Value）。
@@ -434,7 +475,7 @@ def extract_itemevents_tooltips(content: str, file_name: str, extracted: dict, a
     :return: 更新後的 auto_id。
     """
     log_info(f"正在處理檔案: {file_name}，開始掃描 .add() 調用...")
-    
+
     match_count = 0
 
     # 搜尋所有 .add( 的位置
@@ -452,8 +493,9 @@ def extract_itemevents_tooltips(content: str, file_name: str, extracted: dict, a
         # 1. 處理 Item ID (第一個參數)
         raw_id = args[0].strip()
         # 使用 strip_quotes 邏輯簡化提取
-        if (raw_id.startswith("'") and raw_id.endswith("'")) or \
-           (raw_id.startswith('"') and raw_id.endswith('"')):
+        if (raw_id.startswith("'") and raw_id.endswith("'")) or (
+            raw_id.startswith('"') and raw_id.endswith('"')
+        ):
             item_id = raw_id[1:-1]
         else:
             # 如果是陣列或正則表達式，保留原樣作為 Key 的一部分
@@ -467,24 +509,24 @@ def extract_itemevents_tooltips(content: str, file_name: str, extracted: dict, a
         for tm in re.finditer(r"Text\.\w+\s*\(", tooltip_block):
             start_pos = tm.end()
             text_content = extract_js_string_call(tooltip_block, start_pos)
-            
+
             if text_content is None:
                 continue
-            
+
             # ✅ 檢查是否符合跳過條件（空值、指令、Key、已翻譯等）
-            if should_skip_text(text_content):
+            if should_skip_text(text_content, skip_chinese=False):
                 idx += 1
                 continue
 
             # 產生唯一的 Key 格式: 檔案名|物品ID.tooltip.序號
             key = f"{file_name}|{item_id}.tooltip.{idx}"
-            
+
             # 存入結果並清理 Minecraft 顏色代碼
             cleaned_val = clean_text(text_content)
             extracted[key] = cleaned_val
-            
+
             log_debug(f"成功提取內容 [{key}]: {cleaned_val}")
-            
+
             auto_id += 1
             idx += 1
             match_count += 1
@@ -492,6 +534,7 @@ def extract_itemevents_tooltips(content: str, file_name: str, extracted: dict, a
     log_info(f"檔案 {file_name} 處理完畢，共提取 {match_count} 條文本。")
     return auto_id
 
+
 # ---------- 主流程 ----------
 def extract(
     source_dir: str | None = None,
@@ -503,7 +546,7 @@ def extract(
 ) -> dict:
     """
     執行全文提取流程：將 KubeJS 腳本與 Lang JSON 中的待翻譯文字提取出來。
-    
+
     :param source_dir: 模組包根目錄或 kubejs 目錄。
     :param output_dir: 翻譯 JSON 的輸出目錄。
     :param session: UI 工作對話實體，用於更新進度條與日誌。
@@ -532,7 +575,7 @@ def extract(
     for root, _, files in os.walk(src_root):
         for f in files:
             all_files_path.append(os.path.join(root, f))
-    
+
     total_files = max(1, len(all_files_path))
     processed_count = 0
     extracted_files_count = 0
@@ -545,14 +588,16 @@ def extract(
     for file_path in all_files_path:
         file_name = os.path.basename(file_path)
         rel_dir = os.path.relpath(os.path.dirname(file_path), src_root)
-        
-        extracted = {} # 存放當前檔案提取出的 Key-Value
+
+        extracted = {}  # 存放當前檔案提取出的 Key-Value
         id_counters = defaultdict(int)
         auto_id = 1
 
         try:
             # --- A) 處理 KubeJS 腳本 (.js) ---
-            if file_name.endswith(".js") and "client_scripts" in file_path.replace("\\", "/"):
+            if file_name.endswith(".js") and "client_scripts" in file_path.replace(
+                "\\", "/"
+            ):
                 log_debug(f"正在分析 JS 腳本: {file_name}")
                 with open(file_path, "r", encoding="utf-8") as f:
                     content = f.read()
@@ -562,7 +607,7 @@ def extract(
                     arg_str = extract_call_args(content, m.end())
                     if not arg_str:
                         continue
-                    
+
                     args = split_js_args(arg_str)
 
                     # 單一參數情況：可能是字串直接添加
@@ -571,9 +616,9 @@ def extract(
                         # 過濾掉 Resource Location (mod:id)
                         if re.match(r"^[a-z0-9_.-]+:[a-z0-9_/.-]+$", text):
                             continue
-                        if should_skip_text(text):
+                        if should_skip_text(text, skip_chinese=False):
                             continue
-                        
+
                         text = clean_text(text)
                         if len(text) > 1:
                             key = f"{file_name}|auto.{auto_id}"
@@ -589,15 +634,17 @@ def extract(
                         # ✅ Text.translate(...) / Text.of(...) 等屬於語言 key 引用，不抽取
                         if should_skip_kubejs_tooltip_expr(args[1]):
                             continue
-                        
+
                         # 若內容包含 Text. 元件
                         if "Text." in args[1]:
                             # 嘗試簡單提取第一個引號內容
                             m2 = re.search(r"['\"](.+?)['\"]", args[1])
                             if m2:
                                 raw = m2.group(1)
-                                if not should_skip_text(raw):
-                                    extracted[f"{file_name}|{item_id}.{n}"] = clean_text(raw)
+                                if not should_skip_text(raw, skip_chinese=False):
+                                    extracted[f"{file_name}|{item_id}.{n}"] = (
+                                        clean_text(raw)
+                                    )
 
                         # 若內容是陣列 [...]
                         elif args[1].startswith("["):
@@ -605,14 +652,20 @@ def extract(
                                 idx = 0
                                 for tm in re.finditer(r"Text\.\w+\s*\(", args[1]):
                                     t = extract_js_string_call(args[1], tm.end())
-                                    if t and not should_skip_text(t):
-                                        extracted[f"{file_name}|{item_id}.{n}.{idx}"] = clean_text(t)
+                                    if t and not should_skip_text(
+                                        t, skip_chinese=False
+                                    ):
+                                        extracted[
+                                            f"{file_name}|{item_id}.{n}.{idx}"
+                                        ] = clean_text(t)
                                     idx += 1
                             else:
                                 # 純字串陣列
                                 for i, txt in enumerate(extract_array_strings(args[1])):
-                                    if not should_skip_text(txt):
-                                        extracted[f"{file_name}|{item_id}.{n}.{i}"] = clean_text(txt)
+                                    if not should_skip_text(txt, skip_chinese=False):
+                                        extracted[f"{file_name}|{item_id}.{n}.{i}"] = (
+                                            clean_text(txt)
+                                        )
 
                 # 2. 處理 Ponder 劇情文字 (scene.text)
                 for m in re.finditer(r"scene\.text\s*\((.+?)\)", content, re.S):
@@ -624,25 +677,33 @@ def extract(
                             continue
 
                         text = strip_quotes(args[1])
-                        if not should_skip_text(text):
+                        if not should_skip_text(text, skip_chinese=False):
                             key = f"{file_name}|scene.{auto_id}"
                             if key not in extracted:
                                 extracted[key] = clean_text(text)
                                 auto_id += 1
 
                 # 3. 處理 ItemEvents Tooltips (模組化調用)
-                auto_id = extract_itemevents_tooltips(content, file_name, extracted, auto_id)
+                auto_id = extract_itemevents_tooltips(
+                    content, file_name, extracted, auto_id
+                )
 
             # --- B) 處理語言檔 (.json) ---
-            elif file_name.endswith(".json") and "/lang/" in file_path.replace("\\", "/"):
+            elif file_name.endswith(".json") and "/lang/" in file_path.replace(
+                "\\", "/"
+            ):
                 log_debug(f"正在讀取 Lang JSON: {file_name}")
                 with open(file_path, "r", encoding="utf-8") as f:
-                    raw = f.read().lstrip("\ufeff") # 處理可能的 BOM
+                    raw = f.read().lstrip("\ufeff")  # 處理可能的 BOM
                     # 清除 JSON 中常見的結尾逗號錯誤
                     raw = re.sub(r",\s*([}\]])", r"\1", raw)
                     data = json.loads(raw)
                     for k, v in data.items():
-                        if isinstance(v, str) and v.strip() and not is_lang_key_ref_like(v):
+                        if (
+                            isinstance(v, str)
+                            and v.strip()
+                            and not is_lang_key_ref_like(v)
+                        ):
                             extracted[k] = v
 
         except Exception as e:
@@ -685,11 +746,16 @@ def extract(
     }
 
     if errors_count:
-        log_info(f"⚠ 提取完成（含 {errors_count} 筆錯誤）！共輸出 {extracted_files_count} 個檔案，提取 {extracted_keys_total} 條文本。")
+        log_info(
+            f"⚠ 提取完成（含 {errors_count} 筆錯誤）！共輸出 {extracted_files_count} 個檔案，提取 {extracted_keys_total} 條文本。"
+        )
     else:
-        log_info(f"🎊 提取完成！共輸出 {extracted_files_count} 個檔案，提取 {extracted_keys_total} 條文本。")
+        log_info(
+            f"🎊 提取完成！共輸出 {extracted_files_count} 個檔案，提取 {extracted_keys_total} 條文本。"
+        )
 
     return summary
 
+
 if __name__ == "__main__":
     extract()
diff --git a/translation_tool/plugins/kubejs/kubejs_tooltip_lmtranslator.py b/translation_tool/plugins/kubejs/kubejs_tooltip_lmtranslator.py
index b37e3c0..da66cf8 100644
--- a/translation_tool/plugins/kubejs/kubejs_tooltip_lmtranslator.py
+++ b/translation_tool/plugins/kubejs/kubejs_tooltip_lmtranslator.py
@@ -21,6 +21,8 @@
 from pathlib import Path
 from typing import Dict, Any, List, Optional, Tuple
 from concurrent.futures import ThreadPoolExecutor, as_completed
+import re
+import opencc
 
 from translation_tool.core.lm_translator_main import translate_batch_smart
 from translation_tool.core.lm_config_rules import validate_api_keys
@@ -48,6 +50,7 @@
 
 from translation_tool.utils.log_unit import log_info, log_warning, progress
 
+
 # -------------------------
 # Smart item mapping
 # -------------------------
@@ -77,6 +80,7 @@ def collect_items_from_mapping(
         )
     return items
 
+
 def count_translatable_keys(mapping: Dict[str, Any]) -> int:
     """計算 mapping 中『可翻譯字串』的數量。
 
@@ -88,6 +92,44 @@ def count_translatable_keys(mapping: Dict[str, Any]) -> int:
     """
     return sum(1 for _, v in mapping.items() if isinstance(v, str) and v.strip())
 
+
+# -------------------------
+# 繁體中文偵測（用於跳過已翻譯的 tooltips）
+# -------------------------
+_TW_CJK_RE = re.compile(r"[\u4e00-\u9fff]")
+_TW_CONVERTER = opencc.OpenCC("s2tw")
+
+
+def _is_tw_text(text: str) -> bool:
+    """判斷文字是否已經是繁體中文（OpenCC 轉換後不變 = 已是繁體）。"""
+    if not text or not isinstance(text, str):
+        return False
+    if not _TW_CJK_RE.search(text):
+        return False  # 無 CJK 字元，不是中文
+    # 簡體→繁體轉換後，如果等於原本的值，代表原本就是繁體
+    return _TW_CONVERTER.convert(text) == text
+
+
+def _split_off_tw_items(
+    cached_items: List[Dict[str, Any]],
+    items_to_translate: List[Dict[str, Any]],
+) -> List[Dict[str, Any]]:
+    """從 items_to_translate 移出已翻譯（繁體）的項目到 cached_items，回傳被移動的 items。"""
+    tw_items: List[Dict[str, Any]] = []
+    remaining: List[Dict[str, Any]] = []
+    for it in items_to_translate:
+        src_text = it.get("source_text", "") or ""
+        if _is_tw_text(src_text):
+            tw_items.append(it)
+        else:
+            remaining.append(it)
+    cached_items.extend(tw_items)
+    # 清除原本的並寫回剩餘（in-place 修改串列）
+    items_to_translate.clear()
+    items_to_translate.extend(remaining)
+    return tw_items
+
+
 # -------------------------
 # Dry-run stats (optional)
 # -------------------------
@@ -105,6 +147,7 @@ class DryRunStats:
     cache_miss: int = 0
     per_file: Optional[list[dict]] = None
 
+
 # -------------------------
 # Public API (for UI/pipeline)
 # -------------------------
@@ -218,6 +261,8 @@ def _count_one(src: Path) -> Tuple[Path, int]:
                 cache_rules=cache_rules,
                 is_valid_hit=_is_valid_hit,
             )
+            # ✅ 跳過值已經是繁體中文的 items（節省 API + 避免簡體當英文翻）
+            _split_off_tw_items(cached_items, items_to_translate)
             global_total_hit += len(cached_items)
             global_total_to_translate += len(items_to_translate)
         except Exception:
@@ -269,6 +314,9 @@ def _writer(file_id: str) -> None:
             is_valid_hit=_is_valid_hit,
         )
 
+        # ✅ 跳過值已經是繁體中文的 items（從翻譯清單移至 cache hit）
+        _split_off_tw_items(cached_items, items_to_translate)
+
         # ✅ NEW：累積 hit items
         all_hit_items.extend(cached_items)
 
diff --git a/workspace/pr10_b6_progress_check.txt b/workspace/pr10_b6_progress_check.txt
new file mode 100644
index 0000000..fa20ad8
--- /dev/null
+++ b/workspace/pr10_b6_progress_check.txt
@@ -0,0 +1,124 @@
+# PR10 B6：進度條顯示驗證報告
+
+## 任務
+確認翻譯工具在執行 FTB Quest 抽取時，UI 進度條是否有正確更新。
+
+---
+
+## 1. UI 進度條更新鏈路分析
+
+### 讀取端（UI 每 0.1 秒輪詢）
+
+**位置**：`app/views/translation/translation_actions.py` → `start_ui_timer()`
+
+```python
+def loop():
+    while view._ui_timer_running:
+        time.sleep(0.1)
+        snap = view.session.snapshot()
+        view.progress.value = float(snap.get("progress", 0) or 0)  # ← UI 更新點
+```
+
+- 輪詢頻率：每 0.1 秒
+- 進度值讀取：`session.snapshot()["progress"]`（float, 0.0～1.0）
+- UI 元件：`ft.ProgressBar(value=0, ...)`（`translation_view.py` 第 75 行）
+
+### 寫入端（各 Pipeline Step）
+
+**FTB Pipeline 4 步驟 → `session.set_progress()` 呼叫覆蓋率**：
+
+| 步驟 | 函式 | `set_progress` 呼叫 | 說明 |
+|------|------|--------|------|
+| Step 1 Export | `export_ftbquests_raw_json()` | ❌ 無 | 直接呼叫，無 progress 回報 |
+| Step 2 Clean | `clean_ftbquests_from_raw()` | ❌ 無 | 直接呼叫，無 progress 回報 |
+| Step 3 Translate | `translate_ftb_pending_to_zh_tw()` | ✅ 有 | 透過 `set_prog()` 每次 batch 更新 |
+| Step 4 Inject | inject 流程 | ❌ 無 | 無 `session` 參數，無 progress 回報 |
+
+---
+
+## 2. Step 3 翻譯進度機制（唯一有進度的步驟）
+
+**位置**：`translation_tool/plugins/ftbquests/ftbquests_lmtranslator.py`
+
+```python
+def on_progress(p: float, msg: str, eta_sec: float):
+    log_info(f"⏳ [AI 翻譯中] {msg} | 預估剩餘時間：{eta_txt}")
+    set_prog(p)  # 每次 batch 完成時呼叫
+
+set_prog(min(translated_done / max(global_total_to_translate, 1), 1.0))
+```
+
+- `translate_items_with_cache_loop` 每個 batch 完成時呼叫 `on_progress`
+- `set_prog()` 內部呼叫 `session.set_progress(v)`（`v` 為 0.0～1.0 float）
+- 進度基於「已翻譯 key 數 / 總 key 數」計算，**平滑遞增**
+
+### 翻譯進度平滑度評估
+
+| 項目 | 評估 |
+|------|------|
+| 進度類型 | 增量式（每 batch 更新一次）|
+| 更新頻率 | 依 batch size 而定（通常每數十～數百 key 更新一次）|
+| 平滑程度 | 中等（相較於每檔更新有改善，但 batch 內仍是跳躍式）|
+
+---
+
+## 3. 其他步驟進度問題
+
+### Step 1 Export（`export_ftbquests_raw_json`）
+- 直接呼叫 `process_quest_folder()`，**無任何 progress 回報**
+- 706 個 .snbt 檔案解析期間，UI 進度條停在 0
+- 用戶看到：翻譯工具「無回應」或「卡住」
+
+### Step 2 Clean（`clean_ftbquests_from_raw`）
+- 同樣無 progress 回報
+- 涉及磁碟 I/O 和三方合併邏輯
+
+### Step 4 Inject（inject 流程）
+- 無 `session` 參數傳遞，**完全無法回報進度**
+- 706 個任務檔案修改，UI 完全無回應
+
+---
+
+## 4. 進度條根本問題
+
+### 問題 1：Step 1/2/4 完全沒有進度回報
+- **原因**：這些步驟沒有接收 `session` 參數，也沒有 `session.set_progress()` 呼叫
+- **影響**：70% 的 pipeline 時間（Step 1 + 2 + 4）進度條停在 0%
+
+### 問題 2：翻譯階段（Step 3）也非真正平滑
+- **原因**：`on_progress` 只在 `translate_items_with_cache_loop` 的 batch 完成後才觸發
+- batch size 固定時，每次更新間隔穩定；但 batch 內的每個 key 翻譯進度仍不透明
+
+---
+
+## 5. 建議行動
+
+### 高優先度
+1. **[Critical] 為 Step 1/2/4 加入 progress 回報**
+   - `export_ftbquests_raw_json`：解析每個 .snbt 檔案後呼叫一次 `session.set_progress()`
+   - `clean_ftbquests_from_raw`：每處理 N 個檔案後更新進度
+   - inject 流程：傳入 session，注入每個任務檔案後更新進度
+
+2. **[High] 統一 4 步驟的進度計算基礎**
+   - 建議：以「總步驟數」為分母（Step 1 = 25%, Step 2 = 25%, Step 3 = 40%, Step 4 = 10%）
+   - 或：讓各步驟自行回報 0.0～1.0，UI 依啟用的步驟加權計算
+
+### 中優先度
+3. **[Medium] Step 3 翻譯精細化**
+   - 可在 `translate_items_with_cache_loop` 內，每翻譯 N 個 key（非 batch 边界）就回報一次進度
+   - 目前最小更新顆粒度 = 1 batch
+
+---
+
+## 6. 結論
+
+| 評估項目 | 結果 |
+|---------|------|
+| 進度條是否有正確更新？ | ⚠️ **部分正確**：只有 Step 3（翻譯）有進度回報 |
+| 進度是否平滑？ | ⚠️ **中等**：翻譯階段每 batch 更新一次，非真正連續平滑 |
+| Step 1 Export 進度 | ❌ 停在 0% |
+| Step 2 Clean 進度 | ❌ 停在 0% |
+| Step 3 Translate 進度 | ✅ 有更新（但非完全平滑）|
+| Step 4 Inject 進度 | ❌ 停在 0% |
+
+**整體進度條覆蓋率：僅 Step 3（翻譯階段），約佔整個 pipeline 的 30～50% 時間，視資料量而定。**
diff --git a/workspace/pr10_ftbquest_validation_report.md b/workspace/pr10_ftbquest_validation_report.md
new file mode 100644
index 0000000..461fb18
--- /dev/null
+++ b/workspace/pr10_ftbquest_validation_report.md
@@ -0,0 +1,107 @@
+# FTB Quest 抽取驗證報告
+
+**PR10 分支**：`pr10/translation-view-log-fix-and-ftbquest-extraction`  
+**日期**：2026-03-22  
+**驗證協調總管**：Task B Sub-agent
+
+---
+
+## 1. 目錄覆蓋率
+
+### 輸入覆蓋
+| 類別 | 數量 | 說明 |
+|------|------|------|
+| 總檔案數 | 2911 | INPUT_DIR 所有檔案 |
+| FTB Quest .snbt 檔案 | 706 | `config/ftbquests/quests/` |
+| FTB Quest 語系檔案 | 134 | en_us(67) + zh_cn(67) |
+| 其他 .snbt 檔案 | 572 | 任務本體（chapters/ 等）|
+
+### 輸出覆蓋
+| 類別 | 數量 | 說明 |
+|------|------|------|
+| 總輸出檔案 | 8 | JSON 格式 |
+| 抽取後 TSV（新增） | 2 | `ftbquests/extracted/en_us/zh_cn/` |
+
+**覆蓋率**：FTB Quest 語系檔案 100% 抽取，Quest 本體 0%（見下方建議）
+
+---
+
+## 2. 抽取統計
+
+### 抽取結果
+
+| 語系 | lang keys | quests keys | 總計 | 檔案數 |
+|------|-----------|------------|------|--------|
+| en_us | 6550 | 0 | **6550** | 67 |
+| zh_cn | 6516 | 0 | **6516** | 67 |
+| **總計** | **13066** | **0** | **13066** | 134 |
+
+### 與現有輸出比對
+
+| 現有輸出 | keys 數量 | 對應抽取 |
+|---------|----------|---------|
+| `raw/en_us/ftb_lang.json` | 6550 | ✅ 完全匹配 |
+| `raw/zh_cn/ftb_lang.json` | 6516 | ✅ 完全匹配 |
+| `待翻譯/en_us/ftb_lang.json` | 40 | 差異：6510 keys 有 zh_cn 譯文（快取命中） |
+| `整理後/zh_tw/ftb_lang.json` | 6516 | ✅ 對應 zh_cn 並已轉繁 |
+
+### 重大發現：Quest 本體未抽取
+- `ftb_quests.json` 全為 **0 keys**
+- 706 個任務本體 .snbt 檔案（chapters/ 等）未產出任何 quests 翻譯 key
+- 原因懷疑：`extract_quest_file` 函式的欄位匹配邏輯與實際 SNBT 結構不符
+
+---
+
+## 3. 格式問題
+
+| 檢查項目 | 結果 | 說明 |
+|---------|------|------|
+| 多行文字未轉義 | ✅ 無 | `\n` 已置換為 `\\n` |
+| Tab 污染分隔符 | ✅ 無 | 精確 1 個 Tab |
+| 非 UTF-8 字元 | ✅ 無 | 全為 UTF-8 |
+| 空 KEY/VALUE | ✅ 無 | 全部有效 |
+| 引號不配對 | ✅ 無 | 全部有效 |
+| Minecraft 格式碼 | ⚠️ 存在（預期）| `§0-§f`, `&0-§f` 等，需保留 |
+| Placeholder | ⚠️ 存在（預期）| `{variable}` 格式，需保留 |
+| HTML 不完整標籤 | ✅ 無 | 全部有效 |
+
+**結論：ALL CLEAR（格式無問題，需保留的內容已正確保留）**
+
+---
+
+## 4. 建議行動
+
+### 高優先度
+1. **[Critical] 修復 Quest 本體抽取**
+   - 706 個 .snbt 任務檔案（chapters/ 等）未產出翻譯 key
+   - 需檢查 `extract_quest_file` 的 `title/subtitle/description` 欄位是否存在於實際 SNBT 結構
+   - 建議：印出 1-2 個任務 .snbt 的實際結構（DEBUG 模式）比對
+
+2. **[High] 確認抽取 TSV 格式標準**
+   - 目前抽取 TSV 為翻譯工具內部格式（非對外 API）
+   - 建議明文化：是否需要 TSV 輸出？還是以 JSON 為主？
+
+### 中優先度
+3. **[Medium] 翻譯覆蓋率差異**
+   - 待翻譯（40 keys）vs 原始（6550 keys）：僅 0.6% 需翻譯
+   - 其餘 6510 keys 已有 zh_cn 譯文（快取）
+   - 確認：待翻譯的 40 keys 是否確實是新增/差異內容
+
+4. **[Medium] 擴展其他語系**
+   - 目前只支援 en_us + zh_cn
+   - 12 個語系（es_es, fr_fr, ja_jp, ko_kr...）未被抽取
+
+### 低優先度
+5. **[Low] Minecraft 格式碼處理文件化**
+   - 確認 `§` 和 `&` 格式碼在翻譯流程中如何被處理
+   - 建議在抽取環節即標記「需保留格式碼」
+
+---
+
+## 附錄：抽取工具位置
+
+| 檔案 | 說明 |
+|------|------|
+| `translation_tool/plugins/ftbquests/ftbquests_snbt_extractor.py` | FTB Quest 抽取器 |
+| `translation_tool/plugins/ftbquests/ftbquests_snbt_inject.py` | 翻譯注入器 |
+| `translation_tool/plugins/ftbquests/ftbquests_lmtranslator.py` | FTB Quest AI 翻譯 |