ディレクトリに戻る

dsh-qfish

キュレーションリスト掲載メンテナンス: 活発

hyun20202023-ui/dsh-qfish

DeepSeek Harness向けのQQボットプラグインです。OneBot v11/NapCatに対応し、キャラクター設定、記憶、気分、学習記録やWebコンソールを備えます。

GitHub で見る
$ dsh plugin add qfish

19

スター

2

フォーク

JavaScript

言語

NOASSERTION

ライセンス

2026-11-02

作成日

2026-11-17

最終プッシュ

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` が必要です

インストール手順

  1. 01

    `dsh plugin add qfish`(または `pnpm add git+https://github.com/hyun20202023-ui/dsh-qfish.git`)を実行し、DSH を再起動します

    $ dsh plugin add qfish

  2. 02

    NapCat を入れて QQ にログインし、WebSocket サーバーを新規作成します。ポート 3001、メッセージ形式 `array` です

  3. 03

    DSH → プラグイン設定 → qfish で `url` を `ws://127.0.0.1:3001` にし、`consolePort` は `8090` のままにします。サーバーで動かす場合は `consoleListen` を `0.0.0.0` に変えます

  4. 04

    アクセス方式を選びます。許可リスト(`userAccessMode: allowlist` と `userIds`、`groupAccessMode: allowlist` と `groupIds`)か、全開放(両方 `blocklist` でリストは空)です

  5. 05

    NapCat の画面、またはコンソールの「行为参数」タブの QR コードで QQ にログインします

  6. 06

    コンソールを `http://<アドレス>:8090/?t=<トークン>` で開きます。トークンは設定の `consoleToken`、空の場合は `<profile>/onebot-data/console-token.txt` に自動生成された値です

導入成功の確認

  • コンソールの状態で `napcat` が true になっていること
  • 有効にしたグループでメンションすると返信が返ること。個人チャットを試すには先に `respondToPrivate` を `true` にし、`userIds` に自分の QQ 番号を入れます
  • DSH の起動ログに「控制台已启动:http://…」の行があり、その行全体がトークン付きの URL になっていること

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

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 は互いを蹴り出します。
2026-11-022026-11-14v0.3.31

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 が適用されます。

08データと出典

  • 作者による申告github.comaf03f4cf6981…

    > qfish 是 DeepSeek Harness 的 QQ 插件。用 NapCat / OneBot 接普通 QQ 号,不需要申请官方机器人。

  • 作者による申告github.comaf03f4cf6981…

    - **直连 DSH**:模型、会话、工具都走 DSH,中间没有别的层

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-18。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。