🐟 qqbot-plugins — AI QQ 机器人插件市场

给你的大肥鱼一个完整的人生。 给「SnowLuma + qq-bridge + DSH（大肥鱼）」这条链路补上记忆、声音、画笔，和一双能干活的手。

按抖音上很火的那套教程把 DeepSeek 接进 QQ 之后，你会发现一个问题—— 它会说话，但没有生活。 你让它"禁言这个人十分钟"，它只能回你一句解释； 你跟它聊三天，它转头就忘了你是谁。

这个市场就是它的人生补丁：46 个插件 / 75 项能力，网页上点一下安装， 就变成 AI 能自己调用的工具（mcp__qqbot__*）。从此它记得住你（长期记忆）、 开得了口（语音合成）、画得了画（文生图）、管得了群（禁言/踢人/公告）， 还会查天气、记账、发提醒、陪人玩成语接龙。

QQ  ⇄  SnowLuma  ⇄  qq-bridge  ⇄  DSH（大肥鱼）  ⇄  DeepSeek
                                        │
                                        └── ⇄  qqbot-plugins（MCP 插件层）
                                                46 个插件 / 75 个工具

零第三方依赖 · 一个命令启动 · 网页里配置 · MIT 开源

这是什么

一句话：它是那条抖音教程链路的官方「插件补充包」。

教程做到的是「QQ 消息 ⇄ DeepSeek 对话」。但它没解决「AI 怎么操作 QQ」—— 不能发消息、不能禁言、不能查群成员、不能记账。而这些恰恰是群友最想要的功能。

它不改你的教程环境。 不 fork qq-bridge、不往它的目录塞文件、不动 SnowLuma 配置， 只是在 DSH 的 cordis.patch.yml 里并列追加一个 MCP 服务器——和官方 mcp__snowluma__ 用的是同一份文件、同一种格式，互不冲突。

• 市场侧：登录 → 浏览/搜索 43 个插件 → 一键安装/卸载/启停/配置，实时探测链路状态

• AI 侧：node scripts/register-dsh.mjs desktop 把市场注册进 DSH → 重启 DSH → AI 工具列表里出现全部已装插件

• 配置侧：连接渠道（OneBot 地址/Token）、群管理白名单、默认城市等，全部在网页里填，改完立即生效

• 安全侧：踢人/全体禁言等危险操作必须 confirm=true；群管理还支持管理员 QQ 白名单与「只允许操作的群」双重护栏

「装到 QQ 上」到底是什么意思

不需要把插件文件复制进 qq-bridge 目录。插件由市场自己的进程（mcp-server.mjs）提供，DSH 通过 MCP 标准协议调用它，插件再通过 SnowLuma 的 OneBot API 操作 QQ。所以：

• 装插件 = 在市场点「安装」（只改一个状态文件，不往别人的仓库里塞东西）

• 生效 = 重启 DSH（AI 的工具列表在启动时加载）

• 卸载 = 点「卸载」再重启，工具就从 AI 手里消失了

Related MCP server: qq-mcp-server

快速开始

# 0. 前置：已按教程跑通 SnowLuma + qq-bridge + DSH（DSH 里发一句话有回复）

# 1. 拉取并启动市场
git clone https://github.com/xiazhuo123456789/qqbot-plugins.git
cd qqbot-plugins
node server.js
# 浏览器打开 http://127.0.0.1:3210

# 2. 填连接渠道（推荐在网页里点「连接设置」；也可以复制配置文件手改）
copy config.example.json config.json

# 3. 搭桥：把市场注册进 DSH（profile 名看 ~/.dsh/profiles/ 下的子目录名）
node scripts/register-dsh.mjs desktop

# 4. 【关键】完整退出并重启 DSH（MCP 只在启动时加载）
#    然后在 DSH 里搜 mcp__qqbot__ —— 能搜到即搭桥成功 ✅

# 5. 链路体检（随时可跑）
node scripts/doctor.mjs

之后在 QQ 里对机器人说"帮我禁言他十分钟""查下北京天气""开一局成语接龙"，AI 就会自己调用对应插件。

配置（都在网页里填）

1）连接设置 —— 插件和 QQ 通信的渠道

左侧导航点「连接设置」，或搭桥区点「连接设置」：

改完立即生效——mcp-server.mjs 每次被 AI 调用时都会重新读这份配置，不用重启 DSH（只有增删插件才需要重启）。

2）插件配置 —— 群管理等需要权限的插件

有配置项的插件，卡片上会多一个「⚙ 配置」按钮。目前：

group_admin（群管理）

weather（天气）：默认城市，群友只说"今天天气怎么样"也能直接查。

白名单是"防误操作"的护栏，不是绝对安全边界——operator_id 由 AI 传入。真正兜底的是机器人自己的群权限（SnowLuma 侧）和只在可信群里使用。要加新的可配置插件，看 docs/PLUGIN_SPEC.md 里的 settings 声明方式。

插件一览（43 个）

合计 46 个插件 / 75 个工具。分类与数量由 data/plugins.json 统一驱动，市场页面按此分组筛选。

插件来源与实测

这一节把话说清楚，避免误会。

来源：目录是收集的，代码是本项目重写的

所以准确的说法是：目录来自网络社区，实现由本项目重写——不是"把网上的插件原样搬过来"。 好处是全部零依赖、直接能跑、不受上游框架版本影响；代价是行为细节以本项目实现为准。

实测：75 个工具全部跑过一遍

node scripts/verify-plugins.mjs          # 跑全部插件
node scripts/verify-plugins.mjs --json   # 输出机器可读结果

最近一次结果（本机、未开 QQ）：

脚本会自动把存储重定向到临时目录，不会污染你的真实数据；你可以随时自己跑一遍复核。

边界：哪些事它做不了

• 不抓版权内容：点歌插件只返回网易云/QQ音乐/酷狗的搜索链接，不下载音频

• 群管理受权限限制：机器人本身得是群管理员，SnowLuma 的 HTTP API(3000) 必须开着

• 联网插件依赖公开接口：断网或接口挂了会明确告诉你失败，不会假装成功

• 管理员白名单是护栏不是铁门：operator_id 由 AI 传入，真正兜底的还是机器人自身群权限 + 只在可信群使用

与「大肥鱼」的关系

抖音上那套「大肥鱼」机器人（Gitee: luo_sang/qqbot）是一个单体的 Python 程序 （bot.py + persons.py），能力包括对话、语音、表情包、心情状态机、人物记忆、主动发消息、视频生成等。

需要说明的是：它没有插件系统，没有 plugin/ 目录，也没有插件 API 或钩子， 功能扩展只能改配置或用它内置的模块。所以「把它的插件导入这里」这件事做不到—— 它根本没有插件形态，而且 Python 单体程序和这里的 Node MCP 工具不是一回事。

两者的关系是互补：

• 大肥鱼负责「像人一样聊天」：人格、语气、记忆、心情、语音、表情包

• 本市场负责「替人办事」：查数据、管群、记账、玩游戏、定时提醒

本项目与该开源项目没有隶属关系，未使用其代码、素材或预设，只作为它生态里的第三方插件补充； 「大肥鱼」在这里是对该机器人项目的指称。

如果你的 DSH 用的就是大肥鱼那套人格预设，本市场挂在同一台机器上即可， DSH 会同时加载人格和这些工具——它既能用大肥鱼的口吻说话，又能真的动手做事。

插件灵感与能力对标 AstrBot / NoneBot / Koishi / Yunzai 生态的同类插件（目录数据中保留了对应上游出处），但实现全部为本仓库原创、零依赖、面向 MCP 工具调用设计。部分联网插件使用免费公开接口（Open-Meteo / er-api / nbnhhsh / B站 / 必应），无需任何 API Key。

搭桥原理（为什么能和教程里的方法连起来）

详见 docs/BRIDGE.md。一句话版本：

1. qq-bridge 官方通过 ~/.dsh/profiles/<profile>/cordis.patch.yml 给 DSH 挂 MCP 服务器（snowluma、web-search-safe 等）；

2. 本项目用同一配置文件、同一格式追加一个自己的条目 mcp-qqbot（serverName qqbot），指向本仓库的 mcp-server.mjs（stdio JSON-RPC）；

3. DSH 启动时加载它，全部已安装插件的工具以 mcp__qqbot__<tool> 出现；

4. 插件内部需要操作 QQ 时，走 SnowLuma 的 OneBot HTTP API（端口 3000）——和 qq-bridge 用的是同一条通道。

所以：不 fork qq-bridge、不改它任何文件、不和它的 MCP 冲突，教程链路原样保留，只做加法。

开发自己的插件

看 docs/PLUGIN_SPEC.md。一个插件 = 一个 .mjs 文件：

export default {
  meta: { id: 'hello', name: 'hello', description: '打招呼', category: '娱乐' },
  tools: [{
    name: 'qq_hello',
    description: '跟某人说你好',
    inputSchema: { type: 'object', properties: { who: { type: 'string' } }, required: ['who'] },
    run: async ({ who }) => `你好，${who}！`,
  }],
};

放到 plugins/ 下、在 data/plugins.json 加一条，市场里就能看到、AI 里就能用。ctx 注入 ctx.onebot(action, params)（OneBot 调用）与 ctx.storage（持久化）。

目录结构

qqbot-plugins/
├─ server.js            市场服务端（登录/API/体检/搭桥，零依赖）
├─ mcp-server.mjs       MCP stdio 服务器（暴露插件工具给 DSH）
├─ plugins/             43 个插件（每个 .mjs 自包含）
├─ data/plugins.json    插件目录数据
├─ scripts/
│  ├─ register-dsh.mjs  写 cordis.patch.yml 搭桥（自动备份/幂等/--remove）
│  └─ doctor.mjs        四关体检（DSH/SnowLuma/bridge/工具数）
├─ public/              市场前端（原生 HTML/JS，暗色主题）
└─ docs/                搭桥原理 & 插件开发规范

常见问题

安全提醒（和教程一致的三条）

1. 白名单填具体：机器人能操作群管理，务必只在可信群里使用；

2. 用小号：机器人自动行为容易触发风控；

3. 危险操作有确认：踢人/全体禁言/设管理员要求 confirm=true，出现意外行为可在市场里一键停用插件。

交流群

插件开发、使用答疑、踩坑互助，都在这儿：

QQ 群：973971153（点群号复制，QQ 里搜索加入）

群里会同步插件更新、收集新插件需求。想加插件但不会写的话，把"想要什么功能"发群里就行； 自己写好了想合并进主仓库，也欢迎直接提 PR。

记忆 / 语音 / 画画（三个进阶能力）

这三个是后来加的，正好补上「机器人像个活人」的部分。

memory —— 长期记忆

机器人能记住关于每个人的事，并在被问到时想起来。

不依赖向量库和 Embedding 模型——用「中文二字切片 + 时间半衰期衰减」做检索，纯 JSON 存在本机 data/store/memory/，装好就能用。数据不上传任何地方，可随时清空。

对标 AstrBot 社区的记忆插件（memory_beyond、 iris_memory、 mnemosyne），实现是本项目重写的零依赖版。

voice —— 语音合成（TTS）

qq_tts 把文字合成语音，直接作为语音消息发到群里。走 OpenAI 兼容的 /audio/speech，所以这些都能接：

装好后在卡片点「⚙ 配置」填接口地址、Key、模型、音色。没填 Key 时工具会明确提示，不会静默失败。

QQ 语音对编码有要求（silk/amr）。多数 OneBot 实现会自动把 mp3 转码；若协议端报错，去协议端开启语音转码。 参考 qq-bridge 的 Edge TTS 语音回复 PR #74 与 edge-tts。

imagine —— AI 画画

qq_imagine 说一句描述就出图并直接发到群里。两种后端，配置里切换：

免费后端限流比较严格，连续狂发会被 402。插件对同一句描述做了 10 分钟缓存， 真被限流时会告诉群友"稍等十几秒再要"，而不是报错刷屏。 参考 Pollinations 与 Yunzai 的 ap-plugin。

版权与第三方说明（不侵权）

本项目从零实现，可以放心使用和二次分发：

字体走系统字体栈，不发网络请求；不抓取任何版权音视频内容（点歌插件只返回平台搜索链接）。仓库整体采用 MIT 协议。

License

MIT © 2026 xiazhuo123456789