ESP詞彙複習｜處理規則

⭐ 目前最高優先主任務｜5,000+ 詞彙 sub page 強化

這是目前 ESP 詞彙工作的主要任務與最高優先規格。 後續若開啟新對話、新批次或切換到其他主題，只要工作仍屬於西班牙語詞彙頁強化，就必須先依本節執行。若本節與後方較早期規則出現衝突，以本節為準。

A. 任務目標

• 目標是逐步處理約 5,000+ 個詞彙 sub page，涵蓋各級別、各主題的 Vocabulario｜詞彙 與 Más vocabulario｜更多詞彙。
• 每次工作前，必須先確認當前 Vocabulario｜詞彙／Más vocabulario｜更多詞彙 的所有詞彙 sub page 是否已按完整西班牙語 A–Z 排列。若來源是兩個或多個各自 A–Z 的詞表串接，必須先把全部既有 sub page 重新合併排序成單一 A–Z；只移動既有 child-page blocks，不重建、不刪除、不修改已完成頁內容。完成排序後，從排序後第一個尚未完成的詞彙開始連續往後處理；除非使用者要求重做，否則跳過已完成頁。每批開始前必須檢查起點之前是否仍有漏頁；若有，先回補漏頁，再往後。
• 單元處理順序為強制規則，必須依序交替完成：01 Vocabulario｜詞彙 → 01 Más vocabulario｜更多詞彙 → 02 Vocabulario｜詞彙 → 02 Más vocabulario｜更多詞彙 → 03 Vocabulario｜詞彙 → 03 Más vocabulario｜更多詞彙……。每一單元必須先完整處理 Vocabulario，再完整處理同單元的 Más vocabulario；兩區都完成並抽查無漏頁後，才能進入下一單元。不得先把所有 Vocabulario 做完，再回頭做 Más vocabulario。
• 結構辨識規則：每個主題底下的 Vocabulario｜詞彙 與 Más vocabulario｜更多詞彙 是兩個獨立子頁。必須實際 fetch 主題頁，依其子頁連結分別進入處理；不得把 Vocabulario 頁尾出現的附加詞或其他區塊誤認成該主題的 Más vocabulario。
• 使用者只說 「Ok」 時，代表「依目前規則直接繼續上一個批次工作」，不需再次確認。
• **目前 B1 工作範圍只做到 B1_14 完成為止。**B1_14 全部完成後停止，不自動接續 B1_01 → B1_12；只有使用者之後明確要求時才開始其他 B1 單元。
• 採可驗證的小批次處理；目前固定 20 個詞為一批。20 個一起定位、讀取、判級與規劃，但實際寫入逐頁執行；不得為追求速度而犧牲 CEFR 等級、干擾詞品質或 Toggle 結構。

A1. 高效率執行流程｜優先遵守

以下為目前實測最穩定、最快的標準流程。

1. 固定 20 個一批
   • 一次定位下一批 20 個詞與 page ID；已完成頁跳過。
   • 當前頁不足 20 個時，先接同單元下一詞彙頁（優先 Más vocabulario｜更多詞彙），不足再接下一單元；各詞彙頁都先確認完整 A–Z，並依排序後順序補滿 20 個。
2. 讀取與判級
   • 原頁分 4 組 × 5 頁讀取，只確認原詞義／詞性、原例句、原翻譯、完成狀態。
   • A1/2 單元整批只查 1 次 A1：同形同義查得到＝A1；查不到＝A2；不逐詞再查 A2。
3. 一次生成完整內容
   • 每頁固定：Nivel + 2 個新例句 + 4 題 + 4 個獨立 Toggle。
   • 題型固定 2 題目標詞正解 + 2 題其他詞正解且目標詞作干擾項。
   • 干擾詞優先用已驗證同級／更低級詞，不逐題重查。
   • **學生可見的題幹與 A/B/C/D 選項必須使用西班牙文，不使用中文提示，不出「中文詞義 → 找西班牙文翻譯」題。**優先使用：西班牙文情境填空、簡短西語定義、搭配、詞形／陰陽性／複數、同類詞辨識。中文只放在 Toggle 展開後的 中文翻譯 與必要的選項解析中。
   • Toggle 內的 完整句 必須是自然的完整西班牙文句子，不能以「La palabra española para «中文» es…」代替情境句。
4. 寫入｜20 個一起規劃，但逐頁寫
   • 原頁已有詞義／詞性／原例句／翻譯時，不重寫整頁；每頁各自用 1 次 insert_content + position:end，一次補完 Nivel、2 新例句、4 題、4 Toggle。
   • **不要再把 2–5 頁綁在同一個寫入呼叫裡。**逐頁執行並用 try/catch：某頁被攔就跳過，其他頁繼續。
   • 只有缺基本欄位時才補頁首；只有需要整頁重建時才用 replace_content。
5. 被攔頁 fallback
   • 原例句保持原地，不重新送入更新。
   • 先把題目降成中性的西語定義／西語情境／詞性／詞形／拼字／固定搭配辨識；敏感醫療詞與容易觸發的購物／交易詞也適用。即使是 fallback，也不得改成中文詞義 → 西班牙文翻譯題。
   • 若完整頁尾 append 仍被攔，可用最多 2-step insert：先補 Nivel＋2 例句，再補完整練習區。
   • 若仍被攔，先標記待修，完成其餘 19 頁後再單獨重試；禁止在原地無限試錯。
6. 修復原則
   • 禁止逐項補 Nivel、逐題補 Toggle、逐個修 <summary>／</details>。
   • Toggle 結構壞掉時，直接一次重寫整個 ## 詞彙練習 區塊。
7. 20 頁最後只驗證一次
   • 每頁必須有：1 Nivel、2 新例句、4 個最外層題目、4 個獨立 <details>、4 個精確「查看答案、翻譯與選項解析」；0 Desplegable、0 escaped HTML、0 巢狀 Toggle。
   • 額外驗證：回修舊頁時只需掃描 4 個題幹（**1.～**4.）是否出現中文字符；A/B/C/D 選項依生成規則本來就應為西班牙文，不必為找中文題幹額外逐項掃描。中文可保留在 Toggle 展開後的 中文翻譯 與解析中。若題幹是「中文提示 → 找西班牙文」的翻譯式題型，即使結構正確也視為失敗頁，必須回修成西班牙文情境／定義／搭配／詞形題。
   • 只修失敗頁；通過頁不再重讀或重寫。