Назначение: один общий словарь, чтобы документы, код, CLI, API и ИИ-агенты называли одни и те же вещи одними и теми же словами. Если термин употреблён в двух местах в двух смыслах — это дефект, и чинить его надо сначала здесь.
| Термин | Определение |
|---|---|
| Desktop Shell | Процесс интерфейса на Tauri + WebView. Рисует экраны, не держит бизнес-логики, говорит только с Local API. |
| Application Core | Локальная служба на Rust, которой принадлежит вся логика с состоянием (профили, хранилище, прокси, отпечаток, автоматизация, провайдер ядра). Единственное, чему позволено трогать хранилище и процессы браузера. |
| Local API | Единая граница управления, которую Application Core открывает внутри процесса и на loopback. Любая другая поверхность (интерфейс, CLI, MCP, скрипты) — её клиент. |
| Browser Core | Собственно бинарник браузера, который рисует страницы (сегодня — временный Chromium; позже — патченый Chromium). |
| Browser Core Provider | Абстракция, которая находит, запускает и ведёт Browser Core. Реализация сменная; остальная система не знает, какое ядро работает. |
| Profile | Постоянная браузерная личность: её user-data-dir (cookies, хранилище, история) плюс конфигурация отпечатка, привязка к прокси и метаданные. Не «просто папка». |
| Profile Blob | Сериализованная, сжатая, зашифрованная и подписанная форма профиля для хранения и синхронизации (<uuid>.blob + <uuid>.sig). |
| Materialization | Превращение Profile Blob в живой, готовый к запуску user-data-dir на локальном диске. |
| Profile State | Фаза жизненного цикла профиля (см. PROFILE_STORAGE_SYNC.md): CLOUD_ONLY, LOCAL_CACHED, MATERIALIZED, RUNNING, DIRTY, SYNCING_UPLOAD, SYNCING_DOWNLOAD, CONFLICT, LOCKED_REMOTE. |
| Fingerprint Config | Структурированный проверяемый каталог, описывающий личность, которую должен показывать Chromium (ОС, версия, GPU, экран, шрифты, часовой пояс, политика WebRTC…). Не случайный JSON. |
| Vault | Зашифрованное локальное хранилище секретов (учётки прокси, cookies при экспорте, переменные автоматизации, токены). Доступ закрыт режимом политики. |
| Proxy Binding | Связь профиля с прокси, соблюдаемая одинаково в HTTP/DNS/WebRTC/QUIC. |
| Automation Script | Единица автоматизации (визуальный граф или код), выполняемая против одного или нескольких профилей. |
| Module | Переиспользуемый версионированный блок автоматизации, из которых собираются скрипты; свой код выполняется в Node-sidecar. |
| Task | Одно выполнение Automation Script против одного профиля. |
| Task Group | Именованный набор запусков автоматизации по множеству профилей, с расписанием, повторами и журналами. |
| Run | Идущее или законченное выполнение со статусом, журналами и артефактами. |
| Runner | Отдельный рабочий процесс, который выполняет Task и ведёт ядро своего профиля; демон за ним надзирает (ADR-0020). |
| Synchronizer | Открывает N профилей сразу и повторяет в них действия ведущего; synchronizer.broadcast применяет одно действие к нескольким запущенным профилям одним вызовом, изолируя отказ каждого (PHASE5_PLAN §3e). |
| Patch Series | Упорядоченный набор независимых диффов, накладываемых поверх апстрим-тега Chromium, чтобы получить патченое ядро. |
| Core Provider Contract | Интерфейс, которому обязан соответствовать каждый Browser Core Provider (запуск, подключение, эндпоинт CDP, версия, возможности, остановка). |
| Policy Mode | Действующий уровень разрешений для опасных операций: normal, power, danger/admin. |
| Action Log | Журнал аудита только на дозапись для значимых и опасных операций (кто, что, когда, режим, результат). |
| Control Plane | Local API + CLI + MCP + инструменты для агентов: поверхности, которыми систему эксплуатируют. |
| Data Plane | Сами браузеры и данные профилей, над которыми работают. |
| Pack | Превращение живого user-data-dir обратно в Profile Blob (сжать → зашифровать → подписать). Обратная операция к Materialization; вместе они — единственные мосты папка↔блоб. |
| Data Key (DEK) | Случайный ключ на профиль, которым AEAD шифрует полезную нагрузку Profile Blob. Оборачивается одним или несколькими KEK; никогда не хранится развёрнутым. (ADR-0008) |
| Key-Encryption-Key (KEK) | Ключ, который оборачивает (шифрует) DEK. На профиль их несколько — пароль (Argon2id), Recovery Key, необязательные passkey или связка ключей ОС, org-KEK команды, — и любой из них разворачивает DEK. (ADR-0008) |
| Envelope Encryption | Шифрование данных ключом DEK и обёртывание этого DEK несколькими независимыми KEK, чтобы восстановление никогда не требовало открытого текста на сервере. (ADR-0008) |
| Recovery Key | Секрет высокой энтропии, созданный при настройке и хранимый пользователем офлайн (набор на экстренный случай); независимый KEK, который восстанавливает профиль, если пароль потерян. (ADR-0008) |
| Trust Score | Оценка на личность = происхождение × результат валидатора × возможности ядра; запуски с низким доверием помечаются, а не отгружаются молча. (FINGERPRINT_CONFIG_CONTRACT §6) |
| Walking Skeleton | Минимальный сквозной срез Phase-1 (≈6 методов Local API), который открывает настоящий браузер через всю границу, — доказывает архитектуру до того, как расти вширь. |
| Lockstep / Contract Codegen | Правило, по которому CLI, инструменты MCP и SDK порождаются из одного контракта OpenAPI и сверяются с ним в CI, так что поверхности не могут разойтись. (CODEGEN_PIPELINE, инвариант #8) |