返回目錄

dsh-qfish

精選清單收錄維護狀態: 活躍

hyun20202023-ui/dsh-qfish

DSH-QQ bot 外掛(OneBot v11 / NapCat)for DeepSeek Harness:人設、記憶、心情、學習表、聯網、看b站,自帶網頁控制台。

前往 GitHub
$ dsh plugin add qfish

19

星數

2

Fork

JavaScript

語言

NOASSERTION

授權條款

2026-11-02

建立於

2026-11-17

最近推送

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`

安裝步驟

  1. 01

    `dsh plugin add qfish`(或 `pnpm add git+https://github.com/hyun20202023-ui/dsh-qfish.git`),然後重新啟動 DSH

    $ dsh plugin add qfish

  2. 02

    安裝 NapCat 並登入 QQ,新建 WebSocket 伺服器:連接埠 3001,訊息格式 `array`

  3. 03

    在 DSH → 外掛設定 → qfish 裡把 `url` 填成 `ws://127.0.0.1:3001`,`consolePort` 保持 `8090`;跑在伺服器上時把 `consoleListen` 改成 `0.0.0.0`

  4. 04

    選一種存取方式:白名單(`userAccessMode: allowlist` 配 `userIds`、`groupAccessMode: allowlist` 配 `groupIds`),或全開(兩種都設成 `blocklist`、名單留空)

  5. 05

    用 NapCat 介面或控制台「行為參數」裡的 QR code 掃碼登入 QQ

  6. 06

    開啟控制台 `http://<位址>:8090/?t=<權杖>`——權杖來自設定裡的 `consoleToken`,留空時讀 `<profile>/onebot-data/console-token.txt`

驗證整合成功

  • 控制台狀態裡 `napcat` 顯示為 true
  • 在已啟用的群組裡 @ 它,能收到回覆;要測私訊先把 `respondToPrivate` 改成 `true` 並把你的 QQ 號填進 `userIds`
  • DSH 啟動日誌裡有「控制台已启动:http://…」那一行,整行就是帶 token 的完整位址

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

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 會互相踢。
2026-11-022026-11-14v0.3.31

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。

08資料與來源

  • 作者聲明github.comaf03f4cf6981…

    > qfish 是 DeepSeek Harness 的 QQ 插件。用 NapCat / OneBot 接普通 QQ 号,不需要申请官方机器人。

  • 作者聲明github.comaf03f4cf6981…

    - **直连 DSH**:模型、会话、工具都走 DSH,中间没有别的层

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。