Derpyu520/qq-bridge

何を解決するか

このプロジェクトは、QQメッセージングとDeepSeek Harness（DSH）エージェントフレームワークを接続し、ユーザーがQQのプライベートメッセージまたはグループチャットを通じてAIエージェントと対話できるようにします。QQメッセージをDSHセッションに変換し、エージェントの応答、質問、ツール承認をユーザーに返信します。

動作方法

このブリッジは、SnowLuma（OneBot v11 WebSocketクライアント）とDSH Web APIの間のミドルウェアとして機能します。各QQチャット（プライベートまたはグループ）を専用の「QQチャット」ワークスペース内の固有のDSHセッションにマッピングします。

主な技術的構成要素は以下の通りです：

• 通信：SnowLumaを介してQQにWebSocket接続し、DSHにはREST/Event-stream APIを使用。
• MCP統合：Model Context Protocol（MCP）サーバーを統合し、安全な機能（メッセージ送信、グループステータス確認、SSRF保護付きのWeb検索など）をエージェントに提供。
• 運用モード：chat（標準的な安全なチャット）、closed-agent（所有者専用の完全ツールアクセス）、reserved（状態機械による活動・沈黙のシミュレートされたグループメンバー動作）の複数モードをサポート。
• 対話ロジック：メッセージ引用（返信）、スラッシュコマンド（例：/reset）、シミュレートされた役割のためのマルチパートメッセージ分割などの複雑なQQ対話を処理。

対象ユーザー

• AIエージェントをQQに導入したいDeepSeek Harnessのユーザー。
• 自動的に観察・参加できる「AIシミュレートグループメンバー」を開発したい開発者。
• QQ経由でDSHインスタンスをリモートで制御したいパワーユーザー。

特徴

• マルチモード運用：標準チャット、所有者専用エージェント制御、自律的シミュレーションモードの切り替えが可能。
• 安全なツール：MCPを介してQQ操作の制限されたサブセットを使用し、不正なアカウント制御を防止。
• セッション管理：QQ IDとDSHセッション間のマッピングを自動的に管理・永続化。
• インタラクティブフィードバック：エージェントがユーザーに質問やツール承認を求める場合、それを直接QQに転送し、リアルタイムでの意思決定を可能にする。
• 組み込みコンソール：リアルタイムでのモード切り替えやロール設定が可能なWebベースの制御パネルを備えている。