MIT-licensed DSH plugin that supervises and configures a self-hosted WeChat / QQ bot from a settings page and nine `whalegirl_*` agent tools, while the bot itself, its assets and its GPU stack stay in Python.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-11-18
License
MIT
01What can it help you accomplish?
Start, stop and restart the self-hosted WeChat / QQ bot from inside DSH
A supervisor that runs the fixed start sequence (hot-activate WeChat UIA → start the web service → connect WeChat), checks the queue before a restart so in-flight replies are not cut, and reports status back
Operators of a self-hosted deepseekgirl-style bot who are tired of switching terminals to restart the Python sidecar
Tune the bot's personality and chattiness without editing YAML by hand
A settings page with 22 feature switches, a persona form (display name / description / prompt / temperature / token cap / example dialogue) that hot-updates on save, and three reply-frequency presets plus 12 fine-grained knobs
Bot owners who iterate on persona and reply frequency daily and want changes to take effect without a restart
Let the DSH agent operate the bot through tools instead of a dashboard
Nine `whalegirl_*` tools — status, start, stop, restart, say, image, cover, divination and config — callable in the conversation
Users who want to ask the agent to send a message or an image through the configured account mid-conversation
02How to install into DeepSeek Harness
Prerequisites
- Windows with a logged-in WeChat desktop client (UI automation, the window must not be minimised)
- A bot directory containing `.venv\Scripts\python.exe` and `web_main.py`
- The bot's HTTP API listening only on `127.0.0.1:<port>`
- Bot endpoints `/api/settings*`, `/api/style*`, `/api/capabilities` and `/api/divination` — the upstream `linxisama/deepseekgirl` needs them added first
Installation steps
- 01
$ dsh plugin --profile web add github:gzyy111/dsh-we-whalegirl
- 02
Or install from a local directory: `dsh plugin --profile web add /path/to/dsh-we-whalegirl`, or point the desktop app's local-install entry at this directory.
$ dsh plugin --profile web add /path/to/dsh-we-whalegirl
- 03
Restart DSH once — the bundle layer is only assembled on restart.
- 04
Add `botRoot` (the directory holding `web_main.py`) to the profile's `cordis.patch.yml`; without it the 启动 button reports "not configured".
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
Native DSH plugin with two halves: the host half spawns and stops the bot process, same-origin proxies `/dsh-we-whalegirl/*` to `127.0.0.1:8080/api/*` and registers nine `whalegirl_*` agent tools, while the client half renders the 设置 → 鲸鱼娘 page.
Process supervisor
start / stop / restart commands from the settings page or a `whalegirl_*` tool→the Python sidecar running with the fixed start sequence, and a queue check before every restart
spawns `web_main.py` as a subprocesswrites its own log to `%USERPROFILE%\.dsh\dsh-we-whalegirl\plugin.log` (2 MB rotation)22 feature switches
the toggles in 设置 → 鲸鱼娘→the bot's own `config.yaml` updated — the plugin keeps no second copy of the state
writes into the bot's `config.yaml`most switches only take effect after the bot is restartedPersona editor with hot update
display name, description, prompt, temperature, token cap, example dialogue→persona changes applied on save — no restart, no WeChat re-login — with an optional 「锁定出厂人设」lock
writes the persona fields through the bot's `/api/style*` endpointNine agent tools
tool calls from the DSH conversation→status reads, process control, sending a message or an image through the configured account, a divination draw, and a read-only view of the plugin config
sends real messages / images through the configured WeChat or QQ accountPlatform settings and an optional overview panel
WeChat channel controls, the watched group list, QQ open-platform credentials; `enablePanel: true`→platform configuration from the settings page, plus a sidebar 「鲸鱼娘」 overview with stats, a capability self-check, the message stream and logs
stores QQ secrets encrypted by the bot's own Fernet key
04Who is it for? When not to use it?
Good for
- Operators of a self-hosted deepseekgirl-style bot who are tired of switching terminals to restart the Python sidecar
- Bot owners who iterate on persona and reply frequency daily and want changes to take effect without a restart
- Users who want to ask the agent to send a message or an image through the configured account mid-conversation
Not for
- Most feature switches only take effect after the bot is restarted — the handler's switches are injected once at startup. Persona is the exception and hot-updates on save.
- The WeChat channel needs Windows plus a logged-in WeChat desktop client, because it drives UI automation — the window must not be minimised, and the bot has to run inside an interactive desktop session.
- The plugin depends on endpoints the bot project added — `/api/settings*`, `/api/style*`, `/api/capabilities` and `/api/divination`. With the upstream `linxisama/deepseekgirl` you have to add those first, and the bot directory must contain `.venv\Scripts\python.exe` and `web_main.py`.
- The song library, sticker packs and model weights all live on the bot side — the plugin ships none of them, and the settings page field whitelist is decided by the bot's own `settings_api.py`.
05Compatibility, maintenance and safety notes
- Most feature switches only take effect after the bot is restarted — the handler's switches are injected once at startup. Persona is the exception and hot-updates on save.
- The WeChat channel needs Windows plus a logged-in WeChat desktop client, because it drives UI automation — the window must not be minimised, and the bot has to run inside an interactive desktop session.
- The plugin depends on endpoints the bot project added — `/api/settings*`, `/api/style*`, `/api/capabilities` and `/api/divination`. With the upstream `linxisama/deepseekgirl` you have to add those first, and the bot directory must contain `.venv\Scripts\python.exe` and `web_main.py`.
- The song library, sticker packs and model weights all live on the bot side — the plugin ships none of them, and the settings page field whitelist is decided by the bot's own `settings_api.py`.
MIT (plugin code only) · README on branch main · no tagged release, last push 2026-10-20
06Frequently asked questions
Does this plugin include the bot itself?
No. The README is explicit: it is a DSH plugin with a host and a client half, not the bot. WeChat UI automation, faster-whisper, edge-tts and the SoulX-Singer / ACE-Step GPU stack stay on the Python side and are neither included nor rewritten.
What must be true before the 启动 button works?
`botRoot` has to be filled in on the profile's `cordis.patch.yml` — otherwise the button reports "not configured". The bot directory must contain `.venv\Scripts\python.exe` and `web_main.py`, its HTTP API must listen on `127.0.0.1:<port>`, and the bot must expose `/api/settings*`, `/api/style*`, `/api/capabilities` and `/api/divination`.
Do persona changes need a bot restart?
No — persona hot-updates on save, with no restart and no WeChat reconnect. Most feature switches do need a restart, because the handler's switches are injected once at startup.
Which tools can the agent call?
Nine: `whalegirl_status`, `start`, `stop`, `restart`, `say`, `image`, `cover`, `divination` and `config`. `say` and `image` send real messages through the configured account.
What happens if the plugin fails?
The README says failures must not take the host down: every Promise has a catch, the proxy handles errors on req / res / upstream, `apply` is wrapped in try/catch, the page has an error boundary, and a failed registration only degrades. Its own log goes to `%USERPROFILE%\.dsh\dsh-we-whalegirl\plugin.log` with 2 MB rotation.
07Related DSH workflows
dsh-im
by xmanrui
把 IM 机器人接入 DSH:统一管理飞书/微信/钉钉/企业微信/QQ/Telegram/Discord/WhatsApp 八个渠道,扫码或凭据接入、流式回复与设置页管理
dsh-aurabot-qq
by aureth-labs
Connects DSH sessions to QQ through OneBot v11 and exposes configurable chat, media, memory, and social tools.
dsh-qqbot
by tencent-connect
Official QQ Bot IM channel plugin for dsh: QQ WebSocket transport, QR扫码 credential binding, per-peer isolated agents, Markdown chunked replies, slash commands, preset mounting
dsh-wechat
by xcisxc29
WeChat channel for DeepSeek Harness
08Data and sources
**是**:一个 DSH 插件(Host + Client 两半)。Host 半边负责拉起/停掉机器人进程、把浏览器请求同源代理到本机 8080、并注册 9 个 Agent 工具;Client 半边在 **设置 → 鲸鱼娘** 提供完整设置…
或者用 DSH 桌面版「插件」页的本地安装入口指向本目录。装完**重启一次 DSH**(bundle 层要重启才组装)。
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-18. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
