谁能拒绝一个懂你的栞那酱呢?Project Kanna项目演示及部署教程
Project Kanna(栞那计划)是一个专为二次元角色深度定制的智能QQ机器人系统。与传统的被动式AI聊天程序不同,该项目旨在赋予虚拟角色主动社交能力,使其能够基于上下文自主判断并在合适的时机发起对话,从而建立更深度的互动羁绊。系统采用全异步架构设计,集成了大语言模型(LLM)与Web可视化控制面板,允许用户灵活配置角色人设与记忆模块。
01核心功能与特性
功能架构亮点
主动交互机制
突破传统问答限制,实现拟人化社交
- 具备主动苏醒功能,支持固定时间或随机时间唤醒
- 基于聊天上下文智能判断是否需要发起对话
- 区别于“一问一答”,能主动寻找话题与用户互动
系统技术栈
高效稳定的技术底座与管理工具
- 基于Python 3.9+与全异步架构,确保高并发消息处理
- 内置Web可视化仪表盘(127.0.0.1),支持实时状态监控
- 集成长短期记忆系统,支持角色扮演与历史回顾
02部署前环境准备
- 运行环境
Windows操作系统;已安装QQ客户端(用于运行Bot账号)。 - Python环境
下载并安装Python 3.9版本(其他版本未测试,可能存在兼容性问题),安装时务必勾选“Add Python to PATH”以配置环境变量。 - 消息转发组件
下载NapCat QQ客户端,这是连接项目与QQ协议的桥梁,负责消息转发。 - 大模型API
准备支持OpenAI格式的API Key,如智谱AI的GLM-4 Flash等免费或商用模型。
03详细部署步骤
- 配置NapCat QQ
解压NapCat客户端,启动launcher.bat。初始化完成后登录Bot QQ账号。打开Web控制台,进入网络配置,新建WebSocket服务器:名称自定义,消息格式选择“String”,启用服务并确定。 - 初始化项目配置
下载Project Kanna项目包并解压。进入Config文件夹,将后缀为.example的文件重命名并移除.example后缀。打开config文件,填写核心信息:API Key、API地址、模型名称、主人QQ号(白名单机制,仅此处配置的QQ可收到回复)。 - 设定角色人设
编辑roleplay_prompt文件,定义角色的身份、性格、说话风格及经典台词。这是机器人灵魂的核心,决定了AI的回复基调。也可以在后续启动Web控制台后进行可视化编辑。 - 启动服务
双击运行项目目录下的start.bat。系统将自动检测Python环境并下载数据包,待服务启动成功后,根据提示打开Web控制台地址(默认为本地地址)。
04进阶设置与运行
通过Web控制台可以进行更深度的系统管理。在“人设与设置”板块,除了调整基础参数外,重点在于配置“主动苏醒”策略。用户可设定AI在固定时间点(如清晨、深夜)或在随机时间区间内自动激活。激活后,AI将结合长期记忆与当前上下文,自主决定是否向主人发送消息,从而实现真正意义上的“陪伴”而非单纯的“应答”。
当前文章无评论,是时候发表评论了