dsh-qq：让 DeepSeek Harness 的 Agent 在本机 QQ 上收发消息并自动接话

它是做什么的？

它是 DeepSeek Harness（DSH）的 QQ 消息插件，让 DSH 里的 Agent 在本机 QQ 上收发消息、在群里自动接话，并附带一个网页管理面板。它解决的是 Agent 无法触达 QQ 群聊的问题：通道走本机 NapCat（QQNT + OneBot 11 HTTP），插件不加好友、不碰协议，只把 OneBot 的 HTTP 接口和事件推送接到 DSH 上。整个插件只依赖 Node 内置模块，没有第三方运行时依赖，由 ReWebaiyu 维护，采用 MIT 协议。

核心功能

• 六个 qq_* 工具：qq_status 做后端连通性、端口监听、登录号与延迟体检，qq_send_private / qq_send_group 按 QQ 号或群号发消息（群聊可 @ 指定成员），qq_history 读最近消息、会话与未读数。
• 群内自动接话：被 @ 或叫到名字必回，其余按概率只捡问句，回复走 DSH 当前默认模型，无需额外 key。
• 拟人与限流：默认限长 80 字，按字数算 0.7–5 秒打字延迟并加抖动，同群串行；每群每小时 8 条、全局 30 条、同群冷却 25 秒（被点名 8 秒）。
• 网页管理面板：概览今日回复与 Token、人设提示词编辑与「试说一句」预览、监听群与监听账号白名单、近 7 天用量柱状图、接话概率与冷却等设置，改完立即覆盖到运行时。
• 侧边栏集成：DSH 左侧栏出现 QQ 图标，点开即完整面板，可在设置里关掉「在侧边栏显示 QQ 面板」。
• 后端托管：面板可提权拉起 NapCat 并等 OneBot 端口就绪（最多 45 秒），未登录时自动弹扫码框。

怎么使用这个插件？

先在 DSH 中启用插件并重启，工具列表出现 qq_* 六个工具、左侧栏出现 QQ 图标。前提是本机跑着 NapCat：QQNT 加 NapCat.Shell，以管理员身份运行启动脚本首次扫码登录，并在 OneBot 配置里打开 HTTP 服务端与事件推送。接着把 token、NapCat 安装路径、要接话的群号填进你自己的 profile patch，按 id: qq 覆盖 config，其中 eventToken 必须留空，因为 NapCat 的事件推送不带 Authorization。之后打开管理面板，用顶栏状态点判断连接情况：绿点已连接，黄点可点「扫码登录」，红点可点「启动后端」。日常调人设、白名单、接话概率和冷却都在面板里改，配置与用量落在 data/admin.json。

报错怎么排查？

改完插件代码后若提示已安装，说明 ESM 缓存未刷新，需要先移除再重新安装组合包，单纯重装会报 already-installed；只改面板 HTML 则不用重启，刷新页面即可。事件监听端口改动后要同步改 NapCat 的事件推送地址并重启 NapCat，否则收不到群消息。扫码登录拿不到二维码时，NapCat 刚启动 WebUI 可能尚未就绪，可稍后重试或直接看 NapCat 控制台窗口里的二维码。