目录

llama.cpp及其张量库ggml于2026年11月13日发布了1.0.0版本,并确立了明确规则:对公共API或ABI进行不兼容变更时,将更新主版本号。本次发布还会移除已弃用的函数,因此,集成了任一库的开发者都需要在升级前检查现有调用。

要点#

  • libllama和libggml均开始通过主版本号、次版本号和补丁版本号,表明更新对兼容性的影响。
  • 1.0.0版本除移除llama.h中35个已弃用的函数外,还会移除llama_set_warmup等函数。
  • llama-server新增用于语音合成的/v1/audio/speech端点,Web UI则新增具名聊天分组和支持输入预览的Markdown编辑器。
  • 版本管理策略有助于评估升级风险,但应用仍需在实际使用的模型和硬件上进行测试。

版本号的含义#

1.0.0中最有用的变化,是面向依赖libllama或libggml的应用制定了兼容性策略。维护者可以通过版本号判断更新是否会改变公开的集成接口规范。

公布的规则采用major.minor.patch格式。

| 版本类别 | 表示的变更 | |---|---| | 主版本 | 破坏公共API或ABI兼容性的变更 | | 次版本 | 向后兼容的功能或API新增、后端更新、模型支持 | | 补丁版本 | 不改变API的错误修复 |

这为评估依赖更新提供了明确的起点。主版本更新需要检查迁移所需的工作。次版本和补丁版本更新所声明的变更范围较小,但仍需验证其对具体应用的影响。

为什么API和ABI都很重要#

API定义了应用代码调用库的方式。函数被移除后,可能需要修改代码才能重新编译。ABI定义了已编译二进制文件层面的兼容性。破坏性变更可能导致链接该库的软件需要重新构建。

对于分发包含这些库的应用的团队而言,这一区别很重要。确认源代码能够成功编译,与确认打包后的应用能够使用预期的库构建版本加载并运行,是两回事。

公布的策略适用于libllama和libggml的公共API和ABI。不应将其视为一项全面保证,认为同一主版本内的llama-server、其Web UI以及模型运行的所有方面都不会发生变化。

升级前需要检查的事项#

1.0.0版本包含API清理。公共头文件llama.h中35个已弃用的函数被移除,公告还将llama_set_warmup列为移除对象。仍在调用已移除函数的应用需要进行迁移。

采用此版本前,请检查以下4点。

1. 在应用和绑定代码中搜索对已弃用的llama.h函数的调用,包括llama_set_warmup。 2. 将这些调用与1.0.0的头文件和发布文档对照,确定受支持的替代方案。 3. 根据计划使用的libllama和libggml版本,重新构建应用和绑定。 4. 在实际运行所用的模型和硬件上执行有代表性的推理工作负载。

所提供的公告没有列出已移除函数的完整替代对照表。修改调用前请查阅发布文档,不要假定名称相似的函数行为也相同。

服务器和Web UI的新增功能#

对于llama-server用户,主要新增功能是用于语音合成的/v1/audio/speech端点。如果应用需要语音输出,可以具体评估这一功能。不过,仅凭端点的存在,无法判断哪些模型、请求选项和部署配置能够满足需求。

Web UI新增了两项辅助功能:用于整理聊天的具名分组,以及可以预览聊天输入内容的Markdown编辑器。这些变化能直接帮助使用自带界面的用户。

请分别检查库迁移和服务器功能评估。集成库的应用成功重新构建,并不代表语音合成集成已通过验证,也不代表更新后的界面适合现有工作流程。

仍需验证的事项#

开发团队表示,正借助Hugging Face的服务和硬件厂商的支持,扩大覆盖主要硬件平台的自动化测试。这项投入有助于维护支持广泛硬件的项目,但无法保证所有使用环境配置下的结果。

公告没有表明1.0.0在速度或内存占用方面有普遍改善。应将兼容性影响更加明确视为本次发布在运维方面的主要优势;如果性能会影响升级决策,请另行测量。

下一步#

更新依赖前,请将应用调用与llama.cpp 1.0.0的公共头文件进行对照,并记录所有需要替换的已移除函数。

来源: https://gihyo.jp/article/2026/11/llama.cpp-v1.0.0

目录