Back to directory

dsh-we-whalegirl

In a curated listMaintenance: Active

gzyy111/dsh-we-whalegirl

Manage the bot and use agent tools to send messages or images through the configured account.

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

14

stars

2

forks

JavaScript

Language

MIT

License

2026-10-20

Created

2026-10-20

Last push

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

  1. 01

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

  2. 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

  3. 03

    Restart DSH once — the bundle layer is only assembled on restart.

  4. 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

DSH integrationNative runtime

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 restarted
  • Persona 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*` endpoint
  • Nine 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 account
  • Platform 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`.
2026-10-202026-10-20Not specified by the author

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.

08Data and sources

  • Author-claimedgithub.com1c6b50320628…

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

  • Author-claimedgithub.com1c6b50320628…

    或者用 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.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.