2 ноября 2026
Анонс Rspress 2.1.0

Rspress 2.1.0 уже доступен. Этот выпуск включает:
- SSG-MD включён по умолчанию: генерация
llms.txtи Markdown-версий страниц без дополнительной настройки. - Новые WebMCP-инструменты: браузерные Агенты могут напрямую запрашивать, читать и перемещаться по документации.
- Обновлённые стили панели поиска: улучшены десктопные и мобильные раскладки, результаты поиска и пустые состояния.
- Встроенная карта сайта, чистые URL и проверка якорей включены по умолчанию.
- Переход на режим данных React Router с восстановлением прокрутки и новым экраном ошибки загрузки страницы.
SSG-MD включён по умолчанию
SSG-MD рендерит MDX и React-компоненты в Markdown, чтобы Агенты могли их читать.
Сайт Rspress получил 100/100 в оценке AFDocs. Начиная с Rspress 2.1.0, SSG-MD включён по умолчанию, поэтому больше не нужно явно задавать llms: true.
Продакшен-сборки генерируют эти файлы вместе со страницами HTML:
В статье Как создать сайт, удобный для агентов мы объясняем, как объединить SSG-MD, llms.txt и согласование содержимого Markdown, чтобы помочь Агентам обнаруживать и читать документацию.
Встроенные WebMCP-инструменты
WebMCP позволяет сайтам предоставлять инструменты браузерным Агентам. Rspress 2.1.0 включает эти шесть инструментов документации по умолчанию:
Новый хук useWebMcp также позволяет компонентам регистрировать собственные инструменты:
Инструменты регистрируются при монтировании компонента и удаляются при его размонтировании. Инструменты для всего сайта регистрируйте в layout-компонентах, а инструменты для отдельных страниц — на соответствующих страницах.
WebMCP по-прежнему является экспериментальным API браузера. Для него требуется включённый document.modelContext и доступ по HTTPS или с localhost. Другие браузеры по-прежнему могут читать сайт как обычно.
Установите webMcp: false, чтобы отключить встроенные инструменты. Это не влияет на собственные инструменты, зарегистрированные через useWebMcp.
Обновление стилей панели поиска
Стили локальной панели поиска в стандартной теме обновлены:
- Более широкая панель на десктопе, без рамки поля ввода и теней у отдельных результатов.
- Боковые отступы на мобильных устройствах, скорректированные размеры поля ввода и кнопки отмены, а также прокрутка результатов внутри панели.
- Перенос длинного текста и выровненные отступы в пустом состоянии.

Подробнее см. в разделе Полнотекстовый поиск и в PR #3683.
Встроенная карта сайта
Rspress 2.1.0 генерирует sitemap.xml по умолчанию при продакшен-сборке. Устанавливать @rspress/plugin-sitemap больше не нужно.
Задайте адрес развёртывания через siteOrigin и подкаталог через base, чтобы генерировать абсолютные URL:
Используйте опцию верхнего уровня sitemap, чтобы настроить приоритеты, частоту обновления и отдельные записи страниц. Существующие проекты могут использовать её вместо @rspress/plugin-sitemap.
Карта сайта генерируется даже при ssg: false. Установите sitemap: false, если карту генерирует другой процесс.
Чистые URL по умолчанию
route.cleanUrls теперь по умолчанию имеет значение true вместо false. Сгенерированные ссылки на обычные страницы не содержат .html, например /guide/getting-started.html превращается в /guide/getting-started.
Ваша платформа для развёртывания должна отдавать /foo.html напрямую, когда запрошен /foo. Установите route.cleanUrls: false, если хостинг не поддерживает такое поведение или вам нужно сохранить суффикс .html.
Проверка внутренних якорей по умолчанию
markdown.link.checkAnchors теперь по умолчанию имеет значение true вместо false. Rspress проверяет существование связанных разделов, находя устаревшие ссылки вроде /guide/config#old-heading после переименования заголовка.
Проверка охватывает внутренние ссылки на текущую страницу, а также относительные и абсолютные ссылки на Markdown- и MDX-страницы, а внешние URL пропускает. Используйте markdown.link.checkAnchors.excludes для якорей, которые нельзя определить статически, например динамически создаваемых, или установите checkAnchors: false, чтобы отключить проверку.
Режим данных React Router
Теперь Rspress использует режим данных React Router. Ссылки стандартной темы и вызовы useNavigate() загружают данные и код страницы назначения до смены URL и содержимого страницы. Во время загрузки текущая страница остаётся видимой.
В React Router 7 функции навигации, возвращаемые useNavigate() и useLinkNavigate(), поддерживают await, чтобы дождаться завершения перехода.
Новая страница ошибок ErrorLayout предлагает действия перезагрузки и возвращения на главную, если не удалось загрузить или отрендерить страницу. В режиме разработки она также показывает детали ошибки. Кастомные темы могут заменить ErrorLayout.
Восстановление прокрутки
Rspress восстанавливает позицию прокрутки, когда читатель возвращается назад, переходит вперёд или перезагружает страницу. Например, прочитав часть длинной страницы, перейдя на другую и вернувшись назад, читатель может продолжить с того же места. React Router также обрабатывает навигацию по якорям.
Чек-лист обновления
-
Обновите
@rspress/coreи любые используемые в вашем проекте официальные плагины, например:package.json -
Проверьте совместимость SSG-MD с серверным рендерингом. Оберните зависимый от браузера контент в
BrowserOnly. Установкаssg: falseне отключает SSG-MD. Сайтам, которые не могут поддерживать серверный рендеринг, нужны иssg: false, иllms: false. -
Если вы кастомизировали стили темы
SearchPanel, после обновления визуально проверьте десктопную и мобильную раскладки, чтобы убедиться, что всё выглядит как ожидается. -
Проверьте конфигурацию карты сайта. Замените
@rspress/plugin-sitemapна встроенную опциюsitemapили установитеsitemap: false, если карту генерирует другой процесс. -
Проверьте, что ваш хостинг поддерживает URL без
.html, например отдаёт/foo.htmlнапрямую, когда запрошен/foo. Установитеroute.cleanUrls: false, чтобы сохранить прежний формат ссылок. -
Запустите продакшен-сборку и исправьте некорректные якоря. Исключите динамически создаваемые якоря с помощью
markdown.link.checkAnchors.excludesили установитеcheckAnchors: false, чтобы отключить проверку.
Полный список изменений см. в Release Notes v2.1.0.
Спасибо всем, кто внёс свой вклад в этот выпуск! Делитесь отзывами на GitHub или присоединяйтесь к обсуждению в Discord.

