KouriChat 是一款开源的本地AI聊天助手框架，以其“低门槛、高定制、易接入”的特点，让用户能够在本地环境中部署个性化的AI聊天伴侣，并接入微信等『社交平台』。
主要特性与优势
- 多模型支持与本地部署：用户可以选择不同的语言模型或自定义训练数据，在本地运行，保障隐私和数据安全。
- 角色扮演与多轮对话：支持丰富的人格设定，让AI具备连续记忆和多轮交互能力，使聊天体验更加生动自然。
- 高度可定制：可自定义对话风格、语气、知识库和行为规则，满足二次元爱好者、AI恋人爱好者或创作者的多样需求。
- 易于接入应用：内置微信接入接口和插件机制，使AI聊天助手能快速部署到常用社交工具中，实现24小时在线陪聊。
本文将带你从零开始，在本地电脑上部署开源的 KouriChat 智能聊天框架，并通过 ZeroNews 为其分配一个公网访问地址。完成配置后，你不仅可以随时通过浏览器远程管理你的AI，还能将它接入微信，让它化身为你专属的社交聊天助手。
适用人群：AI爱好者、二次元角色扮演玩家、希望拥有私有社交『机器人』️开发者。
部署 KouriChat 本地服务1. 环境准备
- 支持 『Windows』 / Linux / macOS 系统（本文以 Linux 为例）
- Git下载
- Python，建议安装3.12版本
- 微信，建议安装3.9.12版本
注意：
- 在操作下面步骤之前，建议先将如上内容准备好。
- 务必使用微信小号进行测试！切勿直接使用日常主账号，以防任何未知风险。
2. 创建 KouriChat 项目文件夹并克隆项目
- 在本地磁盘创建一个新文件夹，用于放置下载克隆的KouriChat项目文件，例如 D:\KouriChatAI
- 打开命令提示符（CMD）窗口，执行如下命令进入到目标文件夹
这是从github仓库拉取，下载会较慢，请保持等待
当终端显示“done”的字样，表示下载成功
- 可以看到当前文件夹中已存在对应的文件
3. 安装运行本地项目
- 双击运行 run.bat文件
- 系统将自动执行环境安装流程。安装完成后，系统将显示“配置管理系统已就绪”提示，并自动开启本地页面。（也可手动在浏览器输入地址 127.0.0.1:8502 访问本地页面）
请确保提前安装好 Python，推荐使用 3.12 版本
- 首次访问系统时，需完成初始管理员密码与名称的设置操作
- 当系统提示填写 API 密钥时，您可选择暂时跳过该步骤
- 完成上述操作后，系统将自动跳转至 dashboard 页面
4. 设置本地项目配置
- 在左侧菜单中点击“API 服务”选项，若为首次使用，系统将自动重定向至 KouriChat 官网的注册/登录页面
- 完成注册登录后，在官网的“令牌”页面（或类似位置）即可看到系统为您生成的默认令牌。同时，您也可以手动新建一个令牌，复制该令牌以作备用
- 返回本地页面，在页面中找到并点击“配置中心”选项
- 返回本地页面右侧的高级配置区域。在该区域中找到“图形识别 API 配置”与“意图识别 API 配置”两项，将刚刚复制的 Token 分别粘贴至对应位置，随后点击保存按钮以完成配置
若当前使用的大模型识别能力无法满足需求，可将其替换为其他模型，系统支持自定义大模型配置
5. 设置监听对象
基础配置里，填写监听的用户昵称
假设您有一个常用的主微信号A，以及一个用于测试的小号B。您需要在电脑上登录小号B（作为『机器人』️账号），然后在KouriChat的“基础配置”中，将“监听的用户昵称”填写为主号A的微信昵称。这样，当主号A向小号B发送消息时，『机器人』️就会自动回复
6. 启动微信并测试消息
返回系统主页，滑动到页面底部：
- 先点击「微信掉线重连」
- 再点击「启动」
启动成功后，就可以在另一部微信上给『机器人』️发送消息进行测试。
如下图所示
右侧为我们发送的消息，左侧为『机器人』️回复的内容。
如果意图识别效果不理想，可以尝试更换其他模型进行优化。创建 ZeroNews 映射服务
1. 打开 ZeroNews管理后台，然后选择您的系统（小编用的是用Win11，选择『Windows』即可），并按照对应的步骤和命令安装运行 Agent 服务
注意：
- Agent 前台运行不能关闭命令窗口
- 如果您想要开机自启动，可以执行后台运行命令
2. 运行完成之后，您可以在 Agent 页面看到已经在线的 Agent 服务
3. 在域名端口页面，创建一个可用的公网域名（自定义前缀），并勾选HTTPS 协议端口
4. 域名创建完成之后，我们继续打开映射页面，并按下面的步骤添加映射
- Agent：选择第一步运行的 Agent
- 映射协议：选择 HTTPS 协议
- 域名：选择刚创建好的域名
- 带宽：根据需要选择带宽大小
- 内网IP：我们是本地部署，直接使用 127.0.0.1 即可
- 内网端口：输入本地服务的端口 8502 即可
5. 按照上述流程完成所有创建步骤后，系统将自动生成一条可供公网访问的映射域名
公网访问您的KoruiChat服务
在任意一台具备网络访问功能的电脑上，打开浏览器，将链接复制至浏览器地址栏，随后按下回车键即可访问
现在你已经成功在本地搭建了KouriChat AI聊天助手，并配置了公网远程访问能力。
如果在搭建过程中遇到任何问题，或想分享你的AI角色设定，欢迎在评论区留言交流。未来，我们还将持续探索更多AI结合的玩法，敬请期待！
