ErisPulse-QvQChat 2.1.0

ErisPulse QvQChat 智能对话模块 - 多AI协同智能体

QvQChat 智能对话模块

简介

QvQChat 是一个基于多AI协同的智能对话模块，采用"普通群友模式"，让AI像真人一样自然参与聊天。

核心特性 ⭐

• AI自主决策：无需命令格式，直接用自然语言交互
• 记忆自然融合：询问"你记得我的生日吗"，AI根据记忆自然回答
• 配置简化：只需配置dialogue的API密钥，其他AI自动复用
• 窥屏模式：群聊默默观察，适时回复（默认3%回复率）
• 多模态支持：支持图片理解（需要gpt-4o等视觉模型）

快速开始

第一步：配置文件

复制 config.example.toml 为 config.toml，然后进行最简配置：

[QvQChat]
bot_nicknames = ["Amer"]  # 你的机器人昵称
bot_ids = ["123456789"]    # 你的机器人QQ号

[QvQChat.dialogue]
base_url = "https://api.openai.com/v1"  # 或使用中转服务
api_key = "sk-your-actual-api-key-here"  # 填入你的API密钥
model = "gpt-4o"  # 建议使用支持视觉的模型

详细配置：查看 config.example.toml 获取完整配置选项，包括：

• 窥屏模式参数调整
• 多AI独立配置
• 群聊和用户个性化设置
• 对话连续性和记忆管理等

第二步：安装

ep install QvQChat

第三步：启动

配置完成后，启动ErisPulse框架即可自动加载QvQChat模块。

功能简介

1. AI智能决策（普通群友模式）

AI会根据对话上下文智能判断：

• 是否回复：AI判断何时需要回应
• 是否记忆：AI自动判断什么值得记住

群聊使用窥屏模式，大部分时间保持安静，偶尔参与对话（默认3%回复率），被@时积极响应（80%回复率）。

2. 记忆管理

对话后AI会自动提取重要信息保存到长期记忆。支持：

• 自然询问记忆："你记得我的生日吗？"
• 主动添加记忆："记住这件事，我下周五生日"
• 删除记忆："忘记这件事"

3. 自然语言操作

无需命令格式，直接用自然语言描述操作：

• "清除会话" - 清空对话历史
• "把群提示词改成XX" - 修改群设定
• "导出我的记忆" - 备份记忆数据
• "群记忆模式改成混合模式" - 切换记忆模式

4. 图片理解

支持图片内容理解，dialogue AI可直接分析图片（需要视觉模型）。

窥屏模式说明

群聊默认启用窥屏模式，让机器人更像真人：

参数	默认值	说明
enabled	true	启用窥屏模式
default_probability	0.03	默认回复概率（3%）
mention_probability	0.8	被@时回复概率（80%）
keyword_probability	0.5	匹配关键词时回复概率（50%）
question_probability	0.4	提问时回复概率（40%）
min_messages_between_replies	15	两次回复之间至少间隔消息数
max_replies_per_hour	8	每小时最多回复次数

可在 config.toml 的 [QvQChat.stalker_mode] 部分调整这些参数。

使用示例

日常对话

用户：在吗？
AI：[不回复，保持安静]

用户：你觉得这个怎么样？
AI：我觉得挺好的。[偶尔回复，自然参与]

用户：@机器人 今天的天气怎么样？
AI：今天天气不错，适合出去玩。[被@时高概率回复]

记忆相关

用户：你记得我的生日吗？
AI：是的，我记得你的生日是6月15日。[记忆自然融入]

用户：记住这件事，我下周五要考试
AI：好的，我会记住你下周五要考试。[主动记忆]

故障排除

问题1：API错误 401 - Invalid token

原因: API密钥未配置或配置错误

解决方法:

1. 检查 config.toml 中 api_key 是否已填入正确的API密钥
2. 确保API密钥格式为 sk-... 开头
3. 验证API密钥是否有效

问题2：AI不回复任何消息

可能原因:

1. 窥屏模式概率过低（可调高 default_probability）
2. bot_ids/bot_nicknames 未正确配置
3. API密钥无效或过期

解决方法:

1. 查看日志中的AI判断结果
2. 确认机器人ID和昵称正确
3. 测试API连接

问题3：配置复杂，不知道如何开始

解决方法:

1. 使用快速开始中的最简配置
2. 查看详细注释的 config.example.toml
3. 需要调整参数时再逐步添加配置项

更多文档

• 配置详解：查看 config.example.toml 获取完整配置选项和详细说明
• 架构文档：查看 ARCHITECTURE.md 了解系统架构、核心组件、数据流等技术细节

相关链接

• ErisPulse SDK - 底层框架