通到 QQ（dsh-qq-bridge）

让 DSH 里的 AI 伙伴和 QQ 连起来：它在 DSH 里说完话，自动发到 QQ。

现在两半都做出来了，而且都不用 BOT：

• DSH → QQ：伙伴说话 → 发到 QQ。
• QQ → DSH：你在 QQ 里发话，插件自己轮询那个 QQ 后端收进来 → 转进 DSH。只要一个后端就够。

现在的行为

• 盯一个「目标会话」——你自己选，一般就是你平时和它聊天的那一间。
• DSH → QQ：它在某一整轮的最后一句说完，就把这句原文发到 QQ（走 QQ 后端的 3000）。
• QQ → DSH：插件每 4 秒轮询 QQ 后端（get_friend_msg_history / get_group_msg_history）， 发现你在 QQ 里新发的消息 → 转进目标会话，让它照常开一轮。
• 发/收都只走这个 QQ 后端的 HTTP 接口（默认 127.0.0.1:3000）。
• 安全默认：总开关 = 关、试运行 = 开 —— 不手动打开，一句都不会真的发到 QQ。

配置（设置页里点就行，不用改文件）

设置 → 通到 QQ，从上到下：

项	默认	说明
总开关	关	关着 = 一句都不发
试运行	开	开着只记账，不真发
目标会话	（没选）	下拉里选你自己要的那一间，不用手填 id
转私聊 / 私聊 QQ 号	开 / 空	发到哪个私聊
转群 / 群号	关 / 空	发到哪个群
测试一句	—	真发一条测试句到已填的私聊/群（绕过试运行）

配置文件落在 %USERPROFILE%\.dsh\qq-bridge-config.json（一般不用碰它）。

现在就能用的接口

• GET /dsh-qq-bridge/state —— 配置、日志、会话清单、以及「连着的 QQ 是哪个号/昵称」。
• POST /dsh-qq-bridge/save —— 存配置（body 里给要改的键）。
• POST /dsh-qq-bridge/test-send —— 真发测试句（绕过试运行）。

自测（不装插件也能跑）

node tests/宿主半边.mjs
node tests/网页半边.mjs

想让它发语音？（可选附加件）

主插件只管文字。想让 AI「念」出来的声音变成 QQ 语音条，tools\语音\ 里放了整套：

文件	干什么
录语音.mjs	看门狗：盯着朗读桥，念的时候录音、录到就发 QQ
录音回环.ps1	录音器（录系统声音回环，不要麦克风）
朗读信号哨兵/	Chrome 扩展：看到朗读桥面板的「🔊 点朗读」就通知看门狗开录

两种发法，自己选（双击 启动-录语音.bat 会让你输 1 或 2）：

模式	什么样
1 = 切断发	边录边发，念一段发一段（响应快，会连着几条）
2 = 完整发	整段念完，把所有分段拼成一条再发

前提：Windows + 装了朗读桥（dsh-tts-bridge）+ QQ 后端支持发语音。 详细步骤见 tools/语音/README.md。

不装这一套也完全能用主插件。

它依赖什么：一个 QQ 后端（SnowLuma 或 NapCat，二选一）

插件本身不碰 QQ 协议，它只会说 OneBot 11 的 HTTP。所以你要在本机跑一个「QQ 接口」程序， 让插件通过 http://127.0.0.1:3000 跟它说话。

选哪个

后端	说明
SnowLuma	测过，能用（本插件一直在用的就是这个）。
NapCat	也测过，能用。自带网页后台（默认 http://127.0.0.1:6099）扫码登录，比自己配一端省事

插件实际用到的接口（换后端时照这个核对）

send_private_msg            发私聊
send_group_msg              发群消息
get_login_info              看登录的 QQ 是哪个（设置页显示"✓ 连着的 QQ"）
get_friend_msg_history      收私聊（QQ → DSH）
get_group_msg_history       收群消息（QQ → DSH）

只要你的后端把这 6 个接口开在 HTTP 上，插件就能用。

装 NapCat 的步骤

1. 从 NapCat 的 Releases 下 Windows 版，解压到任意目录
2. 双击启动，它会弹一个网页后台（默认 http://127.0.0.1:6099）
3. 在网页里扫码登录你要用的 QQ 号
4. 确认 HTTP 服务开着、端口是 3000（不是的话，在插件设置里把「NapCat 地址」改成你的）
5. 回到 DSH → 设置 → 通到 QQ → 点「测一下」，应该显示 ✓ 连着的 QQ：<昵称>（<号>）

装 SnowLuma 的步骤

同样思路：跑起来 → 登录 QQ → 开启 OneBot 11 的 HTTP 服务 → 端口对上（或改插件里的地址）。 具体菜单名以它的文档为准：SnowLuma 仓库。

两个后端作者都实测过，接口对得上就能用。挑一个顺手的即可。

⚠️ 只有 HTTP 模式够用（插件不连 WebSocket）。开了 WS 但没开 HTTP 的话，插件连不上。

其它

• 桌面只留这个后端 + 本插件 + DSH。
• /receive 路由还留着，是想用别的方式（比如另一个程序）把 QQ 消息灌进来的备用入口，不依赖它也能跑。

改动记录

见 CHANGELOG.md。版本号规矩：每改一次 +0.0.1，末位满 10 进位。