MIT ライセンスのファーストクラスネイティブ dsh プラグイン(`dsh plugin ... add` でインストール)。QQ 内で DeepSeek Harness エージェントを実行 — ピアごとの分離されたセッション、Markdown のチャンク分割返信、スラッシュコマンド、QR コードスキャンによる認証情報の紐付けに対応。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-08-28
ライセンス
MIT
01どんなタスクに使えるのか?
QQ の個別メッセージやグループチャットから DeepSeek Harness エージェントとチャットする
dsh 向けの公式 QQ Bot チャネル:メッセージは QQ WebSocket トランスポートを介して dsh エージェントループに流れ込み、ピアごとに分離されたエージェント、Markdown のチャンク分割返信、スラッシュコマンド、QR コードスキャンによる認証情報の紐付け、プリセットのマウントをサポート
QQ の個別チャットやグループ内で DeepSeek Harness(dsh)エージェントと対話したい開発者やユーザー
QQ チャット内からエージェントのセッション、モデル、プリセットを管理する
組み込みのスラッシュコマンド:/new(エイリアスは /reset /clear)、/compact、/model、/preset、/stop、/bot-ping、/bot-version、/bot-status、/bot-help
チャットから離れずにセッションコンテキストを制御し、モデルやプリセットを切り替え、生成を停止したい QQ ボットユーザー
02DeepSeek Harness への導入方法
前提条件
- npx 経由で公式 dsh CLI を実行できる環境 — README のすべてのコマンドは `npx @deepseek-ai/dsh` を使用
- QQ オープンプラットフォーム上の QQ Bot:AppID / AppSecret、または `QQBOT_APPID` / `QQBOT_SECRET` 環境変数
インストール手順
- 01
プロファイルにインストール:`npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot`
$ npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
- 02
ボットを起動:`npx @deepseek-ai/dsh --profile qqbot`
$ npx @deepseek-ai/dsh --profile qqbot
- 03
初回起動時、プラグインはターミナルの QR コードスキャンガイドに沿って認証情報を紐付けます。あるいは先に `QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"` をエクスポートしてください
- 04
ローカルパスからのインストール:`cd /path/to/dsh-qqbot && pnpm install && pnpm build` の後に `npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot` を実行
$ npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot
導入成功の確認
- QQ チャットで `/bot-ping` を送信 — README では接続テスト(连通性测试)として記載されています
03DSH 統合と能力の範囲
ファーストクラスの dsh プラグイン:`npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot` で dsh プロファイルにインストールし、`npx @deepseek-ai/dsh --profile qqbot` で起動します。dsh の「Plugins, not loop changes」原則に従う純粋な Cordis プラグインです
QQ 個別 / グループチャットトランスポート
QQ の個別メッセージ、または `requireMention` が有効な場合に @bot を含むグループメッセージ→メッセージは QQ WebSocket トランスポート経由で dsh エージェントループに入り、アシスタントの返信は QQ sendMarkdown で送り返されます
初回起動時に認証情報が未設定の場合、プラグインはターミナルの QR コードスキャンガイドに入り、認証情報をプロファイルに保存するMarkdown チャンク分割返信
長いエージェントの返信テキスト→コードブロック / テーブルを考慮したチャンク分割で Markdown 形式の返信を送信。`textChunkLimit`(デフォルト 4500)が各メッセージの上限を設定
長い返信は `textChunkLimit` に従って複数のメッセージに分割されるスラッシュコマンド
/new, /compact, /model, /preset, /stop, /bot-ping, /bot-version, /bot-status, /bot-help→新しいセッション、履歴の圧縮、モデル / プリセットの切り替え、生成の停止、接続テスト、ステータスとヘルプの出力
/compact は古いレコードを要約で置き換えてセッション履歴を圧縮するピアごとのセッション分離と復元
QQ のピア — 個別メッセージのユーザー1人、またはグループチャット1つ→各ピアは独立したエージェントを持ちます。sessionKey(`qqbot:${appId}:${scope}:${peerId}`)は SHA-256 で決定論的に導出され、再起動後に復元されます
メモリリークを防ぐため、アイドル状態のエージェントはタイムアウト後に自動的に破棄される(デフォルト 30 分)プリセットのマウント
エージェントのプリセット ID。`agent-presets` サービスを通じてマウントされる→プリセットのツールセット、プロンプト、その他のエージェント設定が適用されます。プリセットは新しいセッションで有効になります
ask_user_question による Q&A インタラクション
会話の途中でエージェントがユーザーに尋ねる質問→単一選択はインラインボタンで表示(1つをクリックすると残りがグレーアウト)、複数選択は番号で返信。質問は 1 つずつ進行し、質問ごとにタイムアウトが設定される
未回答の質問は `askTimeoutMs`(デフォルト 300000 ms / 5 分)後にタイムアウトする
04誰に向いているのか?使うべきでない場面は?
向いている用途
- QQ の個別チャットやグループ内で DeepSeek Harness(dsh)エージェントと対話したい開発者やユーザー
- チャットから離れずにセッションコンテキストを制御し、モデルやプリセットを切り替え、生成を停止したい QQ ボットユーザー
不向きな用途
- QQ オープンプラットフォームのボットが必要:`appId` と `appSecret` は必須項目(必填)としてマークされています(または `QQBOT_APPID` / `QQBOT_SECRET` 環境変数で提供)。初回起動時に認証情報がない場合、プラグインはターミナルの QR コードスキャンガイドに入り、モバイル QQ アプリで認証情報を紐付けます。
05互換性・メンテナンス・セキュリティ上の注意
- QQ オープンプラットフォームのボットが必要:`appId` と `appSecret` は必須項目(必填)としてマークされています(または `QQBOT_APPID` / `QQBOT_SECRET` 環境変数で提供)。初回起動時に認証情報がない場合、プラグインはターミナルの QR コードスキャンガイドに入り、モバイル QQ アプリで認証情報を紐付けます。
- グループチャットでは、デフォルトでは @メンションされた場合のみボットが発動し(`requireMention` はデフォルトで `true`)、各返信メッセージは `textChunkLimit` 文字(デフォルト 4500)に制限されるため、長い返信は分割されます。
- README では、QR コードをスキャンする前に `0.4.0` 以上へのアップグレードを推奨しています。これらのバージョンはブラウザでリンクを開くことをサポートし、一部のターミナルでの QR コード描画のずれを回避できるためです。
MIT · actively maintained (latest release 0.4.0, 2026-08-16; last push 2026-08-26)
06よくある質問
DeepSeek Harness に dsh-qqbot をインストールするには?
`npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot` で dsh プロファイルにインストールし、`npx @deepseek-ai/dsh --profile qqbot` で起動します。ローカルでビルドしてローカルパスを追加することもできます:`npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot`。
QQ Bot の認証情報を紐付けるには?
初回起動時に認証情報が未設定の場合、プラグインは自動的に QR コードスキャンガイドに入ります。ターミナルに QR コードが表示され、モバイル QQ アプリでスキャンすると認証情報がプロファイルに保存されます — 以降の起動で再スキャンは不要です。あるいは `QQBOT_APPID` / `QQBOT_SECRET` 環境変数を設定してください(設定キーは `appId` / `appSecret`)。
QQ のチャットごとに専用のエージェントが割り当てられますか?
はい — セッション分離は設計原則です。QQ の個別チャットのユーザーやグループチャットごとに独立したエージェントが割り当てられます。セッションキー(`qqbot:${appId}:${scope}:${peerId}`)は SHA-256 で決定論的に導出されるため、再起動後もセッションが復元され、メモリリークを防ぐためにアイドル状態のエージェントは自動的に破棄されます。
どのスラッシュコマンドが組み込まれていますか?
`/new`(エイリアスは `/reset` `/clear`)、`/compact`、`/model`、`/preset`、`/stop`、`/bot-ping`、`/bot-version`、`/bot-status`、`/bot-help` です。たとえば `/compact` は古いレコードを要約で置き換えてセッション履歴を圧縮し、`/bot-ping` は接続テストです。
QQ では長い返信はどのように処理されますか?
返信はコードブロック / テーブルを考慮したチャンク分割で Markdown 形式で送信されます。`textChunkLimit`(デフォルト 4500)が各メッセージの上限です。Q&A インタラクションは `ask_user_question` に対応しており、単一選択はインラインボタンで表示(1つクリックすると残りがグレーアウト)、複数選択は番号で返信し、質問ごとのタイムアウトで1つずつ進行します。
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-wechat
by xcisxc29
DeepSeekハーネスのWeChatチャンネル。
dsh-onebot-qq
by yusaltyfish
DeepSeek HarnessにQQボット機能を追加します。LinuxとWindowsに対応し、9つのサブプラグインでメッセージ受信、画像送信・生成、スタンプ送信を行います。
08データと出典
**基于 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 QQ Bot 插件,将 DeepSeek AI 助手接入 QQ 私聊与群聊。*…
npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
- **纯 Cordis 插件** — 遵循 dsh "Plugins, not loop changes" 原则
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-08-28。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
