ディレクトリに戻る

dsh-qqbot

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

tencent-connect/dsh-qqbot

dsh 公式 QQ Bot IM チャネル:WebSocket、QR 绑定、peer 隔离、Markdown 分割返信、slash コマンド

GitHub で見る
$ npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot

616

スター

77

フォーク

TypeScript

言語

MIT

ライセンス

2026-08-14

作成日

2026-11-20

最終プッシュ

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` 環境変数

インストール手順

  1. 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

  2. 02

    ボットを起動:`npx @deepseek-ai/dsh --profile qqbot`

    $ npx @deepseek-ai/dsh --profile qqbot

  3. 03

    初回起動時、プラグインはターミナルの QR コードスキャンガイドに沿って認証情報を紐付けます。あるいは先に `QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"` をエクスポートしてください

  4. 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 統合ネイティブ実行

ファーストクラスの 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 コード描画のずれを回避できるためです。
2026-08-142026-08-260.4.0

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つずつ進行します。

08データと出典

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

    **基于 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 QQ Bot 插件,将 DeepSeek AI 助手接入 QQ 私聊与群聊。*…

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

    npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot

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

    - **纯 Cordis 插件** — 遵循 dsh "Plugins, not loop changes" 原则

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

🏆

dsh プラグイン おすすめ

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

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

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