QQ を dsh につなぐ:dsh-im プラグインと NapCat の実戦ガイド
ルート A はプラグインで QR 接続、ルート B は NapCat プロトコル側——フレーム検証済み 9 枚のスクリーンショットで、全ステップが元動画に深リンク。
最終更新: 2026-10-03
「dsh で QQ ボットは動く?」動きますし、方法は 2 つあります。ルート A はオープンソースプラグイン dsh-im(GitHub 実査で xmanrui/dsh-im、★1.6k、MIT):1 行のコマンドで導入し、設定画面で QR コードを読むだけで IM ボットを DeepSeek Harness に接続できます。QQ は WeChat・Feishu・DingTalk・WeCom・Telegram・Discord・WhatsApp・Slack と並ぶ 9 チャネルの 1 つ。ルート B はさらに NapCat——QQ クライアントのコミュニティ製プロトコル側——を重ねる構成で、実録動画のグループ機能(グループ参加やメンバー分析)はこちらで実現しています。
以下の 9 枚のスクリーンショットは 2 本の実録動画からフレーム検証したもので、すべて元動画の該当秒に深リンクします。同じプラグインの WeChat/Feishu 向けについては、WeChat 連携ガイドをどうぞ。 WeChat 連携:同じプラグインの WeChat 軸
要点だけ
- ▸ルート A:dsh-im を 1 コマンドで導入 → 設定 → プラグイン → IM ボット → QR 読み取り。QQ は 9 チャネルの 1 つ(WeChat/Feishu/DingTalk/WeCom/QQ/TG/Discord/WhatsApp/Slack)。
- ▸ルート B:NapCat(★10.8k の QQ プロトコル側)+ dsh webui の「QQ チャット」ワークスペース。メッセージはセッションとして dsh に着地し、キャッシュヒット 80% を実測。
- ▸実録デモ:ボットはメンバーとしてグループに参加し、1対1で画像と 10 秒音声を双方向でやり取り、セッションをまたいで動作。メンバーマップは 18 人 · 16 関係。
- ▸用語整理:dsh-im はプラグイン、NapCat はプロトコル側(プラグインではない)、MoonBot は動画作者の自作パネル(公開リポジトリなし)。検索しても出てきません。
ゼロから QQ ボットまで、全 9 ステップ
ルート A:dsh-im プラグイン(公式チャネル)
- 1
dsh-im プラグインを入れる
README にある 2 つの等価コマンド:npx -y github:xmanrui/dsh-im install の 1 行か、プラグイン市場経由の dsh plugin --profile web add @xmanrui/dsh-im。dsh-feishu・dsh-weixin・dsh-dingtalk を直接入れていた場合は、インストーラが dsh-im へ置き換え、既存のチャネル設定とキーはそのまま引き継がれます。
$npx -y github:xmanrui/dsh-im install$dsh plugin --profile web add @xmanrui/dsh-im
README の 2 ルート、どちらの 1 行でも入ります。元動画を見る 0:52 - 2
QR で接続:設定 → プラグイン → IM ボット
dsh web を再起動すると、設定に「IM ボット」パネルが増えます:9 プラットフォームそれぞれ QR コードで紐付け。動画では WeChat ボットが接続済みで、カードには「運行正常 · メッセージチャネル iLink ロングポーリング · 1/1 オンライン」と表示。QQ も同様に読み取るだけです。接続後は受信時に既読と「入力中」を表示してから、Harness の最終回答を返します。
QR を読めばカードが緑に:運行正常、1/1 オンライン。元動画を見る 0:14
ルート B:NapCat プロトコル側
- 3
NapCat を知る:QQ クライアントのプロトコル側
ルート B はもう 1 層下から。NapCat(NapNeko/NapCatQQ、★10.8k)は QQ クライアントプロトコルを実装し、WebUI(トークン付き 127.0.0.1:6099)でボットアカウントとバージョンを一元管理——動画では NapCat 4.9.49・QQ 9.9.26、ネットワーク設定 2 件に HTTP サーバー 1 件と WebSocket サーバー 1 件。dsh はこの層を直接触らず、NapCat が QQ を普通のメッセージ源に翻訳します。
NapCat は QQ クライアントの隣で動き、ネットワーク側はこの WebUI で接続します。元動画を見る 3:16 - 4
QQ メッセージが dsh に着地するのを見る
NapCat をつなぐと、dsh webui に「QQ チャット」ワークスペースが現れます:1対1もグループもセッションとして表示され、ロールカード(SPEECH RULES)が自動注入、ログには [Wake] private:… sleep ended のような起床イベントが流れ、ステータスバーは 1 ターン 1 ステップ、最初のトークンまで 0.6 秒・キャッシュヒット 80% を実測。dsh から見れば、ボットはもう 1 つのチャットウィンドウでしかありません。
つなぎ込みのコードは見えません——QQ メッセージがそのまま dsh のセッションになります。元動画を見る 3:24
実践:設定・ペルソナ・メンバー分析
- 5
実力を見る:グループ参加・画像・音声
動画ではボットが 5 人グループのメンバーリストに「DeepSeek Harness」の名前で載っています。1対1では画像と 10 秒音声を双方向でやり取り。作者いわく「理論的にすべての操作はセッションをまたげる」、Web 検索も「できる、ただし正確とは限らない」。オマケは QQ スペース:ボットが一人称で ATRI の日記を投稿しています。
グループにはメンバーとして入り、1対1では画像も音声も扱えます。元動画を見る 2:00 - 6
ボットの振る舞いスイッチを設定する
MoonBot パネル(動画作者自作、FAQ 参照)にはグループボットの要点が並みます:Agent 一式の有効化、連ターン注入、1対1のみキープ(最大 24 往復、アイドル 1,800,000 ミリ秒で切断)、友達申請と信頼(自動承認 + 友達ガード)、加えて Word 文書クォータ 100000。
ターン数・友達信頼・クォータ——ボットを暴れさせないスイッチはここに。元動画を見る 3:36 - 7
ボットに常駐ペルソナを与える
1 画面でボットの性格を定義します:常駐の自動化ガイド + 自由記述のプロンプトを保存すれば、全チャットで引き継ぎ。丁寧さ・おしゃべり度・簡潔さもここで決めます——QQ のグループ文化は個性で回っています。
ペルソナは 1 度だけ設定、全チャットで共有。元動画を見る 4:00 - 8
グループを読む:メンバー関係マップ
グループでしばらく動かすと、パネルが関係マップを描きます——動画では 18 人 · 16 関係、相互作用の強さは線の太さで表現、凡例はオーナー・グループ主・管理者・1対1で色分け。誰かをクリックすればカードが開きます。
数週間のグループチャットが 1 枚のソーシャルマップに。元動画を見る 4:45 - 9
メンバーカードを開く
各メンバーのダイアログは、上にチャットスタイルの要約、下にやり取りのタイムラインと関係網を敷きます——前ステップのマップのデータ源がここです。データは dsh が最初から見ているもので、人間向けに並べ替えただけ。
ドットを 1 回クリックすれば、その人の話し方まで教えてくれます。元動画を見る 4:50
よくある質問:dsh と QQ の接続
つなぐ前に本当に聞かれる 6 つの質問。
dsh で QQ ボットは動かせますか?
動きます。方法は 2 つ。ルート A は dsh-im プラグイン(npx 1 行)を入れて「設定 → プラグイン → IM ボット」から QR 接続——QQ は 9 チャネルの 1 つです。ルート B は dsh の前に NapCat プロトコル側を置く構成で、本ページの実録動画にあるグループ参加やメンバー分析といったグループ機能はこちらで実現しています。どちらか 1 つでも、組み合わせても構いません。
dsh-im と NapCat の違いは?どちらを選ぶべき?
dsh-im は dsh プラグインで、各プラットフォームの公式チャネル経由で QR 接続します(QQ・WeChat・Telegram・Discord を含む 9 チャネル)。NapCat(NapCatQQ)は dsh プラグインではなく、QQ クライアントプロトコルを実装したプロトコル側で、動画ではより「QQ ネイティブ」なグループ挙動を実現しています。手軽さなら dsh-im、グループ級のボット機能が要れば NapCat を追加。
NapCat は Tencent 公式ですか?安全ですか?
いいえ。NapCat(GitHub:NapNeko/NapCatQQ、★10.8k、TypeScript)はコミュニティのオープンソースプロジェクトで、NTQQ の上にモダンなプロトコル側を実装したものです。Tencent とも DeepSeek Harness とも無関係なので、実際の QQ アカウントを紐付ける前にはリスクを自己評価し、QQ の利用規約に従ってください。本ページでは公開デモの画面のみを引用しています。
接続後、QQ ボットには何ができますか?
実録では:一般メンバーとしてグループ参加、1対1での画像と 10 秒音声の双方向送受信、「理論的にすべての操作はセッションをまたげる」、Web 検索も「できる、ただし正確とは限らない」(作者の言葉)、さらに QQ スペースへの日記投稿まで。メンバー関係マップは 18 人 · 16 関係で、クリックでカードが開きます。あなたの dsh のモデルもプラグインもそのまま効きます——ボットはメッセージが harness に届くもう 1 つの扉にすぎません。
MoonBot はプラグインですか?どこで入手できますか?
プラグインではありません。MoonBot は動画作者(等一只萝卜子)が自身の運用のために作った制御パネルで、公開リポジトリはなく導入もできません。公開されている再現可能な経路は dsh-im(公式チャネル)+ NapCat(プロトコル側)です。MoonBot の画面は「この組み合わせで何ができるか」のデモとして見てください。
QQ 以外に、dsh はどのチャットアプリと接続できますか?
dsh-im は 9 チャネルを一度に扱えます:WeChat、Feishu、DingTalk、WeCom、QQ、Telegram、Discord、WhatsApp、Slack。日本を含む海外では Telegram と Discord の敷居が最も低く、同じ QR パネルがそのまま使えます。WeChat/Feishu 向けの手順は当サイトの WeChat 連携ガイドをどうぞ。
関連ガイド
続き:サイト内のほかの dsh ガイドとコレクション。
WeChat 連携:同じプラグインの WeChat 軸
同じ dsh-im プラグインの WeChat/Feishu 向け手順——QR ペアリング、スマホ側承認、ボット返答を実録でたどるガイド。
ガイドを読むプラグインインストールガイド
dsh-im はプラグイン生態系の 1 員にすぎません:インストールの仕組みとサードパーティコードの審査を 1 本で。
ガイドを読むdsh Web UI ガイド
「IM ボット」パネルも「QQ チャット」ワークスペースも webui の中:起動、ポート 3080、パネル地図を 1 度に。
ガイドを読むLAN アクセスとポート
QQ ボットから見えるのは既定ではローカルの dsh だけ。webui を LAN へ開く方法とファイアウォールを解説。
ガイドを読むリモートアクセス
LAN の外へ:トンネルとトークンで外部から dsh に届くように——ボットを向ける前に公開範囲を吟味を。
ガイドを読むリモート & モバイル コレクション
スマホ・トンネル・QR ペアリング系プラグインのカタログ——チャット側接続の先にあるリモート運用一式。
ガイドを読むソースとクレジット
スクリーンショットはすべて 2 本の第三者実録からフレーム検証したもので、各図が元動画の該当秒へ深リンクします。縦型の dsh-im 動画はクロップ済み(黄色のタイトル/字幕帯は全フレームで除外)。NapCat 実録の水族館壁紙はウィンドウ厳密クロップで除去。MoonBot パネルは動画作者の自作で公開リポジトリなし。リポジトリ名と star は 2026-10-03 に GitHub API で再確認:xmanrui/dsh-im(★1,589、MIT)、NapNeko/NapCatQQ(★10,830)。