DSH プラグインで、NapCat / OneBot v11 を使って普通の QQ アカウントを動かします。人設、気分、人ごとの記憶、画像と Bilibili 動画の理解、グループ管理、トークン必須の Web コンソールを備え、既定は全拒否で許可リストを入れて初めて返信します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-18
ライセンス
NOASSERTION
01どんなタスクに使えるのか?
普通の QQ アカウントに人設と記憶を持たせて、グループと個人チャットで発言させる
人設に沿って文を区切った短い返信と 6 種類の気分、さらに人ごとの長期記憶とセッション要約がローテーション後も引き継がれます
自分の QQ 番号をグループ内で人間らしく動かしたいが、公式ボットの申請はしたくない人
画像と Bilibili の動画を理解してから返事をする
画像の内容に基づく返信、あるいは動画の字幕・フレーム・弾幕・人気コメントを一通り見てからの返信。視聴は一時セッションで行い、メイン側には要約だけが残ります
グループにスクリーンショットや動画リンクを貼り、「開けません」ではなく本物の反応を期待するメンバー
グループを守り、Web コンソールからボットの状態を把握する
語句リストに当たったときの自動撤回とミュート、グループ管理、リマインダー、そしてセッション・記憶・連絡先・視聴履歴・設定・ログをまとめたコンソール
サーバーで常駐させ、管理手段は欲しいがログを見るために SSH はしたくないグループ管理者
02DeepSeek Harness への導入方法
前提条件
- すでに通常どおり会話できる DeepSeek Harness(既定モデルが設定済み)。README が最初に挙げています
- 予備の QQ アカウント
- NapCat または他の OneBot v11 実装で、WebSocket サーバーが有効なこと
- 動画のフレーム単位の解析まで行うなら、ローカル PATH に `ffmpeg` が必要です
インストール手順
- 01
`dsh plugin add qfish`(または `pnpm add git+https://github.com/hyun20202023-ui/dsh-qfish.git`)を実行し、DSH を再起動します
$ dsh plugin add qfish
- 02
NapCat を入れて QQ にログインし、WebSocket サーバーを新規作成します。ポート 3001、メッセージ形式 `array` です
- 03
DSH → プラグイン設定 → qfish で `url` を `ws://127.0.0.1:3001` にし、`consolePort` は `8090` のままにします。サーバーで動かす場合は `consoleListen` を `0.0.0.0` に変えます
- 04
アクセス方式を選びます。許可リスト(`userAccessMode: allowlist` と `userIds`、`groupAccessMode: allowlist` と `groupIds`)か、全開放(両方 `blocklist` でリストは空)です
- 05
NapCat の画面、またはコンソールの「行为参数」タブの QR コードで QQ にログインします
- 06
コンソールを `http://<アドレス>:8090/?t=<トークン>` で開きます。トークンは設定の `consoleToken`、空の場合は `<profile>/onebot-data/console-token.txt` に自動生成された値です
導入成功の確認
- コンソールの状態で `napcat` が true になっていること
- 有効にしたグループでメンションすると返信が返ること。個人チャットを試すには先に `respondToPrivate` を `true` にし、`userIds` に自分の QQ 番号を入れます
- DSH の起動ログに「控制台已启动:http://…」の行があり、その行全体がトークン付きの URL になっていること
03DSH 統合と能力の範囲
DSH プラグインバンドルで、OneBot v11 の WebSocket 経由で NapCat に接続します。モデル、セッション、ツールはすべて DSH 側で動き、同じパッケージにトークン必須の Web コンソールと DSH ページ右下の入口ボタンも含まれます。
人設・気分・言葉の模倣
markdown の人設ファイル、グループの直近のメッセージ、スラング / 禁止語 / ネタのリスト→文字数ではなく語気で区切った短い返信。気分と好感度が長さ・絵文字・記憶の語気に影響します
気分と好感度の状態を `mood.json` に、スラング表を `slang.json` / `slang-normal.json` に書き込みます記憶とセッションのローテーション
グループと個人チャットでの各人の会話履歴→人ごとの記憶(上限に達すると自動で圧縮)、ローテーション後も引き継がれる要約、話についていけるようにするグループキャッシュ
profile のデータディレクトリに `memories.json`、`summaries.json`、`state.json` を書き込みます個人チャットのローテーションでは記憶も 1 件圧縮しますが、グループでは書きませんグループ管理
5 種類の語句リストとマスタースイッチ→ヒット時に自動で撤回とミュート。ミュートしない段階も選べます
接続中の QQ グループでメッセージを撤回し、メンバーをミュートします画像と Bilibili 動画の理解
チャットに送られた画像、または Bilibili の動画リンク→画像に基づく返信、または字幕・フレーム・弾幕・人気コメントに基づく返信。長すぎる動画は正直に断ります
フレーム単位の解析には `ffmpeg` が必要で、9 分割のフレームキャッシュを `frames/` に置きます視聴履歴を `bili-memory.json` と `video-notes.json` に書き込みますWeb コンソール
コンソールのトークンを伴うブラウザリクエスト→セッション、記憶、連絡先、視聴履歴、設定、ログを 1 ページで確認でき、返信数や動画の長さなどの挙動パラメータも調整できます
`consolePort`(既定 8090)で HTTP を提供し、`consoleListen` にバインドしますDSH ページ右下のフローティングボタンからも同じコンソールを開けますコンテンツツールと運用
会話中にモデルが発行するリクエスト→画像検索、Web 検索と本文取得、Bilibili カード、NetEase / QQ 音楽カード、リマインダー、グループをまたぐ送信、`/dsh` のサーバーコマンド
他のグループや個人チャットへメッセージを送ります`/dsh` はサーバーコマンドを実行し、バックエンド権限に限定されます
04誰に向いているのか?使うべきでない場面は?
向いている用途
- 自分の QQ 番号をグループ内で人間らしく動かしたいが、公式ボットの申請はしたくない人
- グループにスクリーンショットや動画リンクを貼り、「開けません」ではなく本物の反応を期待するメンバー
- サーバーで常駐させ、管理手段は欲しいがログを見るために SSH はしたくないグループ管理者
不向きな用途
- 既定は全拒否です。導入直後は誰にも返信しません。設定で QQ ユーザー / グループの許可リストを入れる必要があり、空のリストは全拒否を意味します。全開放するには両方のアクセス方式を `blocklist` にしてリストを空にします。
- `dsh-onebot` とは同時に導入できません。どちらも `/onebot/api` を登録し、同じ NapCat 接続を取り合います。本プロジェクトは `dsh-onebot@1.4.0`(MPL-2.0)からの二次開発で、関連コードは引き続き MPL-2.0 が適用されます。
- コンソールには到達可能なポートとトークンが必要です。サーバーでは `consoleListen` を `127.0.0.1` から `0.0.0.0` に変え、8090(NapCat の Web UI 用に 6099)を開放します。3001 はローカルのプラグイン専用なので公開しないでください。
- プロトコル側は規制を受ける可能性があります。qfish は OneBot / NapCat と普通の QQ アカウントを使い、README の比較表にも「協議端有风控可能」と書かれています。同じ QQ 番号を 2 台で同時にログインすることもできず、2 つの NapCat は互いを蹴り出します。
05互換性・メンテナンス・セキュリティ上の注意
- 既定は全拒否です。導入直後は誰にも返信しません。設定で QQ ユーザー / グループの許可リストを入れる必要があり、空のリストは全拒否を意味します。全開放するには両方のアクセス方式を `blocklist` にしてリストを空にします。
- `dsh-onebot` とは同時に導入できません。どちらも `/onebot/api` を登録し、同じ NapCat 接続を取り合います。本プロジェクトは `dsh-onebot@1.4.0`(MPL-2.0)からの二次開発で、関連コードは引き続き MPL-2.0 が適用されます。
- コンソールには到達可能なポートとトークンが必要です。サーバーでは `consoleListen` を `127.0.0.1` から `0.0.0.0` に変え、8090(NapCat の Web UI 用に 6099)を開放します。3001 はローカルのプラグイン専用なので公開しないでください。
- プロトコル側は規制を受ける可能性があります。qfish は OneBot / NapCat と普通の QQ アカウントを使い、README の比較表にも「協議端有风控可能」と書かれています。同じ QQ 番号を 2 台で同時にログインすることもできず、2 つの NapCat は互いを蹴り出します。
NOASSERTION(README に dsh-onebot@1.4.0 からの二次開発である旨と、関連コードに引き続き MPL-2.0 が適用される旨の記載) · README ブランチ main · 最新リリース v0.3.31 (2026-11-13)
06よくある質問
導入直後にまったく返信しないのはなぜですか?
それが既定の状態です。qfish は全拒否で始まり、空のリストは誰にも返信しないことを意味します。`userAccessMode` を `allowlist` にして `userIds` に自分の QQ 番号、`groupAccessMode` を `allowlist` にして `groupIds` にグループ番号を入れます。両方を `blocklist` にしてリストを空にすれば全開放です。個人チャットには別途 `respondToPrivate` を `true` にする必要があります。
DSH の外に何が必要ですか?
NapCat(または他の OneBot v11 実装)と、有効な WebSocket サーバーです。ローカルならポート 3001・メッセージ形式 `array` の WebSocket サーバーを作ります。サーバーなら `mlikiowa/napcat-docker` イメージを使い、3001 と 6099 を公開して、`http://<サーバーIP>:6099` をブラウザで開き QR コードから QQ にログインします。フレーム単位の動画解析まで行う場合だけ、PATH に `ffmpeg` が必要です。
QQ はオンラインなのに毎ターン blocked になる場合は?
DSH が qfish のセッションを「已归档(アーカイブ済み)」にした可能性があります。アーカイブされたセッションは実行前に拒否され、モデルは一度も走りません。DSH を終了し、`~/.dsh/storages/workspace.json` を開いて `archivedSessionIds` の中で `onebot:` で始まる項目をすべて削除し、DSH を起動し直します。コンソールのチャット欄が動かない場合は、profile に既定モデルが無いことが多く、`cordis.patch.yml` に `agent-default-model` のブロックを追加します。
Web コンソールにはどう入りますか?
コンソールはトークン必須の Web ページで、URL は `http://<アドレス>:8090/?t=<トークン>` です。トークンは設定の `consoleToken`、空なら `<profile>/onebot-data/console-token.txt` に自動生成された値、または DSH の起動ログにある「控制台已启动:http://…」の行そのものです。サーバーで使う場合は先に `consoleListen` を `0.0.0.0` にして 8090 を開放します。
dsh-onebot と一緒に導入できますか?
できません。qfish は `dsh-onebot@1.4.0` からの二次開発で、どちらも `/onebot/api` を登録し同じ NapCat 接続を取り合うため、同時に入れると接続できなくなります。関連コードには引き続き MPL-2.0 が適用されます。
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データと出典
> qfish 是 DeepSeek Harness 的 QQ 插件。用 NapCat / OneBot 接普通 QQ 号,不需要申请官方机器人。
- **直连 DSH**:模型、会话、工具都走 DSH,中间没有别的层
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-18。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
