QQ 桥接 · 使用指南

把 QQ 接进 DeepSeek Harness：在 QQ 里发消息、收消息、留审计，还能按关键词自动回复。整篇按「零基础」写，不要求你懂 WebSocket / OneBot。

一、准备工作

Windows 或 Mac 都行，装了 DeepWhale 桌面端 / DSH 即可。机器人跑在这台电脑上，电脑关机机器人就不回。

建议用一个小号给机器人用，不要用主号。

浏览器打开 q.qq.com，QQ 扫码登录 → 创建机器人 → 在「开发设置」里找到 AppID 和 AppSecret。

AppSecret 等于机器人密码，别发给别人，只填进本地面板。

打开终端，执行：

dsh plugin --profile web add @deepwhale-cn/dsh-qq-bridge

然后重启桌面端，侧栏会出现「QQ 桥接」。

也可以直接下载插件包：dsh-qq-bridge-latest.tgz

侧栏「QQ 桥接」→ 选「QQ 官方机器人」→ 粘贴 AppID、AppSecret → 点「保存配置」。

点「连接」，状态显示 已连接（你的机器人名）就成功了。

把机器人拉进你的 QQ 群；或在手机 QQ 搜机器人名字私聊它。

群里 @机器人（必须从成员列表点选，手打「@名字」不算）发一句话；或直接私聊。面板「入站消息」应出现这条。

平台两条硬规则：① 群里只有真正 @ 机器人的消息才会推过来；② 机器人只能回先跟它说过话的人，主动给陌生人发消息需要官方「主动消息」配额。

默认关闭。打开后，对方一发消息就秒回，不用你手动点。

面板「自动回复」卡片 → 打开开关，填：

默认模板（没命中关键词时用）：收到～{昵称}，我是深鲸机器人，稍后回复你。

关键词规则（一行一条）：价格,多少钱,报价=您好，报价请加客服微信 xxx，工作时间 9:00-18:00

点「保存并生效」。规则从上往下匹配，命中第一条就用它；都不中就用默认模板。

防刷（面板可调）：同一个人 30 秒内只回一次、每小时最多 60 条、消息超 5 分钟不硬发；连续失败 3 次自动暂停并显示原因，可一键恢复。

iPhone / 安卓只需要装 QQ，不用装这个插件，也不用做任何配置。

手机 QQ 私聊机器人、或在群里 @ 它，就和普通聊天一样；回复由你电脑上的插件发出。

配置（AppID/AppSecret、关键词、模板）必须在电脑上做。电脑关机或 DSH 没开，机器人不会回。

看到的提示	意思	怎么办
`40034105 主动消息无权限`	你在给「没先说话的人」发消息	用入站消息旁的「回复」按钮（带 msg_id 被动回复），或去 q.qq.com 申请主动消息配额
`40034005 回复消息 msg_id 已过期`	被动回复窗口（约 5 分钟）过了	让对方重新发一条，再回复
`401 / token 错误`	AppSecret 填错或被重置	回 q.qq.com 重新复制 AppSecret，面板「清除 AppSecret」后重填
`连不上 OneBot 端点 / fetch failed`	选了 OneBot 通道但本机没跑框架	改用「QQ 官方机器人」通道，或先启动 OneBot 框架
勾了「沙箱」连不上	沙箱与正式环境是两套地址/密钥	只在确实用沙箱机器人时勾选；不确定就取消

按顺序查：① 面板状态是不是「已连接」；② 群里消息是不是真 @（从列表点选）；③ 电脑是否休眠/关机；④ 看面板「审计」最后一条的错误码，对照上表。

默认不行。官方限制只能回「先跟机器人说过话的人」；要有主动消息能力，需在 q.qq.com 申请配额，且平台会审核。

AppSecret / token 只存在你电脑本地（`~/.dsh/qq-bridge.json`，权限 0600），面板和接口只显示后四位；审计里也脱敏。插件只连 QQ 官方域名与你配置的端点，不向第三方外发。

v0.3 只做「一问一答」：关键词/正则/模板，不做多轮对话、不做人工接管、不做富媒体（图片/语音/文件）。群里只收 @ 机器人的消息；频道要额外权限。自动回复的统计（今日次数/暂停状态）在内存里，重启清零，配置会持久化。

开源免费、自托管：我们不提供云端代管服务，机器人跑在你自己电脑上。