コンテンツにスキップ

第4章：よくある質問 (FAQ)・システム診断・フィードバック

本章では、ユーザーからよく寄せられる疑問、セキュリティやアカウント保護に関する注意事項、内蔵診断ツール「Doctor」による環境チェック、そして不具合発生時の GitHub Issue 報告手順を解説します。

📑 目次

❓ よくある質問 (FAQ)

1. クローンを作成すると元のアプリのデータに影響はありますか？

全く影響ありません。 ATBClone は完全な独立データディレクトリ（~/ATBClone/Data/<クローン名>）を分離して使用します。元の親アプリのデータやキャッシュディレクトリには一切触れません。

2. クローンのデータはどこに保存されますか？バックアップと移行方法は？

  • 保存場所：デフォルトで ~/ATBClone/Data/<クローン名> にすべて保存されます。
  • バックアップと移行：ダッシュボードでクローンの 「フォルダを開く」 アイコンをクリックし、表示されたフォルダを外付け SSD や別の Mac にコピーするだけで、完全にデータ移行が可能です。

3. アカウントが BAN されるリスクはありますか？

ATBClone は 「非侵入型（Non-Invasive）サンドボックス分離技術」 を採用しています。アプリの通信プロトコルを偽装したり、メモリ内のゲームデータを改ざんしたりする「チートツール / フック」ではありません。macOS ネイティブの安全な環境変数差し替えにより動作するため、公式アプリそのものが動作している状態とシステム上区別されず、安全にご利用いただけます。

さらに、独立プロキシ機能を併用することで、アプリごとに IP アドレスを分散させ、同一 IP からの複数アカウント同時アクセスによる検知リスクも低減できます。

4. 管理者パスワード (Root / Sudo) は必要ですか？

一切不要です。 ATBClone のすべての複製、バイナリラッパー生成、アドホック署名、データ管理は、すべて現在のユーザー権限（User Space）内で完結します。システムファイル（/System）を改ざんすることはありません。

5. 「開発元が未確認のため開けません」または破損エラーが出た場合の対処法は？

macOS Gatekeeper のセキュリティ保護によるものです。以下のいずれかの方法で解消できます： 1. Finder から右クリックで開く：クローンアプリ（.app）を右クリック（二本指タップ）し、「開く」 を選択してダイアログで「開く」をクリック。 2. ターミナルコマンドで隔離属性を解除： 

xattr -cr ~/ATBClone/Apps/<クローン名>.app

6. クローンのアプリアイコンを変更するには？

  1. ATBClone ダッシュボードで対象クローンカードの 「編集」 をクリックします。
  2. アイコン表示領域に、お好みの .png または .icns 画像をドラッグ＆ドロップして保存します。

7. メッセンジャー系アプリでメニューバー常駐や通知が機能しない場合の対処法は？

一部のアプリ（WeChat や Slack など）は、ハードクローン時に Bundle ID が変更されると通知センターへの登録がリセットされる場合があります： * macOS の 「システム設定 ➔ 通知」 を開き、クローンアプリ名（例：WeChat-Work）の通知が許可されているか確認してください。

🩺 システム環境診断 (Doctor ツール)

環境の依存関係や権限が正常か確認するには、内蔵の Doctor ツールをご利用ください：

  • GUI から：左サイドバーの 「システム環境健診 (Doctor)」 をクリック。
  • CLI から： 
    atbclone doctor

Doctor ツールは以下を自動チェックします： * [✔] macOS バージョン互換性 (macOS 12+ Monterey / Ventura / Sonoma / Sequoia) * [✔] Xcode Command Line Tools または codesign コマンドの稼働状態 * [✔] アプリおよびデータ保存ディレクトリの書き込み権限 * [✔] ビルトインレシピ定義の構文整合性

🐞 問題の発見と GitHub Issue 報告手順 (標準トラブルシューティング)

アプリの起動に失敗したり異常が発生した場合は、以下の手順で正確な診断情報を取得してご報告いただけます：

ステップ 1: メイン画面で異常が発生したクローンを選択し「詳細」を開く

対象クローンカードをクリックし、ツールバーの 「詳細 (Details)」 ボタンを押します。

ステップ 2: 「クローン詳細」から診断レポートをコピー

「分身詳細」ダイアログが表示されます。ここには以下の技術情報が自動収集されています： * 基礎情報（クローン名、戦略、Bundle ID、元アプリパス） * 実行可能バイナリ種別とアーキテクチャ（arm64 / x86_64） * 注入された環境変数とプロキシ設定 * 直近のクラッシュログ・起動ログの抜粋

下部の 「診断情報をコピー (Copy Diagnostic Info)」 ボタンをクリックします。

ステップ 3: GitHub Issue に投稿

  1. ブラウザで ATBClone Issues を開きます。
  2. 「New Issue」 をクリックし、「Bug Report」を選択します。
  3. コピーした診断情報を貼り付けて送信してください。開発チームが迅速に原因を調査します。

💬 コミュニティとサポート