Восстановление DOCX с неоднозначными свойствами
Документ с исправным телом должен открываться, даже если его свойства нельзя однозначно представить в типизированной модели. Импорт сохраняет все исходные property parts без изменения байтов. Он не выбирает один из двух авторов и не превращает недопустимое число минут в допустимую длительность.
Дефект воспроизведён на двух неизменных документах корпуса:
OPCCompliance_CoreProperties_OnlyOneCorePropertiesPartFAIL.docx: два root relationship с разными Id ведут к двум одинаковым core-properties parts. До исправления импорт завершалсяDuplicate property part role.testWORD_totalTimeOutOfRange.docx:TotalTimeравен4294967295. До исправления импорт завершалсяInvalid app TotalTime integer.
TotalTime выражается в минутах; его допустимые значения
определены через XML Schema int. Существующий
типизированный контракт длительности также отвергает отрицательное
число. В режиме восстановления исходное число остаётся в XML без
преобразования. Описание
Microsoft.
Проверки импорта
DocumentProperties::from_docx_import_parts сначала
выполняет прежнюю строгую проверку. Успешный результат сохраняет
envelope версии1 и остаётся редактируемым. Если типизированная проекция
невозможна, импорт отдельно проверяет каждый part: безопасный путь,
отсутствие регистронезависимых коллизий, общий лимит32MiB, полный XML и
соответствие namespace/root его роли. Только после этого он создаёт
envelope версии2 с mode='opaque'.
На уровне OPC по-прежнему обязательны CRC, правильные content types, уникальные Id и targets, внутренние разрешимые relationships и отсутствие пересечения с телом/служебными частями. Повреждённый XML, DTD, опасный путь, неверный root, дублированный Id/target и stale private binding не переходят в recovery.
from_docx_parts, envelope версии1 и обычные XML setters
остаются строгими. Версия2 разрешена только для structurally valid
parts, которые действительно не проходят прежнюю семантическую проверку.
Корректные свойства нельзя скрыть под mode='opaque'.
Неизвестные версии и режимы отвергаются.
Модель и правка
Один неизменяемый DocumentProperties владеет всем
исходным набором parts. В recovery is_read_only()
возвращает true, а values() содержит пустую
типизированную проекцию. Это признак отсутствия достоверных полей;
исходные данные доступны через source_xml() и
docx_parts().
Текст документа можно редактировать, отменять и сохранять. Пустой
PropertyUpdates является no-op. Любая явная точечная правка
свойств отвергается до изменения документа, revision или истории,
включая redo-ветку. Осознанная замена всего источника на валидный или
очистка свойств разрешены: это одна Undo-операция, которая
восстанавливает исходные parts вместе с моделью. Удалённые foreign
copies не могут воскресить старые свойства при сохранении.
Legacy MWX, где metadata хранилась только в foreign parts, проходит тот же проверяемый импорт при чтении. DOCX export использует его локально, не изменяя модель вызывающего кода.
Версионный контракт DOCX/MWX/ODT и C ABI
PropertySource::DocxPartsи C ABI format4 сохраняются. Envelope имеет namespaceurn:moffice:document-property-parts:1,version='2' mode='opaque'. Вложенныеp:partсохраняют role/path и точные исходные bytes в base64. Старый читатель версии1 явно отвергнет новую версию.- Обычный DOCX export возвращает каждый исходный property part на его
путь. Private origin carrier хранит версию2 целиком. Его binding
сортирует parts по
(role, path): дублированные роли не делают проверку зависимой от ZIP order. - MWX для recovery пишет
binding-version='3'. После исключения carrier и statistics пустойm:metaсчитается structural container: pretty-print whitespace не меняет binding. Whitespace-only scalar values остаются точными. Прежняя канонизация версий1/2 сохранена; обычный writer продолжает писать2. Читатель знает все три алгоритма: корректная привязка версии3 допустима и для legacy metadata, если канонизация совпала. Принятые модель и source bytes обязаны оставаться точными; внешняя правка видимой проекции делает carrier устаревшим. Неизвестные0/4/999/invalid по-прежнему отвергаются. - ODT сохраняет тот же envelope в
MOffice/document-properties.xml; его существующий source carrier и контроль привязки остаются обязательными. MERIDIAN_ABI_VERSIONостаётся1, новых функций и enum values нет. Getter format4 возвращает точный envelope. Его восстановление через whole-source setter валидируется по версии; пометка ошибочного источника как version1 возвращаетMERIDIAN_E_FORMATбез изменения handle. Format0 очищает свойства с Undo. UI может определить recovery по версии envelope; точечная форма свойств должна сообщить об отказе, сохранив исходный документ.
Binding обнаруживает устаревшую проекцию; он не является подписью подлинности.
Регрессии и границы приёмки
Замороженные восемь docx_property_recovery на52c дали
2PASS/6FAIL; после исправления тот же исходник дал
8PASS. Они проверяют одинаковые и противоречивые core
parts, обратный порядок путей, UTF-8/UTF-16BE, неверные TotalTime,
правку тела/Undo/Redo, отказ точечной правки, очистку и сохранение
строгого редактируемого version1. Исходный test source и старые отказы
сохранены.
Дополнительно проверяются четыре model guards и три transport guards: legacy foreign-only MWX, whole-source replacement/Undo и stale native header. Последний тест пересчитывает package manifest после порчи, поэтому отказ должен исходить именно из property binding, а не из ZIP/manifest checksum.
Прямой Rustc-срез пяти свежих библиотек дал 87+3PASS/0FAIL,17 strict-целей. Два оригинала прошли DOCX/MWX/ODT save/reopen и DOCX re-export. Независимый XML/ZIP-аудит сверил исходные property bytes и native carriers;129 исходных файлов совпали со сборкой. Квитанция.
Этот срез не заменяет свежие Cargo/full14, FFI/C12, native layout и
полный383. Первый b486 full14 остановился на старом тесте, ошибочно
объявлявшем версию3 неизвестной. Исправленный набор сохраняет исходные
v3 входы и stale-контроли: прежние 4PASS/1FAIL → 6PASS,
strict прошёл. Старые C12/383 не запускались из-за отказа зависимости;
новый полный состав принимает их заново. Для кандидата обязательны
all-targets check, полные затронутые tests, strict Clippy, fmt, SBOM,
сборка конвертеров, C ABI unit и настоящий C matrix.
property_recovery.c и
qa/properties/c_recovery_matrix.py дополнительно открывают
оба оригинала через настоящий C ABI: short buffers, byte-identical
no-op, отказ version1 с сохранением redo, body edit/Undo/Redo,
clear/Undo и четыре сохранения/повторных открытия. Python отдельно
проверяет package CRC, исходные property bytes, source carriers и MWX
binding-version3. Этот новый consumer должен быть скомпилирован и
выполнен на свежем staticlib кандидата; одна проверка C syntax не
означает его приёмку. Полный visual сохраняет383 документа,16 прежних
исключений и SSIM≥0,95; восстановление покрытия само по себе не
доказывает достижение60% страниц.