KouriChat/KouriChat

KouriChat – 中文 LLM 聊天機器人平台

這是什麼

• KouriChat 是一個基於 Python 的聊天機器人，它將大型語言模型 (LLM) 服務（例如透過 Kouri API 或使用者提供的 API 金鑰的 DeepSeek）連接到 OneBot 訊息協定。它被宣傳為一個「沉浸式角色扮演」助手，可以在群組聊天中執行、保持持久記憶，並顯示富有表現力的表情符號式回覆。

主要功能（如 README 所列）

• 沉浸式角色扮演 – 支援角色驅動的對話，包括群組聊天情境。
• 智慧對話分段與表情符號產生 – 分割長篇回覆並添加充滿情緒的貼圖。
• 持久記憶 – 跨對話儲存歷史記錄。
• Web UI – 用於設定和互動的視覺化介面。
• OneBot 相容性 – 適用於 OneBot v11（反向與正向 WebSocket 模式）。
• 獨立用戶端 – 可直接透過 python main.py 啟動。
• 1.5 版本重寫 – 目前版本為全面重構。

仍在開發中的功能

• 多使用者處理、影像辨識與語音訊息支援。

如何開始

1. 安裝 – 從 GitHub releases 下載預先建置的 wheel 以及隨附的 elixir 核心 wheel，然後使用 uv tool install … 進行安裝（README 顯示了以 Windows 為中心的指令）。
2. 設定 – 執行 python main.py init 來產生 kourichat.toml 檔案。填入：
   • OneBot WebSocket 設定（反向/正向）
   • LLM API 金鑰（專案託管的 Kouri API 或來自 SiliconFlow 的 DeepSeek 金鑰）。
3. 執行 – 啟動 OneBot 閘道（openclaw-onebotv11.exe run），然後使用 kourichat run（或 python main.py run）啟動 KouriChat。

典型使用情境

• 想要一個能保持角色設定的「虛擬夥伴」的社群或粉絲群組。
• 在支援 OneBot 的平台（例如 QQ 群組）上的角色扮演伺服器。
• 保留過去互動記憶的個人助手。

限制與注意事項

• 本專案僅供研究/學習使用；README 明確禁止非法或不道德的使用。
• 所有生成的內容均為 LLM 的輸出，不代表開發者的意見。
• 目前以 Windows 為主；部署說明依賴 Windows 執行檔。
• 部分核心功能（多使用者、影像/語音處理）仍在開發中。

社群與支援

• 多個 QQ 群組（列出了數十個群組號碼）和一個用於「與 AI 對話」的 QQ 頻道。
• 官方網站、Bilibili 頻道、Xiaohongshu 頁面以及用於文件的 Wiki。
• 透過 WeChat/QQ 號碼直接聯絡，以及用於合作的商業電子郵件。
• 可透過 QR code 進行贊助；README 提到了一個針對捐贈者的「神秘贊助計畫」。

總結 KouriChat 是一個中文聊天機器人框架，將 LLM API 連接到 OneBot 訊息生態系統，提供以角色扮演為導向的功能和 Web UI。它是一個真實、可執行的軟體專案，主要面向愛好者和社群群組，而不是通用的 AI 學習資源。README 提供了清晰的（儘管以 Windows 為主）設定步驟、目前功能列表以及即將推出的功能路線圖。