pinganbbOvO/ai-companion-kit

解決する課題

現在の AI アシスタントは回答は得意ですが、機械的に感じられます。返信が一度に届き、会話をまたいでユーザーを覚えておらず、スマホで操作したり SNS に投稿したりする手段がありません。このプロジェクトは 2 つのギャップを埋めます。AI をより人間らしくし（人を覚える、現実的なタイピング遅延、沈黙するタイミングを知る）、そして手を与えます（adb で実機を制御、自主的に QQ ゾーンに投稿）。

仕組み

キットは独立したパッケージに分かれており、一緒に使うことも単独で使うこともできます。

• ai-companion — 各人についての情報を記憶し（チャットセッションではなく人単位で保存）、日記を書き（記憶とは別に保存され、最近のエントリのみがコンテキストに含まれる）、人間らしくタイピングし（タイピング時間、メッセージ分割、一時停止、夜は遅く）、話すか黙るかを決定します（「@ でのみ起動」「グループでは名前を呼ばれない限り沈黙」などのルール付き）。
• phone-mcp — AI に 34 個の MCP ツールを公開し、タップ、スワイプ、中国語入力、スクリーンショット、画面録画、コンボ操作をすべて adb 経由で行えます（実機またはエミュレータで動作）。网易云音乐も制御できます。
• qzone + qzone-mcp — AI が自主的に QQ ゾーンに投稿できるようにします。6 つのツール：投稿（テキスト + 最大 9 枚の画像）、自分の投稿表示、友達のフィード表示、他のユーザーの投稿表示、いいね、コメント（厳格なレート制限付き）。ワンクリックスクリプト（npm run qzone）がゲートウェイをチェックし、設定を検証し、AI が投稿してよいタイミングを定義するロールカードに段落を追加します。
• own-life（キットに含まれる）— 2.5 時間ごとに AI を静かに通知します（ただし 3:00〜8:00 は除く、1 日最大 6 回）。AI は自主的に QQ ゾーン更新や日記エントリを投稿するか決定できます。状態を保存するため、再起動してもメッセージの洪水は発生しません。

キットには簡単インストーラーが付属しています。Windows で tools/安装.bat をダブルクリックすると、Node の確認、QQ ブリッジのダウンロード、依存関係のインストール、config.json の生成が行われます（あなたの QQ ID、彼女の QQ ID、ゲートウェイトークンのみ入力）。Node.js と QQ ゲートウェイ（SnowLuma）は別途インストールする必要があります（README にスクリーンショット付きガイドがあります）。

対象読者

• プログラマーでない人：生きているように感じられる QQ コンパニオン（記憶、人間らしいタイピング、日記）が欲しく、QQ ゾーンに投稿もできるようにしたい人。README では、任意の AI デスクトップアプリ（DeepSeek、ChatGPT、Cursor）にインストールを依頼する方法を説明しています。
• コマンドラインに少し慣れている人：約 15 分で基本的なチャット専用セットアップを実行したい人。
• プログラマー：完全な制御を望む人。README には、音声認識、スマホ制御、音楽再生、日記、レート制限対策の詳細なチュートリアルが含まれています（第 13 章では、毎分 20 メッセージで Tencent のレート制限に達する警告があります — スキップしないでください）。

ハイライト

• 人ごとの記憶 — AI は各連絡先についての情報を個別に記憶し、グループチャットと DM の両方で保持します（例：グループで言った事実はプライベートチャットでも思い出されます）。
• 人間らしいタイピング — 「入力中…」インジケーターを表示し、メッセージを分割して一時停止しながら送信し、夜はタイピングが遅くなります。
• 起動戦略 — 完全に設定可能：@、つつく、所有者のメッセージ、キーワードに反応、またはグループでは名前を呼ばれない限り沈黙。
• 個性のある日記 — AI はロールカード、最近のコンテキスト、以前の日記エントリから直接自分のジャーナル（1〜4 文、一人称）を書きます。「今日は充実していた」のような繰り返しの埋め草を避けます。手動でエントリを追加することもできます。
• 自主的な QQ ゾーン投稿 — AI は自然に投稿タイミングを決定します（スケジュールボットではありません）。ホワイトリストディレクトリからの画像のみ投稿でき、削除やブロック機能はありません — README は意図的な安全上の選択と述べています。
• 安全なスマホ制御 — タップ、スワイプ、入力、スクリーンショット、録画、コンボ操作が可能ですが、README は支払いや銀行アプリのあるスマホでの使用を強く警告しています。エミュレータまたは予備デバイスを使用してください。
• すべてのデータはローカルのプレーンテキスト — 記憶は JSON、チャットフローは JSONL、日記は JSONL と毎日の Markdown ファイル。いつでも読み取り、編集、grep、バックアップが可能です。
• 各レイヤーは独立して使用可能 — コンパニオンのみ、スマホ制御のみ、QQ ゾーン投稿のみを使用できます。

（注：この説明は README のみに基づいています。記載されているすべての機能は README に存在します。）