第一次安裝
-
安裝 Node.js
到 nodejs.org 下載 LTS 版，一路按「下一步」裝完。版本要 20.12 以上。
-
解壓縮
把壓縮檔解到任意資料夾，例如
D:\gx-twitch-live。路徑最好不要有中文。 -
申請 Groq 金鑰
到 console.groq.com 登入，點 API Keys → Create API Key，複製以
gsk_開頭的那串。免費。 -
貼進設定檔
用記事本打開
config\.env，把第一行改成GROQ_API_KEY=gsk_你的金鑰後存檔。看不到.env：檔案總管上方「檢視」→ 勾選「副檔名」和「隱藏的項目」。
每次使用
- 雙擊
start.bat，瀏覽器會自動開http://localhost:8850。 - 第一次會先安裝套件，大約 1–2 分鐘，之後秒開。
- 旁邊的黑色視窗就是面板本體，用完再關，關掉面板就停了。
- 換頻道：在資料夾路徑列輸入
cmd按 Enter，再打start.bat 頻道名稱。
面板有什麼
- 聊天室
- 匿名讀取頻道聊天，不用登入 Twitch。
- 球庫 / 話術
- 預先寫好的丟球內容，一鍵複製。
- 品牌設定
- 品牌名稱、連結等，在
config\brand.json改。 - AI 教練
- 依聊天內容建議主播怎麼接話，用的是你自己的 Groq 金鑰。
注意
- 預設只有這台電腦能開面板。要讓同網路其他裝置連，在
.env加一行PANEL_PASSWORD=自訂密碼。 - PC 版不含多帳號自動留言，面板裡的「自動」模式無法使用。
.env裡有你的金鑰，不要傳給別人，也不要整個資料夾轉傳。
常見問題
黑色視窗一閃就關、或出現錯誤
開「命令提示字元」輸入
node -v，要顯示 v20.12 以上。太舊或找不到，回第 1 步重裝 Node.js LTS。顯示 8850 port 被佔用
面板已經開著了。把其他黑色視窗關掉再重開
start.bat。AI 教練沒反應
檢查
config\.env 的金鑰有沒有貼完整、前後沒有空白，改完要關掉黑色視窗重開。解壓縮後檔名變亂碼
只影響「使用說明.txt」這個檔名，不影響使用。這頁就是同一份說明。