VFLIN
ВойтиСкачать

docs · docs/10-architecture/GLOSSARY.md · перевод от 2026-09-12 · с английской ревизии 1a3855564ff5

Глоссарий

слова, которыми говорят приложение, CLI, API и эти страницы, — в точности

Назначение: один общий словарь, чтобы документы, код, 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)