DSH（DeepSeek Harness）的架構基於「一切皆插件」。要在 QQ 等平臺跑智能體，需要專門的通道插件。dsh-onebot 提供了一個 OneBot 11 標準的客戶端，直接連接現有的 QQ 機器人實現（如 go-cqhttp、NapCat 等），把消息轉給 DSH 的 agent 處理。
是什麼¶
這是一個給 DeepSeek Harness 的 QQ 通道插件。它遵循 OneBot 11 標準，作爲客戶端接入正向 WebSocket 服務，接收事件並通過 HTTP API 發送消息。每個會話對應一個 dsh agent。
- 維護者: JackZo400
- License: MIT
- Stars: 1
- 核心: 零依賴，僅使用 Node.js 內置模塊（
fetch/WebSocket/node:crypto）。
核心功能¶
- 消息收發：支持羣聊和私聊消息。
- 消息段支持：支持
text/at/image/record/reply/face段。 - 格式解析：同時支持 CQ 碼字符串和 segment 數組解析。
- 會話管理：支持會話隔離（羣號/私聊號作爲 key），一條消息一條回覆串行處理。
- 上下文與細節：支持引用展開（本地緩存 + API 兜底）、回聲過濾、羣成員名冊、斷線指數退避重連。
- 接口支持：支持
get_login_info、send_group_msg、send_private_msg、get_msg等接口。
安裝與啓用¶
在 DSH 的命令行中執行以下命令安裝：
dsh plugin --profile web add github:JackZo400/dsh-onebot
安裝完成後，需要在 cordis.patch.yml 中配置連接參數。配置項通常包括 WebSocket 地址、accessToken、羣組白名單、私聊開關等。
典型用法¶
接入流程分爲三步：
- 運行 OneBot 實現：在本地運行 OneBot 客戶端（如 go-cqhttp、NapCat），並開啓正向 WebSocket 服務。
- 配置連接：在配置文件中設置 WebSocket 地址、鑑權 Token 以及消息過濾規則（如僅處理被 @ 的消息）。
- 驗證連接：重啓 profile，檢查日誌中是否出現
[dsh-onebot] 已連上 OneBot 服務的字樣。
已知侷限¶
- 不支持反向連接：不支持反向 WebSocket 或 HTTP 事件上報。
- 媒體內容限制：圖片/語音/視頻內容在當前版本只顯示佔位符（如「（圖）」），需配置
imageLinks: true開啓直鏈功能。 - 不支持：合併轉發聊天記錄、流式/分段回覆。
- 界面：無 UI，所有配置均在文件中完成。
