mira_qqbot
在终端中运行以下命令:
dsh plugin install Stella-Mira/mira_qqbot
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install Stella-Mira/mira_qqbot 安装本插件(源码:https://github.com/Stella-Mira/mira_qqbot),并需同时安装 mira_account。
插件介绍
如果你希望把「自己正在用的 QQ」交给 DeepSeek Harness 里的模型来协助收发、查资料、处理群务,而不是另起一个无关的机器人账号,mira_qqbot 就是协议层桥梁:它通过 OneBot v11 正向 WebSocket 连到你本机 NapCat,把平台事件转成 DSH 能调用的 qq_* 工具,同时负责与 OneBot 的收发、媒体与常见管理动作。
从 1.18.0 起,本插件刻意只做协议与投递语义:账号池、会话绑定、入站路由、message_id 去重与限流都交给配套的 mira_account。已绑定的对话由本插件实现排队或插话、忙时提示、超时取消,以及 /stop、/new 等控制;出站发送会先完成绑定再投递,错误也统一成可读的 code,方便模型和你在 qq_status 里排查。
核心能力覆盖私聊与群聊(可按 @、关键词或白名单控制是否应答)、好友与群列表、群成员与禁言等管理、本地或 TTS 语音、增量拉取缓冲消息,以及通用 qq_api 逃生舱。配置集中在 DSH_HOME 下的 config.json,必填 wsUrl 指向 NapCat,不猜地址、不静默降级。
适合已经在用 NapCat(或兼容 OneBot v11 正向 WS)托管自己 QQ、并愿意同时安装 mira_account 的 DSH 用户:想让人工智能代写回复、旁听群聊、或在工作流里程序化发消息,又不想维护第二套会话映射表的人。
使用场景
- 让 DSH 模型通过 NapCat 代回私聊与群消息,并按 @、关键词或白名单控制是否应答
- 在工作流里用 qq_* 工具查好友群成员、发媒体、处理加群与禁言等日常管理
- 需要增量拉取缓冲消息或旁听绑定会话,由 agent 协助整理群聊上下文
适合人员
- 已在本地跑 NapCat、用 OneBot v11 正向 WS 托管自己 QQ 的用户
- 愿意同时安装 mira_account、用统一绑定表管理多平台会话的 DSH 用户
- 希望 AI 协助私聊与群务、又不想维护旧 chatId 映射的进阶玩家