DSH Plugins Marketplace

DSH Plugins

Plugins

/

napcat-qq-bridge

s

napcat-qq-bridge

Discovered

? QQ ?? DSH:NapCat + OneBot ??????????

napcat-qq-bridge

把 QQ 接进 DSH:一份踩过坑的现场记录。

status status status license

QQ 客户端一直在更新,NapCat 的注入补丁必须和具体的 QQ 构建号对上。对不上时不会报错,而是静默失败:QQ 正常启动、界面正常,但 6099 没有 WebUI、3001 没有 OneBot,NapCat 的日志一行都不出——你会以为是自己配错了。

这份记录把「哪个版本配哪个」写死了。

版本对照(看这张表就够了)

QQNapCat结果判断依据
9.9.33-522304.18.33✅ 能跑四个 preload 全绿 + WebUI 6099 起来
9.9.33-522304.18.42❌ worker fork 时 error code v2:-8,三次后主进程退出注入进了,校验没过
9.9.33-522304.18.30❌ 日志停在 Process resumed连版本识别都没到
9.9.37-54395任何版本❌ 版本表里没有这一档注入不生效

判别方法:看日志里有没有 [NapCat] [Core] NapCat.Core Version。有,就是真跑起来了;只有 [preload] succeeded 而没有 Core 那行,就是注入成功但 NapCat 没接管。

成功长什么样

启动日志

看到 WebUi User Panel Url 那一行(端口 6099,带 token),用浏览器打开它扫码登录——扫的是这个页面上的码,不是 QQ 客户端自己弹出的登录窗。扫错窗口会登录 QQ 本体,NapCat 完全不接管。

快速开始

# 1. 独立 QQ 副本(不动系统装的那份),解压到 D:\DSH\napcat\QQ-9.9.33
# 2. NapCat Shell 解压到 D:\DSH\napcat\NapCat.41833.Shell
# 3. 启动(隐藏窗口,不占任务栏)
powershell -NoProfile -ExecutionPolicy Bypass -File D:\DSH\napcat\launch-napcat.ps1 -QQ <你的QQ号>
# 4. 打开日志里的 WebUI 地址扫码
# 5. 登录后配 config\onebot11_<QQ号>.json 的 websocketServers 到 127.0.0.1:3001

完整步骤、环境变量、桥接设置接口的全部参数在 SKILL.md。

十一个坑

摘要,细节在 SKILL.md:

  1. QQ 单实例——系统里已有 QQ 在跑时,再启动副本会立刻退出
  2. 别手改 qqnt.json 的 version/verHash
  3. QQ 热更新会破坏组合
  4. launcher.bat 靠注册表反推 QQ 路径
  5. GitHub 直连不稳,用 gh-proxy.com 前缀
  6. OneKey 安装器不能并发跑
  7. 硬改 QQ 的 package.json 入口会触发完整性校验
  8. dbghelp 劫持与 QQNTPatcher 对 9.9.33 无效
  9. 硬杀 DSH 会清空 profile 的 bundles,插件全掉
  10. Windows PowerShell 5.1 写 JSON 会带 BOM,DSH 解析不了
  11. file: 安装的插件按 files 白名单裁剪,器官源码可能根本没装进去

适用边界

  • 只针对 Windows 桌面环境;服务器无桌面请直接用 NapCat 的 Docker 镜像
  • 是个人号的接法(OneBot / NapCat),不是官方机器人
  • 版本组合是 2026-11 的快照,QQ 一升级就可能失效——先回来看那张对照表

许可

MIT。踩坑记录随便用,能替你省掉一个通宵就算没白写。

Comments

Loading…

Similar plugins

dsh-qq-bridge

by cheems135

QQ (NapCat / OneBot 11) bridge for DeepSeek Harness - chat with your harness from QQ, with a full management panel

Tools & CapabilitiesManifest valid

★ 9

↓ 1k/wk

MIT

JavaScript

Nov 7, 2026

dsh plugin --profile web add dsh-im-bridge

by wzwei1990

NapCat / OneBot 11 QQ channel plugin for DeepSeek Harness(QQ 通道:私聊/群聊、@门控、白名单、每会话独立 agent、长文分段)

Manifest valid

★ 0

MIT

JavaScript

Oct 22, 2026

dsh plugin --profile web add dsh-napcat

by hyun20202023-ui

DSH-QQ bot 插件(OneBot v11 / NapCat)for DeepSeek Harness:人设、记忆、心情、学习表、联网、看b站,自带网页控制台。

Tools & CapabilitiesManifest valid

★ 19

MIT

JavaScript

Nov 16, 2026

dsh plugin --profile web add qfish

by Stella-Mira

DSH QQ 接管插件:OneBot v11 连接本机 NapCat,收发消息/好友/群/频道 + qq_ 工具集 + 自动应答

Manifest valid

★ 0

MIT

JavaScript

Nov 6, 2026

dsh plugin --profile web add mira_qqbot

by feely0208

深鲸 QQ 桥接:QQ 官方机器人 / OneBot v11 双通道 + 关键词规则自动回复 + 全量审计(DSH 插件)

Manifest valid

★ 0

MIT

JavaScript

Oct 30, 2026

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

by yunfengnobug

把 DSH 会话接到 QQ(OneBot/NapCat)的插件。白名单默认全关;被 @、叫到昵称或被戳一定叫醒,其余消息按可调概率抽样。Fork 自 sj244/dsh-qq-bridge(MIT)。

Notifications & IntegrationsManifest valid

★ 0

JavaScript

Oct 30, 2026

dsh plugin --profile web add @fengye_nobug/dsh-qq-bot