DeepSeek-harness-qqbot DSH 插件

该插件将腾讯 QQ Bot 与 DeepSeek Harness 连接，实现 QQ 私聊和群聊消息与持久化 Harness 会话的交互。支持图片附件、文件发送、Markdown 回复以及通过 QQ 按钮进行审批。

如何安装 DeepSeek-harness-qqbot DSH 插件

dsh plugin --profile web add github:sliverp/DeepSeek-harness-qqbot

复制不会执行命令。安装 DeepSeek-harness-qqbot DSH 插件前请核对仓库和版本。

DeepSeek-harness-qqbot DSH 插件数据来源

DeepSeek-harness-qqbot DSH 插件快照日期：2026年8月16日

discovered

DeepSeek-harness-qqbot DSH 插件能做什么

通过官方 QQ Bot Gateway 处理私聊和群聊文本消息
接收 PNG、JPEG、WebP 和 GIF 图片作为持久化 Harness 附件
模型不支持图片时自动降级为纯文本
输出助手文本、图片和本地工作区文件
QQ 作用域的 `qq_send_file` 工具，包含工作区限制和文件大小检查（最大 100 MiB）
默认启用 QQ Markdown 回复
每个私聊或群聊会话对应一个持久化 Harness 会话
与 Web 会话相同的 agent 预设组合，包括工具、提示词和技能
通过 QQ 按钮进行主动审批提示，包含“允许一次”和“拒绝”选项及超时
斜杠命令：/bot-ping、/bot-image-test、/bot-file-test、/bot-help、/bot-status、/bot-cancel
通过 Harness 凭据服务解析密钥，无需插件配置
未配置 AppID 或 AppSecret 时静默启动，不阻塞 DSH

DeepSeek-harness-qqbot DSH 插件适合哪些场景

通过 QQ 运行持久化 Harness agent，无需打开 Web 界面
在 QQ 中发送图片、文件，并接收 Markdown 格式的回复
通过 QQ 按钮实现敏感 agent 操作的审批流程
创建同时支持文本和图片输入且自动降级的机器人
管理多个会话，每个用户或群组拥有独立的持久化会话

DeepSeek-harness-qqbot DSH 插件适合谁

构建集成 DeepSeek Harness 的 QQ 机器人的开发者
希望通过 QQ 而非 Web 界面与 AI agent 交互的用户
需要在 QQ 中直接审批 agent 操作的团队

DeepSeek-harness-qqbot DSH 插件的限制

需要 Node.js 22.19+、pnpm 10.33.4 和 DeepSeek Harness 0.1.0-rc.6 或更高版本
需要 QQ Bot AppID 和 AppSecret，并启用私聊/群聊消息事件；审批按钮需要内联键盘权限
仅支持官方 QQ Bot Gateway，不支持其他消息平台
文件发送限制为每个文件最大 100 MiB，且仅在处理当前 QQ 消息时可用
图片输入模式设为“always”时，对于不支持图片的模型可能失败
Markdown 功能需要 QQ Bot 的 Markdown 权限，否则消息会被拒绝
审批提示默认超时时间为 120 秒
Web 中打开的持久化会话无法向之前的 QQ 目标发送文件

DeepSeek-harness-qqbot DSH 插件的仓库 README 摘录

以下文字摘自 DeepSeek-harness-qqbot DSH 插件的上游仓库 sliverp/DeepSeek-harness-qqbot 的 README，版权归原作者，仅作引用。

An out-of-tree [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) channel plugin that connects an official QQ Bot Gateway to persistent Harness agents. ## Features - Official `@tencent-connect/qqbot-nodejs` Gateway client - C2C and group text messages - Inbound PNG, JPEG, WebP, and GIF images as durable Harness attachments - Automatic text-only fallback when the selected model does not accept image input - Inbound voice transcripts and non-image attachment metadata with the temporary QQ download URL - Outbound assistant text, images, and local workspace files - A QQ-turn-scoped `qq_send_file` tool with workspace containment and file-size checks - QQ Markdown replies, enabled by default - One persistent Harness session per C2C or group conversation - Harness agent-preset composition for the same tools, prompts, and skills as Web sessions - Safe reuse of a live session already opened by Web, without a second session writer - Proactive, requester-bound QQ approval prompts with one-shot Allow and Reject buttons - Approval timeout rejection, fallback to another composed approval channel, and no escalation carry-over to later tool calls - Typing indicators, long-reply

阅读完整 README仓库许可: MIT

DeepSeek-harness-qqbot DSH 插件常见问题

如何安装 DeepSeek Harness QQBot 插件？

在 DSH 环境中运行 `pnpm dsh plugin --profile web add github:sliverp/DeepSeek-harness-qqbot`。确保已安装 Node.js 22.19+、pnpm 10.33.4 和 DeepSeek Harness 0.1.0-rc.6 或更高版本。

不配置 AppID 和 AppSecret 可以使用这个插件吗？

可以。如果 AppID 或 AppSecret 缺失，插件会以静默状态启动，不会阻塞 DSH 完成启动。配置好这两个值并重新加载或重启 DSH 后，QQ 频道就会连接。

插件支持从 agent 向 QQ 发送文件吗？

支持。agent 可以使用 `qq_send_file` 工具发送最大 100 MiB 的文件。文件必须位于 agent 的工作目录内。该工具仅在处理当前 QQ 消息时有效，因此无法从针对同一 QQ 用户的 Web 会话中使用。

QQ 中的审批流程是如何工作的？

当 agent 操作需要审批时，插件会发送一条包含“允许一次”和“拒绝”按钮的主动 QQ 消息。只有发起该轮对话的 QQ 用户可以决定。授权仅覆盖该次操作。如果审批提示超时（默认 120 秒），则审批被拒绝。如果发送提示失败，插件会回退到其他已配置的审批渠道（如 Web）。

支持哪些图片格式？

插件支持接收 PNG、JPEG、WebP 和 GIF 图片作为持久化 Harness 附件。如果选择的模型不支持图片输入，插件会自动降级为纯文本模式，并附带包含临时下载链接的元数据通知。