賓邦的助手
==========

一個小程式，可以在你自己的電腦上執行賓邦的聲音、語音辨識和文字 AI。這樣賓邦不用連網，也不用付費服務。AI 模型不包含在模組裡，需要另外下載。

開啟方式：在遊戲裡按 F6 →「AI」分頁→「助手」。或是執行這個資料夾裡的 BingBongHelper.exe。

1. 文字 AI。安裝 LM Studio（lmstudio.ai），在裡面下載一個模型，例如 Qwen 3.5 9B 或 Gemma 4 E4B（比較輕量）。在助手裡：設定 → 文字 AI → 選擇模型。

2. 語音。從 huggingface.co/rhasspy/piper-voices 下載一個 Piper 音色，共兩個檔案（.onnx 和 .onnx.json）。中文可以用 zh_CN-huayan-medium（中國大陸口音的普通話，也能唸繁體字）。在助手裡：設定 → 語音 → 開啟音色資料夾，把兩個檔案放進去。

3. 語音提問（非必要）。下載 whisper.cpp（github.com/ggml-org/whisper.cpp/releases）和模型 ggml-large-v3-turbo.bin（huggingface.co/ggerganov/whisper.cpp）。在助手裡：設定 → 辨識 → 選擇 whisper-server.exe 和模型。

4. 按「全部啟動」。綠點表示正在執行。

5. 在遊戲裡：F6 →「AI」→「全部在本機執行」。

最好有一張 8 GB 以上顯示記憶體的顯示卡：AI 要和遊戲一起執行。

內建 Piper 唸不了中文音色 zh_CN-chaowen 和 zh_CN-xiao_ya，也唸不了日文、希伯來文和泰文音色。要用這些音色：設定 → 語音 → 透過 Python 執行 Piper。需要 Python 和指令 pip install piper-tts。
