它是谁
一个跑在 QQ 里的多模型智能体。
智能体循环
每条消息都经过「思考 → 行动 → 观察 → 回应」循环：先想该用什么工具，调用后阅读结果，再组织成回答。最多 20 轮工具调用，复杂任务也能拆解完成。
多模型路由
简单问题走快速模型秒回，复杂推理自动切换到强力模型；图片与语音另有专用多模态模型处理。
长期记忆与画像
三层记忆引擎自动从对话中提取事实：重复提及的会被强化记住，长期不用的逐渐衰减。
三种人格
助手 Roxy、角色 Roxy、露比三种人格提示词驱动，/人格切换 即时切换，群聊还可由机器人管理员绑定默认人格。
专属工作区
每个 QQ 号拥有独立文件空间（代码 / 上传 / 输出 / 项目子目录），按权限分配 100MB 至 2GB 配额，互不可见。
本地部署 · 隐私优先
基于 NoneBot2 + NapCat（OneBot V11）自建部署，文件操作全部限制在沙箱工作区内，对话数据仅本地存储、不用于训练。你可以随时删除自己的文件/聊天记录。
使用说明
从零到熟练：怎么说话、怎么用命令、会话怎么管。
怎么开始对话
私聊：直接发消息即可，无需 @。群聊：发送 @Roxy + 内容 触发。
不需要记任何命令。搜索、翻译、天气、路线、查资料……像和朋友说话一样直接提需求，它会自己决定调用哪些工具。
群聊免 @ 窗口（连续对话）
在群里 @ 过它一次之后，会开启一个 90 秒的连续对话窗口：窗口内继续发消息不需要再 @，它会直接接话。
- 每发一条消息，90 秒倒计时重新计满——只要聊得够快，窗口一直续着。
- 90 秒内没人说话，窗口自动关闭，恢复「必须 @ 才理你」。
- 想提前退出：发送 或 。
- 窗口按「群 + 人」独立计算，你在 A 群的窗口不影响 B 群。
命令特殊符怎么输入
系统命令以半角斜杠 / 开头（如 /帮助），反馈类以半角井号 # 开头（如 #反馈）。规则只有三条：
- 符号必须是消息的第一个字符，前面不能有空格或其他内容。
- 必须用半角符号。全角的
／和＃不会被识别，会被当成普通聊天内容交给 AI。 - 命令由系统直接处理、不经过 AI、零 token 消耗，所以响应几乎即时；没命中命令的文本才会进入智能体循环。
临时会话 vs 特殊会话
这是两套完全独立的存储系统，不是同一系统的两种模式：
| 临时会话（默认） | 特殊会话（手动创建） | |
|---|---|---|
| 创建方式 | 发消息即存在，无需操作 | /新会话 [名称] 创建，或 /保存为会话 <名称> 把临时对话存档 |
| 上下文容量 | 只保留最近 20 条消息，更早的被挤掉 | 完整上下文持久保存，长对话不丢细节 |
| 过期策略 | 30 分钟不活跃自动过期清空 | 永久保存，直到你 /删除会话 |
| 数量限制 | 每人 1 个 | 按权限：管理员 10 个 / VIP 3 个 / 普通 1 个 |
| 管理命令 | /clear 或发「新对话」清空重来 | /切换会话 /会话列表 /重命名会话 /删除会话 /结束会话 |
| 适用场景 | 随口一问、短平快任务 | 长篇项目讨论、攻略整理、需要隔天接着聊的内容 |
在特殊会话中发送 /结束会话（或 /临时会话）即退回临时模式，特殊会话本身不会被删除。
权限三级
| 级别 | 能力 | 工作区 | 特殊会话 |
|---|---|---|---|
| 普通 | 搜索 / 天气 / 翻译 / 地图 / 文件阅读 / 游戏工具等基础能力 | 100MB | 1 个 |
| VIP | 追加网页抓取、图片分析、语音识别、代码执行（15s）、仓库下载 | 500MB | 3 个 |
| 管理员 | 全部能力，含 Shell 只读白名单与完整代码执行（60s） | 2GB | 10 个 |
权限由管理员在后台配置。想知道自己当前的权限、会话与工作区用量？直接问它「我的信息」。
使用案例
真实 QQ 录屏，无剪辑加速。点开即看 Roxy 怎么接话。
第一次见面：怎么用
私聊发一句「怎么用?」，Roxy 自我介绍并给出常用命令入口——不需要任何前置知识。
聚合搜索网页
让它查一个线上问题：SearXNG 聚合多引擎检索，阅读结果后给出带出处的结论。
自然语言路线规划
「从 A 到 B 怎么走」一句话触发高德路线规划，驾车 / 步行 / 公交方案带距离与耗时。
查游戏兑换码
/兑换码 直查当前有效的限时码，逐条单发方便复制；数据由管理员人工维护，过期 7 天内仍会提示。
查角色详情
/角色详情 露比 直接返回面板成长、技能与倍率资料并附卡片图，不走智能体、秒回。
创建特殊会话
/新会话 测试 开一个持久会话：上下文完整保存，隔天回来接着聊也不丢。
退出特殊会话
/结束会话 退回临时模式。会话本体仍在 /会话列表 里，随时 /切换会话 回去。
清空上下文
/clear 把临时会话抹干净重新开始——换话题前的好习惯。
命令大全
所有命令均为半角符号开头、系统直处理、零 token。点击命令可复制。
会话管理
/会话 同义）/临时会话 同义）人格与功能
/features 同义）/update record 同义）/help /命令 同义）游戏工具（Ark Re:Code）
/redeem-code 同义）群聊与群管理
#取消 同义反馈
已复制
更新日志
每次发版自动同步到本页，无需人工搬运。
加载中…
反馈方式
Bug、建议、想要的功能，都有一条直达管理员的通道。
群内命令反馈（推荐）
在任意会话中发送以下命令，内容会自动附带当前对话上下文快照直达管理员，复现问题不用截图：
项目层面反馈
部署问题、代码建议、合作意向：直接在 GitHub 仓库提 Issue， 或通过「加入我们」板块的联系人 QQ 沟通。
命令反馈适合「机器人刚才答错了」这类现场问题；Issue 适合需要讨论与排期的事。
加入我们
开源项目，欢迎一切有计算机程序设计基础的朋友。
QQBotAgent · MIT License
NoneBot2 + NapCat（OneBot V11）+ 多模型路由的 QQ 智能体框架。 会写 Python、会调 Prompt、会前端、会运维、甚至只会提 Issue——都算数。
路线规划：基于 RAG 的游戏专精智能体
崩坏：星穹铁道 · 全知剧情智能体
检索增强生成驱动的剧情问答：角色背景、事件脉络、文本细节，问啥答啥并给出出处。
崩坏：星穹铁道 · 强度玩法智能体
配队、遗器、轴与伤害期望：基于结构化游戏数据的强度分析与玩法建议。
Ark Re:Code · 强度玩法智能体
在现有兑换码 / 角色 / 羁绊资料库之上，叠加 RAG 检索的强度与玩法决策支持。