前言¶
DeepSeek Harness（DSH）採用插件化架構，意在將智能體控制能力模塊化。在本地電腦上運行 Agent 後，如何通過移動端進行遠程操控是常見需求。傳統方案往往需要配置反向代理或暴露公網 IP，增加了部署複雜度。dsh-qq-plugin 通過對接騰訊官方 QQ 機器人平臺，提供了一個無需額外網絡配置、通過 QQ 消息直接操控本地 DSH Agent 的方案。
插件介紹¶
這是一個名爲 dsh-qq-plugin 的 DSH 插件。它允許用戶在手機 QQ 上通過掃描二維碼綁定騰訊的官方機器人平臺，從而與運行在桌面上的 DSH Agent 進行雙向交互。該插件由用戶 xcisxc29 維護，許可證爲 MIT。
核心功能¶
插件提供了以下核心能力：
- 雙向文本與多媒體：QQ 消息直接作爲 DSH 的 Prompt，Agent 的回覆返回至 QQ；支持圖片、視頻、語音及文件的雙向傳輸。
- 長回覆處理：過長的回覆會自動轉換爲
.md文件發送，避免消息被截斷。 - 多會話管理：支持通過
/new、/list、/switch等命令管理多個 DSH 會話。 - 模型與推理級別切換：通過
/model命令切換模型及推理級別。 - 權限與問題交互：Agent 的權限詢問和選擇題可通過 QQ 數字選項進行回應。
- 主動推送：Agent 可主動向 QQ 發送通知。
- 定時任務：支持通過 QQ 設置定時任務（如“23:12 喚醒我”）。
安裝與啓用¶
安裝前需確保 DSH 桌面版版本爲 0.2.0-rc.2 或更新。插件運行需要 DSH 的 workspace、tool 和 UI 服務。
- 在 DSH 側邊欄進入插件入口，選擇「添加插件」。
- 輸入包名
dsh-qq-plugin（注意不要少寫-plugin後綴）。 - 或在終端執行命令：
dsh plugin --profile desktop add dsh-qq-plugin
- 安裝完成後點擊「立即啓用」並重啓 DSH。
典型用法¶
啓用後，打開 Settings -> QQ，點擊「開始掃碼」，使用手機 QQ 掃描二維碼確認綁定。綁定即完成註冊，無需額外申請 AppID。
- 文件傳輸：在 QQ 說「把我電腦上桌面那張 DSH 自畫像發過來」，文件會直接送達。
- 會話切換：在 QQ 說「切換到另一個」或使用
/switch。 - 模型切換：在 QQ 發送
/model 2。 - 定時任務：在 QQ 說「23:12 喚醒我」。
適用場景與注意¶
該插件適合需要通過手機臨時操控電腦上運行的 DSH Agent 的場景。需注意：未認證機器人僅限管理員使用；主動推送功能基於假設無配額的規則，若消息被攔截會排隊重試。
結尾¶
該插件爲 DSH 用戶在移動端控制桌面 Agent 提供了基於 QQ 的輕量級通道。更多細節可參考 GitHub。
