把 dsh 接进 QQ:dsh-im 插件与 NapCat 实战
路线 A 装插件扫码、路线 B 挂 NapCat 协议端——9 张帧检截图逐步跟做,每步深链回源视频。
最近更新: 2026-10-03
「dsh 能挂 QQ 机器人吗?」能,而且有两条路线。路线 A 是开源插件 dsh-im(GitHub 实查 xmanrui/dsh-im,★1.6k,MIT):一条命令装好后,在设置里扫码就能把 IM 机器人接进 DeepSeek Harness,QQ 与微信、飞书、钉钉、企业微信、Telegram、Discord、WhatsApp、Slack 同列九大通道。路线 B 再加一层 NapCat——QQ 客户端的社区协议端,实战录像里的群级 bot 能力(入群、群友画像)走的就是这条路。
下面 9 张截图全部取自两支实录视频并逐帧复核,每张都深链回源视频的对应秒数。同一个插件在微信/飞书侧的用法,见微信接入指南。 微信接入:同一个插件的微信轴
太长不看
- ▸路线 A:一条命令装 dsh-im → 设置 → 插件 → IM 机器人 → 扫码,QQ 是 9 通道之一(微信/飞书/钉钉/企微/QQ/TG/Discord/WhatsApp/Slack)。
- ▸路线 B:NapCat(★10.8k 的 QQ 协议端)+ dsh webui 的「QQ 聊天」工作区,消息以会话形式落进 dsh,实测缓存命中 80%。
- ▸实战实录:bot 以成员身份入群、私聊双向收发图片和 10 秒语音、跨会话操作,群友关系图 18 人 · 16 关系。
- ▸名词表:dsh-im 是插件,NapCat 是协议端(非插件),MoonBot 是 UP 自制面板(无公开仓库),别拿去搜。
从零到 QQ 机器人,9 步跟做
路线 A:dsh-im 插件(官方通道)
- 1
安装 dsh-im 插件
README 给了两条等价命令:npx -y github:xmanrui/dsh-im install 一行装好,或走插件市场 dsh plugin --profile web add @xmanrui/dsh-im。如果之前直接装过 dsh-feishu、dsh-weixin、dsh-dingtalk,安装器会把它们替换成 dsh-im,原有渠道配置和密钥继续沿用。
$npx -y github:xmanrui/dsh-im install$dsh plugin --profile web add @xmanrui/dsh-im
README 给的两条安装路径,任选一行都能装上。看源视频 0:52 - 2
扫码接入:设置 → 插件 → IM 机器人
重启 dsh web 后,设置里多出「IM 机器人」面板:九个平台各自扫码绑定。录像里微信机器人已接入,卡片显示「运行正常 · 消息通道 iLink 长轮询 · 1/1 在线」;QQ 同样扫一下就接上。接入后收到消息会先显示已读和「正在输入」,再把 Harness 的最终回答发回来。
扫完码卡片就变绿:运行正常,1/1 在线。看源视频 0:14
路线 B:NapCat 协议端
- 3
认识 NapCat:QQ 客户端协议端
路线 B 从更底层开始。NapCat(NapNeko/NapCatQQ,★10.8k)实现了 QQ 客户端协议,它的 WebUI(127.0.0.1:6099 带 token)集中管理 bot 账号与版本——录像里 NapCat 4.9.49、QQ 9.9.26,2 个网络配置挂 1 个 HTTP 服务器和 1 个 WebSocket 服务器。dsh 不直接碰这层,NapCat 负责把 QQ 翻译成普通消息源。
NapCat 跟 QQ 客户端并肩跑,网络侧就在这个 WebUI 里接。看源视频 3:16 - 4
看 QQ 消息落进 dsh
NapCat 接好后,dsh webui 多出一个「QQ 聊天」工作区:私聊和群聊以会话形式出现,角色卡(SPEECH RULES)自动注入,日志里滚动 [Wake] private:… sleep ended 这样的唤醒事件,状态栏实测 1 轮 1 步、首 token 0.6 秒、缓存命中 80%。对 dsh 来说,bot 只是又开了一个聊天窗口。
看不见胶水代码——QQ 消息自己变成了 dsh 的会话。看源视频 3:24
实战:配置、人设与群友画像
- 5
实测能力:入群、图片、语音
录像里 bot 以「DeepSeek Harness」的名字出现在 5 人群的成员列表里;私聊双向收发一张图片和一条 10 秒语音;作者原话「理论上所有操作都是可跨会话的」,让它联网搜索也行——「可以,就是不一定准确」。彩蛋是 QQ 空间:bot 自己以第一人称发了 ATRI 日记。
入群是成员,私聊能收图收语音。看源视频 2:00 - 6
配置 bot 行为开关
MoonBot 面板(UP 自制,见 FAQ)展示了群 bot 的关键开关:启用整套智能体、连回合注入、只对私聊保持(最多来回 24 次,空闲 1,800,000 毫秒关闭),好友申请与信任(自动同意好友 + 好友守卫),外加 Word 文档额度 100000。
回合数、好友信任、额度——让 bot 不吵不闹的开关全在这。看源视频 3:36 - 7
给 bot 一份常驻人设
一块面板定义 bot 是谁:常驻自动化引导加自由填写的提示词,保存一次全聊天继承。bot 说话多正式、多贫、多简短,都在这里定——QQ 群聊生态很吃人设这一套。
人设只设一次,所有聊天共用。看源视频 4:00 - 8
读懂群:群友关系图
在群里跑一阵后,面板画出群友关系图——录像里 18 人 · 16 关系,互动强度用连线粗细编码,图例分主人、群主、管理员、私聊。点任何一个人,直接弹出档案。
几个星期的群聊,浓缩成一张社交地图。看源视频 4:45 - 9
打开成员档案
每个成员的弹窗把聊天风格概括放在上面,互动记录时间线和关系网垫在下面——上一步那张图的数据源就在这里。这些数据 dsh 本来就看得到,只是换成人能读的排法。
点一下圆点,bot 就告诉你这人是谁、平时怎么说话。看源视频 4:50
常见问题:把 dsh 接进 QQ
接入之前,大家真正会问的六个问题。
dsh 能挂 QQ 机器人吗?
能,两条路线。路线 A 装 dsh-im 插件(一条 npx 命令),在「设置 → 插件 → IM 机器人」扫码接入,QQ 是九个通道之一;路线 B 在 dsh 前面挂 NapCat 协议端,本页实战录像里的入群、群友画像等群级能力走的就是这条路。两条路线可以只用一条,也能组合。
dsh-im 和 NapCat 有什么区别?该选哪个?
dsh-im 是 dsh 插件,走各平台官方通道扫码接入,九个平台含 QQ、微信、Telegram、Discord,装上就行;NapCat(NapCatQQ)根本不是 dsh 插件,它实现的是 QQ 客户端协议,录像里配合 dsh 做出更「QQ 原生」的群行为。要省事选 dsh-im,要群级 bot 能力再加 NapCat。
NapCat 是腾讯官方的吗?可靠吗?
不是。NapCat(GitHub:NapNeko/NapCatQQ,★10.8k,TypeScript)是社区开源项目,在 NTQQ 之上实现现代协议端,与腾讯和 DeepSeek Harness 都无关联。绑定真实 QQ 号前请自行评估风险并遵守 QQ 服务条款;本页只引用其公开演示画面。
接入之后,QQ 机器人能做什么?
录像实测:以普通成员身份入群、私聊双向收发图片和 10 秒语音、「理论上所有操作都是可跨会话的」、被要求时联网搜索(作者原话「可以,就是不一定准确」),还会自己发 QQ 空间日记;群友关系图 18 人 · 16 关系,点人看档案。你的 dsh 模型和插件全部照常生效——bot 只是消息进 harness 的另一扇门。
MoonBot 是插件吗?去哪下载?
不是。MoonBot 是视频作者(等一只萝卜子)给自己部署做的控制面板,没有公开仓库,也装不了。公开可复现的路径是 dsh-im(官方通道)+ NapCat(协议端);MoonBot 的截图当作「这套组合能做到什么」的演示看就好。
除了 QQ,dsh 还能接哪些聊天软件?
dsh-im 一次带九个通道:微信、飞书、钉钉、企业微信、QQ、Telegram、Discord、WhatsApp、Slack。海外用户 Telegram 和 Discord 门槛最低,同一个扫码面板通用;微信/飞书侧的逐步教程见本站微信接入指南。
相关攻略
接着看:站内更多 dsh 攻略与合集。
微信接入:同一个插件的微信轴
同一个 dsh-im 插件在微信/飞书侧的接法——扫码配对、手机端审批、bot 回复,一步步实录。
阅读指南插件安装指南
dsh-im 只是插件生态的一员:安装机制怎么运作、第三方代码装前怎么审,一篇讲清。
阅读指南dsh Web UI 图文指南
「IM 机器人」面板和「QQ 聊天」工作区都在 webui 里:启动、3080 端口与面板地图,一次看全。
阅读指南局域网访问与端口
QQ bot 默认只见本机的 dsh;想把 webui 开给局域网设备,防火墙和端口一篇讲透。
阅读指南公网远程访问
超出局域网:隧道与 token 让你从外网够到 dsh——把 bot 指过去之前,先掂量暴露面。
阅读指南远程与移动合集
手机、隧道、扫码配对类插件合集——聊天侧接入之外的全套远程玩法。
阅读指南来源与署名
全部截图取自两支第三方实录并逐帧复核,每张图都深链回源视频的对应秒数。竖片 dsh-im 源经裁修(黄底标题/字幕横幅全部未取帧);NapCat 实录的水族馆壁纸经窗口紧裁去除。MoonBot 面板为视频作者自制,无公开仓库。仓库名与 star 已于 2026-10-03 经 GitHub API 复核:xmanrui/dsh-im(★1,589,MIT)、NapNeko/NapCatQQ(★10,830)。