前言¶

在 DeepSeek Harness（DSH）中使用 agent 时，常见需求不只是在 Web UI 里对话，而是把同一套 agent 能力接到 QQ 单聊、群聊和频道中：接收消息、回复消息、按会话保留上下文、处理图片与附件、做访问控制和审批。

dsh-qqbot-community 为 DSH 提供 QQ 官方机器人的接入能力。

这是什么¶

dsh-qqbot-community 由 DLive 维护，许可证为 MIT。资料说明其核心接入、网关与会话管理逻辑源自 openclaw-qqbot，并遵循原项目的 MIT 许可证。

已核实资料同时提醒：整体功能未严格测试，部分功能可能不稳定。

核心能力¶

消息与会话¶

• QQ 官方机器人接入
• 消息收发
• 会话管理
• Agent preset 挂载
• 沙箱支持

网关与上下文¶

• 网关可靠性：WebSocket 心跳、断线重连退避、会话 RESUME
• @mention 清洗
• 引用消息上下文

媒体与出站回复¶

• 图片理解
• 语音转写（STT）
• 附件落盘
• 富媒体发送
• 流式回复（C2C）
• 出站合并与分段
• 被动回复限额
• typing 指示

控制与扩展¶

• 访问控制
• 审批桥（inline keyboard）
• ask_user_question 转发
• QQ API 代理工具 qq_api
• 斜杠命令
• 定时提醒
• HTTP 推送 API（httpApi，默认关闭）

安装与启用¶

接入 DSH profile 时，资料给出以下命令：

dsh plugin --profile web add dsh-qqbot-community

按 npm 包安装时，资料还给出：

npm install dsh-qqbot-community

运行依赖方面，已核实资料显示 package.json 声明 Node >=20，peerDependencies 需要 @deepseek-ai/cordis ^4.0.1。

启用前需要把 QQ 机器人相关配置追加到 profile 的 patch 文件中。资料给出的位置是：

~/.dsh/profiles/web/cordis.patch.yml

在已有内容末尾追加 qqbot-community 的配置层，例如配置 id、secret、sandbox 等：

- id: qqbot-community
  name: dsh-qqbot-community
  config:
    id: '你的 AppID'
    secret: '你的 AppSecret'
    sandbox: true

这里的 id 和 secret 对应 QQ 官方机器人凭证，sandbox 用于声明沙箱场景。

典型用法¶

完成插件安装与配置后，启动 DSH：

dsh web

启动后会执行：获取 token、建立 WS 网关，并按会话创建或恢复 agent。

在 QQ 会话中，资料给出了按指定 preset 开启新会话的示例：

/new code

该用法用于以指定 preset 开启新会话。

适用场景与注意¶

这个插件适合已经使用 DSH，并希望把 DSH agent 能力接入 QQ 官方机器人的开发者。

使用前需要注意：

• 插件会随当前 dsh 进程运行，能读取 profile 配置、调用 DSH agent 能力并处理 QQ 消息；安装前应检查源码与许可证。
• 整体功能未严格测试，部分功能可能不稳定。
• markdown、消息按钮权限、QQ 特批 GROUP_MESSAGE_CREATE 等能力属于可选、未迁移或可能受限能力，不要默认一定可用。
• 资料明确不迁移 Webhook transport、热升级、pairing 配对流、credential-backup、群自主模式、群历史缓冲注入等。
• HTTP 推送 API（httpApi）默认关闭；已核实资料只说明它用于外部系统向指定 QQ 通道推送文本，完整端点与参数未在给定资料中完整确认。

获取¶

目录页：

https://www.skillhub.cn/plugins/DLive/dsh-qqbot-community

GitHub 仓库：

https://github.com/DLive/dsh-qqbot-community

这是社区插件页面，不属于官方应用商店。