Track 1: Google AI Studio 基礎指南 | AI 程式設計親子課程

🛠️ 步驟 1：家長設定 (工具箱)

家長或指導者必須在課程開始前完成以下步驟：

取得 Gemini API Key：
- 前往 Google AI Studio。
- 使用 Google 帳號登入。
- 點擊 "Get API Key" 並建立一組 API 密鑰。
準備編輯器與環境：
- 安裝簡單的文字編輯器，例如 VS Code 或 Notepad++。
- 將此儲存庫複製 (Clone) 到電腦中：
```
git clone https://github.com/your-repo/TimesTableGame.git
```
- 確認已安裝 pnpm（可執行 pnpm --version）。在本地端執行遊戲以確認運作正常：
```
pnpm install
pnpm dev
```

🎨 步驟 2：孩子與設計師時間 (設計內容)

現在，由孩子接手成為創意總監 (Creative Director)！

任務：產生專屬的 `knowledge.json`

與其只玩乘法表，我們來為你喜歡的主題（例如 Minecraft、恐龍冷知識或動物叫聲）建立專屬題庫吧！

在瀏覽器中開啟 Google AI Studio。
選擇 Gemini 1.5 Pro 或 Flash 模型。
點擊輸入框旁邊的麥克風 (Microphone) 圖示，用語音下達提示詞。
說出以下提示詞：

                "Act as an expert content database generator. Generate a JSON list of 10 trivia questions about [你選的主題]. Each item must look like this: a unique contentId starting with 'custom-', a subjectType of 'trivia', a questionPrompt string, a correctAnswer string, and a list of 3 incorrect decoyAnswers strings. Return only valid JSON."
            

輸出範例：

請確認 AI Studio 視窗中的輸出看起來像這樣有效的 JSON 結構：

[
  {
    "contentId": "custom-dino-1",
    "subjectType": "trivia",
    "questionPrompt": "哪一種恐龍的臉上有三個角？",
    "correctAnswer": "三角龍 (Triceratops)",
    "decoyAnswers": ["暴龍 (T-Rex)", "劍龍 (Stegosaurus)", "迅猛龍 (Velociraptor)"]
  }
]

📂 步驟 3：複製貼上整合 (合作實驗室)

在您的程式碼編輯器中，於 public/data/ 資料夾內建立一個名為 knowledge.json 的新檔案。
路徑：apps/web/public/data/knowledge.json
複製 Google AI Studio 產生的 JSON 程式碼區塊，並直接貼到這個檔案中。儲存檔案。
在編輯器中開啟設定檔，讓載入器指向您的新檔案。（您可以問 AI Studio 助手："How do I edit my load settings to point to my new knowledge.json file?"）。

📝 家庭作業與練習

家庭作業 1：多重主題混合

使用 Google AI Studio 產生一個包含兩個完全不同主題的 knowledge.json 檔案（例如：5 題漫威超級英雄，以及 5 題太陽系知識）。

提示：請確保 subjectType 符合您的自訂分類，並且誘答（錯誤答案）中不會不小心包含正確答案！

家庭作業 2：遊玩測試與微調

啟動您的自訂遊戲，與家人一起遊玩，並找出其中一題「太難」的題目。用語音請 AI Studio 幫您替換一個新問題，複製貼回 knowledge.json，然後重新測試！