KouriChat

外观

用户手册

约 3614 字大约 12 分钟

2025-02-19

1 前言

  • 本教程由KouriChat项目组编写，版权归KouriChat项目组所有。
  • 本教程适用版本: 1.4.0（不支持1.38及以下版本，推荐选择1.39或者此版本）。
  • 最后编写日期: 2025-04-08。
  • 前排提醒: 本项目需要两个微信号，以及一台备用机！！！！（微信电脑端登录必须有一个移动设备同时登录，当然如果你的手机可以双开微信，请无视备用机的需求）

2 简介

  • KouriChat是一个基于大型语言模型（LLM）的情感陪伴程序，能够接入微信，提供更真实的情感交互体验。它解决了传统人机对话程序一问一答的死板效果，提供沉浸式角色扮演、智能断句和多轮对话支持。
  • 点击加入我们的官方社群，里面会有很多好用的小工具以及一些人设。
  • 本项目默认模型为deepseek v3，但是claude 3.5 和 grok3 在体验上更胜一筹，但是价格较贵，用户自行斟酌选择。（kourichat API都有提供）
  • 我们有两种部署方法，一种是在本地电脑上部署，另一种是在云服务器上部署。本地部署好处是便捷，不需要额外付费，并且电脑性能强大，不会卡顿。缺点是电脑需要时刻保持运行才能正常工作，并且不能休眠。而云服务器的好处是可以随时随地运行项目，任何时候都可以和你的AI伴侣畅聊。我们会分别介绍两种部署方法（其实区别并不大）。使用云服务器部署请直接跳转到[云服务器部署方法]。

3 本地部署方法

3.1 准备工作

首先我们需要安装python 3.11.9（点此下载，已经安装过的请无视）。

下载完成后打开下载的exe:

image.png

注意一定要勾选下方的add python.exe to PATH!!!!!

勾选完后，点击Install Now，便会开始自动安装。

image.png

出现这个界面，就说明python安装成功了。

image.png

点击close关闭窗口，现在我们已经完成了前置需求。

3.2 下载方法

  • 通过夸克网盘下载最新稳定版项目，推荐转存，第一时间获得更新，我们项目组也会有收益。
  • 通过官网下载。
  • 通过我们github上项目获得最新版（但是不一定稳定），推荐小白选择前两种方式。
  • 下载安放的路径自由选择，根据你的喜好而定。

3.2 安装教程

下载完成后，打开你下载的目录，解压文件（示例为1.40版本，其他版本一样）:

image.png

解压完成后，打开你解压文件存放的路径:

image.png

打开文件夹，滚轮往下滑，找到run.bat文件:

image.png

双击运行，接下来会自动下载应用需要的安装项:

image.png

静静等待安装完成。如果遇到进度条不动清耐心等待，属于正常现象。遇到报错问题，请查阅 报错指南（强调一下，尽量不要拿校园网下载，一半以上的下载问题都是因为校园网引起的）。

9f0e3d0c219be0923fe4ec550ad98731.png

显示这样的时候就说明安装完成了。稍等片刻，项目会自动跳转。如果没有自动跳转，请复制
http://127.0.0.1:8502，到浏览器中打开即可。

image.png

出现这个页面，说明我们已经安装成功了！自行配置管理员密码。

3.3 程序配置

接下来我们跟随引导逐步完成配置。（填写快速启动可以直接使用基础功能，推荐填写，如果需要进阶功能还需要进行填写。）

首先填写你大号的微信昵称（注意，可以使用备注名，但不能带特殊符号）:

image.png

填写API密钥，推荐选择我们自己的API服务Kourichat API，注册送 2 刀，每日签到赠送0.1 -1 刀不等。我们的默认模型是deepseek v3模型。

image.png

接下来就进入了我们项目的主页面:

image.png

恭喜你！现在只需要登录小号的微信就可以使用我们项目最基础的聊天功能啦！往下滚动，点击机器人状态的右侧绿色的启动按钮，就可以与你的AI畅聊了。（使用的是默认人设莫诺）

image.png

成功启动后的模样:

image.png

如果你希望使用更多进阶功能，请跟随下方指引。

首先我们点击上方主页按钮右侧的配置中心:

image.png

这里我们会看到基础配置和高级配置:

image.png

基础配置我们已经通过快速启动配置好了。如果需要更换其他渠道的API，请自行在API注册地址那里进行更改。接下来我们将目标放在高级配置上，首先是图像识别。图像识别的默认提供商仍然是我们，如果你需要其他渠道，请自行填写。如果你前面用的是kourichat的API，这里会自动填写好。

image.png

接下来是主动消息配置。顾名思义就是AI会主动给你发送消息。至于什么时候发，发什么内容，是根据AI自己的判断来定的，程序只会提供一个范围:

image.png

接下来是Prompt配置。这是用来配置上下文轮数和人设设置的。上下文轮数指的是你和AI聊天会保存10轮的记忆，记忆越长，耗的tokens越多。人设设置就是用来给你切换人设的。

image.png

定时任务模块: 下面是一个示例，点击保存后，AI就会在每天早上7点给你发“早安”

image.png

image.png

接下来是RAG记忆板块，这是我们最新的研究结果，相当于让AI拥有长期的记忆，并且非常地省tokens。

image.png

我们已经完成了所有的配置！接下来切换到角色设定页面:

image.png

这里可以修改人设以及导入新的人设。导入了新的人设以后，我们可以回到配置界面去修改应用人设:

image.png

这里就可以修改人设目录了。

4 云服务器部署

4.1 购买雨云服务器

推荐使用雨云服务器，首先来到雨云服务器:

image.png

来到服务器&云产品页面，选择江苏宿迁，配置选择E5v3:

image.png

套餐选择KVM标配版，或者选择更高的机器:

image.png

点击前往购买后，往下滚动，公网IP选择共享IP模式即可:

image.png

系统选择windows2022数据中心版，之后右下角就会弹出我们的应用

image.png

选择以后点击购买:

image.png

购买以后会跳转到这个界面，耐心等待服务器创建完成:

image.png

点击管理，进入产品管理界面:

image.png

进入管理界面后往下滚，当看到预装软件信息显示kourichat已成功安装，说明已经成功部署了:

image.png

留意远程连接这里的数据:

image.png

4.2 连接云服务器

接下来我们点击键盘上的win键:

image.png

搜索框内搜索远程桌面连接:

image.png

接下来计算机这里输入管理界面得到的这三个信息，首先输入IP:

image.png

点击连接，然后会让你输入账户和密码，一一复制管理界面的信息即可，如果是你自己的电脑可以勾选记住我的凭据，下次打开可以不需要输入账号密码:

image.png

进入云服务器，我们首先关闭这个弹出的页面回到桌面:

image.png

4.3 云服务器脚本启动

接下来我们就可以看到桌面上有kourichat的启动器了。首先先双击微信的安装包，全部一键点到底安装好就行。

image.png

用你的备用机或者双开的微信小号扫码:

image.png

登录以后我们双击启动kourichat的这个图标:

image.png

如果双击以后遇到这样的情况，如图:

image.png

点击edge浏览器旁边的文件图标:

image.png

双击C盘:

image.png

双击temp文件夹:

image.png

双击python 3.11.9.exe

image.png

剩下的步骤参考python安装教程

安装完成后，再次双击安装:

image.png

剩下的配置参考前面

4.4 其他云服务器部署

其他的云服务器参考本地部署和刚刚雨云的前半部分配置教程。

5 报错汇总

推荐下载:

C++库https://www.mefcl.com/vcredistpack.html
微信https://dldir1v6.qq.com/weixin/Windows/WeChatSetup.exe

5.1 API报错（并非程序问题）

注意: API以下文档仅供参考，因为可能服务商原因，可能并不相同

  • Error code: 400（请求体错误 任何API都可参考）
    • 解决办法: 查看是否输入的token值过高（最大token不要超过4096）如果不是请检查其他参数（温度等参数）如果都不是，那就是API余额不足
  • Error code: 401（密钥错误 任何API都可参考）
    • 解决办法: 查看是否填写了密钥，或检查密钥是否填写错误。检查该APIkey是否时该服务商的APIkey。
  • Error code: 403（无可用模型 任何API都可参考）
    • 解决办法: 更换模型，检查模型名字是否填写错误，或更换其他模型
  • Error code: 429（硅基流动可参考）
    • RPH（达到了每小时允许的最大请求数: 30次）
    • RPD (达到了每天允许的最大请求数: 720次)
    • TPM（达到了一分钟最多允许的 token 数: 10000 token）
    • 解决办法: 更换其他支持密钥前缀带 sk- 的API服务
  • Error code: 504 或 503（服务器繁忙 任何API都可参考）
    • 问题详解: 一般是服务系统负载比较高，可以稍后尝试

5.2 安装时报错

  • Microsoft Visual C++ 14.0
    • 解决办法: 安装上方推荐下载的c++运行库，安装后重启电脑，非常重要！
  • 缺少python或python版本不正确
    • 解决办法: 卸载当前python，安装上方推荐下载的python
  • 安装时勾选:

    • ✅ Add Python to PATH

      ✅ Install launcher for all users

    • ✅ pip

    • ✅ tcl/tk and IDLE

5.3 启动时报错

  • 初始化失败: (1400，'setWindowPos'，'无效的窗口句柄')
  • 解决办法: 先打开微信。目前wxauto不支持微信4.0版本，如果安装4.0版本需要手动降级，可以通过上方链接下载。
  • 初始化失败: (5，'setWindowPos'，'拒绝访问')
    • 解决办法: 使用管理员身份运行程序，若还不行，安装上方推荐微信。
  • 初始化失败: Find Control Timeout: {ControlType: ListItemControl}
    • 解决办法: 将你的大号聊天窗口单独点出来。并随便发送一条消息。然后重启程序。
  • 初始化失败: Find Control Timeout: {RegexName: 'XXX',ControlType: ListItemControl}
    • 解决办法: 监听用户不能有特殊符号。
  • 初始化失败: string index out of range
    • 解决办法: 你在配置时未保存，或没有添加监听的用户昵称。添加进去即可
  • DEBUG: 缺失的包: ['XXX','XXX'] 导入模块失败: No module named 'XXX'
    • 解决办法: 这几个报错一样的，在命令行输入: pip install 'XXX'（后面的xxx复制就行） 如果下载失败请更新pip 或使用: pip install 'XXX' -i https://pypi.tuna.tsinghua.edu.cn/simple
  • pycharm命令行: 无法执行 pip 或 python 或 运行 命令
    • 解决办法: 卸载当前python，安装上方推荐下载的python
  • 初始化失败: name 'app' is not defined
    • 解决办法: 删除项目重新安装。（引发报错原因不明）
  • [Error 13] Permission denied: 'C:\Users\USER527749\Desktop\KouriChat-WeChat1.3.3\data/avatars/XXX\avatar.md
    • 解决办法: 找到对应文件，右键后点击属性，把只读的✔去掉。
  • [Error 2] No such file directory: 'C:\Users\USER527749\Desktop\KouriChat-WeChat1.3.3\data/avatars/XXX\avatar.md
    • 解决办法: 关闭bot程序，去配置界面找到prompt配置，选择你的角色，然后点击保存。然后重新启动。查看人设是否缺少表情包文件，如果有表情包文件夹就重启程序。
  • find control timeout: {name:搜索, controltype: editcontrol}
    • 解决办法: 微信语言改成简体中文
  • module 'pyscreeze' has no attribute 'locateOnWindow'
    • 解决办法: 卸载当前python，安装上方推荐下载的python
  • 初始化失败: cannot access local variadle 'listener_thread' where it is not associated with a value
    • 解决办法: 给文件传输助手或微信团队发个消息。

5.4  运行时报错

  • 大语言模型调用失败: Connection error
    • 解决办法: 检查网络，服务商URL是否正确。
  • 找不到图片 或 发送不了表情包
    • 解决办法: 去文件管理器，把设置里的: 隐藏文件扩展名的√点掉。
  • 回车不发消息
    • 解决办法: 去微信设置回车发送消息
  • 程序关了微信一直闪
    • 解决办法: 鼠标右键任务栏，点击任务管理器，找到Python这个，右键它，结束进程后重启程序或者直接重启程序
  • WebUI自动更新失败
    • 解决办法: 手动部署最新版，或利用魔法打败魔法
  • Error - 主程序异常: 'utf-8’
    • 解决办法: 删掉记忆文件
  • Error - 无效时间戳
    • 解决办法: 同步系统时间
  • 群里@机器人不回复，但是私聊回复
    • 解决办法: 清理微信缓存，项目获取到的机器人名称要与群内机器人的昵称一致

5.5 其他离谱的问题

  • 死活安装不上pandas库
    • 解决办法: 卸载你的32位python。安装64位
  • 如果config模块导入失败
    • 解决办法: 在cmd卸载里卸载config，重新安装
  • 使用pycharm安装依赖前面很快但后面突然报错。
    • 解决办法: 更新pip后重启pycharm。

6 实用工具介绍

6.1 Nojikori-Toolbox

这是我们专门用于帮助用户写人设的工具箱