Журнал сессии D «Правка и формат Write»
Дорожка D открыта 2026-10-05 сессией «Анализ параллельной разработки планов» по цели владельца «выполнять полностью — с описанием, тестами, комментариями в коде и необходимым развитием». Взяты пункты плана, которые никто не начинал: № 2 «Операционная модель текста: вставка/удаление/формат как операции, undo/redo» и № 4 «Кодек .mwx (чтение/запись) + шифрование» (отчёт
plan/, раздел 8; фаза 1, шаги 1.1 и 1.2). Согласовано с A (не начинала, против не была), B и C — сообщениями 2026-10-05.Зона D (карта владения
docs/sessions/README.md):kernel/crates/meridian-edit/,kernel/crates/codec-mwx/,tools/mwx-demo/,docs/sessions/D-log.md; стенд https://moffice-edit.24oros.ru (sagr/opt/projects/moffice-edit, контейнерmoffice-edit, 192.168.1.90:18330, маршрутsagr-moffice-edit-direct.yaml). Чужие крейты (meridian-text-model,codec-ooxml,meridian-ffi, вёрстка, окна) D только читает; запросы — во «Входящие» A, B, C. Протокол общий: слияние в main только перемоткой послеjust ci.
Входящие (запросы других сессий)
- 2026-10-05 от C: взять движок диаграмм MOffice Chart
(
meridian-chart, SH-03) — модель (гистограмма/линейчатая с группировкой и накоплением, график, круговая/кольцевая, точечная, с областями; ряды из диапазонов листа, заголовок, легенда, оси, подписи), чтение/записьc:chartSpaceиxdr:twoCellAnchor, отрисовка в RGBA; C ABI для книг — через A. — принято, следующий этап D (см. «План»).
План работ дорожки D
| № | Задача | Статус |
|---|---|---|
| D1 | meridian-edit: адреса, единицы абзаца, обратимые
операции с OpId, история с группировкой, курсор и
выделение, команды Word |
готово 2026-10-05 |
| D2 | codec-mwx: .mwx и .mwxf без потерь модели, манифест с
SHA-256, медиа по хэшу, шифрование паролем |
готово 2026-10-05 |
| D3 | Стенд moffice-edit.24oros.ru
(tools/mwx-demo): открыть → править → сохранить → прочитать
→ сверить |
готово 2026-10-05 |
| D4 | meridian-chart (просьба C): модель, раскладка и
отрисовка, c:chartSpace |
следующее |
| D4а | Тест правок + meridian_ffi::edit::check_caret_stops
(A): после случайных правок и полной отмены места курсора в вёрстке
сходятся |
готово 2026-10-05 |
| D6 | Неизвестные части docx в .mwx (Document.parts, план
1.2): foreign/ooxml/<путь> +
foreign/ooxml/index.xml, в .mwxf — m:file в
m:media; порядок: A — поле (без заполнения) → D — .mwx → A
— read/write_docx |
.mwx готово 2026-10-05 |
| D7 | Ссылки и рецензирование (план 1.4): гиперссылки, поля TOC/SEQ/REF, закладки, примечания — правка в Editor и .mwx (модель, docx и вёрстка — A) | влито в main 2026-10-05 (b6cb106) |
| D8 | Inline::Foreign (диаграммы, SmartArt, OLE, формулы OMML
— исходный XML и связи): правка (одна единица) и .mwx
(g:inline/g:anchor +
m:x source="ooxml/<вид>" part="id=тип=цель;…", XML
текстом) |
влито в main 2026-10-05 (a50f75b) |
| D8а | «Документ со всем»: объекты Foreign — настоящие DrawingML/SmartArt/OMML с частями; строгая проверка через docx (без варианта «без объектов») | готово 2026-10-05 |
| D5 | Правка дальше: строки/столбцы таблиц, списки (Enter в пустом пункте снимает нумерацию), стиль «следующего абзаца», поиск и замена, перенос текста мышью | после D4 или по запросу B |
Решения и устройство
Модель правки
(kernel/crates/meridian-edit):
- Адрес — контейнер блоков (тело раздела, колонтитул, сноска, концевая сноска, ячейка таблицы на любой глубине), индекс абзаца и смещение в единицах: символ текста — одна единица, любой нетекстовый инлайн (табуляция, разрыв, картинка, поле, сноска, фигура) — одна. Деление текста на прогоны на адреса не влияет.
- Восемь примитивов (
Replace,Split,Join,InsertBlocks,RemoveBlocks,SetHead,InsertSections,RemoveSections) — каждый возвращает точное обращение. Команда — транзакция: при ошибке уже применённое откатывается. Журнал операций — сOpId(реплика + номер), чтобы в фазе 6 подложить CRDT без смены API. - История: шаг = команда с выделением до/после; набор склеивается до границы слова (одно «Отменить» — одно слово), Backspace/Delete подряд — в один шаг; перемещение курсора начинает новый шаг. Предел — 1000 шагов.
- Как Word: набор берёт оформление знака перед курсором; «Ж» без выделения — для следующего набора; «Ж» на выделении, полужирном стилем, выключает прямым свойством; удаление через таблицу удаляет её целиком, через границу раздела — сливает разделы; двойной щелчок — слово с пробелами после него.
- Вне модели правки: движение по строкам и Home/End строки (нужна
вёрстка — окно передаёт попадание в
Editor::move_to), рецензирование, комментарии, поля (шаг 1.4).
Формат .mwx (kernel/crates/codec-mwx) —
по spec/formats/write.rnc и
mop-package-layout.md; запись детерминирована (те же байты
для того же документа), медиа
media/image-<uuid из SHA-256>.<ext> (одинаковые
картинки — один раз). Свойства модели, которых нет в схеме, пишутся в
предусмотренный схемой m:x-attrs — список ниже передан B
для внесения в схему.
| Где | Ключ m:x-attrs или элемент |
Что в модели |
|---|---|---|
t:r, t:rpr, t:mark |
font-theme, font-hansi,
fonts=1 |
FontSet::ascii_theme при явном шрифте,
h_ansi, пустой набор |
t:p, t:ppr |
contextual-spacing |
ParaProps::contextual_spacing |
t:p, t:ppr |
outline-body=9 |
уровень 9 «основной текст» (схема — только 1–9 для уровней 0–8) |
t:p, t:ppr |
frame=ширина,высота,привязки,x,y,выравнивания,обтекание,поля,буквица |
ParaProps::frame (w:framePr) |
t:p, t:ppr |
tabs=none |
явно пустой список табуляций |
w:section |
break=next-column, title-page=1 |
начало раздела «с новой колонки», особый первый колонтитул |
t:r |
note-custom=1, note-kind=endnote |
свой знак сноски; знак концевой сноски в её тексте |
g:anchor |
x-offset, y-offset, x-align,
y-align, rel-x, rel-y |
смещение вместе с выравниванием; выравнивание по ширине; привязки вне перечня оси |
g:shape |
line-space, insets=l,t,r,b |
отступ линии, поля надписи |
m:style |
kind=numbering |
стиль нумерации |
tb:tpr в стиле |
margins=1 |
поля ячеек заданы, даже если все стороны пусты |
g:inline, g:anchor |
дочерний t:rpr |
свойства объекта как знака (размер, подъём) — предложение в схему |
t:level |
дочерний t:ppr; align =
justify |
отступы уровня списка — предложение в схему |
w:note |
kind="separator", id="separator" |
разделитель сносок — предложение в схему |
t:sym |
без font, char = код знака |
знаки, недопустимые в XML 1.0 (U+0001…), внутри текста |
Записи
- 2026-10-05 — D1: модель правки Write
(
meridian-edit, c20dd00). Модулиpath(адреса, обход в порядке чтения),units(единицы, деление/вставка/слияние прогонов, оформление набора),op(8 примитивов с обращением),history(выделение, шаги, склейка, пределы),bounds(графемы: комбинирующие знаки, ZWJ, флаги, модификаторы, хангыль,\r\n; слова: апостроф и точка внутри слова),editor(команды). Проверки: 13 модульных, 15 сквозных тестов (группировка набора по словам, Enter/Backspace/Delete, графемы и слова, удаление через абзацы, таблицу и раздел с точной отменой, «Ж» на выделении и для набора, «Ж» поверх стиля, вставка многострочного текста, курсор по графемам/словам/абзацам/ячейкам/разделам, выделение не выходит из колонтитула, таблица/табуляция/разрыв, «выделить всё и удалить», журнал операций) и свойство «любая последовательность правок отменяется до исходного и повторяется до конечного»: 40 зёрен × 60 команд на синтетике, 3 docx × 10 зёрен × 80 команд из репозитория, внешний корпус — 382 из 405 docx (остальные 23 не открывает импорт docx). Найдено и исправлено тестом: вставка поверх выделения через таблицы брала оформление из уже удалённой ячейки. - 2026-10-05 — D2: кодек .mwx
(
codec-mwx, 60ccf00). Модулиxml(своя детерминированная запись поверхmeridian_xml::Element, экранирование,m:x-attrs),props(знаки и абзацы, рамки, табуляции, рамка абзаца),content(разделы, колонтитулы, абзацы, прогоны, поля, сноски, объекты в строке и плавающие, надписи, таблицы сcolspan/rowspan+phantomи вложенными таблицами, списки),styles(умолчания, шрифты темы, стили, списки, настройки),lib(пакет, манифест с SHA-256, медиа, шифрование, плоский .mwxf). Чтение принимает и формы схемы, которые пишут другие программы (текст прямо вt:p,t:link,t:ins, любые поля — результат,w:sdt-block, ссылка на сноску вне прогона). Проверки: 4 модульных, 8 сквозных тестов (каждая конструкция модели — пакет и плоский вариант; раскладка пакета по спецификации; порча части ловится по SHA-256; пароль — верный/неверный, текста не видно; примерspec/formats/write.example.xmlчитается; docx из репозитория; «правка → сохранение → открытие»); внешний корпус — без потерь 382 из 382 открытых docx, .mwx в среднем 0,69 размера docx. - 2026-10-05 — D2, исправление по проверке на стенде:
живой запрос на moffice-edit показал, что docx с картинками
image1.jpeg+image2.pngпосле «записать → прочитать» записывался в другом порядке (части медиа шли по исходным ключам, а после чтения ключи уже переименованы). Медиа теперь пишутся по именам в пакете (и в .mwxf); тестmedia_order_does_not_depend_on_source_keys, тест корпуса проверяет и побайтную повторяемость — 382 из 382. - 2026-10-05 — D3: стенд https://moffice-edit.24oros.ru
(
tools/mwx-demo): свой HTTP-сервер на std, страница «Проверить документ» (docx/.mwx/.mwxf → по желанию «дописать абзац» и «всё полужирным» черезEditor→ .mwx → чтение → сверка: круговой путь, плоский вариант, детерминированность, полная отмена) и скачивание .mwx. Образ — статический musl на пустом базовом (как meridian-api), выкладкаtools/mwx-demo/deploy/deploy.sh. - 2026-10-05 — D3 выложен и проверен онлайн (main
4282831): https://moffice-edit.24oros.ru
— sagr
/opt/projects/moffice-edit, маршрутsagr-moffice-edit-direct.yaml, домен вsagr-domains.lstна входном VPS (бэкап,haproxy -c, reload), сертификат Let’s Encrypt. Снаружи:/и/healthz200, http → 301; загрузка 40 docx корпуса с правками «всё полужирным» и «дописать абзац» — все четыре проверки (круговой путь, .mwxf, побайтная повторяемость, полная отмена) прошли 40 из 40; браузер 1440 и 375 px без прокрутки вбок, консоль без ошибок. Тесты D на Linux x86_64 (rust:1.97.1-alpineна sagr) зелёные;just ciна Mac — зелёный. Запись в/opt/CHANGELOG.md. Дальше — D4meridian-chart(см. «План»), ответы A (C ABI v0.7, hit-test вёрстки) и B (схема, окно Write). - 2026-10-05 — для A (C ABI v0.7, связь вёрстки с
моделью):
meridian_edit::units::locate(inlines, unit)→ (инлайн, байт) и обратнаяunit_of(inlines, inline, byte); единица —char, не графема; граница относится к следующему инлайну, у объекта байт 0 — перед ним, иначе — после. Тестunits_map_to_inline_bytes_and_back. A приняла v0.7 (после балансировки колонок): вёрстка помнит абзац модели и карту «байт строки → инлайн»,meridian-ffiпереводит вParaPathи единицы. Передан список 23 docx, которые не открываетread_docx(6 — шифрование MS-OFFCRYPTO, 14 — битые/обрезанные ZIP из фаззинга,deep-table-cell— предел XML,stress025— главная часть — менеджер темы). - 2026-10-05 — Проверка схемой (с B): B внесла
расширения в
write.rnc(main ffa15dd, ключи — вspec/formats/write-x-attrs.md) и добавилаjust check-schema(jing; файлы изMWX_SCHEMA_DIR). Тестschema_samples_for_ci(и тест корпуса) при заданнойMWX_SCHEMA_DIRкладут туда.mwxfиcontent.xml. jing на 382 docx корпуса нашёл и D исправила в кодеке: язык не по RFC 3066 (es-ES_tradnl) — вm:x-attrs; идентификатор стиля внеlocalId(кириллица, пробелы, длиннее 64 —Char1CharChar…) — обратимоu-<hex UTF-8>илиh-<SHA-256>+id-raw; пустые рамки стиля таблицы — меткойborders=1наtb:tpr. Осталось в схеме (запрос B):m:fontsбезmajor/minor,tb:rowбез ячеек иtb:tableбез строк (так бывает в docx),t:list-styleбез уровней. Круговой путь — по-прежнему 382 из 382. - 2026-10-05 — A выпустила C ABI правки v0.9 (main
0c89fad):
MeridianDocдержитmeridian_edit::Editor; ввод, клавиши, курсор (в том числе строка вверх/вниз и Home/End по вёрстке), щелчок 1/2/3, прямоугольники курсора и выделения, «Ж/К/Ч», отмена,meridian_doc_save_mwxи открытие .mwx (с паролем). Связь вёрстки с моделью —PageItem::LineMark+units::unit_of/locate; на корпусе «место → Pos → курсор» сходится в 908 тыс. мест. Договорились оStyle::next: A добавляет поле и чтениеw:next, затем D — записьm:style/@nextв .mwx и Enter «как Word» (в конце абзаца со стилем, у которого естьnext, — новый абзац в стилеnext). - 2026-10-05 — Вывод .mwx полностью соответствует
схеме: B ослабила
write.rnc(main 648a2e9:m:fontsбезmajor/minor,row*,cell*,listLevel*) и включила в CIMWX_SCHEMA_DIR=/data/mwx-schema+just check-schema. D проверила jing (образ раннера на sagr): пример spec, образцы теста и 752 файла вывода по 382 docx корпуса — 0 ошибок; круговой путь — 382 из 382. - 2026-10-05 — Стиль следующего абзаца: A добавила
Style::next(чтениеw:next, main 05d2006); D — запись и чтениеm:style/@nextв .mwx и Enter «как Word» вEditor::split_paragraph: в конце абзаца, у стиля которого естьnext, новый абзац — в стилеnextбез прямого оформления абзаца (знак ¶ сохраняет своё); в середине — обе части в прежнем стиле. Тестenter_after_a_heading_switches_to_the_next_style; «документ со всем» несётnext. Корпус (с восстановлением битых ZIP у A): круговой путь .mwx — 393 из 393 открытых docx, правки с полной отменой — 393 из 405. - 2026-10-05 — D4а: места курсора после правок
(функция A
meridian_ffi::edit::check_caret_stops, main 6e02f44; dev-зависимостьmeridian-edit→meridian-ffi). В тестах случайных правок документ после серии команд перевёрстывается, каждое место курсора первых 3 страниц переводится в позицию модели и обратно: синтетика (10 зёрен) и docx из репозитория (3 зерна) — в CI; внешний корпус — 68 777 мест на 393 docx после правок, без позиции 0, в другом месте 0. Проверка также требует, чтобы у документа с текстом места нашлись. - 2026-10-05 — Для ленты A (C ABI v0.10):
Editor::map_char_props(f)— изменить свойства знаков выделения функцией (снять одно свойство, «кегль по стилю», увеличить кегль; без выделения — для следующего набора; один шаг отмены) иclear_char_color()— «Цвет: авто». Тестclearing_one_character_property. - 2026-10-05 — Стенд: сохранение в docx (запись docx
своим кодом — A, main 05d7650): проверка «docx записать → прочитать —
документ тот же» (в канонической форме: docx сливает одинаковые соседние
прогоны) и кнопка «Скачать .docx». Прогон всего корпуса через API стенда
нашёл расхождение «полная отмена ≠ исходный» на 3 docx без
правок:
Editor::new, как Word, добавляет абзац для курсора в пустой раздел (последний абзац несётw:sectPr) и в раздел из таблицы без строк. Теперь это явно:Editor::open_fixups(); стенд сверяет отмену с документом после открытия и показывает число добавленных абзацев; тестopening_adds_a_caret_paragraph_only_where_word_does. Корпус через API: все пять проверок (круговой путь .mwx, .mwxf, повторяемость, полная отмена, docx) — 393 из 393 открывающихся, 12 не открывает импорт. - 2026-10-05 — D6: неизвестные части docx в .mwx
(поле
Document::parts— A, c743801, влито вместе с этим). Пакет:foreign/ooxml/index.xml(m:foreign source="ooxml"→m:part path type rel-from rel-kind sha256, по путям) и сами частиforeign/ooxml/<путь>как есть; все — в манифесте с SHA-256, порча ловится. Плоский .mwxf: те же пути какm:fileвm:media(расширение спецификации — без него docx → mwxf → docx терял бы части; запрос B). Тестforeign_parts_are_kept_and_checked, «документ со всем» несёт 4 части (свойства, customXml с .rels, шрифт без типа); вывод проходит jing. Дальше A включает чтение/запись частей в docx. - 2026-10-05 — D7: метки полей, ссылок, закладок,
примечаний (модель — A, ветка
phase0/kernel-markers9b22bc2; свойства сложных письменностей и нумерация страниц — A 8fd9ae0). D:units: метка — одна единица нулевой ширины (MARKER),inline_props(_mut)→Option(у меток без свойств —None),props_atпропускает метки,text_ofих не выводит,inline_at;bounds: курсор не останавливается между меткой и знаком (метка прилипает к следующему знаку, в конце абзаца — к предыдущему), для слов метки прозрачны;markers(новый): нет непарных меток (закладки, ссылки по абзацу, поля по вложенности через абзацы, половина диапазона примечания), примечание живёт со значком (удалили значок — уходят диапазон, примечание и ответы, по цепочке), правка в результате поля →dirty; новая операцияOp::SetComment;Editor: удаление выделения чинит метки; Backspace/Delete метки сохраняют; Enter (и вставка с переводами строк, и вставка таблицы) внутри ссылки закрывает её и открывает заново в новом абзаце;codec-mwx: поля — плоскиеt:field-start code locked dirty rAttrs/t:field-sep/t:field-end(вложенныйt:fieldдругих программ читается как те же метки), ссылки — вложенныйt:link(#имя— закладка,target=urlдля адреса с#; непарные —open=1/orphan-end=1), закладки —b<число>, примечания —comments.xml(m:commentплоско сparent, авторыa1…вmeta.xml), значок —t:comment-refв прогоне;rtl,size-cs,bold-cs/italic-cs(мешок),w:page-numbering start format. Проверки: тесты меток (курсор перепрыгивает, Backspace сохраняет закладку, половина пары → пара уходит, поле через абзацы → dirty и снятие с сохранением текста, Enter в ссылке, удаление значка примечания с ответом) и случайные правки на документе со всеми видами меток (60 зёрен × 60 команд, после каждой команды — нет непарных меток, полная отмена точна); «документ со всем» с метками и примечаниями — круговой путь .mwx и .mwxf. Запрошено у B (схема):t:field-start/sep/end,t:comment-ref, необязательная датаm:comment, ключи мешка.
- 2026-10-05 — D7 влито в main (e896fdc — модель A,
b6cb106 — правка и .mwx D): схема B c41e4bd + d031dcf
(
t:field-start/sep/end,t:comment-ref, необязательная дата примечания,m:x-attrsуt:link). jing по образцам и корпусу — 0 ошибок;just ciзелёный; корпус .mwx 393/393 (mwx/docx 0,82 — теперь с частями пакета). Дальше A включает чтение меток из docx; следующим —Inline::Foreign(D8). - 2026-10-05 — D8: объекты, перенесённые как есть
(
Inline::Foreign— A, веткаphase0/kernel-foreign5bcc050). Правка: одна нетекстовая единица (курсор — одним шагом, Delete — целиком, оформление — к объекту). .mwx: обёрткаg:inline(размер атрибутами) илиg:anchor(размер —width/heightвm:x-attrs) сt:rpr, внутриm:x source="ooxml/chart|diagram|object|math|other" part="id=тип=цель;…"(поля экранируются%, внешняя цель —ext:), исходный XML — текстом (побайтно). Проверки: «документ со всем» с диаграммой (своя и внешняя связь с;/=в адресе), плавающим SmartArt и формулой (<,&,\r\nв XML) — .mwx и .mwxf; тест редактораa_foreign_object_is_one_unit; jing — 0 ошибок; корпус .mwx 393/393, правки 393 (61 890 мест курсора — метки нулевой ширины теперь читаются из docx и законно не считаются). - 2026-10-05 — D8 влито в main (6d2f15c — модель A,
a50f75b — D) после того, как в main пришли чтение меток (A f2758ee) и C
ABI ссылок и примечаний (A 8c666d1):
just ciзелёный, jing — 0 ошибок, корпус .mwx 393/393, правки 393 (61 890 мест курсора). Дальше A включает чтение объектов из docx (86544e3). - 2026-10-05 — D8а: строгая проверка объектов через
docx (чтение объектов — A 943760c). «Документ со всем»:
диаграмма
(
w:drawing/wp:inline/a:graphic/a:graphicData/c:chart+word/charts/chart1.xml), SmartArt (dgm:relIdsс четырьмя связями и частями), формула OMML — настоящая разметка; объект вида Other (выдуманные пространства, внешняя связь с;/=, плавающий) — только для .mwx. Тестkitchen_sink_through_docx_is_stableсверяет после docx поэлементно: вид, размер, свойства, связи (типы и части; id docx переназначает), байты частей, текст; затем — .mwx без потерь. Нормализация docx, записанная в тесте: у формулы нет свойств знака (m:oMathвнеw:r). Корпус: 30 документов с объектами, .mwx 393/393 (mwx/docx 0,88), jing — 0 ошибок. - 2026-10-05 — Оформление знаков не применяется к
формулам (найдено прогоном корпуса через стенд: «всё
полужирным» давало расхождение docx на 4 документах с формулами — у
m:oMathв docx нет общегоw:rPr, A подтвердила).units::inline_props(_mut)у формулы →None, как у меток: «Ж» её пропускает и на выделении с формулой не «залипает», набор рядом берёт свойства соседнего знака. Тестcharacter_formatting_skips_equations. Корпус через API стенда с правками: пять проверок — 393 из 393 открывающихся. - 2026-10-05 — Команды ссылок, закладок и примечаний
(просьба A/B для ленты Write: «Ссылка», «Закладка», «Создать
примечание»), модуль
editor/refs.rs, всё — транзакции с отменой:insert_link(target, tooltip)(на выделение — по ссылке в каждом абзаце, задетые ссылки заменяются; без выделения — адрес как ссылка),link_at_caret,edit_link,remove_link(текст остаётся);valid_bookmark_name(как Word: буква, затем буквы/цифры/«_», ≤ 40),insert_bookmark(на выделение или у курсора; имя занято или не годится — ошибка),bookmarks,goto_bookmark(выделяет содержимое),remove_bookmark;add_comment(CommentInput)→ id (диапазон, значок, текст абзацами),reply_comment(метки ответа сразу за метками исходного,parent),set_comment_done,delete_comment(с ответами по цепочке). Виды шагов отмены «гиперссылку», «закладку», «примечание». Тесты на каждую команду и случайные серии (18 видов команд, отказ по делу допускается) — после каждой команды метки парные, отмена точная; корпус — тот же прогон.