MIT 授權的 DSH 外掛:用設定頁和九個 `whalegirl_*` Agent 工具託管與設定自建的微信 / QQ 機器人,機器人本體、資源與 GPU 相依仍留在 Python 側。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-18
授權條款
MIT
01它能幫你完成什麼?
在 DSH 裡啟停自建的微信 / QQ 機器人
行程託管依固定順序啟動(熱啟用微信 UIA → 起 web 服務 → 連微信),重新啟動前檢查佇列、不打斷在途回覆,並把狀態回給對話
自建 deepseekgirl 系機器人、不想為了重新啟動 Python 側車來回切終端的維運者
不用手改 YAML 就能調機器人的人設與話癆程度
設定頁提供 22 項功能開關、人設表單(顯示名 / 描述 / 提示詞 / 溫度 / token 上限 / 範例對話,儲存即熱更新)與三檔回覆頻率預設加 12 項細調
每天都要微調人設與回覆頻率、希望改完立刻生效的機器人主人
讓 DSH 裡的 Agent 直接用工具操作機器人,而不是切到面板點按鈕
九個 `whalegirl_*` 工具——status / start / stop / restart / say / image / cover / divination / config——可以在對話裡呼叫
想在對話裡直接讓 Agent 用已設定的帳號傳訊息或傳圖的使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- Windows 加上已登入的微信桌面版(走 UI 自動化,視窗不能最小化)
- 機器人目錄裡有 `.venv\Scripts\python.exe` 與 `web_main.py`
- 機器人內部的 HTTP API 只監聽 `127.0.0.1:<port>`
- 機器人要提供 `/api/settings*`、`/api/style*`、`/api/capabilities`、`/api/divination`;上游原版 `linxisama/deepseekgirl` 需要先補這幾個介面
安裝步驟
- 01
$ dsh plugin --profile web add github:gzyy111/dsh-we-whalegirl
- 02
也可以用本機目錄安裝:`dsh plugin --profile web add /path/to/dsh-we-whalegirl`,或在 DSH 桌面版「外掛」頁的本機安裝入口指向該目錄。
$ dsh plugin --profile web add /path/to/dsh-we-whalegirl
- 03
重新啟動一次 DSH(bundle 層要重新啟動才組裝)。
- 04
在 profile 的 `cordis.patch.yml` 裡補 `botRoot`(含 `web_main.py` 的目錄),否則按「啟動」會提示未設定。
驗證整合成功
作者未說明
03DSH 整合程度與能力邊界
原生 DSH 外掛,分 Host + Client 兩半:Host 半邊拉起 / 停掉機器人行程、把 `/dsh-we-whalegirl/*` 同源代理到 `127.0.0.1:8080/api/*` 並註冊九個 `whalegirl_*` 工具;Client 半邊渲染 設定 → 鯨魚娘 頁面。
行程託管
設定頁或 `whalegirl_*` 工具發出的啟動 / 停止 / 重新啟動指令→依固定啟動順序跑起來的 Python 側車;每次重新啟動前先檢查佇列
以子行程方式拉起 `web_main.py`寫自己的日誌到 `%USERPROFILE%\.dsh\dsh-we-whalegirl\plugin.log`(2 MB 輪替)22 項功能開關
設定 → 鯨魚娘 裡的開關→直接改機器人自己的 `config.yaml`,外掛不複製一份狀態
寫進機器人的 `config.yaml`多數開關要重新啟動機器人才生效人設編輯與熱更新
顯示名、描述、提示詞、溫度、token 上限、範例對話→儲存即生效的人設——不重新啟動、不重連微信;另有「鎖定出廠人設」開關
透過機器人的 `/api/style*` 介面寫入人設欄位九個 Agent 工具
DSH 對話裡的工具呼叫→讀狀態、控制行程、用已設定帳號傳訊息或傳圖、抽一次卦,以及唯讀查看外掛設定
透過已設定的微信或 QQ 帳號真的送出訊息 / 圖片平台設定與選用總覽面板
微信通道控制、監聽群清單、QQ 開放平台憑證;`enablePanel: true`→在設定頁完成平台設定;開啟 `enablePanel` 後側欄出現「鯨魚娘」總覽(統計、能力自檢、訊息流、日誌)
QQ Secret 由機器人本體的 Fernet 金鑰加密後儲存
04適合誰?何時不該用?
適合
- 自建 deepseekgirl 系機器人、不想為了重新啟動 Python 側車來回切終端的維運者
- 每天都要微調人設與回覆頻率、希望改完立刻生效的機器人主人
- 想在對話裡直接讓 Agent 用已設定的帳號傳訊息或傳圖的使用者
不適合
- 多數功能開關要重新啟動機器人才生效(handler 的開關在啟動時一次性注入);人設是例外,儲存即熱更新。
- 微信通道要求 Windows 加上已登入的微信桌面版,因為它走 UI 自動化:視窗不能最小化,機器人必須在互動式桌面工作階段裡執行。
- 外掛依賴機器人新增的介面 `/api/settings*`、`/api/style*`、`/api/capabilities` 與 `/api/divination`;用上游原版 `linxisama/deepseekgirl` 需要先補上這些介面,而且機器人目錄裡必須有 `.venv\Scripts\python.exe` 與 `web_main.py`。
- 曲庫、表情包、模型權重都在機器人側,外掛不含這些資源;設定頁能改哪些欄位也由機器人側的 `settings_api.py` 決定。
05相容性、維護與安全提醒
- 多數功能開關要重新啟動機器人才生效(handler 的開關在啟動時一次性注入);人設是例外,儲存即熱更新。
- 微信通道要求 Windows 加上已登入的微信桌面版,因為它走 UI 自動化:視窗不能最小化,機器人必須在互動式桌面工作階段裡執行。
- 外掛依賴機器人新增的介面 `/api/settings*`、`/api/style*`、`/api/capabilities` 與 `/api/divination`;用上游原版 `linxisama/deepseekgirl` 需要先補上這些介面,而且機器人目錄裡必須有 `.venv\Scripts\python.exe` 與 `web_main.py`。
- 曲庫、表情包、模型權重都在機器人側,外掛不含這些資源;設定頁能改哪些欄位也由機器人側的 `settings_api.py` 決定。
MIT(僅外掛程式碼)· README 分支 main · 無 tagged release,最後推送 2026-10-20
06常見問題
這個外掛包含機器人本體嗎?
不包含。README 寫得很清楚:它是 DSH 外掛(Host + Client 兩半),不是機器人。微信 UI 自動化、faster-whisper、edge-tts、SoulX-Singer / ACE-Step 這些 GPU 相依仍在 Python 側,外掛既不包含也不重寫。
按「啟動」之前要先滿足什麼?
要先在 profile 的 `cordis.patch.yml` 裡補 `botRoot`,否則會提示未設定。機器人目錄裡要有 `.venv\Scripts\python.exe` 與 `web_main.py`,它的 HTTP API 只監聽 `127.0.0.1:<port>`,並且要提供 `/api/settings*`、`/api/style*`、`/api/capabilities`、`/api/divination`。
改人設需要重新啟動機器人嗎?
不需要。人設儲存即熱更新,不重新啟動、不重連微信。多數功能開關則需要重新啟動,因為 handler 的開關在啟動時一次性注入。
Agent 能呼叫哪些工具?
九個:`whalegirl_status`、`start`、`stop`、`restart`、`say`、`image`、`cover`、`divination`、`config`。其中 `say` 與 `image` 會透過已設定的帳號真的送出訊息或圖片。
外掛出問題會拖垮 DSH 嗎?
README 的設計取捨是失效不拖垮宿主:所有 Promise 都掛 catch,代理對 req / res / upstream 全掛 error,`apply` 整體 try/catch,頁面有錯誤邊界,註冊失敗只降級。它自己的日誌寫在 `%USERPROFILE%\.dsh\dsh-we-whalegirl\plugin.log`,2 MB 輪替。
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資料與來源
**是**:一个 DSH 插件(Host + Client 两半)。Host 半边负责拉起/停掉机器人进程、把浏览器请求同源代理到本机 8080、并注册 9 个 Agent 工具;Client 半边在 **设置 → 鲸鱼娘** 提供完整设置…
或者用 DSH 桌面版「插件」页的本地安装入口指向本目录。装完**重启一次 DSH**(bundle 层要重启才组装)。
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
