前言¶
DeepSeek Harness（DSH）的設計理念是“一切皆插件”。如果你需要將 DeepSeek 的能力接入 QQ 社交場景，dsh-qqchat 插件提供了現成的方案。它解決了從 QQ 羣聊和私聊直接接入 DSH Agent 的需求，支持官方 Bot 授權、記憶管理以及 DSH 原生會話界面。
插件介紹¶
dsh-qqchat 是 DeepSeek Harness 的一個客戶端插件，由開發者 Coffeiz 維護。它基於 QQ Chat 協議，允許用戶在 QQ 羣聊和私聊中直接使用 DSH 的智能體能力。通過它，DSH 的原生界面、記憶系統和命令機制可以無縫映射到 QQ 的對話場景中。
核心功能¶
- 連接與重連：支持掃碼連接和手動填寫 AppID/AppSecret 兩種方式。支持斷線自動重連，無需重複掃碼。
- 會話管理：每個羣聊和私聊對象對應獨立的 DSH 會話，支持會話隔離。支持從 DSH 原生界面主動向 QQ 發送消息。
- 消息處理：支持羣聊回覆模式（自動回應、@回覆、靜默記錄）、引用消息與 @ 用戶轉換、私聊流式回覆。
- 記憶系統：分別維護羣聊記憶、羣成員記憶和私聊用戶記憶。支持記憶整理（自動將近期記錄轉爲長期記憶）和跨羣複用用戶記憶。
- 權限與工具：支持媒體與文件權限管理，可單獨控制接收、讀取和工具使用權限。
- 命令系統：支持 DSH 原生命令（如
/compact）和 QQChat 自有命令（如/qqhelp）。
安裝與啓用¶
安裝需要指定一個 profile，推薦新建一個 qqchat profile：
npx @deepseek-ai/dsh plugin --profile qqchat add @deepseek-ai/dsh-web-app dsh-qqchat
npx @deepseek-ai/dsh --profile qqchat
也可以安裝到已有的 web profile 中，或者直接從 GitHub 安裝開發分支。
典型用法¶
- 啓動 DSH 後，進入 設置 → QQ Chat。
- 點擊 掃碼連接，使用手機 QQ 掃描生成的二維碼，完成官方 Bot 授權。或者選擇手動配置，填寫 AppID 和 AppSecret。
- 連接成功後，在 QQ 羣或私聊中發送
/qqhelp查看可用命令列表，發送/qqpreset [preset]切換 Agent Preset。
適用場景與注意¶
- 適用場景：需要將 QQ 羣組作爲 DSH 的 Agent 交互入口，或需要管理特定用戶記憶的場景。
- 注意事項：
- 需要使用 QQ 官方 Bot，不支持個人 QQ 賬號登錄。
- 插件當前版本仍在完善中，建議先在測試環境使用。
- 對於富媒體、完整表情和部分複雜消息格式，可能需要使用兼容模式。
- 卸載插件不會自動刪除已保存的聊天記錄和記憶數據。
結語¶
dsh-qqchat 將 QQ 生態與 DSH 的強大能力連接起來。作爲社區插件，其代碼質量仍在迭代中。你可以通過 GitHub 或 SkillHub 目錄查看源碼和文檔。
