# gemini-voice-lab：回合制台灣口語配音：技能書與協作來源 配音太平、尾音太拖？每回合只調一個變因，聽完把有效做法記下來。 ## 工坊收錄說明 內容與行銷 想把 Gemini 配音調成自然台灣口語的創作者、願意親自試聽、逐回合記評語的人。 一張配音基線與單變數回合紀錄，包含本人評語、voice／style／text 分類及尚未定案的規則。 創作者可交換自寫測試句與評語，討論評語該改哪支把手；不同句子確認後，再分享可重現的規則。 先讀 README 的三支把手與限制，在自己的環境用 python3 scripts/voices.py --selfcheck 核對離線流程。 ## 封面與來源署名 作者：Nico 封面插畫：/art/skills/gemini-voice-lab.webp 原作者 GitHub：https://github.com/Rumi-3653/gemini-voice-lab 登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。 原作數據：/api/v1/github/books/gemini-voice-lab/metrics Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。 ## 讀者與格式 Gemini TTS 配音迭代 Skill - 想把 Gemini 配音調成自然台灣口語的創作者 - 願意親自試聽、逐回合記評語的人 ## 功能與使用範圍 MIT。離線自檢與 dry-run 不打 API，dry-run 輸出靜音佔位；真實合成需 Gemini API key，文字與聲音樣本會送到 Google。額度、費用與模型能力以自己的專案為準，不保證免費。固定版本仍把 API 造聲免費層、language_code 與共用配額列為未實測。複製聲音只限本人且先取得同意，私人音檔與 ID 不進 Git；台灣腔效果有上限。配樂、音效、混音不在範圍，工坊未合成或試聽。 - 以 voice（音色）、style（風格）、text（文字）三支把手分類評語，每回合只改一項。 - scripts/tts_gemini.py 讀配音譜與風格表，支援 --dry-run、--one-request 與 SRT；voices.py 提供音色管理及離線自檢。 - 把評語、做法與證據寫入 learnings/rules.md；新規則先驗證，換句子再確認後才定案，無效與爭議都留存。 ## 開始前準備 - Python 3.10 以上、google-genai、PATH 中的 ffmpeg。 - examples/範例角色/cues.txt、styles.txt 與自寫 UTF-8 稿；中文內容放檔案，不塞命令列參數。 - 真實合成前由本人私下設定 GEMINI_API_KEY 與額度；先讀 learnings/api-facts.md 的未驗項。 ## 第一個練習 1. 先讀 README 的三支把手與限制，在自己的環境用 python3 scripts/voices.py --selfcheck 核對離線流程。 2. 照 README 對 examples/範例角色/cues.txt、styles.txt 跑 tts_gemini.py --dry-run；確認切段即可，靜音不是配音成果。 3. 需要試聽才設定自己的 key，以 --one-request 做基線；聽完寫一句評語、只改一個變因，並在 learnings/rules.md 留下證據與驗證中狀態。 ## 練習成果 一張配音基線與單變數回合紀錄，包含本人評語、voice／style／text 分類及尚未定案的規則。 ## 專案與授權 原作 Repo：https://github.com/Rumi-3653/gemini-voice-lab 從原作建立自己的版本：https://github.com/Rumi-3653/gemini-voice-lab/fork 工坊整合參考：https://github.com/Rumi-3653/gemini-voice-lab 記錄的授權：MIT ## 一起改這本技能書 向原作 Issues 回饋自寫發音案例、dry-run 文件或規則欄位問題，保留 Nico 與 MIT 來源；不要附金鑰、本人複製音色 ID 或未授權聲音，實際 API 觀察要附日期。 原作 Repo：https://github.com/Rumi-3653/gemini-voice-lab 預設 PR 目標：Rumi-3653/gemini-voice-lab:main 從原作建立自己的版本：https://github.com/Rumi-3653/gemini-voice-lab/fork 原作 PR：https://github.com/Rumi-3653/gemini-voice-lab/pulls 工坊整合參考：https://github.com/Rumi-3653/gemini-voice-lab 工坊整合任務專用 Fork：https://github.com/Rumi-3653/gemini-voice-lab/fork 工坊任務：https://github.com/Rumi-3653/gemini-voice-lab/issues 工坊 PR：https://github.com/Rumi-3653/gemini-voice-lab/pulls GitHub Milestones：https://github.com/Rumi-3653/gemini-voice-lab/milestones 先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。 以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。 - 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。 ### 改善Gemini TTS 配音迭代 Skill的第一個案例 · 建議任務 向原作 Issues 回饋自寫發音案例、dry-run 文件或規則欄位問題，保留 Nico 與 MIT 來源；不要附金鑰、本人複製音色 ID 或未授權聲音，實際 API 觀察要附日期。 - 驗收：一張配音基線與單變數回合紀錄，包含本人評語、voice／style／text 分類及尚未定案的規則。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。 Agent Skill：/development/skills/gemini-voice-lab/SKILL.md 協作 JSON：/api/v1/skills/gemini-voice-lab/collaboration ## 參與開發 向原作 Issues 回饋自寫發音案例、dry-run 文件或規則欄位問題，保留 Nico 與 MIT 來源；不要附金鑰、本人複製音色 ID 或未授權聲音，實際 API 觀察要附日期。 工坊 Issue／PR 協調入口：https://github.com/Rumi-3653/gemini-voice-lab/issues 先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。 要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues ## 閱讀與來源 閱讀原始專案：https://github.com/Rumi-3653/gemini-voice-lab/blob/c8f6933127ca1d6ba65d0ce47075cfab4b5a0285/README.md 核對日期：2026-10-20 核對版本：c8f6933127ca1d6ba65d0ce47075cfab4b5a0285 - README.md：https://github.com/Rumi-3653/gemini-voice-lab/blob/c8f6933127ca1d6ba65d0ce47075cfab4b5a0285/README.md - LICENSE：https://github.com/Rumi-3653/gemini-voice-lab/blob/c8f6933127ca1d6ba65d0ce47075cfab4b5a0285/LICENSE ## 共創原則 GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。 完整結構化目錄：/api/v1/development-map