dsh-qq-hub

DSH QQ Hub

把 QQ 私聊和群聊接入 DeepSeek Harness（DSH）。插件运行在 DSH 所在设备上，支持 fnOS NAS、Windows、Linux 和 Docker 部署。

当前版本：v1.3.65-test.20261110.5（预发布）。版本历史见 [CHANGELOG.md](CHANGELOG.md)。

能做什么

• QQ 聊天：支持主人私聊、白名单私聊和白名单群聊；群里可被 @、引用或唤醒词触发。
• 图片、语音和文件：看图、语音转文字、发送语音/表情/文件，读取引用和合并转发。
• 人格与记忆：可更换人格；按聊天隔离记忆，支持长期记忆和主动搭话。
• 远程协助：主人可在 QQ 私聊中使用 DSH 的模型和已授权工具，接收提问卡片并审批高风险操作。
• 定时与主动任务：支持提醒、定时分享、QQ 空间日记和动态互动。
• 可选内容模块：B 站、抖音、小黑盒、RSS、贴吧阅读、生图和翻唱等可按需启停。
• 自行扩展：可在数据目录添加模块，无需修改插件源码；支持热重载和面板模拟测试。

默认不会向所有私聊和群开放。机器人账号、主人账号、可用私聊和群都需要明确配置。

安装前准备

需要：

1. 已安装并能正常使用 DSH，已配置可用模型。

2. 一个作为机器人使用的 QQ 小号。

3. 一个兼容 OneBot v11 的 QQ 网关：

• 已有 NapCat、LLOneBot、Lagrange 等服务时，直接使用其正向 WebSocket 地址。
• Windows 也可使用 [SnowLuma](https://github.com/SnowLuma/SnowLuma/releases)，由插件辅助启动和接入。

OneBot 是插件与 QQ 网关之间的通信协议。它本身不是 QQ 登录服务，仍需单独安装和登录网关。

安装

在线安装

Windows 桌面版：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add github:lecheng2018/dsh-qq-hub

fnOS、Linux 或 Docker 命令行：

dsh plugin --profile <你的-profile-名称> add github:lecheng2018/dsh-qq-hub

离线安装

从 [Releases](https://github.com/lecheng2018/dsh-qq-hub/releases) 下载所需版本的 .tgz，然后执行：

dsh plugin --profile <你的-profile-名称> add ./dsh-qq-hub-<版本号>.tgz

也可以在 DSH 的插件安装界面中选择该文件。安装后重启 DSH。

第一次配置

打开 DSH 左侧「自动化任务」中的 QQ Hub，按设置向导完成：

1. 填写机器人 QQ 小号和你自己的主人 QQ 号。

2. 选择网关：

• 已有 OneBot 服务：填写正向 WebSocket 地址；如果网关启用了访问令牌，也填写对应令牌。
• Windows SnowLuma：填写安装目录，启动服务，阅读并同意其协议，再接入已登录机器人小号的 QQ 进程。

3. 添加允许使用的私聊和群。主人私聊不需要重复添加。

4. 检查网关是否已连接，以及插件核对出的登录号是否为机器人小号。

5. 先保持 试运行 开启，用主人账号发一句「在吗」。

试运行时，插件会处理消息并记录准备发送的内容，但不会真的发到 QQ。确认回复、权限和日志正常后，打开总开关并关闭试运行。

fnOS / Docker 网络注意事项

• 如果 DSH 和 QQ 网关不在同一容器或同一设备，不要使用 127.0.0.1。
• 应填写网关所在设备或容器实际可访问的地址，并确认端口和容器端口映射已开放。
• 使用域名访问 QQ Hub 面板时，需要把域名加入 config.json 的 security.panel.allowedHosts；直接通过设备 IP 访问不需要这一项。

日常使用

在 QQ 中管理

以下命令只接受主人发送。即使总开关关闭，也可以用 /on 恢复。

| 命令 | 用途 |

|---|---|

| /help | 查看当前可用命令，包括扩展命令 |

| /status | 查看连接、收发和运行状态 |

| /on、/off | 打开、关闭插件总开关 |

| /silent [分钟] | 当前聊天暂停发言，可设自动恢复时间 |

| /active | 恢复当前聊天 |

| /quiet、/chatty、/normal | 调整当前群的插话档位 |

| /model | 查看模型；/model 序号 切换，/model 默认 跟随 DSH |

| /remember 内容 | 在当前聊天的作用域中记住一件事 |

| /reset | 清空当前对话上下文，不删除长期记忆 |

| /new | 清除当前聊天的记忆，不动对话历史 |

| /diary | 立即写一篇 QQ 空间日记 |

| /remind … | 创建或管理提醒；用 /help 查看具体格式 |

| /approvals | 查看等待审批的高风险操作 |

在面板中管理

• 连接：网关、工作区和连接诊断。
• 权限：私聊/群白名单、主人权限和各模块操作权限。
• 人格：编辑、切换或按聊天指定人格。
• 模型：选择全局或按聊天使用的模型。
• 群聊：插话概率、唤醒词、发送配额和单群设置。
• 扩展：启停、复制、新建或模拟测试模块。
• 日志：查看连接、投递和错误信息。