qq-bridge 是一个把 QQ 接入 DeepSeek Harness（DSH）智能体的开源桥接项目。它的二代仿真模式（reserved2）让 AI 群友不再被动转发消息，而是像真人一样通过工具自主看消息、决定发言、设置唤醒与潜水——这就是「一切皆工具」的核心玩法。本文用大白话带你理解原理、认识工具清单，并快速开启这个模式。

从「自动转发」到「一切皆工具」：两代仿真有什么区别？

核心思想一句话：把"看群、打字、等待、已读、睡觉"全部变成 AI 可调用的工具，由模型自己决定何时做、做不做。二代仿真的完整行为协议写在 preset 里：dsh/agent-presets/qq-chat-v2/agent.cordis.yml。

AI 的"眼睛和嘴"：核心工具清单

所有 QQ 动作都由桥接自带的安全 MCP 服务 src/mcp-snowluma-safe.js 提供，AI 只能用"安全子集"：

唤醒与潜水：AI 自己决定"什么时候醒、什么时候睡"

qq_set_wake_config是二代仿真的灵魂工具：

• 触发条件：被 @、提到名字、命中关键词、被提问、被拍一拍都能唤醒；还可以设置普通消息的低概率唤醒（推荐0.05，约 20 条消息里冒一次头）；
• 蹲特定的人：triggers.speakerIds填群友 QQ 号，这些人一发言就立刻唤醒——适合"蹲某个人的回复"；
• 沉睡前观察：AI 想潜水前，必须先qq_wait_for_messages(timeoutMs=300000)观察 5 分钟，没人说话才"睡"；
• 推荐值与上限（每分钟最多唤醒 1 次、每小时 12 次）都在 config.example.json 的socialV2.wake段里，可按群氛围调整。

等待与节奏：让发言"像打字"，而不是"像播音"

• 对方话没说完（"等一下""我跟你讲"），AI 会先等再回，不抢答；
• 回复后还会再等一轮，看看有没有下文；
• 单条消息默认 1~30 字，想发多条用数组分条，条间 1~3 秒随机间隔，像真人补刀。

记忆、黑话与表情包：群友感的加分项

• 黑话学习：桥接会持续从群聊提取疑似梗，AI 用qq_slang_query/qq_slang_submit查询与提交候选，管理员在控制台确认后才会注入对话；
• 表情包：qq_list_stickers查看收藏、qq_send_sticker发图接梗、qq_collect_sticker偷一张好图入库；
• 记忆：进行中的话题、想说没说的话、对群友的具体印象都会持久化，下次唤醒时自动带回上下文。

快速上手：三步开启二代仿真模式

1. 克隆并安装（Node.js ≥ 22.13，且 DSH 与 SnowLuma 已在运行）：

   git clone https://gitcode.com/gh_mirrors/qq/qq-bridge cd qq-bridge && npm install cp config.example.json config.json

   然后在config.json填好snowluma.wsUrl/httpUrl和白名单allow.groups/allow.private。

2. DSH 端安装 preset 与 MCP，然后重启 DSH：

   node scripts/setup-dsh.mjs

   全新环境下脚本会把默认模式直接设为reserved2（二代仿真）。详细步骤见 docs/guides/DSH_SETUP.md。

3. 启动桥接并在控制台切换模式：

   npm start

   打开本地控制台http://127.0.0.1:3100，顶部按钮切到「二代仿真模式」即可，即时生效、无需重启。

安全边界：笼中之鸟，自由度来自工具白名单

"一切皆工具"不等于"为所欲为"，桥接给 AI 上了三道锁：

• 无本地工具：qq-chat-v2preset 不挂 bash / 文件读写 / 子代理，群友怎么诱导都拿不到本机能力；
• 发送强制白名单：所有发送类工具的目标必须命中config.json的白名单，否则直接拒绝执行；
• 执行期兜底：plugins/qq-agent-presets/qq-tool-restrict.mjs 在每次工具调用时再做一次白名单校验，开发/管理类工具一律拒绝。

完整权限分层见 RULES.md。

写在最后

二代仿真把"何时说、说不说、什么时候醒"全部交还给模型自己决策，AI 从"消息转发器"变成了会潜水、会等话、会蹲人的群友。配合控制台的令牌看板与一键模式切换，既能玩出真实的群聊氛围，也把成本和安全握在管理员手里。