課後帶回家的大禮包・大字圖文自學講義

📖 Antigravity 與 AI 族語教材製作
長輩友善 4 步驟自學指南

編撰：財團法人原住民族語言研究發展基金會許韋晟執行長

💡 請記住今晚最重要的口訣：「AI 負責快，老師負責準！」

您完全不需要懂英文、也不需要會寫任何程式碼。
只要會「複製、貼上、用中文跟 AI 說話」，3 分鐘就能做出班上孩子最愛的族語遊戲！

第一步：準備好您今天要教的「族語單字或句子」

千萬不要叫 AI 自己憑空亂猜族語！最棒的做法是由老師提供正確的族語文字：

去 族語 E 樂園（學習詞表、九階教材、日常生活會話）複製這堂課要教的 5～8 個族語單字 或 3～6 句對話。
包含「族語拼寫」和「中文意思」即可。

📝 準備範例（以排灣語家人稱謂為例）：

kama（爸爸）、kina（媽媽）、vuvu（祖父母）、kaka（兄姊）、tiaken（我）

第二步：打開「提示詞百寶箱」，挑一款您喜歡的遊戲

我們已經為全台灣族語老師準備好 20 款現成可試玩的互動遊戲模板（包含聽音辨圖、翻牌消消樂、單字泡泡龍、句型火車、課堂大轉盤等）：

點開百寶箱網站，先按 「🎮 立即試玩這款生成遊戲」 看看喜不喜歡。
看到喜歡的款式，直接按一下綠色按鈕 「📋 一鍵複製 Antigravity 提示詞」！

🧰 點此前往「提示詞百寶箱（含 20 款遊戲試玩）」 ➔

第三步：貼給 AI（Antigravity / ChatGPT / Gemini）並換上您的族語

打開您習慣使用的 AI 工具（例如 Google Antigravity、ChatGPT、Claude 或 Gemini）：

在對話框按右鍵選「貼上」，把剛剛複製的提示詞貼進去。
把裡面原本示範的太魯閣語單字，換成您第一步準備好的族語單字，按下送出！
您也可以直接點下方按鈕，複製這段「萬用傻瓜起手式提示詞」來試試看：

請幫我製作一個單一 HTML 檔案（index.html）的「族語單字翻牌配對小遊戲」，打開瀏覽器就能直接玩。請嚴格使用我提供的以下太魯閣語 (trv_Truk) 單字與中文意思，一個字母都不要改： 1. mtutuy（起床） 2. mtaqi（睡覺） 3. nhari（快點） 4. uuqun mgrbu（早餐） 5. bubu（媽媽） ⚠️ 【語音與詞彙防呆鐵律】： 1. 嚴禁使用瀏覽器內建的 window.speechSynthesis (Web Speech API) 英語/印尼語假冒族語發音！ 2. 請在後台用 Python 呼叫原語會 10/13 最新 TTS API (https://ai-labs.ilrdf.org.tw/kari-seejiq-tnpusu-ai-hmjil/ 的 /to_formosan_languages 與 /synthesize) 合成 .wav 後，轉為 Base64 (data:audio/wav;base64,...) 直接內嵌於 index.html 中播放，並附上「🎙️ 老師現場錄音」備援按鈕。 3. 介面要求：字體要超大、按鈕清楚好點、配對成功時給學生熱情的鼓勵與加分，全部過關後可以再玩一次！

第四步：覺得哪裡不滿意？用「15 款 QA 急救包（含 TTS / ASR / MT 三大 API 救援）」叫 AI 改到好！

AI 做完第一版之後，如果您覺得「字太小」、「發音變成奇怪外國腔」或「想加上正宗族語發音與語音辨識」，千萬不要自己去改程式碼！直接像吩咐助教一樣跟它說：

🔍 字太小看不清楚：貼上 「長輩跟小朋友看不清楚，請把所有族語單字放大到 32px 以上，按鈕加大！」
🔤 族語特殊符號跑掉：貼上 「請嚴格核對我給你的族語拼寫與喉塞音符號，一個字母都不准自己改！」
🔊 發音變外國腔？一鍵換成原語會 10/13 最新 AI 語音合成／翻譯／辨識 (ai-labs.ilrdf.org.tw)：點擊下方按鈕複製 原語會最新 IlrdfTTSClient（含 TTS 轉 Base64 內嵌、MT 雙向翻譯、ASR 語音辨識）指令貼給 Antigravity，徹底消滅假發音！

⚠️ 【最高優先修正指令】：請立刻移除網頁中所有的 `window.speechSynthesis` / `SpeechSynthesisUtterance` (Web Speech API) 假發音！
請幫我在後台用 Python 串接原語會最新 10/13 正式版 16 族 42 語 AI 語音合成、翻譯與辨識 API (`https://ai-labs.ilrdf.org.tw/`)，將遊戲裡所有族語單字與句子合成為 `.wav` 後轉成 Base64 (`data:audio/wav;base64,...`) 直接內嵌進單一 `index.html` 中，並保留「🎙️ 老師現場錄音」按鈕！

請直接使用以下驗證通過之 Python 程式碼：
```python
import base64
from gradio_client import Client, handle_file

class IlrdfAiClient:
    def __init__(self):
        # 🔊 TTS 語音合成 & 🌐 MT 機器翻譯端點 (10/13 最新版)
        self.tts_mt_endpoint = "https://ai-labs.ilrdf.org.tw/kari-seejiq-tnpusu-ai-hmjil/"
        self.client = Client(self.tts_mt_endpoint, verbose=False)
        self.current_tribe = None
        self.code_to_tribe = {
            "ami": "阿美", "pwn": "排灣", "tay": "泰雅", "bnn": "布農",
            "dru": "魯凱", "pyu": "卑南", "tsu": "鄒",   "xsy": "賽夏",
            "tao": "雅美", "ssf": "邵",   "ckv": "噶瑪蘭", "szy": "撒奇萊雅",
            "trv": "太魯閣", "sxr": "拉阿魯哇", "xnb": "卡那卡那富"
        }

def switch_tribe_if_needed(self, dialect_code: str):
        prefix = dialect_code.split('_')[0]
        if dialect_code in ["trv_Delu", "trv_Duda", "trv_Tegu"]:
            tribe = "賽德克"
        elif dialect_code == "trv_Truk":
            tribe = "太魯閣"
        else:
            tribe = self.code_to_tribe.get(prefix, "阿美")
        if self.current_tribe != tribe:
            self.client.predict(tribe, api_name="/to_formosan_languages")
            self.current_tribe = tribe

def synthesize_to_base64(self, text: str, dialect_code: str) -> str:
        """合成語音並直接回傳可內嵌於單一 HTML 的 data:audio/wav;base64,... 字串"""
        self.switch_tribe_if_needed(dialect_code)
        wav_path = self.client.predict(text, dialect_code, api_name="/synthesize")
        with open(wav_path, "rb") as f:
            b64 = base64.b64encode(f.read()).decode("ascii")
        return f"data:audio/wav;base64,{b64}"

def translate_zh_to_indigenous(self, zh_text: str, dialect_code: str) -> str:
        """🌐 MT 華語翻族語 (/translate_1)"""
        self.switch_tribe_if_needed(dialect_code)
        return self.client.predict(zh_text, "zho_Hant", dialect_code, api_name="/translate_1")

def recognize_speech(self, wav_path: str, asr_tribe_code: str = "formosan_trv") -> str:
        """🎤 ASR 族語語音辨識 (https://ai-labs.ilrdf.org.tw/sapolita-kaldi/)"""
        asr = Client("https://ai-labs.ilrdf.org.tw/sapolita-kaldi/", verbose=False)
        return asr.predict(dialect_id=asr_tribe_code, audio_data=handle_file(wav_path), api_name="/automatic_speech_recognition")
```
📌 16 族 42 方言常用代碼：太魯閣 `trv_Truk`、阿美秀姑巒 `ami_Xiug`、阿美海岸 `ami_Coas`、排灣中 `pwn_Cent`、泰雅賽考利克 `tay_Seko`、布農郡群 `bnn_Junq`、魯凱霧台 `dru_Wuta`、卑南南王 `pyu_Nanw`、鄒 `tsu_Tsou`、賽夏 `xsy_Sais`、雅美 `tao_Yami`、邵 `ssf_Thao`、噶瑪蘭 `ckv_Kava`、撒奇萊雅 `szy_Saki`、賽德克德固達雅 `trv_Tegu`、拉阿魯哇 `sxr_Saar`、卡那卡那富 `xnb_Kana`。

👉 在「提示詞百寶箱」點選最後一個頁籤【🛠️ QA微調急救包】，15 張救援指令卡（含 TTS #13、ASR #14、MT #15）都能一鍵複製！

❤️ 給族語老師的 3 個安心錦囊

Q1：我不小心按錯按鈕，電腦或網頁會不會壞掉？

👉 絕對不會壞掉！AI 產生的只是一個網頁檔案（就像一張電子學習單），就算改壞了，重新貼一次提示詞就能在 30 秒內重做一張新的！

Q2：AI 生出來的族語例句有錯，或是發音怪怪的怎麼辦？

👉 這正是各位國寶老師無可取代的價值！AI 只是幫我們做遊戲外殼的挑夫，若發音用了瀏覽器假音，請貼上百寶箱【#13 TTS 語音合成急救】改接原語會 AI 語音，或直接點畫面上的「🎙️ 老師現場錄音」親自錄下最道地的母語！

Q3：我今天還沒決定要做什麼遊戲，可以先用現成的嗎？

👉 當然可以！課程總入口網上的「AI 出題小幫手」、「16 族語音辨識闖關遊戲」、「族語圖卡與六格小書產生器」全部都是免費現成工具，明天上課就能直接打開給學生玩！

🚀 快速傳送門（點擊立即前往）

🏠 返回課程總入口網
所有課堂連結總整理 🧰 提示詞百寶箱
20款遊戲試玩＋15題急救包 🌟 第三站：我的許願單
許願您想要的族語教具