K0nd1us/QQ-agent

解決する課題

QQ Agentは、QQの会話のためのローカルAIアシスタントを提供します。モデルの対話、セッション管理、メモリ、ペルソナ設定、Web検索、およびプラグインベースの機能拡張を処理します。プロジェクトは現在、安定したベースライン（0.4）と、モジュール性とリソース管理を改善するためのアーキテクチャ刷新中（0.5）の2つのバージョンに分かれています。

仕組み

このプロジェクトは、ユーザーが個別にインストールおよび設定する必要があるOneBot v11プロトコルを介してQQに接続します。エージェントはアプリケーション層として機能し、メッセージの処理とロジックの実行を行います。バージョン0.5では「シンカーネル」アーキテクチャが導入され、コンポーネントが明確に定義されているため、コンポーネントの交換、標準化されたSDKベースの拡張開発、および起動時や障害時のより信頼性の高いリソースクリーンアップが可能になります。

対象ユーザー

QQ上でローカルかつカスタマイズ可能なAIアシスタントを実行したいユーザー向けです。安定した既存のベースラインが必要な場合はバージョン0.4が推奨されます。バージョン0.5は、開発者や新しいモジュール式アーキテクチャのテストに関心があるユーザーを対象としていますが、現在は未完成であり、機能の手動検証が必要です。

ハイライト

• デュアルバージョン構造： 安定したベースライン（0.4）と進行中のアーキテクチャ刷新（0.5）を分離し、破壊的変更を防ぎます。
• モジュール式アーキテクチャ： バージョン0.5では、コアサービス、フロントエンドパネル、プラグイン間の境界を明確にすることに重点を置き、モジュール間の依存関係を削減します。
• 拡張可能な設計： 定義されたSDK、権限境界、ライフサイクル管理を備えたプラグインとスキルをサポートします。
• プロトコル非依存： OneBot v11を使用してQQとインターフェースし、ユーザーがプロトコル側のインストールと資格情報を自分で管理できるようにします。
• リソース制御： コンポーネントと拡張機能がリソースを管理する方法を改善し、メモリリークや残存タスクを防ぎます。