建立雅思學習工作室
為目前學習者建立一套完整、可用的學習網站。將任何現有的雅思網站僅視為行為參考。切勿複製其他學習者的 Google Drive 網址、文件、日期、主題、儲存點、最愛、錯誤或部署身份。
從學習者開始
僅收集缺失的決策，最多以三個問題為一組詢問：
- 詢問學習者的 Google Drive 資料夾網址，或是是否從本機上傳/手動貼上開始。
- 確認學習類別與啟用模式。預設為聽力、閱讀、口說、寫作、筆記、單字卡、中翻英測驗、最愛收藏以及錯誤筆記本。
- 確認儲存期望：預設為裝置本地持久儲存，或是在明確要求時啟用經過驗證的跨裝置持久儲存。
若請求已回答這些問題，則立即繼續。在產出可用的第一個畫面之前，無需要求提供範例文件。
在實作之前，請先閱讀 product-contract.md。在設定 Drive、持久儲存、分享或部署時，請閱讀 customization-and-privacy.md。最終驗證請使用 acceptance-tests.md。
建置工作流程
- 檢視工作區，保留其框架與設計慣例。當
.openai/hosting.json存在時，使用 Sites 建置與託管工作流程。 - 建立首次執行設定，儲存這位學習者的資料夾網址與偏好。不要將參考學習者的值硬編碼為預設值。
- 在修飾次要 UI 之前，先實作資料攝取管線：
- 列出學習者 Drive 資料夾中支援的檔案；
- 解析 DOCX 的黃色標記與追蹤修訂，無數量限制；
- 從 PDF 中擷取工作表詞彙；
- 當沒有標記或修正時，從一般文字中擷取有價值的語言；
- 為檔案建立指紋，使新增、編輯與刪除能乾淨地更新網站。
- 在每個擷取到的知識點進入筆記、單字卡或測驗之前，先進行標準化：
- 使用可重複使用的詞元或字典形式；
- 使用單數名詞，除非文法要求使用複數；
- 保留被動分詞，例如
be accompanied by； - 保留必需的動名詞，例如
prevent someone from doing something； - 保留相依介係詞與完整搭配詞組；
- 將包含多個可學習詞彙或搭配詞的句子拆分為獨立的知識點；
- 排除姓名、格式殘留物與低價值的修正。
- 為每個接受的知識點補充準確的中文釋義、用法、例句、發音、搭配詞、來源句子、日期、主題以及一個或多個雅思類別。當補充失敗時，絕不顯示佔位字串解釋；請重試或將該項目標記為待審查。
- 當相同表達出現在多個類別時，保留一個邏輯知識點，但在每個適用的類別中顯示它。
- 建立完整的學習循環：筆記本、學習卡、語音播放、最愛收藏、範圍測驗、提示、三次錯誤後揭示、持久錯誤筆記本以及每日/主題歸檔。
- 持久儲存學習者狀態。裝置本地儲存必須能在重新整理與瀏覽器關閉後存活。僅在使用者要求帳號式或跨裝置行為時，才使用伺服器持久儲存。
- 驗證 acceptance-tests.md 中的行為、成功建置，並以私密方式發佈，除非學習者明確選擇其他存取模式。
適應規則
- 允許學習者變更標籤、啟用類別、主題命名慣例、測驗範圍與視覺方向，同時不削弱擷取的正確性。
- 從檔案名稱與文件標題推斷日期、主題與類別。當推斷不明確時，提供可編輯的備案。
- 偏好安靜、專注於學習的介面，適合每日重複使用。保持控制項簡潔且反應迅速；不要將產品變成行銷登陸頁面。
- 當學習者尚未有 Drive 資料夾時，保持上傳與貼上文字功能完全可用，並將 Drive 連線設為可選的下一步。
- 誠實說明公開連結的限制。公開的 Drive 資料夾 MVP 不等同於私密的 OAuth 存取。
完成標準
完成時提供學習者獨立的網站網址，以及已啟用功能的簡潔摘要。明確說明任何無法整合的功能。不要暴露來源憑證、內部專案 ID、參考學習者資料或部署內部細節。