📖 ATBClone ユーザーマニュアル（日本語版）¶

English Version | 簡體中文 | 繁體中文 | 日本語版 | 한국어 | Deutsch | Français | Español | Русский

ATBClone 公式ユーザーマニュアルへようこそ。本マニュアルでは、macOS アプリの多重起動（マルチインスタンス）およびサンドボックス完全分離機能の使い方について、初心者向けの基本操作から、クローン管理、カスタムレシピの作成、内部アーキテクチャの解説、システム診断、トラブルシューティングに至るまで、ステップバイステップで詳しく解説します。

🧭 チャプターナビゲーション¶

利用目的やスキルレベルに応じて、最適なチャプターをご参照ください：

🌟 なぜ ATBClone を選ぶのか？¶

macOS 環境において、従来のアプリ多重起動手法（単純な cp -R による App コピーやターミナルでのシンボリックリンク作成など）は、クラッシュしたり動作しなくなったりすることが多発します。これは、現代の macOS アプリがユーザー環境設定、システムキーチェーン、ローカルデータベースを共有しているためです。

ATBClone は独自開発のエンジン構造により、真の「4重分離（Quadruple Isolation）」を実現しています：

graph TD
    A[ATBClone 分離エンジン] --> B[1. データ＆キャッシュの完全分離]
    A --> C[2. 視覚的アイデンティティとDockの独立]
    A --> D[3. システム安全権限 TCC の独立]
    A --> E[4. ネットワークプロキシの独立ルーティング]

    B --> B1["独立した $HOME と $TMPDIR、SQLite データベースのロック競合ゼロ"]
    C --> C1["独立した Dock アイコン、カスタムアプリ名、Spotlight 検索対応"]
    D --> D1["マイク、カメラ、ローカルネットワーク権限の個別管理"]
    E --> E1["アプリごとに個別の HTTP/SOCKS5 プロキシを設定（IP 指紋の関連付け防止）"]

1. 📦 データ＆キャッシュの完全分離：各クローンは専用の独立したホームディレクトリ（$HOME）またはカスタムデータディレクトリ（--user-data-dir）を保持します。複数アカウントで同時にログインしても、ローカルデータベースやキャッシュが衝突することはありません。
2. 🎨 視覚的アイデンティティとDockの独立：クローンアプリは独立した名称とアプリアイコンを持ち、Spotlight 検索、Launchpad（起動台）、Dock（プログラムウ）すべてにおいて個別のアプリケーションとして認識されます。
3. 🛡️ システム権限 (TCC) の独立：ハードクローンは CFBundleIdentifier を書き換えることで新しいシステム識別子を獲得するため、カメラ、マイク、アクセシビリティなどのシステム許可設定が元の親アプリと完全に独立します。
4. 🌐 ネットワークプロキシの独立ルーティング：指定したクローンアプリに個別の HTTP または SOCKS5 プロキシを設定可能です。ホスト全体のネットワーク環境に影響を与えることなく、アプリ単位で異なる外部 IP を使用できます。

📚 主要コンセプト・用語集¶

マニュアルをお読みいただくにあたり、以下の主要な用語をご確認ください：

• 親アプリ (Host App)：お使いの Mac にインストールされている元の正規アプリケーション（通常 /Applications に配置）。
• クローンアプリ (Clone App)：ATBClone エンジンによって生成された独立インスタンス（デフォルト保存先：~/ATBClone/Apps）。
• ハードクローン (Hard Clone / 実体複製＋ラッパーハイジャック)：App バンドル全体を複製し、固有の Bundle ID に書き換え、環境変数インジェクションスクリプトを注入してコード署名を再適用します。LINE、WeChat、Telegram、Discord、Slack などのネイティブアプリに最適です。
• ソフトクローン (Soft Clone / ランチャーラッパー)：軽量な起動ラッパーシェルのみを生成し、起動引数（--user-data-dir や --profile）でデータパスを切り替えます。Cursor、VS Code、Chrome、Edge、Firefox などのブラウザや開発ツールに最適です。
• レシピ (Recipe)：対象アプリをどのように複製・分離・起動するかを定義した YAML 形式の指示書。
• データディレクトリ (Isolated Data Directory)：クローンアプリがチャット履歴、設定、キャッシュ、データベースを格納する専用フォルダ（デフォルト：~/ATBClone/Data/<クローン名>）。

🚀 クイックスタート¶

1. ダウンロードとインストール：GitHub Releases から最新の ATBClone-*.dmg をダウンロードします。DMG を開き、ATBClone.app を /Applications フォルダにドラッグ＆ドロップします。
2. ATBClone を起動：Launchpad またはアプリケーションフォルダから ATBClone を起動します。
3. ウィザードを開始：メイン画面右上の 「+ 新規クローン」 ボタンをクリックします。
4. 7ステップの案内に従う：対象アプリを選択 ➔ レシピを確認 ➔ クローン名を入力 ➔ インストール先とデータ保存先を確認 ➔ 「クローンを実行」 をクリックします。
5. 利用開始：「起動」 ボタンをクリックするか、Spotlight 検索や Dock から直接クローンを立ち上げます！