AstrBot 専用コンパニオンプラグイン – 「永遠にあなたのそばにいます」

概要 – オープンソースのチャットボットフレームワーク AstrBot 向けのプラグインで、長期的なパーソナリティ駆動型の「コンパニオン」レイヤーを追加します。このプラグインは継続的なライフスタイルコンテキスト（状態、スケジュール、人間関係、夢、健康など）を保持し、そのコンテキストを使用して、プライベートチャット、グループチャット、または任意のスタンドアロンWeb UIを通じて、反応的な返信と能動的なメッセージ（挨拶、リマインダー、画像投稿、音声メッセージなど）を生成します。

---

基本コンセプト

AstrBotはすでに受信メッセージに回答する基本的な「ペルソナ」を提供しています。このプラグインはそのペルソナを置き換えるのではなく、以下のようなキャラクターの生きたシミュレーションによってそれを拡張します：

• 毎日の状態、スケジュール、場所、天気、健康、空腹度、および任意の周期的な気分を維持します。
• 主要ユーザー（「メインコンパニオン」）および二次ユーザーとの人間関係をトラッキングし、親密度レベル、インタラクション段階、最近のトピックを保存します。
• シミュレートされたライフイベント、時間ウィンドウ、トークン制限、権限チェックに基づいて、能動的なアクション（テキスト、画像、音声、ポック、スクリーンキャプチャなど）を生成します。
• デバッグと透明性のために、すべての決定（メッセージが送信またはブロックされた理由、トークン使用量、監査証跡）をログに記録します。
• 画像生成、コンテンツ作成、ComfyUI、現実世界のデバイスインタラクションなどの任意モジュールで拡張できます。

---

主な機能

領域	プラグインの機能
ライフの連続性	毎日の状態（エネルギー、気分、睡眠、健康、空腹度）、詳細なスケジュール、場所、天気、旧暦、任意の周期的シミュレーション。
プライベートチャットコンパニオン	パーソナライズされた挨拶、未完了トピックの記憶、軽量なユーザープロファイル、レート制限付きの能動的な連絡、ユーザーごとの設定可能なトーン。
能動的な行動	テキスト、画像、音声、ポック、スクリーンキャプチャ、外部ツール呼び出し、分割メッセージ、引用トリガーを送信します。
グループチャットの理解	許可されたグループを観察し、グループの雰囲気を作り、メンバー、スラング、トピックスレッド、短期記憶、関係グラフをトラッキングし、適切な場合にコメントを挿入できます。
マルチモーダル	プライベートチャットの画像処理、GIFフレーム抽出、画像引用、転送の統合、画像生成（リンクされた画像プラグイン経由）、TTS、撤回されたメッセージの短期記憶。
コンテンツライフ	ニュース、AI日報、能動的なWeb検索、B-siteハイライト、夢の記録、日記エントリ、メモ；アダプターが存在する場合、QQ空間と同期できます。
成長と記憶	スキル進捗、個人的な非創造的目標、自己タイムライン、関係観察、メモリアシスタント統合。
管理と診断	ビジュアル「コンパニオンパネル」、モデルルーティング、トークンと残高の概要、設定移行、能動アクションの監査、組み込みFAQ。

---

任意の拡張機能（別途インストール）

• astrbot_plugin_image_companion – 画像生成（テキストから画像）および関連コマンド。
• astrbot_plugin_content_companion – 創造的な執筆、ストーリー/アルバム管理。
• astrbot_plugin_comfyui – 画像生成のためのローカルComfyUIワークフロー。
• astrbot_plugin_reality_companion – カメラ/オーディオデバイスインタラクション（現実世界の「あなたのそばにいます」）。
• 「メモリ」、「トゲザー」、「スクリーン」、「ライブストリーム」などの追加コンパニオンがあり、それぞれに焦点を当てた能力セットを追加します。

---

インストール

メソッド	手順
プラグインマーケット (AstrBot WebUI)	astrbot_plugin_private_companion を検索し、インストールして、AstrBotを再起動します。
Gitインストール	AstrBotのプラグインマネージャーで Gitからインストール を選択し、https://github.com/menglimi/astrbot_plugin_private_companion を入力します。
ZIPアップロード	python scripts/build_plugin_package.py でパッケージをビルドし（dist/astrbot_plugin_private_companion‑vX.Y.Z.zip を生成）、WebUI経由でアップロードします。
手動コピー	リポジトリを <AstrBot data>/plugins/astrbot_plugin_private_companion にクローンします。
スタンドアロンWebUI (任意)	設定で enable_standalone_webui を有効にし、アクセストークンを設定してから、http://127.0.0.1:6190/ にアクセスします。

---

クイックスタートチェックリスト（約10分）

1. コンパニオンパネル を開き → プラグインがエラーなく読み込まれることを確認します。
2. ワールドナレッジ を設定 – メインのAstrBotペルソナを指定し、追加のキャラクターまたはワールドの説明を追加します。
3. モデルページ – 低レイテンシタスク用にクイックモデル、スケジュール/関係推論用に複雑モデル、（画像プラグインがある場合）ビジュアルモデルを選択します。
4. 基本設定 を入力 – ボット名、タイムゾーン、おやすみ時間、主要ユーザーID。
5. プライベートチャット タブで、主要ユーザーを メインユーザー としてマークします。
6. プライベートチャットで 陪伴 状态 を送信；ボットの現在の状態、スケジュール、次の能動候補が表示されるはずです。
7. (任意) グループチャット 観察を有効にし、グループをホワイトリストに登録して、陪伴群 状态 でテストします。
8. 必要に応じて、追加の能力（画像、音声、スクリーンキャプチャ、ニュースなど）を徐々に有効にします。

---

動作原理（高レベルフロー）

• 受動的な返信 – メッセージが到着すると、プラグインは階層化されたコンテキスト（ペルソナ → 時間 → 関係 → コンテンツ → 送信前チェック）を構築し、LLMプロバイダーに渡す前に独自のプロンプトを追加します。
• 能動候補 – ライフイベント、スケジュール項目、リマインダー、天気変化、ニュースなどが候補アクションを生成します。各候補は以下を通過します：
  1. 時間ウィンドウと価値スコアリング
  2. ユーザー/関係/おやすみ時間チェック
  3. ペルソナレベルの決定
  4. テキストの生成 / 外部ツールの実行
  5. 最終監査（重複検出、プライバシーガード、トークン予算）
  6. 送信 → ログ → メモリ更新
• 状態とスケジュール – JSON（デフォルト）またはSQLite（任意）に保存されます。プラグインは各インタラクション後に状態を更新し、パネル経由でエクスポート/インポートできます。
• 関係エンジン – 8つの親密度段階 + メインユーザー向けの「独占的絆」；7つのインタラクション強度レベル；自動減衰、上限、設定可能な「謝罪」修復ロジック。
• マルチペルソナモード (デフォルトでオフ) – 各ペルソナは独自の独立した状態、スケジュール、日記、トークン会計を持ちます。

---

設定ハイライト

• トークン制限 – ハードリミットはすべての新しいLLMタスクを停止します；ソフトリミットは低優先度のバックグラウンドジョブ（ニュース、画像生成など）をスロットリングします。
• モデルルーティング – クイック/複雑/創造的/ビジュアルモデルをタスクごとに割り当て可能；モデルが欠落している場合はAstrBotのデフォルトにフォールバックします。
• 画像生成 – 毎日の服装、ユーザー要求による生成、編集、または自動的な「ライフイベント」画像；複数のバックエンド（オンラインAPI、ComfyUI、SDGen）をサポートし、自動フォールバックが可能です。
• TTS – テキストから音声への変換は、返信と一緒に送信するか、別の音声メッセージとして送信できます；Fish-Audioモデルと任意のMiMo音声クローン統合をサポートします。
• プライバシーと安全 – プラグインは成人向けコンテンツを保存または転送しません；関係ベースの権限により、プライバシーやデバイスアクセスのエスカレーションを防ぎます。

---

ヘルプの入手先

• Wiki – https://vue.syuan.org (インストール、設定、FAQ)
• Issues – リポジトリのGitHub Issuesページ
• QQグループ – 1097283005
• スポンサー – 提供された愛発電リンク経由での任意のサポート（機能への影響なし）。

---

要約

astrbot_plugin_private_companion は、AstrBot向けの完全機能で拡張可能なコンパニオンレイヤーであり、チャットボットに永続的な「生活」、関係記憶、能動的な行動を与えつつ、すべてを監査可能かつ設定可能に保ちます。AstrBotのプラグインマーケット経由でインストールし、メインユーザーとモデルを設定すると、ボットは挨拶を始め、過去の会話を記憶し、毎日の状態更新を投稿し、（追加モジュールを有効にした場合）画像、音声メッセージを生成し、現実世界のデバイスとインタラクションすることさえできます。すべての動作はJSON/SQLite状態ファイルによって駆動され、組み込みのWebパネルを通じて検査または調整できます。