Blume 2.0 реорганизует конфигурацию документации в модульные адаптеры, представляет настройки обнаружения агентов и добавляет средства автоматизированного обновления.
Назначение продукта и его официальное позиционирование
Blume 2.0 — это мажорный релиз фреймворка документации, который перестраивает конфигурацию сайта, сохраняя при этом существующий контент Markdown и MDX. Обновление заменяет устаревшие строковые параметры и вложенные конфигурационные блоки типизированными адаптерами, импортируемыми из специализированных подпутей для хостов развертывания, поисковых систем, источников контента, аналитики, справочников API и бэкендов ИИ-ассистентов.
Релиз также модернизирует механизмы обнаружения, организуя машиночитаемые метаданные для ИИ, конфигурации Model Context Protocol и навыки в единое пространство имен agents. Проекты могут автоматизировать миграцию с помощью интерактивной команды обновления CLI, совместимой с автоматизированными агентами написания кода, такими как Codex и Claude Code.
Сценарии, подтверждённые официальными источниками
Команды разработчиков могут обновить существующие репозитории документации, запустив CLI обновления для выявления устаревших настроек, корректировки переопределений компонентов и обновления схем конфигурации.
Организации могут объединять документацию из локальных репозиториев, рабочих пространств Notion, Sanity, GitHub Releases и схем API в единый сайт со статическим или серверным рендерингом.
Описанный в документации процесс, если он доступен
Запустите CLI обновления из корня проекта, чтобы повысить версию пакета и просканировать конфигурационные файлы на наличие необходимых изменений.
Преобразуйте блоки поиска, развертывания, источников контента, справочников API, аналитики и ассистентов в blume.config.ts в импортированные вызовы функций адаптеров.
Перенесите инлайн-функции и внутренние объявления из components.ts в отдельные файлы, импортируя их как дискретные ссылки на компоненты.
Выполните команды CLI doctor и build, чтобы подтвердить, что все параметры конфигурации и привязки компонентов проходят валидацию без ошибок.
Blume 2.0 переводит архитектуру на модульные адаптеры во всех точках функциональной интеграции. Вместо указания строковых провайдеров и блоков учетных данных внутри blume.config.ts разработчики импортируют специализированные функции адаптеров из выделенных подпутей, таких как blume/search, blume/deploy, blume/sources, blume/reference, blume/analytics и blume/ai. Такая архитектура позволяет явно объявлять выходные форматы для конкретных платформ, таких как Vercel, Netlify, Cloudflare и Node.js, исключая неявное определение сервера во время выполнения и устаревшие флаги командной строки для сборки.
Для упрощения перехода Blume 2.0 включает автоматизированный рабочий процесс обновления через CLI. Запуск утилиты upgrade проверяет файлы blume.config.ts, components.ts и скрипты пакета, выводя точные расположения файлов и замены для устаревших конфигураций. Инструмент также может вызывать агентов написания кода, таких как Codex или Claude Code, для интерактивного устранения проблем миграции перед проверкой сайта встроенными средствами диагностики doctor и build.
Проверки на собственных материалах и рабочих процессах
Какие источники и когда были проверены
Ответы на основе карточки продукта с проверенными источниками
Страницы Markdown и MDX не требуют изменений при обновлении, поскольку Blume 2.0 меняет синтаксис конфигурации, а не структуру содержимого страниц.
Поле frontmatter search.boost, которое игнорировалось в Blume 1, теперь активно и напрямую умножает рейтинг релевантности поиска для данной страницы.
Запуск команды обновления с флагом codex или claude открывает интерактивную сессию агента для автоматического применения необходимых исправлений конфигурации.
Все записи компонентов теперь должны представлять собой импортированные компоненты, пути к файлам или конкретные объекты-дескрипторы компонентов; инлайн-функции и внутренние объявления запрещены.
Отдельные блоки справочников заменены единым массивом reference, заполняемым функциями адаптеров для OpenAPI, AsyncAPI, GraphQL и Scalar.
