--- # 🎭 AIデスクトップキャラクター ### あなたのPCに住む、AIとVRMで動く賢いデスクトップマスコット **AIデスクトップキャラクター**は、VRMアバターをデスクトップに透過表示し、Google Gemini AIがあなたの画面を「見守り」ながら状況に応じてリアルタイムにつぶやく、Windows向けの次世代デスクトップマスコットアプリです。 プッシュツートークでの音声会話やお好みのVOICEVOX音声での読み上げ、会話の積み重ねによる長期記憶機能など、あなただけのパートナーとしての機能を凝縮しています。 --- ## ✨ 主な機能 🧍 VRM透過表示：任意のVRMモデルを最前面に透過表示。 👁️ 視線・首追従：マウスの動きに合わせてキャラクターの顔が自然に追従。 🖥️ 画面見守り：ランダムな間隔で画面をキャプチャ・AI分析し、状況に合わせてつぶやく。 🎙️ 双方向音声会話：ホットキー長押し（プッシュツートーク）で、いつでも声での会話が可能。 🔊 VOICEVOX連携：ローカルのVOICEVOXと連携し、詳細な音声パラメータ調整にも対応。 🧠 長期記憶システム：会話履歴を蓄積し、あなたの趣味や過去の会話を学習・記憶。 💾 魂データの継承：記憶・人格データを個別ファイルとしてエクスポート・移行が可能。 --- ## 🚀 導入・セットアップ手順 ### 1. 必要なもの 本アプリの動作には、本体のほかに以下のデータや外部連携が必要です。 Google Gemini APIキー：[Google AI Studio](https://aistudio.google.com/)から**完全無料**で取得可能 お好みのVRMモデルファイル（`.vrm`）：※本アプリに3Dモデルは同梱されていません VOICEVOX：音声読み上げ機能を使用する場合 / 無料ソフト ### 2. 初期設定 1. 同梱の `AIデスクトップキャラクター Setup x.x.x.exe` を実行してインストール。 2. アプリ起動後、キャラクターを**右クリック ➡️「設定画面を開く」**。 3. 取得した **Gemini APIキー** を入力して保存。 4. 「VRMファイル」の項目から、ご用意いただいた `.vrm` ファイルを選択。 5. （音声利用時）VOICEVOXをあらかじめ起動しておくと、アプリが自動検出します。 > ⚠️ **Windows SmartScreen警告について** > 本アプリは個人開発のコード署名なしビルドのため、初回起動時に「WindowsがPCを保護しました」と表示される場合があります。「詳細情報」➡️「実行」をクリックすることで安全に続行できます。 --- ## 🕹️ 操作方法・設定項目 ### 基本操作 左クリックドラッグ：キャラクターウィンドウの移動 右クリック**：コンテキストメニュー表示（手動ツッコミ / 設定 / 終了） F6キー（デフォルト）：自動見守りの一時停止 / 再開 F7キー（デフォルト）：手動トリガー（その瞬間の画面をAIに見せて反応させる） F8キー長押し（デフォルト）：プッシュツートーク（音声会話の開始） ### 主な設定項目 設定画面から以下のパラメータを動的にカスタマイズ可能です。 AI挙動設定：使用モデルの選択（高速/高精度）、口調や関係性を定義する「性格プロンプト」 見守り間隔：自動見守りの最小/最大間隔（分単位。共に`0`で自動撮影を完全停止） VOICEVOX詳細：話者ID（キャラクター）の選択、話速・音高・抑揚・音量・無音時間の調整 その他：キャラクターのライトの明るさ調整、マウス追従感度、各種ホットキーの再割り当て、Windows起動時の自動起動ON/OFF、記憶（魂データ）のバックアップ・復元 --- ## 🔒 プライバシー＆セキュリティ（完全ローカル動作の基本設計） 本アプリは、ユーザーのプライバシーを最優先に考えた**完全ローカルファースト**設計です。 ### 1. 重要データの暗号化と保管場所 APIキー等の設定： (`config.json`) OSのキーチェーンと連動するElectronの `safeStorage API` を用いて強固に暗号化。そのPCのログインアカウント以外では復号できません。 記憶・会話データ： (`soul.json`) プレーンなJSON形式でローカルのみに保存。外部サーバーへ自動アップロードされることは一切ありません。いつでも手動で確認・削除・バックアップが可能です。 ### 2. 画面キャプチャの安全性・プライバシー保護仕様 マルチモニター対応（アクティブ画面のみ） キャプチャは「現在マウスカーソルが存在するモニター」のみを自動判別して撮影します。別の画面に開いているプライベート情報の写り込みを防ぎます。 キャラクター自身の映り込み除外 OSレベルのウィンドウ保護（`setContentProtection`）を使用し、キャプチャ画像からキャラクター自身を自動的に除外（非表示化）します。 ストレージへの非保存 キャプチャされた画像はGemini APIへの送信の瞬間のみメモリ（RAM）上に生成され、PCのストレージ（HDD/SSD）に画像ファイルとして残ることはありません。 ワンタッチ停止機能 機密情報を扱う際は、`F6` キーでいつでも見守りを一時停止できます。 --- ## ❓ よくある質問（FAQ） Q. Gemini APIは有料ですか？ A. いいえ、完全無料で利用可能です。Googleアカウントがあれば、月額サブスクリプションを契約していなくても無料枠（Free Tier）の範囲内で十分に楽しむことができます。※無料枠の仕様上、データはAIの改善に利用される規約となっています。規約を避けたい場合はAI Studio側で従量課金（Pay-as-you-go）に切り替えることも可能です（個人利用であれば極めて安価です）。 Q. 一部のゲームをプレイ中に、キャラクターが裏に隠れてしまう A. Windowsの「全画面表示の最適化」機能が影響している可能性があります。以下の対策を行うことで改善する場合があります： 1. ゲーム側の画面設定を「ボーダーレスウィンドウ」または「ウィンドウモード」に設定する。 2. ゲームの実行ファイル（例: `Cyberpunk2077.exe`）を右クリックして「プロパティ」を開き、「互換性」タブで **「全画面表示の最適化を無効にする」** にチェックを入れる。 3. アプリを再起動し、ゲームを起動し直す。 > ⚠️ **ご注意** > アプリ側では常に最前面で描画されるよう制御（Always On Top）していますが、OSの仕様やゲームタイトルの描画方式、またはグラフィックボード等の環境によっては、例外的にゲームの背後に隠れてしまう場合（最前面表示が機能しない場合）があります。あらかじめご了承ください。 Q. すべてのVRMモデルが動きますか？ A. 一般的なVRM（0.x / 1.x）に対応していますが、構造により例外があります。 モデルのポリゴン数、特殊なマテリアル設定、シェーダー、データ構成によっては、一部のテクスチャが乱れる、表情の動きが不自然になる、あるいは読み込めない場合があります。 --- ## ⚙️ 動作確認済み検証環境 本アプリは、以下の環境において動作確認を行っています。 - OS：Windows 11 Home (64bit) - CPU：AMD Ryzen 9 5900X 12-Core Processor - メモリ：32GB - GPU：NVIDIA GeForce RTX 4060 Ti - その他：インターネット接続（Gemini API通信用）、Gemini APIキー ※ 3Dモデル（VRM）の描画やVOICEVOXによる音声合成処理を行うため、動作にはある程度スペックに余裕のあるPCでのご利用を推奨します。 --- ## ⚠️ 免責事項・利用規約 1. 現状有姿での提供：本アプリは仕様上の不具合やバグを含まないことの保証を行わない「現状有姿（As-Is）」で提供されます。 2. 免責事項：本アプリの使用、または使用不能によって生じた直接的・間接的な損害（PCの不具合、データの消失、連携ゲーム等でのペナルティ、API課金の発生など）について、開発者は一切の責任を負いかねます。 3. 音声・モデルの商用利用について：本アプリを用いて出力された音声やVRMモデルを配信・動画等で使用する場合は、連携する外部ソフト（VOICEVOX等）およびアバター製作者の利用規約に必ず従ってください。 4. 禁止事項：二次配布、無断転載、再アップロード、リバースエンジニアリング（解析・改ざん・ソースコードの抽出）、自作発言、および公序良俗に反する活動への利用を固く禁止します。 5. メディア露出について：本アプリを使用した状態での動画配信、スクリーンショットの公開、非営利・営利目的のコンテンツ制作（配信の演出など）への利用は自由に行っていただいて構いません。 --- ## 📜 使用ライブラリ・ライセンス * Electron (MIT) * Three.js / @pixiv/three-vrm (MIT) * Google Generative AI SDK (Apache 2.0) * uiohook-napi (GNU LGPLv3) * screenshot-desktop (MIT) ## 🔄 更新履歴 ### 🚀 Ver 1.0.0 (2026/06/19) - 初版リリース（販売開始）