ネカマくん — シンプルAIボイスチェンジャー
v0.1.0-beta.3 / Windows x64 / 無料・商用利用可
公開者：ヨモゲーム https://x.com/ymgluck
公式ページ：https://yomogame252.com/nekama-kun/

この版は公開ベータです。全PC・全ゲームでの動作を保証するものではありません。
ブラウザで動くアプリではなく、Windowsに実行環境を準備して使います。

【必要なもの】
・Windows 11 x64（開発PCで検証）。Windows 10 x64は未検証です。
・NVIDIAのCUDA対応GPUと対応ドライバ。RTX 2070 8GBで検証。
  最低要件は未確定。CPUだけ・AMD GPU・Macでは現行のAI変換はできません。
・Python 3.12 64bitの公式Windows版。
  入手先：https://www.python.org/downloads/release/python-31210/
  Windows installer (64-bit)を使用してください。Python 3.13以降はこの版では未検証。
・初回セットアップ用インターネット。AI環境の取得は数GB規模です。
・ダウンロードと展開の余裕として20GB以上の空き容量を確保してください。

【初回の準備】
1. ZIPを完全に展開します。中のexeをZIPの中から直接起動しないでください。
2. 展開フォルダを今後も使う場所へ置きます。例：ユーザーフォルダ内のNekamaKun。
3. Python 3.12 64bitを公式インストーラーで導入します。導入済みならそのままで構いません。
4. Setup.cmdをダブルクリックします。
   Pythonパッケージ・CUDA実行ライブラリ・モデルを取得し、GPU上でモデルを読み込み確認します。
   初回は時間がかかります。途中で失敗した場合はエラーを確認してSetup.cmdを再実行できます。
5. Setup completeと表示されたら、NekamaKun.exeまたは作成されたショートカットから起動します。
   AI環境はこのWindowsユーザーのLOCALAPPDATA/NekamaKun/runtimeに保存します。
   設定は展開フォルダを参照するため、フォルダを移動した場合はSetup.cmdを再実行してください。

【話してみる】
・入力：実際に使う物理マイク。出力：最初はヘッドホン。
・ネカマ度50、バイパスOFF。「変身する」を押し、準備完了を待ちます。
・「元に戻る」で停止します。詳細設定の「元の声を出す（バイパス）」をONにすると地声が通話先にも届きます。停止中のみ変更でき、アプリ起動時は毎回OFFに戻ります。
・ネカマ度は声質の寄せ方で、0でも変換されます。100が最高品質という意味ではありません。

【Discord等へ送る】
停止中に「通話用マイクを準備 / 選択」を押します。
初回は公式USBipドライバの取得・導入とサービス登録に管理者権限が必要です。
Windowsが再起動を要求した場合は作業を保存して手動で再起動してください。
アプリの出力：スピーカー（ネカマくん マイク）
Discord等の入力：マイク（ネカマくん マイク）
Discord等の出力：普段のヘッドホン
Windows全体の既定の出力はヘッドホンのままにしてください。
通話前にDiscord等のマイクテストで確認してください。

【制限】
・開発PCでの推定遅延は約0.6〜0.8秒。音響往復の実測ではありません。
・ゲームとGPUを共有すると音切れ・音質低下が起こりえます。FPS制限等でGPUに余裕を作ってください。
・小声や語尾が欠けたり、変換音に加工感が残ることがあります。
・自社のコード署名証明書による署名はありません。Windowsの警告を回避するために
  セキュリティ機能を無効化しないでください。導入できない場合はエラー内容をお知らせください。
・Windows 10、別のGPU、初期状態の別PC、実際のDiscord通話の網羅的検証は未完了です。

【音声と情報】
音声変換はPC内で行い、通常利用でマイク音声をファイルに録音したり公開者へ送信したりしません。
Discord等の送信先には各サービスの方針が適用されます。
初回取得先はPyPI、PyTorch、GitHub、Hugging Face等で、各サイトへ通信情報が伝わります。
設定・診断ログはLOCALAPPDATA/NekamaKun内に保存します。
問い合わせ時にログを添える場合は、ユーザー名やデバイス情報を確認してから送ってください。

【削除】
1. アプリを停止・終了します。
2. 仮想マイクを導入した場合は、管理者PowerShellから
   scripts/setup-virtual-mic.ps1 -Remove を実行してサービスを解除します。
   USBipは他アプリと共用の可能性があるため自動削除しません。不要な場合のみ
   Windowsの「インストールされているアプリ」から削除してください。
3. 展開したフォルダとショートカットを削除します。
4. 設定・AI環境も不要ならLOCALAPPDATA/NekamaKunを削除します。
   このフォルダに旧版の設定等がある場合も消えるため、必要なものは先に保存してください。
Pythonは他アプリで使う可能性があるため自動削除しません。

コードのライセンス：GPL-3.0-only。全文LICENSE、区分LICENSING.md、第三者一覧THIRD_PARTY_NOTICES.md。
対応するソースコードは公式ページでバイナリと同時提供します。

更新：起動時に公式ページへ更新確認（OFF可）。「更新を確認」でも確認できます。新しい版があれば停止中に「更新して再起動」で取得・SHA256検証・展開・再起動します。設定・モデルは保持し、新版はデスクトップのNekamaKunから起動します。旧フォルダは自動削除しません。初回はこの更新機能付きの版を手動で導入してください。
声の高さ調整：詳細設定の実験用・非推奨機能。初期OFF、停止中に±3半音で調整します。加工感や音揺れが増えることがあります。「標準に戻す」でOFF・0半音に戻ります。起動時もOFF。別人物の声モデルに切り替える機能ではありません。
