简体中文 | 繁體中文 | English | 日本語

介紹 ✨

沐雪，一隻會主動找你聊天的 AI 女孩子，其對話模型基於 Qwen 微調而成，訓練集體量 3k+ ，具有二次元女孩子的說話風格，比較傲嬌，但樂於和你分享生活的瑣碎，每天會給你不一樣的問候。

功能 🪄

✅ 支援近乎全自動安裝環境

✅ 提供本人由 3k+ 對話數據微調的 Qwen Lora 微調模型

✅ 支援多個模型加載器，可脫離沐雪微調模型使用

✅ 主動發起聊天（隨機和每天早中晚固定時間）

✅ 提供 5 條命令以便在聊天中進行刷新回覆等操作

✅ OFA 圖像識別：識別表情包、理解表情包、發送表情包

✅ 支援通過 fishaudio/fish-speech 進行語言合成（沐雪 TTS 模型尚未發佈）

✅ 在群聊中聊天（支援被 @ 回覆或不被 @ 隨機回覆）

✅ 在控制台中實時語音對話（暫不支援打 QQ 語音）

✅ 多語言文檔

✅ 常見 Q&A 指南

✅ 清晰的日誌管理輸出

✅ Faiss 記憶模組，從過去的對話數據中進行檢索並自動加入上下文

快速開始 💻

建議環境：

• Python 3.10
• 一張擁有 6GB 及以上顯存的顯卡（int4 量化最低要求為 4G 顯存，CPU 推理需要 16G 及以上記憶體）

自動安裝（venv）

目前已做到自動安裝所有軟體、依賴，通過 Code -> Download ZIP 下載解壓最新源碼。

雙擊 install_env.bat 安裝（不能啟用舊版控制台），或在命令行中運行以下命令：

.\install_env.bat  

自動安裝可能需要較長時間，請耐心等待，安裝完成後，你仍需手動下載模型。

自動安裝腳本使用的是 Python 虛擬環境，不需要 Conda，請留意安裝腳本的提示。

手動安裝（使用 Conda）

git clone https://github.com/Moemu/Muice-Chatbot  
cd Muice-Chatbot  
conda create --name Muice python=3.10.10 -y  
conda activate Muice  
pip install -r requirements.txt -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple  

對於 GPU 用戶，請額外執行

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124  

對於 GPU 用戶，請確保您已配置好 cuda 環境。參考連結

加載沐雪微調模型

目前支援的基底模型如下表：

基底模型	對應微調模型版本號	對應 loader	額外依賴庫
ChatGLM2-6B-Int4	2.2-2.4	transformers	cpm_kernels
ChatGLM2-6B	2.0-2.3	transformers	-
Qwen-7B-Chat-Int4	2.3、2.6.2	llmtuner	llmtuner
Qwen2-1.5B-Instruct-GPTQ-Int4	2.5.3	llmtuner	llmtuner
Qwen2.5-7B-Instruct-GPTQ-Int4	2.7.1	llmtuner	llmtuner
RWKV(Seikaijyu微調)	參見 HF	rwkv-api	（需要下載配置 RWKV-Runner）

本項目的requirements.txt基於 llmtuner 環境要求搭建，因此我們建議使用 Qwen 系列模型，若選用 ChatGLM 系列模型，可能會導致環境錯誤。

微調模型下載：Releases

建議將基底模型與微調模型放入 model 文件夾中然後在配置文件中配置相應配置項（確保配置文件中的路徑目錄下存在多個模型文件而不是只有一個文件夾，部分微調模型由於疏忽還套了一層 checkpoint-xxx 文件夾）

對於沐雪系列 Qwen 微調模型，建議的配置如下：

model:  
  loader: llmtuner  
  model_path: model/Qwen2.5-7B-Instruct-GPTQ-Int4 # 基底模型路徑  
  adapter_path: model/Muice-2.7.1-Qwen2.5-7B-Instruct-GPTQ-Int4-8e-4 # 微調模型路徑  
  template: qwen # LLaMA-Factory 中模型的模板（必填）  
  system_prompt: '現在開始你是一個名為的「沐雪」的AI女孩子' # 系統提示（可選）  
  auto_system_prompt: true # 自動配置沐雪的系統提示（默認為 false）  

如果你沒有合適的顯卡，需要通過 CPU 加載模型或者需要加載量化模型，請安裝並配置 GCC 環境，然後勾選 openmp。參考連結

脫離沐雪微調模型使用

本倉庫同時支援脫離沐雪微調模型使用（如直接使用基底模型或使用其他微調模型等），另請參考 支援的模型加載器列表 配置。

本倉庫支援調用多模態模型，另請參考 多模態模型加載器列表 。

Bot 服務配置

現以提供 OneBot 服務支援

本項目使用 OneBot V11 協議, 若您希望於 QQ 使用, 推薦參考 LLOneBot 或 Lagrange.Core 使用 OneBot 服務

使用LLOneBot: 請在安裝好 LLOneBot 後, 於設置中開啟反向 WebSocket 服務, 填寫 ws://127.0.0.1:21050/ws/api

使用Lagrange.Core: 請參照 Lagrange快速部署 完成配置, 並在其配置文件中添加以下配置項

{  
	"Type": "ReverseWebSocket",  
	"Host": "127.0.0.1",  
	"Port": 21050,  
	"Suffix": "/ws/api",  
	"ReconnectInterval": 5000,  
	"HeartBeatInterval": 5000,  
	"HeartBeatEnable": true,  
	"AccessToken": ""  
}  

您也可以使用其他 OneBot V11 的適配器連結其他軟體，詳見 OneBot V11 適配器

能使用請勿隨意更新 QQNT, 若無法使用請嘗試降級 QQNT

在 Telegram Bot 中使用的方法：遷移至 Telegram Bot

其他功能

• 語音回覆
• 圖像識別（識別 / 發送表情包）
• Faiss 長期記憶
• 實時語音聊天

配置 ⚒️

配置文件說明位於 configs.yml，請根據你的需求進行修改

使用 🎉

在本項目根目錄下運行 main.py

conda activate Muice  
python main.py  

或是運行自動安裝腳本生成的啟動腳本start.bat

命令 🕹️

命令	釋義
/clean	清空本輪對話歷史
/refresh	刷新本次對話
/help	顯示所有可用的命令列表
/reset	重置所有對話數據(將存檔對話數據)
/undo	撤銷上一次對話

常見FAQ

常見FAQ

示例對話（訓練集） 📑

參見公開的訓練集 Moemu/Muice-Dataset

沐雪人設

與其他聊天機器人項目不同，本項目提供由本人通過自家對話數據集微調後的模型，在 Release 中提供下載，關於微調後的模型人設，目前公開的資訊如下：

訓練集開源地址： Moemu/Muice-Dataset

原始模型：THUDM/ChatGLM2-6B & QwenLM/Qwen）

本項目源碼使用 MIT License，對於微調後的模型文件，不建議將其作為商業用途

關於 🎗️

代碼實現：Moemu、MoeSnowyFox、NaivG、zkhssb、Asankilp

訓練集編寫與模型微調：Moemu （RWKV 微調：Seikaijyu）

幫助文檔編寫：TurboHK、葉子

友情連接：Coral 框架、nonebot-plugin-marshoai

總代碼貢獻：

如果此項目對你有幫助，您可以考慮贊助。

感謝你們所有人的支持！

本項目隸屬於 MuikaAI

官方唯一頻道：沐雪的小屋

Star History：