Сохранность файлов: этап 0R
Дата: 7 октября 2026. Начальный этап —
codex/moffice-reliability, база d54c1b2;
актуализация — интеграционный кандидат 9eafd4a. Это
инженерный кандидат, не завершённый релиз.
Что изменено
Все пути записи документов через FFI — MWX, DOCX, защищённый DOCX,
ODT, XLSX и два PDF-экспорта — используют атомарную запись
meridian_core::atomic_file (обычную или с дополнительной
проверкой назначения). Экспорт CSV из Sheets использует тот же
механизм.
- Создаётся уникальный временный файл в каталоге назначения, с эксклюзивным созданием и правами 0600 на Unix.
- До первого байта временный файл на macOS/Linux освобождается от
унаследованной ACL. Весь результат записывается туда; owner/group,
обычные права и доступные ACL/xattr существующего файла переносятся до
sync_all. Контракт и проверки метаданных. - Дескриптор закрывается, временный файл переименовывается поверх назначения. Оригинал не удаляется отдельным действием.
- На Unix синхронизируется каталог. Ошибка этого последнего шага прямо сообщает: новый файл уже записан, долговечность записи каталога не подтверждена.
- При обычной ошибке или panic временный файл убирается. При аварийном завершении процесса временный файл может остаться, а ранее сохранённый оригинал остаётся целым.
Существующая символическая ссылка сохраняется, запись идёт в её конечный файл. Каталог, оборванная ссылка, файл только для чтения и отсутствующий родитель дают ошибку. Проверяется также доступ на запись исходного файла, а не только возможность переименования в его каталоге.
Два редактора и внешние изменения
Ручное сохранение MWX, DOCX (в том числе с паролем) и XLSX теперь запоминает SHA-256 тех байтов, которые были прочитаны при открытии. Дата изменения и размер недостаточны: другой редактор может сохранить файл того же размера с прежней датой.
- Перед записью проверяется исходный путь и содержимое. Изменение,
удаление или смена цели ссылки останавливает сохранение с
MERIDIAN_E_CONFLICT = -7; правки в окне и аварийная копия остаются. - Короткая системная блокировка
.moffice-lock-<hash>удерживается от проверки до завершения атомарной замены. Другой новый MOffice получает ошибку занятости сразу, без зависания интерфейса. В конце записи выполняется явный unlock (дескриптор мог кратко унаследовать запускаемый дочерний процесс); при аварии блокировку освобождает ОС. - После подготовки временного файла SHA-256 проверяется ещё раз непосредственно перед rename. Это обнаруживает внешнюю запись во время подготовки файла.
- Lock-файл остаётся пустым после сохранения. Его нельзя удалять, пока
работают редакторы: удаление нарушило бы общий объект блокировки. Он не
содержит документ, пароль или исходный путь. Имена начинающиеся с
.moffice-lock-зарезервированы. - Имена для блокировки и сравнения пути приводятся к нижнему регистру и NFC. Это покрывает варианты регистра/Unicode на обычных macOS/Windows томах. На чувствительной к регистру файловой системе разные пути, отличающиеся только регистром/нормализацией, могут консервативно считаться одним и получить конфликт.
- Автокопия использует отдельный API и не обновляет запомненную версию оригинала. Отмена действий и восстановление снимка Sheets также не возвращают старую версию диска.
- Write и Sheets предлагают «Сохранить как» с именем «… (копия)». Файл первой записи остаётся, в отдельную копию попадают правки второго окна. Автоматического слияния и кнопки принудительной перезаписи здесь нет.
- После аварийного восстановления любой документ сохраняется как отдельная копия: sidecar не содержит проверенной версии прежнего оригинала. Для защищённого Write путь и имя оригинала также не раскрываются.
Граница гарантии. Протокол блокировки соблюдают только новые пути сохранения MOffice. Word, старый MOffice, PDF/ODT/CSV-экспорт и другие программы могут его игнорировать. Между последним сравнением и rename остаётся очень короткая гонка с таким процессом; универсальной файловой операции «заменить, только если хэш прежний» в Rust std нет. Работа на сетевых ФС, необычные правила имён и враждебная подмена lock-файла не приняты.
«Сохранить как» в другой существующий файл остаётся явной заменой после подтверждения диалога. Для него проверка отсчитывается от начала записи, а не от открытия исходного документа. Разбор различий и принудительное разрешение конфликта — отдельная будущая возможность.
Системная блокировка использует безопасный Rust
File::try_lock, доступный с 1.89; минимальная версия
meridian-ffi поднята до 1.89, поэтому настольным
приложениям также нужен Rust не ниже 1.89. Проверки выполняются
закреплённым Rust 1.97.1; отдельный полный MSRV-прогон ещё не заявлен.
Для блокировок внешние зависимости и unsafe не нужны. Последующий
системный перенос метаданных изолирован во внутреннем адаптере.
Автовосстановление
Write
- Изменённый защищённый документ получает зашифрованную MWX-копию с тем же паролем. Пароль не записывается в метаданные и журналы.
- Открытый
.txtрядом содержит только «Защищённый документ», без имени и исходного пути. После восстановления требуется «Сохранить как». - Неверный пароль, отмена диалога и ошибка чтения не удаляют копию.
- Успешное открытие также не удаляет единственный экземпляр: он остаётся до следующей успешной автокопии, обычного сохранения или явного отказа от документа.
- Смена пароля без изменения текста немедленно обновляет автокопию. Сначала проверяется удаление старой незашифрованной копии; при ошибке защита не считается изменённой. Если запись новой копии не удалась, правки остаются в памяти и показывается ошибка.
- При повторном падении находятся и новые
<pid>-recovered-…и старыеclaimed-…копии.
Sheets и Hub
Sheets сохраняет восстановленный XLSX до следующей долговечной записи. Повреждённая копия остаётся на диске. Hub понимает прежние и новые имена копий.
Современные v2-копии принадлежат уникальному окну с системной
блокировкой; PID и heartbeat не определяют их доступность. Устаревшие
имена с PID читаются консервативно: живой процесс сохраняет право на
копию даже при старой или отсутствующей .alive. Повторное
использование PID может откладывать только такое устаревшее
восстановление. Подробности — хранилище
recovery.
Проверки
cargo test -p meridian-core --locked: замена и создание; ошибка после частичной записи; panic; отказ rename; права и ссылки; завершение дочернего процесса до фиксации.cargo test -p meridian-ffi --lib --locked: два отдельных процесса пишут из одной версии (успех только одного), занятой lock не блокирует UI-поток, аварийный выход освобождает lock; завершённая запись освобождает lock даже при дубликате дескриптора; именованный канал отвергается без зависания; хэш обнаруживает изменение при одинаковых размере/дате, удаление и смену ссылки.cargo test -p meridian-write --test file_safety --locked: два окна с MWX/DOCX и паролем, реальный переход диалога «Сохранить как», шифрование, неверный пароль, отмена, повторное падение, повреждённая копия, ошибка автосохранения и повторная попытка, отказ сохранения в файл только для чтения.cargo test -p meridian-sheets --test file_safety --locked: повторное падение с формулой, повреждённая копия, отказ XLSX/CSV и успешный повтор; два окна с конфликтом, диалог отдельной копии, сохранение после Undo/restore, видимая ошибка каталога восстановления.- Нативное окно macOS: синтетический защищённый документ восстановлен после ввода тестового пароля; после принудительного завершения процесса копия снова предложена при запуске. Это не проверка реального отключения питания.
Синтетические данные проверок не содержат пользовательских
документов. MOFFICE_SAFETY_FIXTURE_DIR,
MOFFICE_SAFETY_SCREENSHOT,
MOFFICE_CONFLICT_SCREENSHOT и
MOFFICE_SHEETS_CONFLICT_SCREENSHOT — необязательные
абсолютные пути для получения тестового образца и
изображения диалога.
История предыдущих сохранений
Write (MWX/DOCX) и Sheets (XLSX) сохраняют до 20 предыдущих версий / 256 МиБ рядом с исходником. Диалог «История версий» восстанавливает проверенную по SHA-256 отдельную копию. Автокопии не пополняют историю. При защищённой записи открытая история очищается; старым зашифрованным версиям нужен прежний пароль. Полный контракт, последствия ошибки и оставшиеся пункты: История сохранений.
Что ещё нужно для завершения 0R
- Сравнение двух версий и управляемое слияние; проверка протокола на всех целевых файловых системах и ОС.
- Именованные/закреплённые версии, фоновая работа, глобальная квота и история MOP; уборка временных файлов после аварии по проверенной принадлежности.
- Windows ACL/ADS и hard links, привилегированные/скрытые атрибуты и особые файловые системы. macOS/Linux перенос доступных ACL/xattr и отказ для Unix hard links реализован в интеграционной ветке; точные границы.
- Нативные тесты на Windows и Linux: открытые дескрипторы, отказ доступа, заполнение диска, сетевые файловые системы. Windows не имеет переносимой синхронизации каталога через Rust std.
- Отказ питания/диска на отдельном тестовом устройстве. Успешный
fsyncи имитация ошибки не доказывают поведение любого накопителя. - Защита от намеренной подмены пути другим процессом между проверкой и rename. Текущая реализация рассчитана на обычные пользовательские каталоги, не на враждебный совместный каталог.
- Sheets ещё не поддерживает зашифрованные XLSX; Write не гарантирует точное сохранение всех неподдерживаемых элементов чужого DOCX.
Обычное удаление прежней автокопии не является гарантированным стиранием данных с SSD или из резервной копии ОС.