MOffice

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
    ◀── ответ: статус, сообщение, снимок ────  выход (процесс одноразовый)
    читает снимок (пределы), вёрстка/пересчёт

Формат обмена

Кадры как у превью Hub: u32 длина + тело. Запрос: MOSB + версия, вид (1 документ, 2 книга, 9 проверочный аварийный выход), флаги (из шаблона, пароль Office по умолчанию), байты файла (≤ 512 МиБ). Ответ: статус (0 готово, 1 формат, 2 нужен пароль, 3 предел, 4 не поддержано), сообщение UTF-8 (≤ 64 КиБ), снимок Wire (≤ 1 ГиБ). Снимок читается с пределами: длина любой последовательности не больше оставшихся байтов, глубина вложенности ≤ 256, хвост после снимка — ошибка. Для чтения снимка — цель фаззинга.

Что передаётся обратно:

Пределы и изоляция

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

Флаг и выкатка

Проверка

Сделано 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/.

Риски