Документация исходного кода; установленный выпуск может отличаться.

Матрица завершения стабилизации 3.7.1

Историческая спецификация от 08.10.2026. Она не описывает текущий релизный кандидат. Актуальные сведения о продукте — в руководстве и списке изменений.

English

Срез от 2026-10-08. Документ объединяет текущую реализацию, исходный отзыв тестировщика из 19 пунктов и требования завершения кандидата 3.7.1. Это спецификация стабилизации, не объявление выпуска и не утверждение, что все сценарии работают.

Границы и назначение документов

Текущий запрос — довести существующие функции прежде новых возможностей roadmap. Исходный документ уровня Notion задаёт целевой опыт, но не доказывает соответствие плагина этому опыту. Roadmap от 29 сентября остаётся направлением развития. Цикл стабилизации от 5 октября ставит потерю данных, ввод и производительность перед этим планом. Исходный отзыв задаёт номера проверок ниже.

Закрытый контракт Borshkit release-371 уже полной матрицы: этапы стабилизации 2–4 исключены за пределами явно добавленных C9/C10/C11/C12, остаток шага 6 общих полей остаётся исключённым. Первая волна имеет C7/C8, вторая — C9/C10, третья — C11/C12. Зелёные автоматические проверки не доказывают завершения всех 19 пунктов. Для дополнительных работ нужны явные критерии до заявления об их завершении; ручные критерии не заменяются модельными.

Разные документы отвечают на разные вопросы:

Вопрос Источник решения
Что существующий продукт обязан выполнять надёжно? Исходные пункты тестировщика и эта матрица
Что действительно реализовано? Исходники точной рабочей копии и регрессионные тесты
Что прошло на определённом устройстве? Записанный сценарий, хеш сборки, среда и наблюдаемый результат
Что принято? Лист приёмки Borshkit; ручные критерии решает пользователь
Что появится позднее? Roadmap; он не закрывает дефект стабилизации
Как пользоваться и расширять плагин? Руководство, архитектура, API, участие

Исторические отчёты сохраняются. Новый отчёт заменяет старый результат только для того же сценария на идентифицированной новой сборке. Посторонний зелёный тест, статический анализ пакета, узкое окно ПК и отсутствие жалоб на тему не считаются приёмкой на телефоне.

Точная исходная реализация

Основная копия: 479321bd871b83e8d245b6ac5b9fdfc102f0fb50. Кандидат: borshkit/release-371, 352cc1083288060f9b2aa6b9408c394f3f6d6f45 плюс незакоммиченные исправления исходников. В package и manifest по-прежнему 3.7.0, минимум Obsidian 1.8.7, isDesktopOnly: false. «3.7.1» — название кандидата, не версия уже установленного выпуска.

Текущие незакоммиченные исправления охватывают контекстное чтение британских/американских дат, сохранение исходной записи даты при чтении → редактировании таблицы → записи → повторном чтении и несогласованность отсутствующего режима/пользовательских списков агенды. Для них есть точечные регрессионные тесты. Это не закрывает все дефекты ввода БД, жестов календаря и интерфейса агенды.

Изолированная сборка от 8 октября: SHA-256 main.js — 954955dfd15bfbe11b75052e66b7ec96f37fe381001e191113d27e3cc8d0643b, styles.css — d247bf40b210e42b2a41c363a3d5efdab617798af016ec178e464e1fea3b7dd7. Она загрузилась в отдельном тестовом хранилище настольного Obsidian 1.13.7. Это подтверждает только загрузку. Среда отклонила запуск экземпляра с CDP для подключения Playwright; в этом срезе нет прошедших сценариев интерфейса Playwright или настоящего телефона.

Матрица завершения

Первая волна реализации (после исходной проверки только загрузки выше) добавляет кооперативный поиск таблицы, отмену и очистку при закрытии, защиту от неверного числа/неполной даты, защиту IME, ограниченное окно отрисовки после сокращения данных и нажатие/клавиатурную доступность имени записи. tableSearchResponsiveness.test.ts на 5000 записях проверяет уступание очереди, замену/очистку запроса, замену данных, закрытие и пустой результат. Остальные регрессии покрывают editableCell.test.ts, tableWindowing.test.ts и tableNameNavigation.test.ts. Это реализованные и проверенные кодом улучшения, не приёмка на устройствах. В закрытый контракт добавлены автоматический C7 и ручной C8 без принятия или удаления C3–C6. Прежний хеш сборки относится к прежней проверке загрузки, не к этим новым исходникам.

Продолжение первой волны: listEditRoundTrip.test.ts использует установленный настоящий YAML-парсер, не упрощённую общую заглушку, чтобы воспроизвести запись строки вместо массива при выходе без изменений и сбой отрисовки повторяющихся элементов. Текстовые списки теперь используют ListCellEditor с общими TextField/FloatingPopup, независимым черновиком, явными «Применить»/«Отмена», добавлением/удалением и фокусом на новом элементе. Пунктуация, повторения/пустые элементы, другие свойства и тело заметки сохраняются при повторном чтении; нетекстовые значения не приводятся к строкам. Неподдерживаемые массивы в скалярных колонках защищены, а не объявлены редактируемыми. Escape в IME больше не закрывает общий попап в ходе составного ввода. Вынос скалярного редактора, предиката поиска и операций таблицы возвращает компоненты в лимиты размера; существующие лимиты снижаются до измеренного размера, а не повышаются. Это не миграция шага 6 и не приёмка всех попапов/сценариев клавиатуры.

Приоритет — предложение для сортировки: P0 — целостность данных/краш/блокировка ввода, P1 — отказ основного сценария, P2 — понятность/адаптация. Каждый пункт остаётся открытым до приложения наблюдаемого результата приёмки. «Частично» означает наличие реализации или теста, не полное устранение исходной жалобы. Пути относительно src/ обозначают границу проверки, а не доказательство успеха.

ID Приоритет и исходный дефект Текущее доказательство / граница проверки Обязательная приёмка
01 P0: поля БД не редактируются; даты сбрасываются/меняют формат Частично: lib/helpers/dateShape.ts, ui/views/Dashboard/widgets/DatabaseCall/editedCellValue.ts; dateEditRoundTrip.test.ts проверяет сохранение Текст, число, флаг, выбор и все поддерживаемые записи дат: Enter/потеря фокуса/Escape, повторное открытие и перезагрузка. Меняются только нужные поля; текст заметки, длительность/время/формат сохраняются. Существующие настройки формата должны быть находимы. ПК + телефон.
02 P1: тач-дроп дашборда уезжает; компоновка/навигация негибки Частичная работа над порядком; ui/views/Dashboard/WidgetGrid.svelte Смещение захвата, скролл во время переноса, отмена и сброс у краёв. Компактный предварительный показ положения и согласованные размеры/навигация должны отвечать жалобе. ПК + телефон.
03 P0: таблицы зависают/крашат/нагревают телефон Виртуализация не доказывает работу устройства; ui/views/Dashboard/widgets/DatabaseCall/DataTableContent.svelte На указанном телефоне: записанные малый/большой наборы и число плиток; число отрисованных строк, задержка действий, долгие задачи и память при повторном открытии/скролле. Нет краша или блокировки навигации. Нагрев фиксируется наблюдением устройства, не выводится из таймингов браузера.
04 P1: таблица не совпадает с размером плитки Не подтверждено; таблица и оболочка виджета Узкая/широкая плитка и окно, длинный текст и горизонтальный скролл: содержимое остаётся внутри своей плитки, элементы управления достижимы. ПК + телефон.
05 P0: поиск БД блокирует телефон Не закрыто; поиск в ui/views/Dashboard/widgets/DatabaseCall/tableCanon.ts Ввод, замена и очистка запроса при скролле большого набора. Отмена и планирование поиска сохраняют отзывчивую навигацию; замеры до/после на телефоне.
06 P1: блокировка плитки бессмысленна Не закрыто; ui/views/Dashboard/widgets/WidgetHost.svelte, граница переноса сетки Определить, что блокировка запрещает в существующей модели дашборда, и проверить каждый путь, включая перенос. Не сохранять элемент без наблюдаемого эффекта.
07 P1: пользователь не может построить график Настройки есть, успешный сценарий тестировщика отсутствует; ui/views/Dashboard/widgets/Chart/ChartConfig.svelte На новом наборе построить осмысленный график только интерфейсом; проверить источник, оси, агрегацию, пустое/ошибочное состояние без помощи разработчика.
08 P2: создание виджета спрятано за нелепыми кнопками Не закрыто; ui/views/Dashboard/DashboardToolbar.svelte Один понятный путь создания; лишний шаг «Виджеты → создать» без назначения отсутствует. Названия, фокус и клавиатура проверены.
09 P2: смысл суммарной статистики неясен Числовая агрегация не является графиком; ui/views/Dashboard/dashboardWidgets.ts Ясно отличить числовую сводку от диаграммы; на конкретных данных объяснимы агрегация, поле и пустое состояние.
10 P1: новые виджеты исчезают внизу экрана Добавление в конец; тот же модуль создания После создания новая плитка видна и нужный элемент получает фокус либо есть понятная настройка размещения. Порядок сохраняется после перезагрузки.
11 P1: перекрытие событий месяца/двух недель Не закрыто на телефоне; ui/views/Calendar/CalendarView.svelte Несколько записей одного дня в обоих масштабах читаемы и достижимы; обработка переполнения не скрывает доступ к событиям.
12 P1: скролл вызывает попап дня; масштаб малого окна неверен Не подтверждено; календарь и обработчики жестов Скролл не открывает попап, намеренный тап открывает. В малом окне и на телефоне проверены размер попапа и фокус.
13 P0: фильтр агенды не принимает текст Одних тестов недостаточно; ui/views/Calendar/components/Timeline/AgendaSidebar.svelte Фокус и ввод физической/экранной клавиатурой; значение и подсказки обновляются; фильтр сохраняется согласно правилам. Поле остаётся над клавиатурой. ПК + телефон.
14 P1: вместо созданного списка появляются старые пресеты Частичное исправление отсутствующего режима; agendaListPersistence.test.ts Ожидаемое состояние при новом запуске. Создать, переименовать, изменить, удалить и перезагрузить свой список; он не подменяется посторонними пресетами. ПК + телефон.
15 P0: разные всплывающие окна прыгают/скрываются клавиатурой Частичная миграция общих полей; остаток исключён старым контрактом Опись каждого редактора/попапа; согласованный фокус, закрытие, скролл и обход клавиатуры. Нативные диалоги допустимы, если намеренны, описаны и пригодны. Поле не уходит из доступной области.
16 P0: ресайз становится переносом; длительность падает до часа Частичные исправления/тесты; ui/views/Calendar/calendar.ts, processor.ts Верхний/нижний ресайз, перенос, отмена, дубликат и перезагрузка в дне/неделе; многочасовая длительность и текст сохраняются на границах дат/часовых поясов. ПК + настоящее сенсорное устройство.
17 P0: краши Kanban; обложки/пути изображений не работают Частичная работа с миниатюрами/переносом; ui/views/Board/ Повторный перенос больших досок указанного размера, отмена, выбор/ресайз обложки и корректные/ошибочные локальные пути. Нет краша, слипания текста, потери данных. ПК + телефон.
18 P2: явных жалоб на темы нет Это не успешная проверка тем Повторить основные сценарии ввода, попапов и переноса в светлой/тёмной теме; контраст и фокус видимы.
19 P1: мобильная сетка/карточки галереи неполноценны Частичная адаптивная сетка; ui/views/Gallery/ На ширине телефона выбрать раскладку/размер карточки, редактировать/открывать её и применять заявленные поля/действия без обрезки и недоступных элементов.

Порядок исполнения и остановки

Вторая волна: проверяемые кодом исправления

В C9/C10 добавлены пункты 06/08/09/10 и ограниченная часть 15. dashboardReorder фиксирует индексы заблокированных плиток в вертикальном стеке даже при переносе соседей и отклоняет некорректный набор ID. У заблокированной плитки нет ручки переноса; содержимое, удаление и сворачивание не блокируются. Меню создания открывается непосредственно; dashboardReveal фокусирует/показывает только последнее новое создание в своём корне после отрисовки, без переупорядочивания и повторного фокуса при эхо конфигурации. Редактор имени защищает IME, отмену и однократное подтверждение.

statsDefaults согласует первичную настройку и показ карточек; явный пустой список больше не заменяется итого/суммой/средним. Число колонок применяется с адаптацией узкой плитки, подсказка отличает сводку от графика. statsSparkline заменяет переполнение стека на 200000 значений ограниченным SVG до 200 точек с крайними значениями интервалов; числовой итог использует все значения. Мастер неготового виджета и обработчик настройки не предлагают запись в readonly.

Общие FloatingPopup/ComboField учитывают visualViewport своего окна и очищают обработчики; мобильный слой ограничивается видимой областью и раскрывает сфокусированный элемент, десктопный попап ограничивает размер/скролл. Escape сначала отдаётся вложенному полю, затем верхнему попапу; нажатие в верхнем окне не закрывает нижнее. popupKeyboard, dashboardFeedback, dashboardLayoutFeedback, statsFeedback, statsSparkline, widgetSetupFeedback и WidgetShell проверяют эти механизмы. Бюджеты новых модулей измерены, старые не повышены.

Это уточнение кодовых доказательств к строкам 06/08/09/10/15 выше, не закрытие ручной приёмки. Все 19 исходных пунктов остаются в матрице. Хеш старой загрузки не относится к этой волне; новый идентифицированный артефакт и итог проверок записываются в отдельном закрытом отчёте Borshkit. Обновлены парные руководства RU/EN; установка, версия, merge/push/релиз не выполняются.

  1. Закрыть блокировки данных/ввода/краши: 01, 03, 05, 13, 15, 16, 17. Для каждой правки сначала падающая регрессия; текст заметки и посторонние свойства сохраняются.
  2. Унифицировать общий ввод, всплывающие окна и жизненный цикл указателя/тача. Проверить обход клавиатуры и ложный клик после скролла; исправление одного поля не доказывает работу всего слоя.
  3. Стабилизировать размещение, границы, блокировку и фокус дашборда: 02, 04, 06, 10. Наблюдаемое поведение задаётся до добавления органов управления.
  4. Проверить объяснимость графиков/статистики/создания и адаптацию календаря/галереи: 07–09, 11–12, 18–19; выполнить приёмку на настоящих устройствах.

Новая функция roadmap не компенсирует неработающий существующий сценарий. Делить исправления на ограниченные задачи можно; вычёркивать пункт тестировщика из матрицы нельзя. Падающая проверка блокирует выпуск. Ненаблюдавшийся ручной результат остаётся непроверенным, не PASS. Бюджеты качества не увеличиваются ради сокрытия регрессии.

Третья волна: график и операторы агенды

Дополнение от 2026-10-09, C11/C12: частичный срез пунктов 07/13/15. chartAggregations ограничивает операции типом поля через общий канон агрегаций. Несовместимая сохранённая операция остаётся видимой с предупреждением и не переписывается при открытии. Явная смена поля сохраняет совместимую операцию либо выбирает «Количество всех»; пояснение отличает подсчёт записей, включая пустые значения, от суммы. Scatter не показывает неиспользуемую агрегацию. ChartWidget снимает подписку выбора при уничтожении.

chartFeedback.test.ts соединяет настоящие ChartConfig и ChartWidget: три записи A/10, A/30, B/20 дают столбцы 40/20, затем линейный SVG. Само построение этого SVG работало и до третьей волны; подтверждённые RED-регрессии касаются несовместимых операций, смены поля и утечки подписок. Это не доказывает понятность всех типов графиков для пользователя.

FilterRow заменяет отдельный императивный попап операторов на FloatingPopup/PopoverList, сохраняет правила очистки значения для операторов без ввода и возвращает фокус настоящей кнопке поля. Тесты проверяют стрелки, выбор кнопкой, Escape/IME, отсутствие записи при отмене и портал в документ якоря. Модель iframe не является проверкой настоящего окна Obsidian; вызов экранной клавиатуры и реальный тач остаются ручной C12. Старый полный сбор подсказок по записям/хранилищу и оставшаяся миграция полей не объявляются исправленными. Все 19 исходных пунктов остаются в матрице; новый срез требует собственного идентифицированного артефакта и свежих проверок.

Продолжение третьей волны: дополнительные серии и редактор агенды

Дополнение от 2026-10-09: ChartSeriesEditor использует тот же канон агрегаций, что и основная ось, с метаданными своего источника. Текстовое первое поле больше не получает sum по умолчанию. Несовместимая сохранённая операция и отсутствующее поле остаются видимыми; открытие и поздняя загрузка источника не пишут настройки. Явная смена поля или уже загруженного источника согласует операцию. Для неизвестного поля/типа доступны подсчёты, а не неподтверждённые числовые операции. Перед исправлением восемь сценариев chartSeriesEditor.test.ts падали по ожидаемым причинам; дополнительная регрессия воспроизвела исчезновение имени отсутствующего поля. Новая пустая серия использует канонический «Количество всех». Это не решает историческую неоднозначность поля с буквальным именем count и специального подсчёта: она остаётся отдельным ограничением формата конфигурации.

fitAgendaOverlay ограничивает реальный редактор списка одновременно календарным контейнером и видимым viewport его собственного окна. Уже открытая клавиатура учитывается при появлении окна; resize/scroll viewport и изменение контейнера пересчитывают границы, закрытие снимает обработчики. Удалена вторая компенсация клавиатуры через большое нижнее поле внутри уже уменьшенного редактора. agendaOverlayViewport.test.ts монтирует настоящий AgendaSidebar, открывает редактор и проверяет границы/очистку, пересечение с контейнером, отдельный документ, отсутствие двойного отступа и прокрутку к полю. Три RED-регрессии подтвердили геометрию; отдельная RED-регрессия подтвердила лишний нижний отступ. Это модели DOM и viewport, не приёмка настоящей клавиатуры. Дополнительные шаги включены в C10/C12, точечные проверки — в C9/C11; семь ручных критериев не приняты.

Новый модуль и редактор серий включены в ratchet по измеренным размерам; прежние бюджеты не повышены. Сборка этого продолжения требует новых хешей: прежние артефакты не содержат этих изменений. Все 19 пунктов матрицы сохраняются; этот срез не закрывает мобильные краши, раскладку месяца/двух недель, обложки канбана, галерею или остаток миграции общих полей.

Настройки разработчика и протокол проверки

CI использует Node 22; локальный Borshkit — Node 24.21.0. Версия фиксируется для каждого прогона. Уже подключён obsidianmd.configs.recommended с типизированным ESLint. Предпочтение нового API определения настроек явно отключено ради минимума 1.8.7; при уборке нельзя включать несовместимый API или поднимать минимум без отдельного решения о совместимости.

Обязательны TypeScript, Svelte с --fail-on-warnings, ESLint с --max-warnings 0, весь Jest и изолированная production-сборка. Документы дополнительно проверяются R0_25_documentationPairs и R0_26_documentationLinks. Точные нативные проверки Borshkit и доказательства находятся в закрытой задаче; см. правила участия. После последней правки файлов проверки обновляются.

Для живого прогона записать копию/диф, хеши сборки, версии Obsidian/плагина/ОС, окно или устройство, размер набора, действия, изменение сохранённого файла, ошибки консоли и пути снимков/трассировки. Использовать отдельное синтетическое хранилище, не личные данные. До автоматизации проверить имя хранилища; если стенд меняет реестр хранилищ, сохранить и восстановить его.

Использовать GitHub-скилы Microsoft Playwright CLI и Obsidian CLI, закреплённые здесь для воспроизводимости. В этом срезе изучены @playwright/cli 0.1.22 и настоящая справка Obsidian CLI. Доказательства строятся по наблюдаемым элементам/DOM, не вымышленным селекторам. Справка установленной CLI важнее примера из более нового скила.

Команды Obsidian CLI всегда явно адресуют тестовое хранилище:

obsidian vault=<synthetic-vault-name> help
obsidian vault=<synthetic-vault-name> plugin:reload id=obs-projects-plus
obsidian vault=<synthetic-vault-name> dev:errors
obsidian vault=<synthetic-vault-name> dev:console level=error

Playwright подключается только к принадлежащему тесту настольному экземпляру с CDP. Electron документирует флаг удалённой отладки. Не открывать его для личного хранилища или во внешнюю сеть. Отключать только именованную тестовую сессию; не применять глобальную остановку браузеров. Узкое настольное окно не считается мобильной приёмкой. Глобальная мобильная эмуляция Obsidian в этом пространстве запрещена.

Применяются официальные правила плагинов Obsidian: рабочий код использует app плагина, атомарную запись frontmatter, нормализованные пути и очистку ресурсов; зависимости Node/Electron требуют мобильно-безопасных границ. Тема и принадлежность документа должны выдерживать отдельные окна. Существующие правила Obsidian ESLint помогают проверке, но не доказывают удобные жесты и приемлемую производительность.

Завершение выпуска

Нужны успешные применимые сценарии всей матрицы на идентифицированной сборке, зелёная автоматика, парная документация реального поведения и ручная приёмка пользователя. Ошибки и исключения публикуются явно; процент готовности по одним зелёным тестам недопустим. Диагностика исполнения и личные настройки не попадают в Git. Документ не разрешает смену версии, merge, push или выпуск.

Исходник страницы ↗