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 为主）设置步骤、当前功能列表以及即将推出的功能路线图。