英語學習站

給高三統測考生的英文家教系統：考前倒數、閱讀測驗、單字卡、單字小考、學習紀錄，老師可登入查看學生練習狀況與錯題。純前端（HTML / CSS / JS），不需要伺服器，放上 GitHub Pages 即可使用，iPhone 可「加入主畫面」當 App 用。

功能

區塊	內容
首頁	最上面是學校動畫，接著每日一句、世界地圖與 20 個城市小卡（台北、東京、新加坡、雪梨、倫敦、紐約、多倫多、洛杉磯、首爾、曼谷、馬尼拉、孟買、杜拜、開羅、奈洛比、開普敦、羅馬、奧克蘭、里約熱內盧、墨西哥城；每張有城市插圖、旅遊實用句、對話、路標、單字和小測驗）、100 分鐘時間分配、我的書籤、最近測驗
使用導覽	第一次打開首頁時，畫面正中間會浮出一張半透明的大卡片「👋 初次使用本站嗎？」，可以「開始導覽」或「不用了」（按 Esc 或點卡片外面也算「不用了」）。導覽時畫面變暗，一步一步亮起重要的地方並附說明：左邊的 🎯 選程度、主選單、考試倒數、中文／English、登入、📈 紀錄（電腦上連同設定；手機上會告訴你設定在「更多」）；可按「下一步」「上一步」、鍵盤 ← → 或 Esc。最後一步還沒選程度的話可以直接「🎯 選程度」。之後在「更多」或「設定」都能按「🧭 使用導覽」再看一次
我的程度	畫面左邊的 🎯 小標籤點一下或往右拉，就會拉出選程度的抽屜：A2 入門、B1 基礎、B2 進階、C1 挑戰、C2 頂尖，B1 / B2 標示 ⭐ 統測生推薦，每級附說明，可先跳過（尚未選擇時，標籤旁會提示「請先選擇程度」）。選了之後，閱讀、選擇題、克漏字、翻譯、單字卡與單字小考都先出這個程度；每一頁仍可自己切換。隨時可從左邊 🎯 或「設定」更改，登入後跟著帳號同步；老師在「學生狀況」看得到學生選的程度
閱讀測驗	內建 508 篇：A2 入門 20、B1 127（含電子郵件 20）、B2 120（文章 100、電子郵件 20）、C1 挑戰 95（文章 80、電子郵件 15）、C2 頂尖 95（文章 80、電子郵件 15）、應用文（書信、公告、廣告、Email、時刻表）51；各程度中的電子郵件以 ✉️ 標示，也可用主題「Email」篩選；每篇 5 題、中文解析與逐段翻譯。文章上方標出程度、主題、字數與預估時間；先顯示英文，中文翻譯和「學習筆記」都要按了才展開。學習筆記（按需載入 reading-notes.js）有每段一句的段落重點、6–8 個關鍵字（文中的意思）與 1–2 句句子解析（同文法頁的 S／V／O／C 結構圖解）；按關鍵字旁的 ☆ 會把這個字連同它所在的句子存進書籤，單字卡背面和單字庫會顯示「出自〈文章〉」和原句。老師自己新增的文章沒有整理好的筆記，會改列依 7000 單字表自動標出的字並註明。文章目錄可依程度、主題、狀態篩選，練習過的會打綠色勾勾；老師也可自行出題
選擇題・克漏字	字彙、文法、情境對話 540 題（A2 40、B1 167、B2 133、C1 100、C2 100），克漏字 75 篇（A2 5、B1 25、B2 15、C1 15、C2 15）是「練習」裡自己的分類（#/cloze）。設定卡：一行小統計（已作答、正確率、待加強），再選題型、程度、題數與模式：「學習」每題答完立刻回饋，「測驗」計時、不顯示對錯，交卷後統一看每一題的解析。回饋寫出正確答案、考點（文法題連到對應章節）、為什麼選這個，以及其他每個選項錯在哪裡；這些說明是依各題原本的中文解析逐題整理（practice-notes.js），並由第二位審查者逐題核對，審查時發現 9 題原解析說得太絕對，已一併修正
翻譯練習	中譯英 375 題（A2 25、B1 118、B2 82、C1 75、C2 75），每頁 20 題；先自己寫，再看參考答案、其他正確寫法與文法重點（連到對應章節）。網站不會自動批改翻譯：關鍵字只做字面比對（標示「已使用／未使用」，不打 ✗，換個說法也可能是對的），再照「自行檢查」四點（意思、時態與主詞動詞一致、關鍵句型、拼字標點）自己標對或錯。和選擇題一樣的設定卡：主題（下拉選單）、程度兩列，再按「開始練習」
錯題本	「紀錄 → 錯題本」（#/wrong）：選擇題、克漏字、翻譯（自己標錯的）、文法題（章末小測驗、綜合測驗）和閱讀測驗中，最近一次答錯的題目都會列出來源、考點、錯幾次／作答幾次與日期；再答對就自動離開。可依來源篩選、一起重做（選擇題、翻譯、文法一次最多 20 題，克漏字依整篇重做，閱讀回到整篇文章），或「回到教材」（文法章節、文章、字彙題可查單字庫）。閱讀題的題型（主旨、細節、推論、字義…）是依題目文字自動判斷。首頁「待複習」會顯示錯題數
每日新聞	CNN、BBC、NPR、The Guardian、Taipei Times 的英文新聞頭條，每天早上由 GitHub Actions 自動更新，標題中 7000 單字 Level 3 以上的字會標示中文；每則新聞都整篇改寫成學習用文章，附逐段中文翻譯與單字、片語、文法（📖 全文＋翻譯，可用 Gemini 免費額度）；其他新聞可點「📘 學習」看裡面的單字、片語與文法；附 CNN 10 等學生新聞網站
內建字庫	大考中心 7000 單字（Level 1–7，標示 CEFR A1–B2）共 7,213 字、挑戰單字 C1 443 字、頂尖單字 C2 336 字，加上 3,251 個片語（A1 134、A2 459、B1 916、B2 1,572、C1 85、C2 85）；每筆都有中文、同義字與例句
單字卡	翻卡練習、「記得 / 不記得」、自動安排複習（間隔 0 / 1 / 3 / 7 天）、發音、背面顯示同義字（存單字時記下的原句優先）；每個字只有三種狀態：未學、待複習（今天到期會註明）、已熟悉，直接由原本的複習紀錄判斷，不另存一份；設定只有單元和每輪張數：先複習今天該再看一次的字（不會被單元篩掉），再學單元裡的新字（已選程度的學生，單元預設就是自己的程度）
單字小考	看英選中、看中選英、拼字測驗
單字庫	搜尋（含同義字）、依單元篩選（程度、片語、統測高頻、老師自訂）、只看書籤、每頁 50 筆；狀態欄寫未學／待複習／已熟悉；老師可新增、編輯、批次貼上，也可修改或隱藏內建字
片語	3,251 個片語（A1–C2）分 10 類，每一類由簡單到難排（A1 → A2 → B1／B2 → C1 → C2），每張卡片有中文、例句（片語本身畫底線）、同義說法、🔊 發音與 ☆ 書籤；上方一張篩選卡：搜尋、類別與程度下拉選單、只看書籤、「第 1–24 個，共 n 個 · 已熟練」，以及針對目前類別的「單字卡」「小測驗」按鈕
字根字首字尾	獨立頁面 roots.html（從「學習 → 單字」的小分頁進入），外觀和網站一樣，也沿用網站上選的主題、字體與男聲／女聲。66 個字首、152 個字根、70 個字尾，每個都有中文意思、來源（拉丁文、希臘文或古英文）、記憶小撇步、📖 詳細說明（用法、拼法變化、字義引申，書面語）、⚠️ 注意（容易混淆之處，例如 uncle、under 的 un 不是字首）、🔗 相關的字首字根字尾（意思相反、相近或容易混淆，點了跳到那張卡），以及多數 8 個例字（共 2,216 個；常用而拆得清楚的字不足時少於 8 個，不硬湊）。每個例字都有一句英文例句與中文翻譯，例字以粗體標出，旁邊 🔊 可聽整句。例字用顏色拆開（字首紅、字根藍、字尾綠、原本就是單字的部分用虛線框），每一塊下面寫中文意思，再加「字面意思」、真正的中文、程度（A1–C2）與統測高頻標記，點 🔊 聽發音。可以搜尋字首字根字尾、例字或中文，也可以依分類篩選：「分類」是一格一格的方塊（emoji、名稱、個數與前幾個例子，例如「🚫 否定・相反 10 個・un- in- dis-」），清單裡每一類前面有彩色標題列與一句說明，卡片上緣是字首紅、字根藍、字尾綠；分頁下方「📘 認識字首／字根／字尾」（含拆字方法三步驟）預設收合成一行；卡片每頁 6 張，上下都有換頁（手機是「‹ 第 n 頁 ›」），「📋 目錄」列出目前所有的字首字根字尾，點一下就跳到那一張。網站切到 English（或按這一頁上方的「中文／EN」）時整頁變成英文：介面、分類、每張卡的意思、字源、記憶提示、詳細說明、注意、相關、例字的英文意思、字面意思、拆字小字與拼字說明都是英文，例句只顯示英文句子（英文內容另存在 roots-en.js，只有英文模式才載入）。「🎯 拆字測驗」一次 10 題，可選全部／字首／字根／字尾，題型有「這個字首是什麼意思」「哪一個字根表示『看』」「用拆開的部分猜整個單字」，選項之間不會有意思相同的；每個範圍會記住最佳成績
文法	「學習 → 文法」（電腦上方有自己的分頁；網址 #/grammar、某一章 #/grammar/g-passive、綜合測驗 #/grammar/quiz）：26 章依單元排列（句子基礎、時態、助動詞與語態、不定詞動名詞與分詞、形容詞副詞與比較、連接詞與子句、假設與特殊句型），可依程度篩選或搜尋。每章開頭列出學習目標、先備章節（可點）和難度；每一節依序是核心規則（進階補充摺疊起來，要看再打開）→ 結構圖解（公式＋一句拆成 S 主詞／V 動詞／O 受詞／C 補語，固定顏色且一定寫出文字標籤，修飾語與連接詞是灰色）→ 中英例句（🔊）→ 常見錯誤 → 1–2 題小練習（答完立刻看解析）；章末有統測重點和 8 題小測驗（6 題以上算完成）。第二版內容經過逐句審查：規則都寫清楚適用範圍（例如第三人稱單數加 -s 只限現在簡單式肯定句的一般動詞；介系詞片語在判斷主詞單複數時不算，但它也可能是不能拿掉的補語），小練習和小測驗由不看答案的解題者驗證、結構圖解由不看答案的分析者驗證；無法確認的地方（例如美式與英式用法、統測是否接受某種說法）直接標「待審」，不寫成定論。文法題答錯會進錯題本，章節成績會跟著帳號同步。選擇題的文法題、每日新聞的文法重點都會連到對應章節
時間觀念	首頁「100 分鐘怎麼用」時間分配條（字彙 8、對話 8、綜合 14、閱讀 40、非選 15、檢查 10、緩衝 5 分）與答題小抄；按「📖 看完整說明」在網站裡打開題型分析與時間分配（試卷結構、配分、近年趨勢、各段小撇步、四個不失分的習慣），右上角 ✕、底下「關閉」、Esc 或返回手勢都能關掉，裡面也能下載 PDF 版；閱讀測驗交卷後顯示「你花了幾分鐘、考試節奏約每篇 10 分鐘」
每日一句	首頁每天換一句英文勵志句（附中文、重點單字、發音），600 多句，考前不重複
書籤	文章與單字都能加入書籤 🔖，首頁「我的書籤」集中顯示，也能在那裡直接用單字卡練書籤單字；老師也看得到學生收藏了什麼
學習紀錄	最上面寫出紀錄存在哪裡：只在這台裝置、本機帳號、已同步到雲端（附時間）、同步中、離線，或「同步失敗：紀錄仍完整保存於本裝置」並附「重試」。接著「學習概況」表格分開列出閱讀、文法、單字、選擇題、克漏字、翻譯的已瀏覽／已練習／已掌握與總數（定義寫在表格下方），「各考點正確率」（字彙、片語搭配、文法、轉折連接、情境對話、閱讀各題型、翻譯，以及正確率最低的文法章節），「錯題分布」（各來源錯題數，連到錯題本）和「待複習」。下面保留熟練度、連續學習天數、12 週活動圖、測驗歷史、一鍵傳送紀錄給老師：PDF 報告包含連續天數、閱讀測驗與錯題、單字卡與單字小考、選擇題、翻譯練習（畫出來是空白時會先重試，仍失敗就提示，不會給出空白的 PDF）；產生 PDF 報告後，雲端模式登入的學生可以填「老師的 Email」「個人 Email」和想說的話，按「📨 直接寄出」就由網站寄出（PDF 自動附上，老師按回覆會回到學生的信箱；要先完成下面的「直接寄給老師」設定）；也可以用分享、寄信程式或下載的方式自己寄
學生狀況（老師）	閱讀錯題分析（學生選了什麼、正解是什麼）、不熟悉單字排行、拼錯的字、活動時間軸
設定	我的程度、🔊 發音聲音、考試日期、匯出 / 匯入 JSON；學生另有學生姓名、老師的 Email；老師的設定頁不出現學生用的欄位，改成考試名稱、「學生報告收件 Email」（可按「使用登入 Email」一鍵填入，按「儲存」後學生寄報告時就會先填好）與老師邀請碼
發音聲音	🔊 朗讀只唸英文（句子裡的中文會跳過，不會用英文聲音唸中文）。在「設定」可選男聲／女聲、指定這台裝置上的某個英文聲音（自動時依男聲／女聲挑選），以及速度（慢 0.75、標準 0.9、正常 1.0）；音調維持自然（1.0）。正在朗讀時畫面下方會出現「■ 停止朗讀」，任何時候都能停；再按另一個 🔊 會先停掉前一個，不會重疊；換頁、切到別的分頁或 App 也會自動停止。瀏覽器不會告訴網頁哪個聲音是男是女，所以依常見的聲音名稱挑；這台裝置沒有合適的聲音時，設定頁會照實說明（Android 由手機的文字轉語音設定決定）。某個聲音 4 秒內沒出聲就自動換下一個，都不行才顯示提示。iPhone／iPad 靜音模式下會讓網頁像播影片一樣出聲，並提醒怎麼關靜音。新增的閱讀逐段朗讀目前只開放 3 篇樣本（a14–a16，文章上方標「試用」），確認效果後再加到其他文章。選擇只存在這台裝置

頁面分成五個入口：首頁 · 學習（閱讀：閱讀測驗、每日新聞；單字：單字卡、單字庫、片語、字根字首；文法）· 練習（選擇題、克漏字、翻譯）· 紀錄（學習紀錄；老師還有學生狀況，老師按「紀錄」會先打開學生狀況）· 更多／設定。手機下方是這五個按鈕；在「學習」「練習」裡，最上面一排是三個分類（閱讀 · 單字 · 文法／選擇題 · 克漏字 · 翻譯），下面是這個分類的小分頁。電腦上方的分頁直接列出這些分類（「學習」「練習」兩組各三個），最右邊是「設定」。每一頁都有自己的網址（例如 #/translate、克漏字是 #/cloze），iPhone 往回滑可以回到上一頁。練習時（選擇題、克漏字、翻譯、單字卡、閱讀）手機會進入專心模式，按「✕ 結束」會先確認；做到一半去別的分類，原本那一區會亮一個小點，回去就能接著做。

手機的「更多」只放設定，不放學習內容：設定與帳號（設定、使用導覽、登入／帳號）和 外觀（語言、字體、發音、主題顏色）。學習內容只在「學習」「練習」和它們的分類與小分頁。

單字卡、單字小考和單字庫的「單元」下拉選單都一樣：全部（單字＋片語）；依程度 A1 起步、A2 入門、B1 基礎、B2 進階、C1 挑戰、C2 頂尖（A1–B2 附 7000 單字的 Level，每個都附字數）；其他：片語、統測高頻 3000 字（選了會多一個下拉選單，可以選全部或第 1–30 組，每組 100 字，最常考的在前面）；✏️ 老師自訂（全部，以及老師取名的每個單元）。從片語頁選了一個類別再按「🃏 單字卡」或「📝 小測驗」過來時，單元選單會多一組「片語（依類型）」顯示那一類。

預設介面為 中文，可切換 English（電腦在右上角的選單，手機在最上面標題列的語言下拉選單（中文／EN），「更多」裡也有）；也可切換手寫風 / 標準字體與六種配色主題。標題列會一直顯示今天日期、現在時間與考試剩餘天數，點一下會打開可愛的日曆，選一天就能更改考試日期；首頁有積木凸點風格的世界地圖（藍色海洋、綠色陸地、土色沙漠）。

帳號與權限

• 右上角「登入 / 註冊」。身分分為 學生 與 老師。
• 註冊老師帳號需要 老師邀請碼。本機模式預設為 teacher2028，老師登入後可在「設定」更改；雲端模式的第一個老師用 SQL 升級（見下方），邀請碼由老師自己設定。
• 只有老師登入後才看得到「學生狀況」分頁與編輯功能（新增文章、單字），也只有老師能改考試名稱；考試日期學生可以自己改。
• 老師權限由伺服器決定（雲端模式）：身分存在 Supabase 的 profiles.role，只有資料庫觸發器（比對邀請碼）或管理者能設成老師；能不能讀全班紀錄、改班級教材，由資料庫的 RLS 權限規則把關，前端無法繞過。網頁這一側也不再只看存在裝置上的身分：每次開啟都要等伺服器確認是老師，才會顯示學生狀況與老師工具（離線時會顯示「正在向伺服器確認老師身分」）；切回頁面時每 5 分鐘重新確認一次，被調整身分不必重新整理；老師專用的按鈕不再只是用 CSS 藏起來，學生的畫面根本不會產生，對應的動作也會先檢查身分；匯入檔案不能替學生加入老師帳號或改邀請碼。
• 本機模式（沒有設定 Supabase 時）沒有伺服器，所有身分只存在這台裝置，無法真正防止竄改，只適合自己一台裝置使用；正式站使用雲端模式。
• 學生不登入也能練習，但建議登入，紀錄才會對應到名字。

兩種使用模式

1. 本機模式（預設，不用任何設定）

帳號、教材、紀錄都存在該裝置的瀏覽器。

• 老師在自己的裝置出題後，到「設定 → 只匯出教材」，把 JSON 檔傳給學生，學生用「匯入 JSON」即可更新教材。
• 學生在「學習紀錄 → 傳送學習紀錄給老師」，iPhone 會直接開分享選單（LINE / Email）。老師在「學生狀況 → 匯入學生傳來的紀錄」查看。

2. 雲端模式（選配，Supabase 免費方案）

設定 Supabase 後，老師與學生各自註冊，學生的練習紀錄會自動同步，老師在任何裝置登入都能看到所有學生；老師改教材，學生登入後就是最新版。

1. 到 https://supabase.com 註冊，按 New project 建立專案（Region 選 Northeast Asia (Tokyo)，資料庫密碼自己保管好）。

2. 左側 SQL Editor → New query，把 supabase/schema.sql 整份貼上，按 Run。看到 Success 就好（重複執行也安全）。

3. Authentication → Sign In / Providers → Email，二選一：

   • 保留 Confirm email（較安全）：學生註冊後要先到信箱點確認連結，再回網站登入。Supabase 內建的寄信服務每小時只能寄幾封，全班同時註冊可能要分批。
   • 關掉 Confirm email（較方便）：註冊完馬上能用，但系統不會確認 email 是不是本人的，任何人都可以用別人的 email 註冊。老師要在「學生狀況」確認每個帳號都是自己的學生。
   • 不論哪一種，全班都註冊好之後，建議把同一頁的 Allow new users to sign up 關掉，陌生人就不能再註冊；有新學生時再暫時打開。

4. Authentication → URL Configuration：Site URL 填你的網址（例如 https://funenglishlearning.com），Redirect URLs 加上 https://funenglishlearning.com/** 和 https://www.funenglishlearning.com/**。

5. 按上方 Connect（或 Project Settings → API Keys），複製：

   • Project URL（https://xxxx.supabase.co）
   • Publishable key（sb_publishable_ 開頭），或舊版的 anon public key

6. 打開 supabase-config.js，把 window.SUPABASE_CONFIG = null; 換成：

   window.SUPABASE_CONFIG = {
     url: "https://xxxx.supabase.co",
     anonKey: "sb_publishable_xxxx"
   };
   

   這兩個值本來就是公開的（網頁一定看得到），資料安全靠第 2 步的規則保護。絕對不要把 service_role / secret key 放進網站或傳給任何人。

7. 部署後，在網站上用你的 email 註冊（身分選學生即可）。再回 SQL Editor 執行這一行，把你自己升級成老師：

   update public.profiles set role = 'teacher'
   where id = (select id from auth.users where email = lower('你的[email protected]'))
   returning email, role;
   

   下方結果出現一列、role 是 teacher 才算成功（沒有任何一列表示 email 打錯，或還沒註冊 / 還沒確認 email）。登出再登入後就是老師。

   之後若有其他老師，到「設定」設定老師邀請碼（至少 8 個字，建議 10 個字以上、不要用好猜的字），他們註冊時選「老師」並填這個碼即可。用完把邀請碼清空，就沒有人能再註冊成老師。有人連續猜錯 20 次，邀請碼會自動作廢，重設一個新的就好。

雲端模式的安全規則（都在資料庫裡執行，網頁改不了）：

• 學生只能讀寫自己的紀錄，看不到其他學生。
• 老師看得到所有學生的紀錄，但不能改學生的紀錄；只有老師帳號能改共用教材。
• 同一台電腦換人登入時，前一個人的紀錄不會跑到下一個人的帳號；登出時還沒上傳的練習，會在本人下次登入時補上傳。
• 身分（學生 / 老師）由資料庫決定；邀請碼存在資料庫的 private 區，任何人都讀不到。
• 學生把名字取成奇怪的程式碼也沒用：老師頁面一律當文字顯示。

免費專案若連續 7 天沒有人使用會自動暫停（寒暑假可能發生），到 Supabase 後台按 Restore 即可恢復。暫停超過 90 天就不能一鍵恢復，放長假前後記得登入看看。 想把某位學生改成老師、刪除帳號：Supabase 後台 Table Editor → profiles 改 role，或 Authentication → Users 刪除（紀錄會一起刪除）。

選配：讓學生「直接寄給老師」（Resend 寄信服務）

網頁本身不能寄信，所以「📨 直接寄出」是由 Supabase 上的一個小程式（Edge Function send-report）透過 Resend 寄出。沒設定之前，學生按下去會看到「老師還沒開啟直接寄信」，其他寄送方式照常可用。

1. Resend 註冊（免費方案每天 100 封、每月 3,000 封）。登入後 Domains → Add Domain，填 funenglishlearning.com。
2. 畫面會列出幾筆 DNS 記錄（MX、TXT）。到你買網域的地方（網域在 Vercel 買的就到 Vercel → Domains → DNS Records）照抄加上，回到 Resend 按 Verify，等狀態變成 Verified（通常幾分鐘到幾小時）。
3. Resend → API Keys → Create API Key（權限選 Sending access），複製金鑰（re_ 開頭，只會顯示一次）。金鑰請自己保管，不要貼到聊天或程式碼裡。
4. Supabase 後台 → SQL Editor：把最新的 supabase/schema.sql 整份再執行一次（會新增寄信紀錄表 mail_log，舊資料不會動）。
5. Supabase 後台 → Edge Functions → 建立新的 Function，名稱填 send-report，把 supabase/functions/send-report/index.ts 整份貼到網頁編輯器裡，按 Deploy。保持預設的「Verify JWT」開啟。（會用 Supabase CLI 的話：supabase functions deploy send-report。）
6. Edge Functions → Secrets，新增兩筆：
   • RESEND_API_KEY：第 3 步的金鑰
   • MAIL_FROM：寄件人，例如 英語學習站 <[email protected]>（@ 後面要是第 2 步驗證過的網域）
7. 測試：用學生帳號登入 → 學習紀錄 → 傳送學習紀錄給老師 → 填老師的 Email（要是本站的老師帳號的 email）→ 📨 直接寄出。

防止被拿去亂寄信的規則（都在伺服器上執行）：只有登入且 email 已確認的帳號能寄；收件人一定要是本站的老師帳號；每個學生 24 小時內最多 5 封、全站最多 90 封；附件只能是 6 MB 以內的 PDF。老師收到的信裡有學生的名字、帳號 email、想說的話和學習摘要，按「回覆」就會寄到學生填的 email。

部署到 GitHub Pages

1. GitHub 專案 → Settings → Pages。
2. Source 選 Deploy from a branch，Branch 選你的分支、資料夾 / (root)，儲存。
3. 幾分鐘後網址會是 https://<帳號>.github.io/<repo>/。

iPhone 加到主畫面

用 Safari 打開網址 → 分享按鈕 → 加入主畫面。之後會以全螢幕 App 的方式開啟，並支援離線使用：離線時畫面最上面會寫「目前離線」，已下載的內容照常可用，練習紀錄先存在這台裝置、連線後自動上傳。網站更新時，新版本會整包下載到新的快取（只更新 Cache Storage，不會動到存在裝置上的練習紀錄），舊快取隨即刪除；離線時只會從目前版本的快取讀檔，不會新舊混用。已開著的頁面會出現「網站已更新，重新整理後即可使用新版本」和「重新整理」按鈕（還有沒做完的練習時會先問）。

老師如何出題

1. 用老師帳號登入。

2. 閱讀測驗 → ＋ 新增文章：填標題、文章、題目（四個選項、勾選正解、解析）。

3. 單字庫 → ＋ 新增單字 或 批次貼上，每行一個：

   adventure, n., 冒險, Life is an adventure.
   brave | adj. | 勇敢的
   

4. 本機模式記得「設定 → 只匯出教材」傳給學生；雲端模式會自動同步。

檔案說明

檔案	用途
index.html / style.css / app.js	主程式
data.js	預設教材（3 篇文章、50 個範例單字），可隨時在網站內修改
library.js	內建 7000 單字＋片語字庫（唯讀，約 1.3 MB；老師的修改存在自己的資料裡）
worldmap.js	首頁世界地圖點陣資料
daily.js	每日一句（610 句）
docs/tve-english-exam-guide.pdf	統測英文題型分析與時間分配（首頁「看完整說明」視窗裡可下載）
i18n.js	中 / 英介面文字
speech.js	🔊 朗讀（選聲音、iPhone 靜音模式、沒出聲時換聲音），主程式和字根頁共用
roots.html / roots.css / roots.js / roots-data.js / roots-en.js	字根字首字尾頁面與它的資料（roots-en.js 是英文模式用的英文內容）
grammar.css / grammar-data.js	文法分頁的樣式與 26 章的內容（grammar.html 只把舊網址轉到 #/grammar）
supabase-config.js	雲端模式設定（預設關閉）
supabase/schema.sql	雲端模式的資料表與安全規則（貼到 Supabase SQL Editor 執行）
supabase/functions/send-report/index.ts	「📨 直接寄給老師」的寄信程式（Supabase Edge Function，透過 Resend 寄出）
vendor/	內附的第三方程式（Supabase、html2pdf，MIT 授權，授權檔在同資料夾）
manifest.json / sw.js / icons/	PWA（加入主畫面、離線）

考試日期

預設為 2028/04/24（117 學年度）。日期可以在「設定」隨時修改，請以技專校院入學測驗中心公告為準。雲端模式下學生會跟著老師設定的日期；學生自己改過日期後，這台裝置就保留學生的日期（改回和老師一樣的日期，就會再跟著老師）。

字庫來源

• 7000 單字清單與中文釋義：整理自大考中心高中英文參考詞彙表（社群整理版 QuantumSamuel/GSAT-vocab 的 data/words.json）。
• A1／A2 片語：原本標成 B1 的基本片語（get up、look at、in front of…）由兩位 AI 審查分別依英國劍橋 EVP 程度表與國中課本／會考範圍判斷，兩位都同意（或第三位裁定）才改成 A1／A2；缺少的基本片語（a lot of、next to、excuse me…）由 AI 撰寫，再經另一位 AI 逐筆挑錯、查重複；最後一輪由獨立審查找問題、第二位確認後才修改（22 處）。
• 同義字、例句與片語：由 AI 依 B1–B2 程度產生，已自動檢查每筆都有同義字與例句，但未經人工逐筆校對；若發現錯誤，老師登入後可直接在單字庫修改。
• 字根字首字尾：由 AI 撰寫，每一組再由另一位 AI 審查員逐條檢查字源（避免「民間字源」）、拆法、中文與詞性並修正；例字多選自 7000 單字，程度與統測高頻標記取自網站字庫。未經人工逐筆校對，若發現錯誤請告訴網站管理者。
• 世界地圖：Natural Earth 國界（公眾領域）轉成點陣。
• 每日一句：由 AI 撰寫並逐批校對（文法、中譯、去重複）；標註人名的 27 句已人工核對出處，其餘為原創句或常見諺語。

每日新聞怎麼更新

• .github/workflows/news.yml 每天台灣時間早上 5:41 執行 scripts/fetch_news.py，抓取各家 RSS 頭條，寫入 news.json 並自動 commit。
• 只保存標題、連結、日期與 RSS 提供的短摘要，點進去會到原新聞網站閱讀。
• 會過濾掉以暴力、犯罪為主的標題，讓內容適合高中生。
• 第一次也可以到 GitHub 的 Actions → Daily English news → Run workflow 手動執行。
• 排程只在預設分支執行；本 repo 目前的預設分支就是網站所在的分支。

全文＋翻譯（AI 改寫，免費）

• 同一個排程接著執行 scripts/make_lessons.py，替每一則還沒有文章的新聞：
  1. 讀取原文網頁（scripts/article_text.py）當作事實來源；
  2. 請 AI 把整則新聞從頭到尾改寫成 250–400 字、B1–B2 程度的英文文章，每一段附台灣用語的中文翻譯，並整理單字、片語、文法重點。
• 免費做法：Google Gemini 免費額度
  1. 到 https://aistudio.google.com/apikey 用 Google 帳號登入，按 Create API key（免費，不用信用卡）。
  2. 到 GitHub repo 的 Settings → Secrets and variables → Actions → New repository secret，Name 填 GEMINI_API_KEY，貼上 key。
  3. 到 Actions → Daily English news → Run workflow 執行一次。
  • Google 對免費 key 有每日次數上限（約每天數十到數百次，依帳號而定），用完就停，隔天自動接著寫。
  • 免費方案下，Google 可能用送出的內容改善模型；這裡送出的只有公開新聞內容。
• 選用（付費）：若加上 ANTHROPIC_API_KEY，就改用 Claude 撰寫（預設每天 6 篇，LESSONS_MAX、LESSON_MODEL 可調整）。
• 已寫好的文章會保留到那則新聞離開列表為止，所以每天只需要替新的新聞寫文章。
• 為了尊重著作權，網站不轉貼原文：文章用自己的話重寫，程式會檢查不能連續照抄原文 12 個字以上，每篇都附原文連結；原文內容不會存進 news.json。
• 程式也會檢查字數、每段都有中文翻譯、單字／片語／文法例句都真的出現在文章裡；不合格的就跳過。
• 每則沒有全文的新聞也有「🌐 整篇中文翻譯」按鈕，會用 Google 翻譯開啟原文的中文版本（不用任何設定）。
• 註：GitHub Models 已於 2026/7/30 停止服務，所以不使用。