llama.cpp и ggml 1.0.0 обозначили границы совместимости библиотек

Для кого важна новая схема версий

llama.cpp используют для запуска языковых и мультимодальных моделей на разных аппаратных платформах. Для разработчиков приложений, которые встраивают библиотеку или поддерживают обёртку, значение имеют её публичные интерфейсы. API определяет способ обращения к библиотеке из программы, ABI связан с двоичной совместимостью скомпилированных компонентов.

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

Как команда описывает изменение номера

• Основная версия MAJOR меняется при несовместимом изменении публичного C API в каталоге include. В анонсе отдельно указаны границы API и ABI.
• Дополнительная версия MINOR используется для совместимых возможностей, обновлений вычислительных бэкендов, поддержки моделей и расширений API.
• Исправление PATCH обозначает устранение ошибки без изменения API.

В примечаниях к llama.cpp 1.0.0 перечислено удаление устаревших функций и параметров публичного интерфейса. Также NextN API переносится в основной заголовок, а часть интерфейсов получает новые имена. Поэтому привязку к старому заголовку нельзя считать проверенной только по успешной загрузке файла библиотеки.

Что проверить перед обновлением интеграции

Практический следующий шаг зависит от способа использования. Если приложение напрямую связывается с libllama или libggml, стоит сверить публичные вызовы, заголовки и используемую версию обёртки. Если работа идёт через серверный HTTP-интерфейс, отдельно проверьте используемые маршруты и параметры: совместимость библиотечного C API не заменяет проверку сетевого сценария.

Сохраните исходную версию зависимости и воспроизведите нужные приложению действия в тестовом окружении. Полезны загрузка модели, обычный ответ, потоковая выдача и обработка ошибки, если приложение использует эти режимы. Это рекомендуемый план проверки, а не отчёт о тестировании редакцией.

Разобрать связь заголовков, сборки и библиотечных интерфейсов можно с наставником по C++. Для системного изучения языка и сборки доступны курсы C++.