📖 Руководство пользователя ATBClone (Русская версия)¶

Демонстрация интерфейса ATBClone

Добро пожаловать в официальное Руководство пользователя ATBClone. В этом руководстве подробно описаны все возможности запуска мульти-экземпляров и изоляции в песочнице (sandbox) приложений macOS — от базовых шагов для начинающих до глубокого анализа архитектуры и диагностики системы.

🧭 Навигация по главам¶

Глава	Название	Аудитория	Основные темы
Глава 1	Базовые операции & Управление клонами	👶 Начинающие / Все пользователи	Мастер создания из 7 шагов, запуск, прямой переход к каталогу данных, синхронизация обновлений без потери данных, табличный вид (пакетное обновление и удаление), безопасное удаление.
Глава 2	Пользовательские рецепты & Базовые параметры	⚡ Опытные пользователи	Использование App Prober (Умный зонд) для анализа редких приложений, визуальный редактор рецептов, описание параметров (`bundle_id`, `strategy`, `strip_sandbox`, `proxy`).
Глава 3	Внутреннее устройство & Расширенные параметры	🔬 Разработчики / Эксперты	Сравнение Soft и Hard клонов, принципы Hard Clone и перехват бинарной обертки (Wrapper Hijack), разделение логики и данных, расширенные параметры YAML (`environment_injection`, `symlink_whitelist`, макросы путей).
Глава 4	Часто задаваемые вопросы (FAQ), Диагностика & Поддержка	🩺 Все пользователи	Популярные вопросы (безопасность данных, пути хранения, защита от блокировок, работа без прав root), системная проверка Doctor, копирование отчета и создание Issue на GitHub.

🌟 Почему ATBClone?¶

В macOS традиционные методы клонирования (простое копирование .app через cp -R или псевдонимы в терминале) часто приводят к сбоям, поскольку современные приложения совместно используют пользовательские настройки, базы данных SQLite и системную связку ключей (Keychain).

ATBClone решает эту проблему благодаря четырехуровневой изоляции (Quadruple Isolation):

graph TD
    A[Движок изоляции ATBClone] --> B[1. Изоляция данных и кэша]
    A --> C[2. Независимая визуализация и Dock]
    A --> D[3. Безопасность и разрешения macOS TCC]
    A --> E[4. Сетевая изоляция через прокси]

    B --> B1["Раздельные $HOME и $TMPDIR, отсутствие блокировок SQLite"]
    C --> C1["Отдельная иконка в Dock, собственное имя, поиск в Spotlight"]
    D --> D1["Индивидуальные разрешения на камеру, микрофон и диск"]
    E --> E1["Выделенный HTTP/SOCKS5 прокси для каждого клона"]

📦 Изоляция данных и кэша: Каждый клон использует собственную домашнюю директорию ($HOME) или --user-data-dir. Можно входить в несколько аккаунтов одновременно без конфликтов.
🎨 Визуальная независимость: Клоны имеют собственные имена и иконки, отображаясь отдельно в Spotlight, Launchpad и Dock.
🛡️ Изоляция разрешений TCC: Уникальный CFBundleIdentifier позволяет macOS управлять системными разрешениями клонов независимо от основного приложения.
🌐 Сетевой трафик через прокси: Возможность настроить индивидуальный HTTP или SOCKS5 прокси для каждого клона.