文档 - 最后更新日期 2025/02/20

约 2263 字大约 8 分钟

2025-02-19

简介

KouriChat 是一个基于大型语言模型（LLM）的情感陪伴程序，能够接入微信，提供更真实的情感交互体验。它解决了传统人机对话程序一问一答的死板效果，提供沉浸式角色扮演、智能断句和多轮对话支持。
推荐使用DeepSeek V3 模型。

部署推荐

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

项目声明

法律与伦理准则
▸ 本项目仅供技术研究与学习交流
▸ 禁止用于任何违法或违反道德的场景
▸ 生成内容不代表开发者立场
使用须知
▸ 角色版权归属原始创作者
▸ 使用者需对自身行为负全责
▸ 未成年人应在监护下使用

项目结构

Kourichat/
├── data/                           # 数据存储目录
├── logs/                           # 日志目录
├── src/                            # 源代码主目录
│   ├── autoupdate/                 # 自动更新相关
│   │   └── updater.py              # 更新器实现
│   │
│   ├── config/                     # 配置文件目录
│   │   ├── config.json             # JSON配置文件
│   │   ├── settings.py             # 设置模块
│   │   └── __init__.py             # 配置初始化
│   │
│   ├── handlers/                   # 处理器目录
│   │   ├── emoji.py                # 表情处理
│   │   ├── image.py                # 图片处理
│   │   ├── memory.py               # 内存处理
│   │   ├── message.py              # 消息处理
│   │   └── voice.py                # 语音处理
│   │
│   ├── services/                   # 服务层目录
│   │   ├── ai/                     # AI服务目录
│   │   └── database.py             # 数据库服务
│   │
│   ├── utils/                      # 工具函数目录
│   │   ├── cleanup.py              # 清理工具
│   │   └── logger.py               # 日志工具
│   │
│   ├── webui/                      # Web界面相关
│   │   ├── background_image/       # 背景图片目录
│   │   ├── routes/                 # 路由目录
│   │   └── templates/              # 模板目录
│   │       ├── config.html         # 配置页面
│   │       └── config_item.html    # 配置项模板
│   │
│   ├── main.py                     # 核心业务逻辑
│   └── __init__.py                 # 包初始化文件
│
├── .git/                           # Git版本控制目录
├── .gitignore                      # Git忽略配置
├── LICENSE                         # 开源许可证
├── MileStone.md                    # 项目里程碑
├── README.md                       # 中文说明文档
├── README_EN.md                    # 英文说明文档
├── SponsorList.md                  # 赞助者名单
├── Thanks.md                       # 致谢文档
├── run.bat                         # Windows启动脚本
├── requirements.txt                # 依赖包列表
├── run.py                          # 主程序入口
├── run_config_web.py               # Web配置界面入口
├── test.py                         # 测试文件
└── version.json                    # 版本信息配置

功能全景

已实现

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

开发中

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

快速启动

环境准备

Python 3.11
备用设备：安卓手机/模拟器（微信电脑端登录必须有一个移动设备同时登录，因此不能使用您的主要设备。）
微信小号：能登录PC版即可
API密钥：查阅文档开头
最好有一台Windows Servers服务器用于挂机：雨云服务器五折券

半自动配置（推荐小白）

半自动部署流程

运行半自动化部署程序：

run.bat

如果出现错误，请查阅常见问题。

手动配置（推荐经验丰富人群）

手动部署流程

# 克隆仓库
git clone https://github.com/KouriChat/KouriChat.git
# 更新pip
python.exe -m pip install --upgrade pip
# 安装依赖
pip install -r requirements.txt
#调整配置文件
python run_config_web.py
# 启动程序 或 使用WebUI启动 (在此之前，请启动微信！不然会提示未找到窗口句柄...）
python run.py