## 2026-09-27 toeic-drill-01 語音改成預錄真人級聲音
- 改了什麼：🔊 改播 edge-tts 預錄 mp3（美英澳加四口音輪流、慢 10%），找不到檔才退回瀏覽器語音並挑最好的聲音。
- 為什麼：Chrome 內建語音太像機器人。
- 影響檔案：toeic-drill-01.html、make-toeic-audio.py（新）、toeic-drill-01-audio/（新，200 個 mp3）。

## 2026-09-27 toeic-drill-01 加「不知道」選項、修統計、重寫詳解、語速可調
- 改了什麼：每題加 E 不知道（算已作答、自動標不懂、列入「只看錯的」）；修好「答對」一直是 0 的統計 bug；100 題詳解改成四段＋對照課綱；錄音改成 70% 速度錄，頁面可選 60–100%。
- 為什麼：主理人要用「不知道」讓統計更準、詳解要更細、正常語速還聽不懂。
- 影響檔案：toeic-drill-01.html、make-toeic-audio.py（RATE -30%）、toeic-drill-01-audio/（重錄 200 檔）。

## 2026-09-27 toeic-drill-01 加第二套聲音 Supertonic M5
- 改了什麼：頁面上方可切換「多益四口音／M5」並記住選擇；make-toeic-audio.py 加 --m5 模式，本機錄 200 檔到 toeic-drill-01-audio-m5/（同樣 70% 速度）。
- 為什麼：主理人原本用 Read Aloud 的 M5 聲音，想兩套都保留。
- 影響檔案：toeic-drill-01.html、make-toeic-audio.py、toeic-drill-01-audio-m5/（新）。

## 2026-09-27 toeic-drill-01 加「句子拆解」、修 7-9 雙空格錄音
- 改了什麼：100 題各加一份句子拆解（整句切塊，每塊寫作用、中文、課綱位置），作答後才出現、不影響自動標記；錄音程式改成雙空格一格填一個字，重錄 7-9 兩套聲音。
- 為什麼：主理人文法會選但句子看不懂，要知道整句用了哪些文法；7-9 原本會念兩次「issued slash confused」。
- 影響檔案：toeic-drill-01.html、make-toeic-audio.py、toeic-drill-01-audio/7-9*.mp3、toeic-drill-01-audio-m5/7-9*.mp3。

## 2026-09-27 toeic-drill-01 翻譯改白話版
- 改了什麼：100 題的翻譯全部重寫，照英文順序拆成短句，不再把長修飾語塞在名詞前面。
- 為什麼：原本直譯（例 1-7）連中文都看不懂，翻譯失去「幫忙看懂」的作用。
- 影響檔案：toeic-drill-01.html。

## 2026-09-27 toeic-drill-01 單字表加語音
- 改了什麼：每組「5 個新字」的每個字旁邊加 🔊；錄音程式會一併錄 40 個單字（w-<word>.mp3），兩套聲音都有。
- 為什麼：主理人要能聽單字發音。
- 影響檔案：toeic-drill-01.html、make-toeic-audio.py、toeic-drill-01-audio/w-*.mp3、toeic-drill-01-audio-m5/w-*.mp3。

## 2026-09-27 toeic-drill-01 單字表加「字族」
- 改了什麼：40 個新字每個多一行字族：源頭（怎麼拼出來的）＋家族成員（詞性、中文），資料存在 W 的第 6 欄。
- 為什麼：主理人想知道 -ly、dis- 這類字的源頭是哪個字。
- 影響檔案：toeic-drill-01.html。

## 2026-10-02 toeic-drill-01 句子拆解每一塊加語音
- 改了什麼：句子拆解的 414 塊各加 🔊；錄音程式會一併錄 p-<題號>-<第幾塊>.mp3（兩套聲音，聲音跟該題整句同一人）。
- 為什麼：主理人想逐塊聽句子。
- 影響檔案：toeic-drill-01.html、make-toeic-audio.py、toeic-drill-01-audio/p-*.mp3、toeic-drill-01-audio-m5/p-*.mp3。

## 2026-10-02 toeic-drill-01 移除 M5，只留多益四口音
- 改了什麼：刪除 toeic-drill-01-audio-m5/ 與 M5 試聽檔；頁面拿掉「聲音」切換，所有 🔊 只播四口音；make-toeic-audio.py 拿掉 --m5 模式。
- 為什麼：主理人決定只要一套聲音。
- 影響檔案：toeic-drill-01.html、make-toeic-audio.py、toeic-drill-01-audio-m5/（已刪）、voice-samples/1-1_Supertonic-M5_70.wav（已刪）。

## 2026-10-02 toeic-drill-01 語速標籤更正、預設改 70%
- 改了什麼：「100% 多益原速」改成「100% 正常語速」；預設語速 85% → 70%；移除舊的「一次性改成 85%」程式碼。
- 為什麼：查證後「多益原速」沒有根據（找不到官方語速數字）；實測 100% ≈ 每分鐘 165 字，是這些聲音的正常說話速度。主理人目前能力上限是 70%。
- 影響檔案：toeic-drill-01.html。

## 2026-10-03 toeic-drill-01 語速實測：100% ≈ 多益語速
- 改了什麼：100% 的標籤改成「≈多益語速」。
- 為什麼：用 Whisper 實測 IIBC（日本多益主辦單位）官方範例 Part 3/4 共 8 段，平均每分鐘 184 字；本題庫 100% 約 180 字（官方的 98%），70% 約 126 字（官方的 69%）。上一筆「正常語速」的更正是錯的。
- 影響檔案：toeic-drill-01.html。


## 2026-10-05 新網站「聽力練習模式」完成（app/）
- 改了什麼：新做一個照正確方法練聽力的網站（複習→新學→連續聽，次數制、點字標記、連續 2 次都聽出來就學會），進度存在實驗室電腦的 server，手機電腦都能接著學；附學習方法手冊子頁。
- 為什麼：舊頁只能做題，不會引導「先聽、照英文順序懂、不翻譯」的練法，也不會自動排複習。
- 影響檔案：app/（全新：index.html、guide.html、app.css、js/、server.py、tests/、DEPLOY.md）；舊頁 toeic-drill-01.html 沒改。報告：docs/reports/2026-10-04-listening-mode.html

## 2026-10-05 交接包：舊網頁紀錄匯入指令＋打包
- 改了什麼：server.py 加 `--import-old FILE`（把舊網頁紀錄當成一筆 legacy 事件寫進資料庫，重複執行不會重複）；從這台 Chrome（Profile 2）讀出舊紀錄放進 docs/old-record/（50 題：對 32、錯 17、不知道 1）；DEPLOY 第 6 節改用這個指令；e2e r2-M4 改成等底部條更新（4 次偶發 1 次）；打包 C:\D槽\聽力練習網站_交接包_20261005.zip。
- 為什麼：主理人要「只搬一個壓縮檔、自己什麼都不用做」，舊紀錄（含答錯的題）要一起帶過去複習。
- 影響檔案：app/server.py、app/tests/server_test.py（test_13）、app/tests/e2e.js、app/DEPLOY.md、docs/old-record/（新）、00-給實驗室AI-從這裡開始.md（新）

## 2026-10-06 題目改成「一題一個清楚的職場場景」
- 改了什麼：100 題裡 82 題的句子、翻譯、詳解、句子拆解、錄音改寫（題號、考點、答案、選項不變）；修掉 6-10 兩個正解、9-1 用了教學示範句、3 題標籤 18／19 對調；課綱出題規則改成「場景優先」。
- 為什麼：主理人發現 5-9 等題情境不合理；原因是出題時把背過的字硬塞進句子。多益聽力練的是「什麼場景用什麼字」。
- 影響檔案：toeic-drill-01.html、toeic-drill-01-audio/、app/js/book.js、app/audio/book1/、english-grammar-curriculum__21_.html、app/tests/plan.test.js、docs/old-record/。報告：docs/reports/2026-10-06-scene-rewrite.html

## 2026-10-06 實驗室電腦部署
- 改了什麼：新增 app\tools\setup-admin.ps1 與根目錄「一次設定-按兩下.bat」（設密碼＋開機自動啟動＋防火牆只開給 Tailscale）
- 為什麼：這個帳號沒有管理員權限，AI 不能代建排程與防火牆；排程直接用 python 完整路徑，因為開機時的 SYSTEM 帳號找不到使用者裝的 python
- 影響哪些檔案：app\tools\setup-admin.ps1、一次設定-按兩下.bat（程式本身未改）

## 2026-10-06 取消密碼（主理人指示）
- 改了什麼：config.json 加 `"no_password": true` 時 server 不要密碼；一次設定的腳本拿掉設密碼那步
- 為什麼：主理人說不要密碼；只有同一個 Tailscale 帳號的裝置連得到，防火牆也只開給 Tailscale
- 影響哪些檔案：app\server.py、app\tests\server_test.py（+2 測試）、app\config.json、app\tools\setup-admin.ps1

## 2026-10-06 改成公開網址 https://toeic.cyut-cattrap.duckdns.org/（主理人指示：任何裝置開網址就能進）
- 改了什麼：XAMPP Apache 加 conf\extra\httpd-toeic.conf（子網域轉到 127.0.0.1:8765，win-acme 憑證）；config.json host 改 127.0.0.1；開機啟動改成使用者「啟動」資料夾的 toeic-drill-server.vbs；刪掉需要管理員的一次設定腳本
- 為什麼：主理人要用網域、不用密碼也不用 Tailscale；這個帳號沒有管理員權限
- 影響哪些檔案：C:\xampp\apache\conf\httpd.conf（最後加一行 Include，原檔備份 httpd.conf.before-toeic）、conf\extra\httpd-toeic.conf、conf\ssl.crt\toeic.*、app\config.json

## 2026-10-06 改成「學習資料」總資料夾
- 改了什麼：整個英文專案搬進 C:\英文學習資料\英文\；網址改成 https://learn.cyut-cattrap.duckdns.org/英文/app/（舊的 toeic. 網址自動轉過去）；Apache 設定改成 conf\extra\httpd-learn.conf；啟動資料夾的 vbs 路徑跟著改
- 為什麼：主理人要把所有科目放同一個資料夾、一個網站看全部
- 影響哪些檔案：資料夾位置、C:\xampp\apache\conf\httpd.conf（Include 換成 httpd-learn.conf）、根目錄 README.md、_site\（程式本身未改；四組測試全過）