如何在微信里部署 AI 女友（KouriChat 教程）

前言

简要记录一次在 Windows（VMware 虚拟机）上部署 KouriChat 并接入微信的实践过程，侧重环境准备、安装启动、API 配置与注意事项。本文仅供学习与研究，请务必在可控的小号/测试环境中操作。

项目简介：KouriChat（概述）

KouriChat 是一款支持本地部署的 AI 聊天助手框架，特点：

  • 支持多模型与本地运行，隐私友好；
  • 支持角色设定、多轮记忆与定制化回复；
  • 提供微信接入接口，可把助手绑定到微信对话（需谨慎使用）。

环境准备（最小要求）

  • 操作系统：Windows 10（示例环境：VMware 中的 Win10 22H2）
  • Python：3.11.x（64-bit）已安装并加入 PATH
  • 网络：稳定的互联网连接（用于 pip 安装依赖与模型 API 调用）
  • 硬件：4GB 内存可运行基础部署（仅做测试）

常用检查：

1
2
python --version
# 应输出 Python 3.11.x

安装与启动（快速步骤）

  1. 解压项目：
    • 将 KouriChat-1.4.3.2.zip 解压到目标目录。
  2. 进入目录并运行：
    • 双击 run.bat（或在 PowerShell/CMD 里执行）。
    • 脚本会创建虚拟环境并安装依赖（使用国内镜像会更快）。
  3. 启动完成后访问：
    1
    http://localhost:8502
    若浏览器未自动打开，可手动访问上述地址；出现页面即表示服务已启动。

核心配置（Admin 页面）

  1. 首次访问，按页面提示设置管理员密码。
  2. 进入「配置中心」→ 基础配置：添加要监听的用户（填写“昵称”，不是备注或微信号）。
  3. 在 AI 接入处选择 API 提供方（以 DeepSeek 为例），填写 API 地址与密钥（下一节详述）。
  4. 保存并生效，回到主界面执行“微信掉线重连”与“启动”操作。

获取 DeepSeek API Key（示例）

  1. 访问： https://platform.deepseek.com
  2. 登录后进入 API keys → 创建新 key → 复制保存（仅显示一次）
  3. 在 KouriChat 的配置页面填入 API 地址与密钥：
    1
    2
    API 地址: https://api.deepseek.com/v1
    模型: deepseek-chat

微信接入与重要风险提示

  • 目前微信客户端与平台会不断升级与风控，某些接入方式可能随版本不可用或存在账号风险。
  • 强烈建议仅使用小号/测试号进行试验，切勿在主账号上测试。
  • 本文不提供规避官方风控的方法；任何导致账号异常的后果由使用者自行承担。

推荐操作流程：

  1. 使用小号登录并确认能正常收发消息。
  2. 在 KouriChat 中配置监听昵称并启动机器人。
  3. 观察控制台日志与模型调用返回，确认消息转发与回复流程正常。

常见问题与排查要点

  • 启动失败：检查 Python 版本、虚拟环境创建日志与 pip 依赖安装错误。
  • 无法访问 localhost:8502：确认防火墙规则、服务是否已启动。
  • 微信无法正常接入：检查微信客户端版本与 KouriChat 支持的接入方式，尝试使用提供的兼容资源或官方文档建议的办法。
  • 模型调用失败：核对 API key、API 地址与配额/余额情况。

常用排查命令（Windows PowerShell）：

1
2
3
4
5
# 查看 8502 端口是否被监听
netstat -ano | findstr 8502

# 查看 Python 进程与虚拟环境日志（按项目实际路径）
type .\logs\kourichat.log

安全与合规建议（必读）

  • 请仅用于学习、研究或获得授权的场景；避免在未经允许的环境中抓取或保存他人隐私数据。
  • 不要尝试绕过服务提供方或平台的安全机制。
  • 对可能触发风控的自动化行为保持谨慎（频率、内容等）。

后续扩展（可选方向）

  • 将 KouriChat 暴露到公网（通过反向代理 / 隧道服务），注意认证与 HTTPS。
  • 用更强的本地模型替代云 API（如果硬件与许可允许）。
  • 集成消息队列以提高并发与稳定性。

参考与资源

结束语

本文整理了在 VM/Windows 环境下把 KouriChat 启动并接入微信的基础流程与要点。再次提醒：请在受控的测试环境和小号中进行尝试，注意账号与数据安全。如需我把“公网穿透配置”或“VirtualBox/VMware 下的详细环境配置”单独展开，回复说明即可。