前言¶

DeepSeek Harness (DSH) 提供了一個插件化擴展框架。在 DSH 的生態中，將 QQ 平臺作爲消息通道通常只涉及基礎的消息收發。dsh-qqbot 是一個基於 DSH 的 QQ Bot IM 插件增強 fork，它將 QQ 平臺作爲 DSH agent 的前端協議驅動，並在此基礎上增加了表情包圖庫、富媒體收發、定時任務、多實例人格、好感度系統及可視化設置面板等能力。

功能特性¶

該插件提供以下核心能力：

• 表情包圖庫：支持自動去重入庫，可將羣聊中的圖片按狀態分類（待整理、收藏、回收站），並可在回覆中調用。
• 富媒體收發：支持圖片、視頻、文件、SILK 語音等多種媒體格式，支持在純文本驅動下發送富媒體內容。
• 定時任務：支持設定定時觸發器，例如在指定時間發送“早安”或“提醒喝水”。
• 多實例人格：支持多賬號同時運行，每個賬號擁有獨立的 AppID、獨立人格配置、獨立的圖庫和定時任務。
• 好感度系統：記錄與用戶的互動關係，通過熟識度和好感度兩個維度量化互動數據，影響交互權重。
• 羣管理：提供入羣審批、禁言、踢人等羣管理功能。
• 可視化設置面板：提供 Web 界面的配置入口，用於管理人格、設置面板和查看數據。
• 會話自動重排：活躍會話會自動置頂，保持重要對話不被冷處理。

安裝與啓用¶

安裝此插件必須指定 web profile，否則無法獲得可視化設置面板。

npx @deepseek-ai/dsh plugin --profile web add @zaofan/dsh-qqbot

安裝完成後，在 DSH 的 Web 界面“設置”中即可看到“QQ 機器人”面板。

典型用法¶

• 表情包管理：羣聊中發送的圖片自動進入圖庫，機器人可在回覆中引用圖庫內容。
• 定時提醒：設置定時任務，機器人會在指定時間主動發言提醒羣成員。
• 入羣審批：啓用入羣審批功能，機器人覈對 openid 臺賬後自動放行或拒絕入羣申請。

注意事項¶

• 設置面板依賴：必須將插件安裝到 web profile 才能使用可視化設置面板。如果安裝到其他 profile，插件將僅有後臺邏輯而無界面。
• 官方 Bot 方案：本插件走騰訊官方 QQ 機器人開放平臺，不模擬 QQ 客戶端協議，安全性較高，但功能範圍受官方 API 限制。
• 踢人功能：由於官方未開放踢人接口，該功能通過使用機器人自己的 QQ 號走羣官網接口實現。
• 安卓部署：在安卓設備上運行時，需在設置中開啓“程序兜底（不依賴小模型）”，否則小模型可能無法加載。
• 源碼安裝：如果從 GitHub 直裝，需要編譯產物 dist/ 目錄，否則安裝會失敗。

結語¶

dsh-qqbot 爲 DSH 用戶提供了從基礎 IM 集成到高級人格管理和羣控功能的完整解決方案。更多細節及源碼可參考：GitHub | 社區目錄