MIT ライセンスの DSH プラグイン。設定ページと 9 つの `whalegirl_*` エージェントツールから自前の WeChat / QQ ボットを管理・設定します。ボット本体やそのリソース、GPU 依存は Python 側に残ります。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-18
ライセンス
MIT
01どんなタスクに使えるのか?
DSH の中から自前の WeChat / QQ ボットを起動・停止・再起動する
固定の起動シーケンス(WeChat UIA をホットアクティブ化 → Web サービス起動 → WeChat 接続)でプロセスを管理し、再起動前にキューを確認して処理中の返信を中断しません。状態は会話に返ります
deepseekgirl 系のボットを自前で運用し、Python サイドカーの再起動のたびにターミナルへ戻りたくない運用担当者
YAML を手で書かずにボットの人格とおしゃべり頻度を調整する
設定ページには 22 項目の機能スイッチ、人格フォーム(表示名 / 説明 / プロンプト / temperature / token 上限 / 会話例。保存でホット更新)、3 段階の返信頻度プリセットと 12 項目の微調整があります
人格と返信頻度を毎日のように調整し、変更をすぐ反映させたいボットの管理者
ダッシュボードではなくツール経由でエージェントにボットを操作させる
`whalegirl_status / start / stop / restart / say / image / cover / divination / config` の 9 つのツールを会話から呼べます
設定済みのアカウントで、会話の途中にエージェントからメッセージや画像を送らせたい利用者
02DeepSeek Harness への導入方法
前提条件
- Windows とログイン済みの WeChat デスクトップ版(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 plugin --profile web add /path/to/dsh-we-whalegirl
- 03
DSH を 1 回再起動します(bundle 層は再起動時にしか組み立てられません)。
- 04
profile の `cordis.patch.yml` に `botRoot`(`web_main.py` があるディレクトリ)を追加します。書かないと「启动」を押したときに未設定と表示されます。
導入成功の確認
作者は未記載
03DSH 統合と能力の範囲
Host と Client の 2 層からなる DSH のネイティブプラグインです。Host 側はボットプロセスの起動 / 停止、`/dsh-we-whalegirl/*` から `127.0.0.1:8080/api/*` への同一オリジンプロキシ、9 つの `whalegirl_*` ツールの登録を担当し、Client 側が 設定 → 鲸鱼娘 ページを描画します。
プロセススーパーバイザ
設定ページまたは `whalegirl_*` ツールからの起動 / 停止 / 再起動の指示→固定の起動シーケンスで動く Python サイドカー。再起動のたびにキューを確認します
`web_main.py` を子プロセスとして起動する独自ログを `%USERPROFILE%\.dsh\dsh-we-whalegirl\plugin.log` に書く(2 MB ローテーション)22 項目の機能スイッチ
設定 → 鲸鱼娘 のスイッチ→ボット自身の `config.yaml` を直接書き換えます。プラグイン側に状態の複製は持ちません
ボットの `config.yaml` に書き込む多くのスイッチはボットの再起動後に反映される人格エディタとホット更新
表示名、説明、プロンプト、temperature、token 上限、会話例→保存した時点で反映される人格(再起動も WeChat 再ログインも不要)。「锁定出厂人设」のロックも用意されています
ボットの `/api/style*` エンドポイント経由で人格フィールドを書き込む9 つのエージェントツール
DSH の会話からのツール呼び出し→状態の読み取り、プロセス制御、設定済みアカウントでのメッセージや画像の送信、占いの抽選、プラグイン設定の読み取り専用表示
設定済みの WeChat / QQ アカウントから実際にメッセージや画像を送信するプラットフォーム設定と任意の概要パネル
WeChat チャネルの制御、監視グループ一覧、QQ オープンプラットフォームの認証情報、`enablePanel: true`→設定ページからのプラットフォーム設定に加え、`enablePanel` を有効にするとサイドバーに「鲸鱼娘」の概要(統計・機能セルフチェック・メッセージストリーム・ログ)が出ます
QQ の Secret はボット本体の Fernet 鍵で暗号化して保存される
04誰に向いているのか?使うべきでない場面は?
向いている用途
- deepseekgirl 系のボットを自前で運用し、Python サイドカーの再起動のたびにターミナルへ戻りたくない運用担当者
- 人格と返信頻度を毎日のように調整し、変更をすぐ反映させたいボットの管理者
- 設定済みのアカウントで、会話の途中にエージェントからメッセージや画像を送らせたい利用者
不向きな用途
- 多くの機能スイッチはボットの再起動後にしか反映されません(handler のスイッチは起動時に一度だけ注入されるため)。人格だけは例外で、保存すればホット更新されます。
- WeChat チャネルは Windows とログイン済みの WeChat デスクトップ版が必要です。UI オートメーションで動くため、ウィンドウを最小化できず、ボットは対話的なデスクトップセッション内で動かす必要があります。
- プラグインはボット側で追加された `/api/settings*`、`/api/style*`、`/api/capabilities`、`/api/divination` に依存します。上流の `linxisama/deepseekgirl` を使う場合はこれらを先に追加する必要があり、ボットのディレクトリには `.venv\Scripts\python.exe` と `web_main.py` がなければなりません。
- 曲ライブラリ・スタンプ・モデルの重みはすべてボット側にあり、プラグインには含まれません。設定ページで編集できるフィールドの許可リストも、ボット側の `settings_api.py` が決めます。
05互換性・メンテナンス・セキュリティ上の注意
- 多くの機能スイッチはボットの再起動後にしか反映されません(handler のスイッチは起動時に一度だけ注入されるため)。人格だけは例外で、保存すればホット更新されます。
- WeChat チャネルは Windows とログイン済みの WeChat デスクトップ版が必要です。UI オートメーションで動くため、ウィンドウを最小化できず、ボットは対話的なデスクトップセッション内で動かす必要があります。
- プラグインはボット側で追加された `/api/settings*`、`/api/style*`、`/api/capabilities`、`/api/divination` に依存します。上流の `linxisama/deepseekgirl` を使う場合はこれらを先に追加する必要があり、ボットのディレクトリには `.venv\Scripts\python.exe` と `web_main.py` がなければなりません。
- 曲ライブラリ・スタンプ・モデルの重みはすべてボット側にあり、プラグインには含まれません。設定ページで編集できるフィールドの許可リストも、ボット側の `settings_api.py` が決めます。
MIT(プラグインコードのみ)· README ブランチ main · タグ付きリリースなし、最終 push 2026-10-20
06よくある質問
このプラグインにボット本体は含まれますか?
含まれません。README は Host と Client の 2 層からなる DSH プラグインであり、ボット本体ではないと明記しています。WeChat の 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` を提供している必要があります。
人格の変更にボットの再起動は必要ですか?
不要です。人格は保存すればホット更新され、再起動も WeChat の再接続も要りません。一方、多くの機能スイッチは再起動が必要です。handler のスイッチは起動時に一度だけ注入されるためです。
エージェントが呼べるツールは?
`whalegirl_status`、`start`、`stop`、`restart`、`say`、`image`、`cover`、`divination`、`config` の 9 つです。`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
by xmanrui
8 IM 渠道(飞书/微信/钉钉/企微/QQ/Telegram/Discord/WhatsApp)を DSH に統合。QR/凭据、流式返信
dsh-aurabot-qq
by aureth-labs
OneBot v11経由でDSHセッションをQQに接続し、チャット、メディア、記憶、ソーシャル機能を切り替え可能なツールとして公開します。
dsh-qqbot
by tencent-connect
dsh 公式 QQ Bot IM チャネル:WebSocket、QR 绑定、peer 隔离、Markdown 分割返信、slash コマンド
dsh-wechat
by xcisxc29
DeepSeekハーネスのWeChatチャンネル。
08データと出典
**是**:一个 DSH 插件(Host + Client 两半)。Host 半边负责拉起/停掉机器人进程、把浏览器请求同源代理到本机 8080、并注册 9 个 Agent 工具;Client 半边在 **设置 → 鲸鱼娘** 提供完整设置…
或者用 DSH 桌面版「插件」页的本地安装入口指向本目录。装完**重启一次 DSH**(bundle 层要重启才组装)。
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-18。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
