MIT 授權的第一級原生 dsh 外掛（透過 `dsh plugin ... add` 安裝），讓 DeepSeek Harness agent 在 QQ 內執行 — 每個對談對象的獨立 session、Markdown 分段回覆、斜線指令與 QR 掃碼憑證綁定。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-08-28
授權條款
MIT
01它能幫你完成什麼？
從 QQ 私訊與群聊中與 DeepSeek Harness agent 聊天
dsh 的官方 QQ Bot 通道：訊息透過 QQ WebSocket 傳輸層流入 dsh agent 迴圈，支援每個對談對象的獨立 agent、Markdown 分段回覆、斜線指令、QR 掃碼憑證綁定與 preset 掛載
想在 QQ 的私訊或群聊中與 DeepSeek Harness（dsh）agent 對話的開發者與使用者
在 QQ 聊天中管理 agent 的 session、模型與 preset
內建的斜線指令：/new（別名 /reset /clear）、/compact、/model、/preset、/stop、/bot-ping、/bot-version、/bot-status 與 /bot-help
需要在聊天中直接控制 session 上下文、切換模型或 preset、停止產出的 QQ bot 使用者
02如何將外掛接入 DeepSeek Harness？
先決條件
- 可透過 npx 執行官方 dsh CLI 的環境 — README 中的所有指令都使用 `npx @deepseek-ai/dsh`
- 在 QQ 開放平台建立的 QQ Bot：AppID / AppSecret，或 `QQBOT_APPID` / `QQBOT_SECRET` 環境變數
安裝步驟
- 01
安裝到 profile：`npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot`
$ npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
- 02
啟動 bot：`npx @deepseek-ai/dsh --profile qqbot`
$ npx @deepseek-ai/dsh --profile qqbot
- 03
首次啟動時，外掛會進入終端機 QR 掃碼引導來綁定憑證；也可以先匯出 `QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"`
- 04
本機路徑安裝方式：`cd /path/to/dsh-qqbot && pnpm install && pnpm build`，然後執行 `npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot`
$ npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot
驗證整合成功
- 在 QQ 聊天中傳送 `/bot-ping` — README 將它列為連線測試（连通性测试）
03DSH 整合程度與能力邊界
第一級 dsh 外掛：透過 `npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot` 安裝到 dsh profile，並以 `npx @deepseek-ai/dsh --profile qqbot` 啟動；是遵循 dsh「Plugins, not loop changes」原則的純 Cordis 外掛
QQ 私訊 / 群聊傳輸
QQ 私訊，或在啟用 `requireMention` 時標註 @bot 的群組訊息→訊息透過 QQ WebSocket 傳輸層進入 dsh agent 迴圈；助理回覆透過 QQ sendMarkdown 回傳
首次啟動且未設定憑證時，外掛會進入終端機 QR 掃碼引導，並將憑證儲存到 profileMarkdown 分段回覆
較長的 agent 回覆文字→以 Markdown 格式傳送回覆，具備程式碼區塊 / 表格感知分段；`textChunkLimit`（預設 4500）限制每則訊息長度
較長的回覆會依 `textChunkLimit` 拆分為多則訊息傳送斜線指令
/new, /compact, /model, /preset, /stop, /bot-ping, /bot-version, /bot-status, /bot-help→開啟新 session、壓縮歷史、切換模型 / preset、停止產出、連線測試、狀態與說明輸出
/compact 會以摘要取代舊紀錄來壓縮 session 歷史每個對談對象的 session 隔離與復原
一個 QQ 對談對象 — 一個私訊使用者或一個群聊→每個對談對象都有自己的獨立 Agent；sessionKey（`qqbot:${appId}:${scope}:${peerId}`）會透過 SHA-256 決定性地推導出來，並在重啟後復原
閒置 agent 會在一段逾時後自動釋放，以防止記憶體外洩（預設 30 分鐘）Preset 掛載
一個 agent preset id，透過 `agent-presets` 服務掛載→套用 preset 的工具集、prompt 及其他 agent 設定；preset 會在新 session 生效
ask_user_question 問答互動
agent 在對話中途向使用者提出的問題→單選題會顯示內嵌按鈕（點選一個後其餘變灰），多選題則以編號回覆；問題逐題推進，並有每題逾時
待回覆的問題會在 `askTimeoutMs`（預設 300000 ms / 5 分鐘）後逾時
04適合誰？何時不該用？
適合
- 想在 QQ 的私訊或群聊中與 DeepSeek Harness（dsh）agent 對話的開發者與使用者
- 需要在聊天中直接控制 session 上下文、切換模型或 preset、停止產出的 QQ bot 使用者
不適合
- 需要一個 QQ 開放平台的 bot：`appId` 與 `appSecret` 標記為必填（或透過 `QQBOT_APPID` / `QQBOT_SECRET` 環境變數提供）。首次啟動且未設定憑證時，外掛會進入終端機 QR 掃碼引導，透過手機 QQ app 綁定憑證。
05相容性、維護與安全提醒
- 需要一個 QQ 開放平台的 bot：`appId` 與 `appSecret` 標記為必填（或透過 `QQBOT_APPID` / `QQBOT_SECRET` 環境變數提供）。首次啟動且未設定憑證時，外掛會進入終端機 QR 掃碼引導，透過手機 QQ app 綁定憑證。
- 群聊預設只有被 @標註時才會觸發 bot（`requireMention` 預設為 `true`），且每則回覆訊息以 `textChunkLimit` 字元為上限（預設 4500），因此較長的回覆會被拆分。
- README 建議在掃碼前升級至 `0.4.0` 以上版本，因為這些版本支援在瀏覽器中開啟連結，並可避免部分終端機 QR code 渲染錯位的問題。
MIT · actively maintained (latest release 0.4.0, 2026-08-16; last push 2026-08-26)
06常見問題
如何將 dsh-qqbot 安裝到 DeepSeek Harness？
使用 `npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot` 安裝到 dsh profile，再以 `npx @deepseek-ai/dsh --profile qqbot` 啟動。你也可以在本機建置後加入本機路徑：`npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot`。
如何綁定我的 QQ Bot 憑證？
首次啟動且尚未設定憑證時，外掛會自動進入 QR 掃碼引導：終端機印出 QR code，你用手機 QQ app 掃描，憑證就會儲存到 profile — 之後啟動不需要重新掃描。或者設定 `QQBOT_APPID` / `QQBOT_SECRET` 環境變數（設定鍵為 `appId` / `appSecret`）。
每個 QQ 聊天都有自己的 agent 嗎？
是的 — session 隔離是設計原則：每個 QQ 私訊使用者或群聊都有自己獨立的 Agent。Session 金鑰（`qqbot:${appId}:${scope}:${peerId}`）會透過 SHA-256 決定性地推導出來，因此重啟後 session 可復原，閒置 agent 也會自動釋放以防止記憶體外洩。
內建了哪些斜線指令？
`/new`（別名 `/reset` `/clear`）、`/compact`、`/model`、`/preset`、`/stop`、`/bot-ping`、`/bot-version`、`/bot-status` 與 `/bot-help`。例如 `/compact` 會以摘要取代舊紀錄來壓縮 session 歷史，`/bot-ping` 則是連線測試。
在 QQ 中較長的回覆如何處理？
回覆以 Markdown 格式傳送，具備程式碼區塊 / 表格感知分段；`textChunkLimit`（預設 4500）限制每則訊息。問答互動支援 `ask_user_question` — 單選題顯示內嵌按鈕（點選一個後其餘變灰）、多選題以編號回覆，並逐題推進且每題有逾時。
07相關的 DSH 工作流程
awesome-gpt-image-2
作者 freestylefly
Prompt as Code | GPT Image 2 / 2.5 提示詞與案例庫，530+ 個案例、20+ 套工業級模板與可複用 Skills，新增 2.5 同提示詞對比專區，附完整提示詞與生成記錄，持續更新。
voyager
作者 voyager-crew
Enhancement suite for Gemini, AI Studio, Claude, ChatGPT & DeepSeek — plus a prompt manager for any website, DeepSeek Harness included. / 面向 Gemini、AI Studio、Claude、ChatGPT 與 DeepSeek 的增強套件；其中的提示詞管理器可用於任意網站，如 DeepSeek Harness。
dsh-im
作者 xmanrui
通過掃碼或機器人憑據把IM機器人接入DeepSeek Harness（支援飛書、微信、釘釘、企業微信、QQ、Slack、Telegram、Discord和WhatsApp）。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).
wegent
作者 wecode-ai
開源、可自託管的 AI 工作空間，用於規劃、構建和交付程式碼、協作與自動化任務。
08資料與來源
**基于 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 QQ Bot 插件，将 DeepSeek AI 助手接入 QQ 私聊与群聊。*…
npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
- **纯 Cordis 插件** — 遵循 dsh "Plugins, not loop changes" 原则
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-08-28。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。