CoboldAIValley - AI對話模組

使用AI對話系統讓星露谷物語煥發生機！與居民們進行完全自由的對話，利用您PC的強大性能免費使用AI！注意：需要超過8GB顯存！

CoboldAIValley

🌟 **使用AI驅動的對話系統，讓星露谷的NPC們活起來！**

🎯 核心功能

• **🤖 智能角色感知**：AI會考慮每個NPC的性格和與您的關係
• **🎭 完全可定製的角色特質**（通過characters.json文件）
• **🧠 實驗性記憶系統**與原版風格對話完美融合
• **📅 上下文感知回覆**（考慮時間、日期、友誼等級）
• **💝 動態關係系統**（友誼等級會根據您的語氣變化）
• **🎮 自定義NPC支持**（下方有詳細說明）

⚠️ 重要系統要求

• **需要8GB以上顯存！**
• **至少使用約6GB系統內存**
• **首次啓動可能需要5-20分鐘**

🛠️ 安裝指南

必需模組：

• SpaceCore
• Expanded Preconditions Utility
• SMAPI - Stardew Modding API
• Generic Mod Config Menu（用於模組配置）

外部程序（必需）：

• **KoboldCpp** - GitHub下載鏈接
• **語言模型（gguf格式）** - 推薦從Huggingface.co下載

🚀 設置步驟

• **安裝所有必需模組**到Mods文件夾
• **下載語言模型**（推薦7B以上，Q值4-6的模型）
• **配置KoboldCpp**：
• 爲程序創建單獨的英文路徑文件夾
• **以管理員身份運行**
• 根據顯存調整GPU Layers設置
• 通過Browse加載您的語言模型
• 在網絡選項卡中設置Host爲：localhost
• **啓動KoboldCpp**，等待控制台顯示localhost:5001
• 在瀏覽器中打開localhost:5001驗證AI功能
• 重置爲默認模板，選擇聊天模式，**保持控制台開啓**
• 啓動遊戲，在SMAPI控制台中檢查連接狀態
• **完成！** 接近NPC按**T**鍵開始聊天

🎮 遊戲內操作

• 接近NPC後按**T**鍵打開聊天界面
• 輸入您想說的話，遊戲會自動識別對話對象
• AI會在短暫處理後生成原版風格的對話回覆
• 如果想取消聊天，**按兩次ESC鍵**

🔧 高級配置

語言模型推薦：

• **Harbinger-24B-Q4_K_M** - 240億參數，理解力強，錯誤少（響應時間13-20秒）
• **Saiga_Gemma3-12B-Q6** - 輕量但能力強，準確遵循提示（響應時間約7秒）

GPU Layers設置建議：

• 8GB顯存 → 23層
• 12GB顯存 → 30層
• 16GB+顯存 → 43層

🛠️ 故障排除

• **AI行爲異常？** 檢查KoboldCpp控制台輸出，在config.json中添加停止詞
• **NPC回覆太短？** 編輯config.json中的提示詞鼓勵更長回覆
• **NPC不理解您？** 如果SMAPI提示超過2k字符，在KoboldCpp中增加token size

🎭 添加自定義內容

自定義NPC：

編輯**characters.json**文件，按照模板添加新NPC的名稱、特質和關係

自定義事件：

修改**events.json**文件，爲特定日期添加或更改遊戲內事件

💡 使用技巧

• 爲獲得最佳性能，推薦使用Q4-Q6量化的7B左右模型
• 模型名稱中的"B"值越高越聰明，但需要更多資源
• "Q"值代表量化質量，避免使用Q<4的模型

---

**感謝下載！這是我第一個模組，我會很高興修復發現的任何bug！**

祝您遊戲愉快，農場生活更加豐富多彩！ 🌟