失敗（文件翻譯）

「失敗」分頁僅用於文件翻譯。它會讀取當某個區段無法成功翻譯成某個地區設定時寫入 SQLite 的失敗記錄，例如模型輸出為空或無效、翻譯後驗證錯誤（AST mismatch、佔位符洩漏和類似的品質檢查），或阻礙進度的嚴重情況。

它能幫助您回答：哪個來源區段出錯了？針對哪個地區設定和模型？記錄了什麼錯誤訊息？

何時使用

• 在 translate-docs 或 sync 完成時出現錯誤、部分地區設定或令人困惑的日誌時，可以排序和篩選失敗，而不是單獨滾動終端機輸出。
• 當您想要優先處理返工時：按「# 失敗」排序，以便在重試中重複失敗的區段會首先出現；這些是簡化或重新格式化來源 Markdown 的有力候選者。
• 當您需要確切的區段時——檔案路徑、行提示、來源雜湊和完整的來源文字——以便在您的儲存庫中編輯正確的段落。

為什麼來源編輯很重要

密集的內聯標記（粗體與`code`混合、巢狀強調、帶有許多跨度的長句）使得模型更難返回仍能通過結構檢查的翻譯。具有多個記錄失敗的區段通常透過重寫或拆分來源（或將範例移至圍欄程式碼區塊）比在未更改的文字上重新執行翻譯更能改善。這與複雜的 Markdown 和失敗的品質檢查一致。

如何使用此分頁

1. 在儀表板中開啟「失敗」。
2. 閱讀摘要條：包含任何失敗的區段，以及具有1、2或3+ 失敗記錄的區段計數。
3. 按部分檔案名稱、地區設定、模型、品質錯誤（值來自您的快取）、僅嚴重，以及可選的來源雜湊、來源文字或錯誤訊息子字串進行篩選，然後點擊「套用」。
4. 選擇「排序：# 失敗」（預設）或「排序：檔案路徑 + 行號。
5. 使用表格頂部或底部的分頁。點擊一行以展開完整的來源文字。「模型」欄顯示失敗模型，如果可用，還會顯示來自稍後成功快取條目的模型。
6. 🔗 連結控制項會將檔案/行提示記錄到正在執行 ai-i18n-tools dashboard 的終端機。
7. 修正您專案中的來源檔案，然後再次執行 translate-docs 或 sync。如果成功執行後列表看起來過時，請執行 ai-i18n-tools sync --force-update 並重新載入儀表板。

為了在 UI 旁邊進行基於檔案的偵錯，請在重試期間使用 translate-docs --debug-failed 將 FAILED-TRANSLATION 詳細資訊寫入 cacheDir 下方——請參閱快取行為和 translate-docs 旗標。

失敗與 Markdown 問題

	失敗	Markdown 問題
記錄時間	翻譯期間（每個地區設定）	翻譯之前（來源掃描）
典型原因	錯誤的模型輸出、驗證錯誤	不成對的強調、未閉合的程式碼跨度、連結外部的粗體
修正	編輯來源並重新翻譯	修正來源 Markdown，然後重新翻譯

請參閱Markdown 問題以了解翻譯前的靜態檢查。