PythonWeChatAI
KouriChat 本地部署 AI 聊天助手并接入微信远程管理
KouriChat 是一款开源本地 AI 聊天助手框架，支持多模型部署与角色定制。本文介绍如何在 Windows 环境下安装 Python 及项目依赖，配置 DeepSeek API 密钥，并将 AI 接入微信实现自动回复。同时通过内网穿透技术实现公网远程访问控制台，确保数据本地运行且隐私安全，无需编程基础即可完成部署与管理。
KouriChat 是一款开源本地 AI 聊天助手框架，支持多模型部署与角色定制。本文介绍如何在 Windows 环境下安装 Python 及项目依赖，配置 DeepSeek API 密钥，并将 AI 接入微信实现自动回复。同时通过内网穿透技术实现公网远程访问控制台，确保数据本地运行且隐私安全，无需编程基础即可完成部署与管理。
Windows 系统（推荐 Windows 10，4G 运存即可，无显存要求）
KouriChat 是一款开源本地 AI 聊天助手框架，主打'低门槛、高定制、易接入'——支持多模型本地部署，能自定义二次元角色的对话风格、语气甚至知识库，内置微信接入接口，不用复杂编程就能让 AI 女友 24 小时蹲在微信里陪聊，全程数据本地运行，隐私拉满。
KouriChat 最绝的地方，就是把'复杂的 AI 玩法'做成了'傻瓜式操作'：
本来 KouriChat 部署好只能在自家电脑用，出门一趟就'失联'，但使用内网穿透工具后，直接把'本地限定'变成'全网可用'，便利多到数不过来：
KouriChat 就像一把'二次元 AI 钥匙'，把高门槛的角色陪聊变成了人人能玩的小事 —— 本地部署保隐私，微信接入添趣味，自定义人设够个性；而内网穿透工具则是这把钥匙的'扩展器'，打破了'本地服务只能内网用'的枷锁，让你的专属 AI 女友不仅能 24 小时蹲在微信里，还能跟着你走，不管在哪都能调、能聊、能管理。
不用会编程，不用砸大钱，一台普通 Windows 电脑，就能拥有一个'不泄露隐私、随叫随到、完全定制'的 AI 女友。
下面，就让我们一步步看看如何将角色 AI 接入微信，实现全天陪聊吧。
KouriChat 是一款开源的本地 AI 聊天助手框架，旨在让用户能够将自己喜爱的角色、虚拟人物或自定义人格模型轻松接入聊天平台（如微信），实现全天候互动。项目核心特点包括：
在开始部署 KouriChat 之前，我们需要先搭建一个稳定的运行环境，以确保后续模块能够顺利运行。部署此项目需要准备一台 Windows 系统，建议为 Windows 10,项目对配置要求不大，预计 4G 运存即可，不要求显存。必要的环境需要安装 Python 3.11 版本，即可。本教程将在虚拟机 VMware中的Windows 10 22h2版本的镜像作为演示，以纯净初始的系统来部署该项目。
双击运行名为 python-3.11.8-amd64.exe的程序：
![图片]
在显示的界面下，勾选 Add python.exe to PATH选中框，然后点击 install Now进行安装：
![图片]
安装完成后，点击 Close关闭即可：
![图片]
接着，电脑按 Windows+R键，在弹出的运行框中输入 cmd回车，打开命令提示符窗口后，输入如下命令验证 python 版本信息：
python --version
出现版本信息即可！
将 7z2501-x64.exe压缩软件安装至电脑（也可以用其他解压软件或用自带的也可以），然后将 KouriChat-1.4.3.2.zip(目前最新版) 项目解压下来：
![图片]
然后进入项目目录中，双击启动 run.bat脚本：
![图片]
等待脚本执行，脚本会检测你的系统 Python 环境，会自动创建 python 虚拟环境，然后使用 阿里源来进行安装 python 相关的环境依赖，过程稍微比较久，取决于你的网络因素。
![图片]
环境依赖下载完成后会输出提示（如果下载过程中一直卡着，可以尝试回车，可能鼠标脱离终端，导致假卡死了）：
![图片]
下载完成后，会尝试启动程序，且会自动打开浏览器：
![图片]
如果没有打开，手动输入提示的网址即可：
http://localhost:8502
出现网页即代表安装部署成功啦！
由于 KouriChat 项目目前尚未完全适配 微信新版 4.1，新版暂时不可用。近期旧版 3.9 版本微信 强制提示升级至最新版，导致无法正常登录微信，从而使项目暂时无法直接接入。 不过，仍有可行的登录方式（此处不再赘述，可在网盘中获取相关资源），通过该方式依然可以实现微信消息的接入与对话功能。
⚠️ 使用重要提示：
建议 尽量使用小号进行测试与登录。
虽然该方案 并非通过注入或修改微信本体，而是以拟人化的方式（即通过对话框内输入信息的方式发送）进行消息交互，但仍存在 极小概率触发微信风控或封号的风险。
请务必牢记——重要的事情说三遍：请使用小号、请使用小号、请使用小号！
本项目及本文档仅供学习与研究使用，如因使用该方案导致微信账号异常、限制或封禁，后果由使用者自行承担。
接下来，将进入 KouriChat 项目的配置步骤，开始搭建属于你的本地 AI 聊天系统。
首先，进入官方的用量信息页面，未登录会先跳转登录页面，登录即可，在该页面可以看到余额和消耗：
https://platform.deepseek.com
![图片]
接着，点击 API keys,进入该页面：
![图片]
在页面上点击 创建 API key的按钮，然后设置一个 名称（用于辨识），创建完成后点击复制按钮进行复制（注意，只会显示一次，不用刻意记忆，忘记删除重新创建即可）：
好了，这样就获取到了 deepseek 的 Api 密钥了，留着备用，接下来进行接入 KouriChat 项目！
首先，在初始化管理员页面设置一个管理员密码：
![图片]
在接下来的页面，点击跳过：
![图片]
然后在首页，点击顶部导航栏的 配置中心，在基础配置中添加一个要监听的用户（请填写用户的 昵称，不是备注，也不是微信号）：
![图片]
添加完成后，滚动到下方，选择 API 注册地址为 AeepSeek API,AI 模型选择 DeepSeek 官方 V3 模型，将前面获取到的 API 密钥填入即可：
![图片]
接着，展开右侧区域的 意图识别 API 配置，同样填写 deepseek 的相关信息，具体如下图：
# API 注册地址 https://api.deepseek.com/v1 #AI 模型选择 deepseek-chat
![图片]
然后再下方的 消息配置中，设置消息队列等待时间为稍短一些的，这里设置的为 0：
![图片]
最后点击 保存所有设置且提示保存并生效即可：
![图片]
回到主页，点击 微信掉线重连按钮，提示重连成功即可：
![图片]
接着点击 启动按钮，等待启动完成，启动完成后它会自动操作你当前登录的微信（请尽量用小号尝试），作为机器人，然后打开前面配置好的监听昵称的微信对话框：
![图片]
我这里使用的是昵称为【细碎念.】的账号作为机器人，使用昵称为【淡忘如思.】的账号作为被监听的。所以使用【淡忘如思.】的账号来手动发送消息对话：
![图片]
可以看到，发送的消息，控制台成功监听到了，然后调用了 deepseek-chat 模型进行意图解析。最后进行 AI 回复，和正常对话聊天一样的！
部署好 KouriChat 后，很多人都会遇到这种情况：电脑必须 24 小时开着，你却得像'值班管理员'一样守在旁边。一旦外出，AI 突然罢工、不再回复，而家里的控制台又访问不到——日志看不了、角色切不了、API 改不了，一切都陷入停摆。
好消息是，这种局限其实很容易破。借助 内网穿透工具，你可以为本地的 KouriChat 打开一条通往公网的安全通道。无论你是在办公室、出差途中，还是用手机，都能随时登录控制台、切换角色、监控日志，甚至给项目分配一个固定的二级子域名，让你的 AI 助手真正做到'永在线、可远控'。
接下来，我们就来看看——如何用内网穿透工具将 KouriChat 稳定穿透至公网，并绑定专属子域名，让一切操作不再受限于'本地'。
打开内网穿透工具的下载页面，点击下载按钮，下载对应系统的安装包。下来是一个压缩包，解压后执行目录中的应用程序，一路默认安装即可，安装完成后，打开 cmd 窗口输入如下命令确认安装：
cpolar version
出现如上版本即代表安装成功!
注册完成后，在浏览器中输入如下地址访问 web ui 管理界面：
http://localhost:9200
如果还没有账号，点击下方免费注册即可注册账号。输入刚才注册好的账号登录即可进入后台页面: ![图片]
随机域名方式适合预算有限的用户。使用此方式时，系统会每隔 24 小时 左右自动更换一次域名地址。对于长期访问的不太友好，但是该方案是免费的，如果您有一定的预算，可以查看 大纲 5.4.2 的固定域名方式，且访问更稳定。
点击左侧菜单栏的 隧道管理，展开进入 隧道列表页面，页面下默认会有 2 个隧道：
![图片]
点击编辑 website的隧道，修改成我们 kourichat需要的信息：
![图片]
接着来到 在线隧道列表，可以看到名称为 kourichat-8502隧道的两条记录信息，一条协议为 http，另一条协议为 https:
![图片]
以 https 为例，访问测试 (加载稍慢，需耐心等待一下)：
![图片]
可以看到，成功的访问到了 kourichat的 web 页面了。
通过前面的配置，我们已经成功实现了 kourichat 的远程访问，但免费随机域名方案的局限性也逐渐显现：每24 小时左右自动更换域名地址，意味着你需要频繁更新书签、重新分享链接，甚至可能因为忘记更新而无法访问。固定域名方案正是为了解决这些痛点而生，让你拥有一个 永久不变的专属地址，真正实现稳定可靠的远程 AI 工作台。
首先，进入官网的预留页面:
https://dashboard.cpolar.com/reserved
选择 预留菜单，即可看到 保留二级子域名项，填写其中的 地区、名称、描述（可不填）项，然后点击保留按钮，操作步骤图如下：
![图片]
列表中显示了一条已保留的二级子域名记录：
China Top。kourichat。注：二级域名是唯一的，每个账号都不相同，请以自己设置的二级域名保留的为主
接着，进入侧边菜单栏的 隧道管理下的 隧道列表，可以看到名为 kourichat-8502的隧道，点击 编辑按钮进入编辑页面：
![图片]
修改域名类型为 二级子域名，然后填写前面配置好的子域名，点击更新按钮：
![图片]
来到 状态菜单下的 在线隧道列表可以看到隧道名称为 kourichat-8502的公网地址已经变更为 二级子域名 + 固定域名主体及后缀的形式了：
![图片]
这里以 https 协议做访问测试（加载稍慢，需耐心等待一下）:
![图片]
访问成功！这样一来，你就拥有了一个永久不变的专属域名，再也不用担心 24 小时域名更换的问题。
从本地环境搭建到可视化控制台，从 DeepSeek 官方 API 接入到微信自动回复，再到用内网穿透工具将内网服务稳定暴露到公网——我们把原本繁琐的角色 AI 搭建路径拆解成人人可复现的几步操作，让'把最爱的角色做成 AI 女友并接入微信'真正落地。
这不仅是一份部署指南，更是一套可长期运行的本地 AI 聊天工作台方案。无论是个人体验还是轻量级部署，你都能在几分钟内获得一个可持续、可远控、重隐私的专属角色 AI。现在就动手试试吧！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online