DSH插件测评:QQ 群里 @ 一下,DSH 在电脑上干活

看完你能把 QQ 私聊和群聊接成 DSH 的入口：3 步装好，命令照抄就能跑，建议先收藏。

一、它是什么

mario841859784/dsh-onebot 是 DSH 的 QQ 通道插件：按 OneBot 11 协议把 QQ 的私聊和群聊接进来，消息交给 DSH，回复、图片、文件再发回聊天窗口。npm 包名是 dsh-onebot-qq，BSD-3-Clause 许可。

装之前，大家一般两种凑合法：拿 NapCat 收消息，自己写一段脚本转发给模型；或者干脆用远程桌面、SSH 连回那台机器。两条路都能通，代价是断线重连、权限和发图要你自己兜。

截至 2026-11-14 05:00 抓取：GitHub 16 星、插件页 30 天下载 90,116、npm 最新 0.10.0（2026-11-10 发布）。星标少、下载多，说明它主要靠群里口耳相传。

二、能力与作用

• 反向、正向 WebSocket 二选一 → 你不用改 NapCat 的部署方式；边界：本机仍要另跑一个 OneBot 11 实现。
• 私聊、群聊都接，群里 @ 或引用机器人才触发 → 你不用怕它乱接话；边界：拿不到机器人 QQ 号时，一律当没 @。
• 权限分管理员、成员、受限三档 → 你不用给群里每个人开终端；边界：白名单得你自己填。
• 语音转文字、收图看图 → 你不用先打字；边界：要装 ffmpeg 和 whisper，可一键关掉。
• 长回复自动排版成文字图、可按段发 → 群里不会糊一脸 Markdown 符号；边界：Linux 得装 CJK 字体。
• 19 个斜杠命令、问题卡片回传 → 你不用守着网页审批；边界：命令默认只给管理员。

三、三个场景

独立开发者：你在地铁上，想让家里那台机器跑测试。动作是在 QQ 私聊里发一句需求、用斜杠命令看当前会话、末尾补一句「跑完把日志发我」。产出是执行结果或日志文件直接回到聊天窗口。依据：README「会话工作区」「斜杠命令速查」。

团队协作：群里同事想用 DSH，但你不愿把终端权限给所有人。动作是在设置页填管理员白名单、把其他同事设成成员或受限用户、群里 @ 机器人提需求。产出是成员只能问答、受限用户连文件操作都走不了，配置与终端挡在外面。依据：README「dm / group 访问策略」「群聊权限分档」。

非技术知识工作者：你不会配环境，也不想学命令行。动作是在群里发一段语音、补一句「整理成要点」、点问题卡片上的选项回答它的追问。产出是转写后的要点稿，或者一张排版好的文字图。依据：README「语音转写」「t2i 卡片」「ask_user_question 桥接」。

三个场景：独立开发者、团队协作、非技术知识工作者

四、对比与版本对应

| 维度 | dsh-onebot | 自写 NapCat 转发 | 远程桌面 / SSH | | --- | --- | --- | --- | | 消息入口 | QQ 私聊、群聊 | 自己接 WebSocket | 要装客户端 | | 断线处理 | 断线即失败、单任务重连 | 自己写 | 无 | | 权限 | 三档 + 管理员白名单 | 自己写 | 全权 | | 语音转写 | 本机 whisper，可关 | 自己接 | 无 |

版本对应：@deepseek-ai/dsh-agent、dsh-tools、dsh-session、dsh-llm 都要求 >=0.2.0-rc.1 <0.3.0-0 这一线，schemastery 要 ^3.18.0，另外 engines 里写着 node >=22。你现在这台宿主是 0.2.2-rc.1，落在 >=0.2.2-0 <0.2.3-0 段内，能装。

三种接入方式对照：入口、断线处理、权限范围

五、踩坑清单 + 三步上手

• 坑 1：图片下载 403。NapCat 会把链接里的 & 转成 &amp;，插件已替你反转义；还失败就看日志里的 media 下载行。
• 坑 2：文字图中文变豆腐块。Linux 没装 CJK 字体，apt install fonts-noto-cjk，再用 fontFiles 指到 SC 字体文件。
• 坑 3：崩溃循环。同一个插件文件被 insert 两次，去 patch 里查有没有重复条目。
• 坑 4：语音只留一个 [语音] 占位。ffmpeg 或 whisper 没装好，或转写超时，调大 sttTimeoutMs，或者直接关掉。
• 坑 5：peer 依赖解析失败。只复制 lib/ 不够，要跑 scripts/link-host.sh 把 @deepseek-ai/* 链到宿主装的那份。

它不解决什么，说清楚：QQ 官方机器人的审核与回调不归它管；群里各人的权限不会自动分级，白名单得你自己定。

三步：

踩坑清单与版本对应：五个坑 + engines 原值

想撤掉就 dsh plugin --profile web remove dsh-onebot-qq，重启 dsh web；mediaDir 下的临时媒体 6 小时后自己清。