DSH 外掛,用 NapCat / OneBot v11 驅動普通 QQ 帳號:人設、心情、按人記憶、看圖與看 B 站影片、群組管理,外加一個需 token 的網頁控制台——預設全拒,填了白名單才回訊息。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-18
授權條款
NOASSERTION
01它能幫你完成什麼?
讓一個普通 QQ 號帶著人設與記憶在群組和私訊裡說話
依人設切句的短回覆、六種心情,加上按人儲存的長期記憶與工作階段摘要,輪換後繼續帶著走
想讓自己的 QQ 號在群組裡像個人、又不想去申請官方機器人的使用者
看懂圖片與 B 站影片之後再回話
依圖片內容的回覆,或先把影片的字幕、畫面、彈幕與熱評看過一輪再聊;觀看的過程在臨時工作階段完成,主線只留一條摘要
群組裡經常丟截圖和影片連結、期待真反應而不是「打不開」的成員
守群,並用一個網頁掌握機器人的狀態
詞表命中自動撤回並禁言、群組管理、提醒,以及一個涵蓋工作階段、記憶、社交、觀看紀錄、設定與日誌的控制台
在伺服器上常駐機器人、需要管理手段又不想 SSH 翻日誌的群組管理者
02如何將外掛接入 DeepSeek Harness?
先決條件
- 已經能正常對話的 DeepSeek Harness(設好預設模型)——README 把它列在第一條
- 一個 QQ 小號
- NapCat 或其它 OneBot v11 實作,且開著 WebSocket 服務
- 要做影片逐格畫面,本機 PATH 上需要有 `ffmpeg`
安裝步驟
- 01
`dsh plugin add qfish`(或 `pnpm add git+https://github.com/hyun20202023-ui/dsh-qfish.git`),然後重新啟動 DSH
$ dsh plugin add qfish
- 02
安裝 NapCat 並登入 QQ,新建 WebSocket 伺服器:連接埠 3001,訊息格式 `array`
- 03
在 DSH → 外掛設定 → qfish 裡把 `url` 填成 `ws://127.0.0.1:3001`,`consolePort` 保持 `8090`;跑在伺服器上時把 `consoleListen` 改成 `0.0.0.0`
- 04
選一種存取方式:白名單(`userAccessMode: allowlist` 配 `userIds`、`groupAccessMode: allowlist` 配 `groupIds`),或全開(兩種都設成 `blocklist`、名單留空)
- 05
用 NapCat 介面或控制台「行為參數」裡的 QR code 掃碼登入 QQ
- 06
開啟控制台 `http://<位址>:8090/?t=<權杖>`——權杖來自設定裡的 `consoleToken`,留空時讀 `<profile>/onebot-data/console-token.txt`
驗證整合成功
- 控制台狀態裡 `napcat` 顯示為 true
- 在已啟用的群組裡 @ 它,能收到回覆;要測私訊先把 `respondToPrivate` 改成 `true` 並把你的 QQ 號填進 `userIds`
- DSH 啟動日誌裡有「控制台已启动:http://…」那一行,整行就是帶 token 的完整位址
03DSH 整合程度與能力邊界
DSH 外掛包:透過 OneBot v11 WebSocket 連上 NapCat,模型、工作階段與工具全部走 DSH 本身;同一個套件還附一個需 token 才能進入的網頁控制台,以及 DSH 頁面右下角的入口按鈕。
人設、情緒與語言模仿
一個 markdown 人設檔案、群組裡最近的訊息,以及黑話 / 禁詞 / 梗表→依語氣而不是字數斷句的短回覆,心情與好感度會影響長短、表情與記憶語氣
把心情與好感度狀態寫進 `mood.json`,黑話表寫進 `slang.json` / `slang-normal.json`記憶與工作階段輪換
每個人員在群組與私訊裡的聊天紀錄→按人儲存的記憶(滿了自動壓縮)、輪換後帶進新工作階段的摘要,以及讓機器人接得上話的群組快取
在 profile 資料目錄裡寫 `memories.json`、`summaries.json` 與 `state.json`私訊輪換時還會壓一條記憶,群組輪換不寫群組管理
五類詞表,外加一個總開關→命中後自動撤回並禁言,另有不禁言檔可選
在連著的 QQ 群組裡撤回訊息、禁言成員看圖與看 B 站影片
聊天裡送來的圖片,或 B 站影片連結→依圖片的回覆,或依字幕、畫面、彈幕與熱評的回覆;太長會直說太長
逐格畫面需要 `ffmpeg`,九宮格影格快取在 `frames/`把觀看紀錄寫進 `bili-memory.json` 與 `video-notes.json`網頁控制台
帶控制台 token 的瀏覽器請求→一個頁面裡看工作階段、記憶、社交、觀看紀錄、設定與日誌,並調整回覆條數、影片長度等行為參數
在 `consolePort`(預設 8090)上提供 HTTP 服務,綁定到 `consoleListen`DSH 頁面右下角的懸浮按鈕開啟同一個控制台內容工具與維運
模型在對話中發起的請求→搜圖、聯網搜尋與抓正文、B 站卡片、網易雲 / QQ 音樂卡片、提醒、跨群送訊息,以及 `/dsh` 伺服器指令
會往其它群組或私訊送訊息`/dsh` 會跑維運指令,僅限後台權限
04適合誰?何時不該用?
適合
- 想讓自己的 QQ 號在群組裡像個人、又不想去申請官方機器人的使用者
- 群組裡經常丟截圖和影片連結、期待真反應而不是「打不開」的成員
- 在伺服器上常駐機器人、需要管理手段又不想 SSH 翻日誌的群組管理者
不適合
- 預設全拒:裝完不會回覆任何人。必須先在設定裡填 QQ 使用者 / 群組白名單,空名單等於全拒;要全開就把兩種存取方式都改成 `blocklist` 並留空名單。
- 不能與 `dsh-onebot` 同時安裝:兩者都會註冊 `/onebot/api`,還會爭用同一個 NapCat 連線。專案由 `dsh-onebot@1.4.0`(MPL-2.0)二次開發而來,相關程式碼繼續適用 MPL-2.0。
- 控制台需要一個能存取的連接埠和 token。在伺服器上必須把 `consoleListen` 從 `127.0.0.1` 改成 `0.0.0.0`,並放行 8090(NapCat 網頁還要 6099);3001 只給本機外掛用,不要暴露到公網。
- 協議端可能被風控:qfish 走 OneBot / NapCat 加普通 QQ 號,README 自己的對照表就寫了「協議端有風控可能」。同一個 QQ 號也不能兩台機器同時登入,兩個 NapCat 會互相踢。
05相容性、維護與安全提醒
- 預設全拒:裝完不會回覆任何人。必須先在設定裡填 QQ 使用者 / 群組白名單,空名單等於全拒;要全開就把兩種存取方式都改成 `blocklist` 並留空名單。
- 不能與 `dsh-onebot` 同時安裝:兩者都會註冊 `/onebot/api`,還會爭用同一個 NapCat 連線。專案由 `dsh-onebot@1.4.0`(MPL-2.0)二次開發而來,相關程式碼繼續適用 MPL-2.0。
- 控制台需要一個能存取的連接埠和 token。在伺服器上必須把 `consoleListen` 從 `127.0.0.1` 改成 `0.0.0.0`,並放行 8090(NapCat 網頁還要 6099);3001 只給本機外掛用,不要暴露到公網。
- 協議端可能被風控:qfish 走 OneBot / NapCat 加普通 QQ 號,README 自己的對照表就寫了「協議端有風控可能」。同一個 QQ 號也不能兩台機器同時登入,兩個 NapCat 會互相踢。
NOASSERTION(README 註明由 dsh-onebot@1.4.0 二次開發,相關程式碼繼續適用 MPL-2.0) · README 分支 main · 最新 release v0.3.31 (2026-11-13)
06常見問題
為什麼剛裝好它一則訊息都不回?
這就是預設狀態。qfish 預設全拒,空名單等於誰都不回。把 `userAccessMode` 設成 `allowlist`、`userIds` 填你的 QQ 號,`groupAccessMode` 設成 `allowlist`、`groupIds` 填群組號;或者兩種都改成 `blocklist` 並留空名單全部放開。私訊還需要把 `respondToPrivate` 改成 `true`。
DSH 之外還要跑什麼?
NapCat(或其它 OneBot v11 實作)並開著 WebSocket 服務。本機新建一個連接埠 3001、訊息格式 `array` 的 WebSocket 伺服器;伺服器上可以用 `mlikiowa/napcat-docker` 映像,放行 3001 與 6099,再用瀏覽器開啟 `http://<伺服器IP>:6099` 掃碼登入 QQ。只有要做影片逐格畫面時,才需要 PATH 上有 `ffmpeg`。
QQ 明明在線,但每一輪都被判 blocked,怎麼辦?
DSH 可能把 qfish 的工作階段標成了「已封存」,封存的工作階段會被直接拒絕執行,模型一次都不會跑。離開 DSH,編輯 `~/.dsh/storages/workspace.json`,刪掉 `archivedSessionIds` 裡所有以 `onebot:` 開頭的項目,再啟動 DSH。如果表現為控制台聊天框不動,多半是 profile 沒設預設模型,需要在 `cordis.patch.yml` 裡補一個 `agent-default-model` 區段。
怎麼進網頁控制台?
控制台是一個必須帶 token 的網頁:`http://<位址>:8090/?t=<權杖>`。權杖來自設定裡的 `consoleToken`,留空時讀 `<profile>/onebot-data/console-token.txt` 裡自動產生的值,或者直接用 DSH 啟動日誌裡「控制台已启动:http://…」那一行給出的完整位址。跑在伺服器上時要先把 `consoleListen` 改成 `0.0.0.0` 並放行 8090。
能和 dsh-onebot 一起裝嗎?
不能。qfish 由 `dsh-onebot@1.4.0` 二次開發而來,兩者都會註冊 `/onebot/api` 並爭用同一個 NapCat 連線,一起裝會連不上。相關程式碼繼續適用 MPL-2.0。
07相關的 DSH 工作流程
dsh-im
作者 xmanrui
通過掃碼或機器人憑據把IM機器人接入DeepSeek Harness(支援飛書、微信、釘釘、企業微信、QQ、Slack、Telegram、Discord和WhatsApp)。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).
dsh-aurabot-qq
作者 aureth-labs
讓 DeepSeek Harness 裡的 AI 以「大肥魚」住進 QQ:會聊天、發表情、發語音、記事、發空間、刷 B 站、唱歌。功能都是模組,能開關、能自己寫,還能從模組市場裝更多(SnowLuma / OneBot v11)。
dsh-qqbot
作者 tencent-connect
讓 QQ Bot 接入 DeepSeek Harness(dsh)的官方外掛
dsh-wechat
作者 xcisxc29
DeepSeek Harness 微信頻道
08資料與來源
> qfish 是 DeepSeek Harness 的 QQ 插件。用 NapCat / OneBot 接普通 QQ 号,不需要申请官方机器人。
- **直连 DSH**:模型、会话、工具都走 DSH,中间没有别的层
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
