返回目錄

dsh-we-whalegirl

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

gzyy111/dsh-we-whalegirl

DSH 外掛:自建微信/QQ「鯨魚娘」機器人的控制面 —— 啟停 Python 側車、逐個開關功能、改人設、調回複頻率,並可用 whalegirl_* 工具在對話裡指揮她

前往 GitHub專案首頁
$ dsh plugin --profile web add github:gzyy111/dsh-we-whalegirl

14

星數

2

Fork

JavaScript

語言

MIT

授權條款

2026-10-20

建立於

2026-10-20

最近推送

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` 需要先補這幾個介面

安裝步驟

  1. 01

    $ dsh plugin --profile web add github:gzyy111/dsh-we-whalegirl

  2. 02

    也可以用本機目錄安裝:`dsh plugin --profile web add /path/to/dsh-we-whalegirl`,或在 DSH 桌面版「外掛」頁的本機安裝入口指向該目錄。

    $ dsh plugin --profile web add /path/to/dsh-we-whalegirl

  3. 03

    重新啟動一次 DSH(bundle 層要重新啟動才組裝)。

  4. 04

    在 profile 的 `cordis.patch.yml` 裡補 `botRoot`(含 `web_main.py` 的目錄),否則按「啟動」會提示未設定。

驗證整合成功

作者未說明

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

原生 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` 決定。
2026-10-202026-10-20作者未說明

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 輪替。

08資料與來源

  • 作者聲明github.com1c6b50320628…

    **是**:一个 DSH 插件(Host + Client 两半)。Host 半边负责拉起/停掉机器人进程、把浏览器请求同源代理到本机 8080、并注册 9 个 Agent 工具;Client 半边在 **设置 → 鲸鱼娘** 提供完整设置…

  • 作者聲明github.com1c6b50320628…

    或者用 DSH 桌面版「插件」页的本地安装入口指向本目录。装完**重启一次 DSH**(bundle 层要重启才组装)。

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

🏆

最佳 DeepSeek Harness 外掛

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

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

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