前言¶

在 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

這是社區插件頁面，不屬於官方應用商店。