宾邦的助手
==========

一个小程序，可以在你自己的电脑上运行宾邦的声音、语音识别和文本 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。
