ADR G7-1: песочница разборщиков — чужие файлы разбираются в отдельном процессе
Статус: принято к реализации, 17.10.2026 (дорожка
«Ядро», ветка claude/kernel-parser-sandbox-c901b0).
Основание: аудит ядра 16.10
(plan/report-20261016-modules/audit/kernel.md, риск Б6,
10–15 сд), подтверждение владельца (сообщение главной сессии 17.10).
Предыдущий шаг — пределы разборщиков (Б1–Б4) и 10 целей фаззинга, уже в
main.
Задача
Чужой файл (DOCX, ODT, MWX, XLSX; картинки внутри них) разбирается не в процессе окна, а в отдельном процессе-исполнителе с ограничениями. Окно получает уже проверенную модель. Если разбор упал, завис или съел память, документ не открывается, окно показывает понятное сообщение и остаётся живым.
Модель угроз (честно)
Разборщики — свой код на Rust, #![forbid(unsafe_code)] в
25 крейтах. Порча памяти и исполнение чужого кода маловероятны. Реальные
угрозы — отказ в обслуживании, и не всё из этого ловит
catch_unwind на FFI:
| Что | Сейчас в процессе окна | В исполнителе |
|---|---|---|
| паника | ловится guarded() |
ловится, плюс процесс выбрасывается целиком |
| переполнение стека (глубокая вложенность) | abort — окно падает | падает исполнитель |
нехватка памяти (alloc → abort) |
abort — окно падает | предел памяти, падает исполнитель |
| бесконечный цикл, «бомба времени» | окно висит | тайм-аут и предел CPU |
неизвестная ошибка в будущем коде, unsafe в
зависимостях |
процесс окна | без сети и файлов, процесс одноразовый |
Замеры (17.10.2026, Mac, процессорное время потока, корпус с GX10: 382 DOCX ≤ 4 МБ и 161 XLSX)
| разбор | перевод в модель | запись .mwx |
чтение .mwx |
вёрстка / пересчёт | |
|---|---|---|---|---|---|
| DOCX | 2,3–2,9 с | — | 3,1–3,6 с | 2,0–2,3 с | 5,5–7,0 с |
| XLSX | 1,8–1,9 с | 8,8–9,4 с (to_workbook) |
— | — | 1,2 с |
Круг docx → Document → .mwx → Document точен на всех 382
файлах (с учётом переименования медиа rename_media).
Варианты
| Вариант | Как | Изоляция | Время открытия |
|---|---|---|---|
| А. «Проверить и разобрать заново» | исполнитель разбирает, окно при успехе разбирает те же байты | только от отказов (окно всё равно читает чужие байты) | DOCX +30 %, XLSX +88 % — не проходит (+15 %) |
Б. Перекодировать в .mwx |
исполнитель пишет .mwx, окно читает |
полная для Write; для книг формата нет | DOCX +76 % — не проходит |
| В. Свой двоичный снимок модели | исполнитель отдаёт готовую модель (Document; для книг —
Workbook после пересчёта и данные сохранения) в формате
meridian-wire |
полная: окно не видит чужих байтов, только наш снимок | оценка +5…10 % (кодирование и чтение снимка, запуск процесса скрыт заранее запущенным исполнителем) |
Решение — вариант В. Формат снимка свой, без serde:
крейт meridian-wire (типаж Wire, примитивы,
коллекции, предел глубины и длины) и свой процедурный макрос
#[derive(Wire)] в meridian-wire-derive (только
proc_macro из компилятора, без
syn/quote). Макрос держит кодек в согласии с
типами: добавили поле — оно кодируется; тип без Wire в
модели — ошибка компиляции, а не тихая потеря.
Граница процесса
окно (Write / Sheets) исполнитель (тот же бинарник, `--meridian-parse-worker`)
meridian_doc_open / meridian_book_open
читает файл (SavedFile: хеш, версия)
── запрос: вид, флаги, байты файла ──────▶ изоляция ОС → разбор → модель → снимок Wire
◀── ответ: статус, сообщение, снимок ──── выход (процесс одноразовый)
читает снимок (пределы), вёрстка/пересчёт
- Исполнитель — тот же исполняемый файл приложения с
ключом
--meridian-parse-worker: упаковку (S1) менять не нужно. Приложение вызываетmeridian_ffi::sandbox::init()первым делом вmain: в режиме исполнителя функция обслуживает один запрос и завершает процесс, иначе включает песочницу для этого процесса. Хост, которыйinit()не вызвал (Hub, C-пример, тесты без исполнителя), разбирает файлы по-прежнему в своём процессе. - Исполнитель не трогает файловую систему: байты
файла передаются по каналу, пути и
SavedFileостаются в окне. - Запуск заранее и переиспользование: окно держит
один готовый исполнитель (уже изолированный, ждёт запрос на stdin).
Процесс обслуживает подряд до 16 разборов, затем заменяется новым; после
любого отказа, ответа больше 64 МиБ или памяти больше половины предела —
сразу новый. Причина — холодный старт: свежий процесс на каждый документ
давал +44 % ко времени открытия корпуса (запуск 22–58 мс, холодные кэши
и распределитель памяти). Цена — изоляция между документами одного окна
внутри серии из 16 (исполнитель не хранит состояния между запросами, а
захват процесса потребовал бы порчи памяти в коде без
unsafe). Окно закрылось — исполнитель получает EOF и выходит.
Формат обмена
Кадры как у превью Hub: u32 длина + тело. Запрос:
MOSB + версия, вид (1 документ, 2
книга, 9 проверочный аварийный выход), флаги (из шаблона,
пароль Office по умолчанию), байты файла (≤ 512 МиБ). Ответ: статус
(0 готово, 1 формат, 2 нужен
пароль, 3 предел, 4 не поддержано), сообщение
UTF-8 (≤ 64 КиБ), снимок Wire (≤ 1 ГиБ). Снимок читается с
пределами: длина любой последовательности не больше оставшихся байтов,
глубина вложенности ≤ 256, хвост после снимка — ошибка. Для чтения
снимка — цель фаззинга.
Что передаётся обратно:
- документ:
Document, предупреждения импорта, вид (DOCX / ODT / ОТТ-шаблон / MWX с сессией) и данные сессии.mwx— уже разобранные исполнителем; - книга:
Workbookпосле пересчёта, форматы и оформление ячеек, разметка листов, тема, сводные, свойства, XML-карты, «сквозные» части и перечень «что не сохранится» — всё, чтоMeridianBookберёт из файла. - картинки: исполнитель разбирает заголовок каждой картинки документа; паника — карантин. Картинки, похожие на бомбу (≥ 64 МиБ пикселей при сжатии от 50:1), проверяются полностью отдельными запросами по одной: не раскодировалась или исполнитель упал / вышел за предел — карантин, документ открывается без неё. Байты картинок не меняются (сохранение ничего не теряет); картинку в карантине окно не декодирует. Полное декодирование всех картинок в исполнителе отвергнуто: на корпусе оно удваивало время открытия DOCX. Остальные картинки окно декодирует само — с бюджетом 1 Гпикс на документ, пределом 64 Мпикс и декодерами под фаззингом (Б2, Б3).
Пределы и изоляция
| Linux | macOS | Windows | |
|---|---|---|---|
| память | RLIMIT_AS 2 ГиБ (не меньше 768 МиБ: поток пересчёта
книг берёт стек 512 МиБ) |
контроль RSS из окна (proc_pidinfo), 2 ГиБ
(RLIMIT_AS мешает dyld) |
Job Object: память процесса 2 ГиБ |
| CPU | RLIMIT_CPU 60 с |
RLIMIT_CPU 60 с |
Job Object: время процесса 60 с |
| время (стенка) | 60 с от запроса, затем убить группу | так же | так же, TerminateJobObject |
| дочерние процессы | seccomp: execve, fork запрещены |
профиль SBPL (deny default) |
Job: не больше 1 процесса |
| сеть и файлы | seccomp: socket, open* запрещены;
no_new_privs |
sandbox_init со своим профилем SBPL строкой:
(deny default), разрешены только сигналы себе и чтение
sysctl; без подписи; встроенные профили по имени
(pure-computation) на macOS 27 убивают процесс — проверено
18.10 |
не закрываются средствами Job; записано честно |
| дескрипторы | закрыты все кроме 0–2 до exec,
RLIMIT_NOFILE 8 |
так же | наследуются только каналы |
| окружение | пустое, рабочий каталог / |
так же | пустое |
| дамп | RLIMIT_CORE 0 |
так же | — |
seccomp — свой фильтр BPF (без libseccomp): белый список системных
вызовов для чтения/записи каналов, памяти, потоков (clone
только с CLONE_THREAD, clone3 →
ENOSYS), часов, сигналов и выхода; остальное —
EPERM; архитектуры x86_64 и aarch64, чужая архитектура —
убить.
Поведение при отказе
| Исход | Окно |
|---|---|
| формат, пароль, «не поддержано» | та же ошибка FFI, что и без песочницы
(MERIDIAN_E_FORMAT, MERIDIAN_E_PASSWORD) |
| предел памяти / CPU, тайм-аут | MERIDIAN_E_FORMAT: «Документ слишком сложный: разбор
превысил предел памяти/времени» |
| исполнитель упал (abort, сигнал) | MERIDIAN_E_FORMAT: «Документ не удалось разобрать:
разборщик аварийно завершился» |
| исполнитель не запустился | разбор в процессе окна (как до песочницы) и строка в журнале; сделано, чтобы песочница не мешала открывать файлы на необычной системе |
| снимок не прошёл проверку | MERIDIAN_E_FORMAT |
Флаг и выкатка
MERIDIAN_SANDBOX=0в окружении — разбор в процессе окна (обход для поддержки); по умолчанию включено в тех хостах, которые вызвалиsandbox::init()(Write, Sheets —[касание S3],[касание S4], одна строка вmain).- Hub оставляет свой исполнитель превью; перевод его на
meridian-sandbox— решение S2 после 0.9. - CSV в Sheets (18.10) разбирается в исполнителе как «задание хоста»:
Sheets до
init()регистрируетregister_job("csv", csv_job)— свой разборщикtext_importостаётся в крейте S4, исполнитель (тот же бинарник) выполняет его по запросу, параметры и строки идут снимкомmeridian-wire; без песочницы — разбор в окне, как раньше. Своего чтения ODS пока нет. - Встроенные шрифты документов ядро пока не читает; когда начнёт — разбор шрифта идёт в исполнителе по той же схеме.
Проверка
Сделано 18.10.2026: тесты meridian-sandbox (9: эхо и
переиспользование, бомба памяти, цикл CPU, тайм-аут,
abort/паника/переполнение стека, файлы/сокет/процесс запрещены, потоки
работают, пределы размеров) и meridian-ffi/tests/sandbox.rs
(5: та же модель, книга, ZIP-бомба, PNG-бомба в карантин, падение
исполнителя) на macOS 27, Linux aarch64 (GX10) и x86_64 (sagr) в
rust:1.97.1-slim; clippy для Windows. Время открытия —
квитанция kernel/crates/meridian-sandbox/evidence/.
- Тесты в исполнителе: ZIP-бомба и PNG-бомба — отказ с сообщением, окно живо; аварийный выход и бесконечный цикл исполнителя — сообщение и тайм-аут; seccomp/sandbox: попытка открыть файл и сокет из исполнителя не проходит.
- Снимок: круг
модель → Wire → модельточен на корпусе (документы и книги); цель фаззингаwire. - Время: открытие корпуса (382 DOCX, 161 XLSX) с песочницей и без — не
хуже +15 % (квитанция в
qa/). - Windows: код за
cfg(windows),just clippy-windows; приёмка на Windows-ПК — в G6.
Риски
derive(Wire)на типах S3 и S4: новые типы модели должны его получить, иначе не соберётся (это и есть защита).- Ошибка в белом списке seccomp ломает открытие на Linux — поэтому запасной путь «исполнитель не запустился → в процессе» и тест на каждом раннере (sagr x86_64, GX10 aarch64).
sandbox_initна macOS помечен устаревшим; на macOS 27 встроенные профили по имени уже убивают процесс, свой профиль строкой работает. Замена — App Sandbox в подписанном пакете (G2, Developer ID); тестfiles_network_and_processes_are_deniedпоймёт, если Apple сломает и это.- Снимок читается без повторной проверки инвариантов типов (например,
DocumentProperties: XML и проекция): его пишет наш исполнитель; пересчёт из XML вернул бы в окно разбор чужих байтов.Workbookпроверяется (18.10, вместе с S4): окно принимает книгу только черезWorkbook::accept_snapshot— номера листов у имён и таблиц, границы ячеек, разливов и строк; разлив обязан совпадать с массивом-результатом, формула массива — не больше 16 млн ячеек; массивrows × colsсверяется с данными при чтении снимка. Граф зависимостей и очередь пересчёта в снимок не входят и строятся заново по формулам. Фаззингwireс пересчётом принятой книги — 11 мин, 6 млн прогонов без падений.