🌸 KouriChat - 在虚拟与现实交织处，给予永恒的温柔羁绊

本仓库为​开发分支​，包含新的​实验性特性​。若非开发人员请勿直接使用此分支，​否则您的问题可能无法得到答复​。

最新整合包：夸克网盘下载
详细文档：项目官网
角色广场已上线！：角色档案馆

🌟 效果示例

🚀 部署推荐

• 通过夸克网盘下载项目，推荐转存，第一时间获得更新，我也会有收益
• 最好有一台Windows Server服务器挂机，雨云服务器五折券
• 项目直属公益API（推荐）（注册送20刀，签到送1-5刀）
• 获取DeepSeek API Key（免费15元额度）

---

📜 项目声明

法律与伦理准则 ▸ 本项目仅供技术研究与学习交流 ▸ 禁止用于任何违法或违反道德的场景 ▸ 生成内容不代表开发者立场

使用须知 ▸ 角色版权归属原始创作者 ▸ 使用者需对自身行为负全责 ▸ 未成年人应在监护下使用

---

🛠️ 功能全景

✅ 已实现

• 微信无缝接入 & 多用户支持
• 沉浸式角色扮演（支持群聊）
• 智能对话分段 & 情感化表情包
• 图像生成 & 图片识别（Kimi集成）
• 语音消息 & 持久记忆存储
• 自动更新 & 可视化WebUI

🚧 开发中

• 智能定时任务系统
• 记忆整理优化（8B小模型）
• 分布式负载均衡
• 数学公式渲染引擎
• OneBot协议兼容
• 参与开发计划

---

🚀 快速启动

环境准备

1. 备用设备：手机/模拟器/双开应用（微信电脑端登录必须有一个移动设备同时登录）
2. 微信小号：能登录PC版即可
3. API密钥：

• 项目直属公益API（推荐）（注册送20刀，签到送1-5刀）
• 获取DeepSeek API Key（免费15元额度）

部署流程

半自动部署流程

运行 run.bat

手动部署流程

# 克隆仓库
git clone https://github.com/KouriChat/KouriChat.git

# 更新pip
python -m pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple --upgrade pip

# 安装依赖
pip install -r requirements.txt

#调整配置文件
python run_config_web.py

# 启动程序 或 使用WebUI启动 (在此之前，请启动微信！不然会提示未找到窗口句柄...）
python run.py

---

🧩 项目架构

KouriChat/
├── docs/                        # 项目文档
├── data/                        # 运行数据存储
├── Plugins/                     # 插件系统
├── tools/                       # 工具脚本
├── src/
│   ├── memories/               # 记忆管理系统
│   ├── config/                 # 配置文件
│   ├── Plugins/               # 插件管理
│   ├── utils/                 # 工具库
│   ├── Wechat_Login_Clicker/ # 微信登录助手
│   ├── autoupdate/           # 自动更新系统
│   ├── api_client/           # API客户端
│   ├── handlers/             # 功能处理器
│   ├── webui/               # 可视化配置界面
│   ├── services/            # AI服务接口
│   └── AutoTasker/         # 自动任务系统
├── run.py                      # 主程序入口
├── run.bat                     # Windows启动脚本
├── run_config_web.py          # WebUI配置工具
└── requirements.txt           # 依赖管理

---

💖 支持我们

点击星星助力项目成长 ⭐️ →

🎯 您的支持将用于：
🚀 服务器费用 • 🌸 API资源 • 🛠️ 功能开发 • 💌 社区运营

🔒 神秘赞助计划： 限定数字藏品·开发者礼包·神秘周边·▮▮▮▮

---

🌐 社区互动

核心交流群

通过其他方式联系我们

• 开发讨论：功能建议 & Bug反馈
• 视频教程：哔哩哔哩频道
• 技术文档：KouriChat Wiki
• 商务合作：[email protected]

---

_{🛠️ 核心技术栈}

项目结构

项目结构的详细说明请参考 项目结构文档