把 dsh 接進 QQ:dsh-im 外掛與 NapCat 實戰
路線 A 裝外掛掃碼、路線 B 掛 NapCat 協定端——9 張幀檢截圖逐步跟做,每步深鏈回源影片。
最近更新: 2026-10-03
「dsh 能掛 QQ 機器人嗎?」能,而且有兩條路線。路線 A 是開源外掛 dsh-im(GitHub 實查 xmanrui/dsh-im,★1.6k,MIT):一行指令裝好後,在設定裡掃描 QR Code 就能把 IM 機器人接進 DeepSeek Harness,QQ 與微信、飛書、釘釘、企業微信、Telegram、Discord、WhatsApp、Slack 同列九大通道。路線 B 再加一層 NapCat——QQ 用戶端的社群協定端,實戰影片裡的群組級 bot 能力(入群、群友畫像)走的就是這條路。
下面 9 張截圖全部取自兩支實錄影片並逐幀複核,每張都深鏈回源影片的對應秒數。同一個外掛在微信/飛書側的用法,見微信串接指南。 微信串接:同一個外掛的微信軸
太長不看
- ▸路線 A:一行指令裝 dsh-im → 設定 → 外掛 → IM 機器人 → 掃碼,QQ 是 9 通道之一(微信/飛書/釘釘/企業微信/QQ/TG/Discord/WhatsApp/Slack)。
- ▸路線 B:NapCat(★10.8k 的 QQ 協定端)+ dsh webui 的「QQ 聊天」工作區,訊息以會話形式落進 dsh,實測快取命中 80%。
- ▸實戰實錄:bot 以成員身分入群、私訊雙向收發圖片和 10 秒語音、跨會話操作,群友關係圖 18 人 · 16 關係。
- ▸名詞表:dsh-im 是外掛,NapCat 是協定端(非外掛),MoonBot 是 UP 自製面板(無公開儲存庫),別拿去搜。
從零到 QQ 機器人,9 步跟做
路線 A:dsh-im 外掛(官方通道)
- 1
安裝 dsh-im 外掛
README 給了兩條等價指令:npx -y github:xmanrui/dsh-im install 一行裝好,或走外掛市場 dsh plugin --profile web add @xmanrui/dsh-im。如果之前直接裝過 dsh-feishu、dsh-weixin、dsh-dingtalk,安裝器會把它們替換成 dsh-im,原有渠道設定和金鑰繼續沿用。
$npx -y github:xmanrui/dsh-im install$dsh plugin --profile web add @xmanrui/dsh-im
README 給的兩條安裝路徑,任選一行都裝得起來。看源影片 0:52 - 2
掃碼串接:設定 → 外掛 → IM 機器人
重啟 dsh web 後,設定裡多出「IM 機器人」面板:九個平台各自掃描 QR Code 綁定。影片裡微信機器人已接入,卡片顯示「運行正常 · 訊息通道 iLink 長輪詢 · 1/1 線上」;QQ 同樣掃一下就接上。接入後收到訊息會先顯示已讀和「正在輸入」,再把 Harness 的最終回答傳回來。
掃完碼卡片就變綠:運行正常,1/1 線上。看源影片 0:14
路線 B:NapCat 協定端
- 3
認識 NapCat:QQ 用戶端協定端
路線 B 從更底層開始。NapCat(NapNeko/NapCatQQ,★10.8k)實作了 QQ 用戶端協定,它的 WebUI(127.0.0.1:6099 帶 token)集中管理 bot 帳號與版本——影片裡 NapCat 4.9.49、QQ 9.9.26,2 個網路設定掛 1 個 HTTP 伺服器和 1 個 WebSocket 伺服器。dsh 不直接碰這層,NapCat 負責把 QQ 翻譯成普通訊息源。
NapCat 跟 QQ 用戶端並肩跑,網路側就在這個 WebUI 接。看源影片 3:16 - 4
看 QQ 訊息落進 dsh
NapCat 接好後,dsh webui 多出一個「QQ 聊天」工作區:私訊和群組聊天以會話形式出現,角色卡(SPEECH RULES)自動注入,日誌裡捲動 [Wake] private:… sleep ended 這樣的喚醒事件,狀態列實測 1 輪 1 步、首 token 0.6 秒、快取命中 80%。對 dsh 來說,bot 只是又開了一個聊天視窗。
看不見膠水程式碼——QQ 訊息自己變成 dsh 的會話。看源影片 3:24
實戰:設定、人設與群友畫像
- 5
實測能力:入群、圖片、語音
影片裡 bot 以「DeepSeek Harness」的名字出現在 5 人群組的成員列表裡;私訊雙向收發一張圖片和一則 10 秒語音;作者原話「理論上所有操作都是可跨會話的」,請它連網搜尋也行——「可以,就是不一定準確」。彩蛋是 QQ 空間:bot 自己以第一人稱發了 ATRI 日記。
入群是成員,私訊能收圖收語音。看源影片 2:00 - 6
設定 bot 行為開關
MoonBot 面板(UP 自製,見 FAQ)展示了群組 bot 的關鍵開關:啟用整套 Agent、連回合注入、只對私訊保持(最多來回 24 次,閒置 1,800,000 毫秒關閉),好友邀請與信任(自動同意好友 + 好友守衛),外加 Word 文件額度 100000。
回合數、好友信任、額度——讓 bot 不吵不鬧的開關全在這。看源影片 3:36 - 7
給 bot 一份常駐人設
一塊面板定義 bot 是誰:常駐自動化引導加自由填寫的提示詞,儲存一次全聊天繼承。bot 說話多正式、多健談、多簡短,都在這裡設定——QQ 群組生態很吃人設這一套。
人設只設一次,所有聊天共用。看源影片 4:00 - 8
讀懂群組:群友關係圖
在群組裡跑一陣後,面板畫出群友關係圖——影片裡 18 人 · 16 關係,互動強度用連線粗細編碼,圖例分主人、群主、管理員、私訊。點任何一個人,直接彈出成員卡片。
幾個星期的群組聊天,濃縮成一張社交地圖。看源影片 4:45 - 9
打開成員卡片
每位成員的彈窗把聊天風格概括放在上面,互動紀錄時間線和關係網墊在下面——上一步那張圖的資料源就在這裡。這些資料 dsh 本來就看得到,只是換成人能讀的排法。
點一下圓點,bot 就告訴你這個人是誰、平常怎麼說話。看源影片 4:50
常見問題:把 dsh 接進 QQ
接入之前,大家真正會問的六個問題。
dsh 能掛 QQ 機器人嗎?
能,兩條路線。路線 A 裝 dsh-im 外掛(一行 npx 指令),在「設定 → 外掛 → IM 機器人」掃碼串接,QQ 是九個通道之一;路線 B 在 dsh 前面掛 NapCat 協定端,本頁實戰影片裡的入群、群友畫像等群組級能力走的就是這條路。兩條路線可以只用一條,也能組合。
dsh-im 和 NapCat 有什麼差別?該選哪個?
dsh-im 是 dsh 外掛,走各平台官方通道掃碼串接,九個平台含 QQ、微信、Telegram、Discord,裝上就行;NapCat(NapCatQQ)根本不是 dsh 外掛,它實作的是 QQ 用戶端協定,影片裡配合 dsh 做出更「QQ 原生」的群組行為。要省事選 dsh-im,要群組級 bot 能力再加 NapCat。
NapCat 是騰訊官方的嗎?可靠嗎?
不是。NapCat(GitHub:NapNeko/NapCatQQ,★10.8k,TypeScript)是社群開源專案,在 NTQQ 之上實作現代協定端,與騰訊和 DeepSeek Harness 都無關聯。綁定真實 QQ 號前請自行評估風險並遵守 QQ 服務條款;本頁只引用其公開示範畫面。
接入之後,QQ 機器人能做什麼?
影片實測:以普通成員身分入群、私訊雙向收發圖片和 10 秒語音、「理論上所有操作都是可跨會話的」、被要求時連網搜尋(作者原話「可以,就是不一定準確」),還會自己發 QQ 空間日記;群友關係圖 18 人 · 16 關係,點人看卡片。你的 dsh 模型和外掛全部照常生效——bot 只是訊息進 harness 的另一扇門。
MoonBot 是外掛嗎?去哪下載?
不是。MoonBot 是影片作者(等一隻蘿蔔子)給自己部署做的控制面板,沒有公開儲存庫,也裝不了。公開可重現的路徑是 dsh-im(官方通道)+ NapCat(協定端);MoonBot 的截圖當作「這套組合能做到什麼」的示範看就好。
除了 QQ,dsh 還能接哪些聊天軟體?
dsh-im 一次帶九個通道:微信、飛書、釘釘、企業微信、QQ、Telegram、Discord、WhatsApp、Slack。海外使用者 Telegram 和 Discord 門檻最低,同一個掃碼面板通用;微信/飛書側的逐步教學見本站微信串接指南。
相關攻略
接著看:站內更多 dsh 攻略與合集。
微信串接:同一個外掛的微信軸
同一個 dsh-im 外掛在微信/飛書側的接法——掃碼配對、手機端審批、bot 回覆,一步步實錄。
閱讀教學外掛安裝指南
dsh-im 只是外掛生態的一員:安裝機制怎麼運作、第三方程式碼裝前怎麼審,一篇講清楚。
閱讀教學dsh Web UI 圖文指南
「IM 機器人」面板和「QQ 聊天」工作區都在 webui 裡:啟動、3080 連接埠與面板地圖,一次看全。
閱讀教學區域網路存取與連接埠
QQ bot 預設只見本機的 dsh;想把 webui 開給區網裝置,防火牆和連接埠一篇講透。
閱讀教學公網遠端存取
超出區網:隧道與 token 讓你從外部網路夠到 dsh——把 bot 指過去之前,先掂量暴露面。
閱讀教學遠端與行動裝置合集
手機、隧道、掃碼配對類外掛合集——聊天側接入之外的整套遠端玩法。
閱讀教學來源與署名
全部截圖取自兩支第三方實錄並逐幀複核,每張圖都深鏈回源影片的對應秒數。直式 dsh-im 源經裁修(黃底標題/字幕橫幅全部未取幀);NapCat 實錄的水族館桌布經視窗緊裁去除。MoonBot 面板為影片作者自製,無公開儲存庫。倉庫名與 star 已於 2026-10-03 經 GitHub API 複核:xmanrui/dsh-im(★1,589,MIT)、NapNeko/NapCatQQ(★10,830)。