告別逐題手動複製貼上！透過 Python + Playwright 驅動真實 Chrome，讓 AI Agent 依照教材自動在 WayGround (前身為 Quizizz) 建立互動遊戲與題目草稿。
當老師要把課文講義、閱讀測驗或題庫轉換成 WayGround 互動測驗時，往往需要經歷「生成題目 ➔ 複製題幹 ➔ 複製選項 ➔ 設定正確答案 ➔ 找配圖 ➔ 存檔」的繁瑣循環。 WayGround CLI 將這一切自動化，只需給予結構化題庫或讓 AI Agent 自行閱讀教材，就能自動填入後台！
附帶標準 SKILL.md，可無縫對接 Antigravity、Claude Code 或 GPT，一句指令完成全自動出題。
完整支援單選題、簡答/填空題、多選複選題、投票活動以及開放式問答，滿足多元教學評量需求。
每題皆可指定圖片檢索關鍵字，由腳本自動搜尋並插入合適的題目配圖，讓測驗生動吸睛。
預設一律儲存為 WayGround 草稿（Draft），方便老師在上線前進行最後人工校對與微調。
所有題目皆以乾淨簡潔的 JSON 格式定義。AI Agent 或使用者只需產生對應結構即可進行出題：
| 題型名稱 | type 欄位 |
answers 選項規則 |
correct 答案規則 |
|---|---|---|---|
| 多選單選題 | quiz / multiple_choice | 2 至 4 個選項文字字串 | 正確選項索引值（0 到 3） |
| 簡答 / 填空題 | fill_in_the_blank / type_answer | 1 個以上接受的正確解答字串 | 通常固定為 0 |
| 多選複選題 | checkbox | 2 至 4 個選項文字字串 | 正確選項索引陣列（如 [0, 2]） |
| 投票活動 | poll | 2 至 4 個投票選項字串 | 不需填寫（由學生自由投選） |
| 開放式問答 | open_ended | 空陣列 [] | 不需填寫（收集學生開放文字反饋） |
{
"title": "國中台灣地理隨堂測驗",
"description": "涵蓋台灣地形、氣候與水文的互動複習題",
"questions": [
{
"question": "台灣最高的山峰是哪一座？",
"answers": ["玉山", "雪山", "陽明山", "阿里山"],
"correct": 0,
"type": "quiz",
"time_limit": 30,
"image_search": "Yushan Mountain Taiwan"
},
{
"question": "請選出位於台灣南部的國家公園（複選）：",
"answers": ["墾丁國家公園", "太魯閣國家公園", "台江國家公園", "陽明山國家公園"],
"correct": [0, 2],
"type": "checkbox",
"time_limit": 45
}
]
}在 Windows PowerShell 中只需簡單四個步驟即可完成環境配置與出題：
# 步驟 1：下載專案並安裝依賴
git clone https://github.com/littleyi22/wayground-quiz-creator-skill.git
cd wayground-quiz-creator-skill
.\setup.ps1
# 步驟 2：開啟真實 Chrome 手動登入獲取憑證 (Port: 9335)
python wayground.py chrome-login
python wayground.py grab-session
python wayground.py check # 出現 [OK] 登入有效 即完成！
# 步驟 3：自動建立測驗並存為草稿（背景靜默執行）
python wayground.py create --content examples/quiz_example.json
# 進階：連線至已開啟的專用 Chrome 視窗（推薦，操作零延遲）
python wayground.py create --content examples/quiz_example.json --cdp-url http://127.0.0.1:9335
本工具絕對不會、也無法記錄您的帳號與密碼。登入完全在您本機的 Google Chrome 進行，Session 僅保存在本機使用者目錄（~/.wayground/state.json），絕不上傳任何雲端伺服器，安全無虞！
| 指令 | 功能說明 |
|---|---|
python wayground.py doctor |
診斷本機環境（Python / Playwright / Chrome / 登入憑證） |
python wayground.py chrome-login |
開啟專用 Chrome Profile (Port: 9335) 供手動登入 WayGround |
python wayground.py grab-session |
從專用 Chrome 擷取 Session 憑證並存至本機 |
python wayground.py check |
快速驗證本地 Session 憑證是否仍在有效期限內 |
python wayground.py create --content x.json |
讀取 JSON 題庫並自動出題（預設背景執行並存為草稿） |
python wayground.py create ... --publish |
建立後直接一鍵發布上線 |
python wayground.py create ... --no-headless |
有頭模式，可即時觀看瀏覽器自動點擊與填寫過程 |
python wayground.py create ... --dry-run |
僅校驗 JSON 格式是否正確，不啟動瀏覽器 |
專案內建標準 SKILL.md。只要將 GitHub Repo 連結交給您的 AI Agent（如 Antigravity, Claude Code, Cursor 或 GPT），它就能依照教材內容自主完成以下流程：