LocalAI 版本发布全流程指南从 PR 标签、Release Notes 到演示视频与博客文章的发布纪律【免费下载链接】LocalAILocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.项目地址: https://gitcode.com/GitHub_Trending/lo/LocalAI打一个 Git tag 并不等于一次发布完成。对 LocalAI 这样的开源项目来说tag 只是发布工程的起点变更日志、博客文章与演示视频需要与 tag 一起交付因为它们共同决定了外界能否看懂这次发布改了什么、为什么值得关注。本文以 .agents/preparing-a-release.md 为骨架结合仓库中真实的博客示例、站点媒体目录与前端脚本完整拆解 LocalAI 一次版本发布必须包含的交付物、演示视频的录制规范以及从标注 PR 到同天合并博客的推荐工作顺序。读完你可以直接照此流程为 LocalAI 及其周边项目如自建 fork 或独立引擎项目组织一次合格的发布。一、为什么发布不能止步于 tag原文档开宗明义A release is not finished when the tag is pushed. The GitHub release, the blog post and the demo clips ship togethertag 推上去发布并未完成GitHub Release、博客文章和演示剪辑必须一起交付。这一纪律的动机很朴素changelog 说明什么动了what moved博客文章与视频剪辑说明为什么值得关心what make anyone care。二者缺一用户面对一次发布就只剩一屏看不出含义的 commit 列表。这一定义也与仓库 AGENTS.md 的快速参考一节的条目互相印证——Releases ship with a post and clips即一次用户可见的代码变更缺少对应的文档/内容交付同一次没有博客与剪辑的发布一样都被视为不完整。这与 LocalAI 内部的docs-with-code rule用户可见行为变更必须在同一次变更中同步更新 docs/content/ 文档是同一套工程价值观在发布环节的延伸。二、一次发布必须包含的四件交付物原文档给出了严格的四要素清单。任何发布都必须按序备齐这四样才算进入可发布状态。1. 已合并 PR 上的标签Labels on the merged PRsGitHub 的自动 release notes 是从PR 标签生成原始草稿的因此流程铁律是label first, generate second先标标签再生成笔记。标签标错意味着生成的 changelog 分类错误随后只能靠人工逐条改而手工修正的过程最容易出现漏改与笔记与 diff 对不上。标签是发布的数据源头务必在进入生成环节之前把每个已合并 PR 的分类标签补齐、校正。2. 仓库根目录的RELEASE_NOTES_vX.Y.Z.md按文档约定需要生成一份位于仓库根目录、文件名带版本号的发布笔记文件X.Y.Z即本次版本号并且遵循项目一贯的 house style内部风格内容应覆盖改了什么what changed为什么重要why it mattersPR 编号PR numbers让读者能直接跳转查看 diff。该文件是发布流程中生成的一次性工件随发布进入版本历史当前工作树中并不保留常驻副本因此不应把它当作源码来维护而是每次发布按模板生成。3.website/content/blog/下的一篇博客文章每个发布对应一篇博客存放在站点的博客目录 website/content/blog/ 中。文章 front matterYAML 头部需要包含文档列出的字段title、date、author、category: Release、tags、summary并加载extracss: [blog.css]。仓库中已有的发布博客提供了最直接的可对照样例例如 website/content/blog/what-landed-in-localai-4-8.md 的头部--- title: What landed in LocalAI 4.8 date: 2026-08-04 author: Ettore Di Giacinto category: Release tags: [release, vllm.cpp, audio.cpp, 3d, agent, gallery, distributed, performance] summary: A new inference engine, a terminal agent in the CLI, 3D generation, and a web interface 3.48x lighter. 386 pull requests in twenty-two days. extracss: [blog.css] ---博客文章内容的选材原则在文档中写得很清楚Cover the two or three changes that alter what a user does day to day, not the whole changelog, and link the PR numbers.即文章只挑两三个真正改变用户日常操作的变更展开讲而非复述整份 changelog所有叙述均带 PR 编号以便读者回溯 diff。上面这份 4.8 文章的正文正是这一原则的范例它把 386 个合并 PR 收敛为web 界面瘦身 3.48 倍、gallery 单条目多变体、vllm.cpp 新引擎、3D 生成、chat 变成 agent、音频端点整合、VRAM 预算、分布式修复与安全修复等可感知的主题每个主题都给出 PR 号与实测数据。tags字段还承担着博客列表与检索的索引职责website/content/blog/_index.md 对全站博客的描述是Release write-ups, benchmark reports and engineering notes并同样声明数字必须可回溯到 release、commit 或 benchmark 记录。4. 代表性功能的演示视频剪辑Demo clips任何可见的改动——新后端、UI 变更、新端点、实测加速——都要配一段短屏录剪辑。剪辑文件放入站点媒体目录 website/static/media/从博客文章中引用它并在合适的营销页面上复用。仓库里这种一次录制、多处引用的例子很多vllm-race.mp4同时出现在 4.8 博客 与首页的引擎展示区gallery.mp4、nib.mp4也被 website/layouts/index.html 等页面复用。一句话总结这条交付标准的强度A release without a post and without clips is incomplete, in the same way a user-facing code change without a docs update is incomplete.没有博客、没有剪辑的发布和改了用户可见行为却不更新文档的代码变更一样属于工程上未完成。三、演示视频的录制与接入规范剪辑不是随便录一段丢上去原文档给出了六个具体约定涉及编码、内容真实性、公平对照与命名可复用性。编码与格式MP4 / H.264 编码除非功能本身与音频相关否则不带音轨时长保持10 到 30 秒并且可循环播放loopable——短而循环是这类展示在营销站上的基本形态。内容必须真实Record the real thing必须录真的东西——引擎自带的基准测试套件benchmark suite跑出的真实画面或一次真实会话严禁 mockup模拟/摆拍画面。若改动是提速则要在同一台机器、同一输入上录制前后两侧保证对比诚实。仓库媒体目录中的实际文件印证了这一约定vllm-race.mp4、3d-generation.mp4、magpie.mp4、moss.mp4、parakeet-duel.mp4、depth-race.mp4、model-lifecycle.mp4、import-model.mp4等无一是按版本号命名的通用宣传片而全是可指向具体功能/引擎的实录。文件命名按功能命名而非按发布命名Name the file after the feature, not the release (vllm-race.mp4, notv4-8-demo.mp4), so it stays reusable once the release is old.目录中vllm-race.mp4、3d-generation.mp4正是按功能命名的体现——这些功能在后续版本中仍然存在剪辑可以被 4.8、4.9 乃至更后的博客与营销页持续复用而v4-8-0-ui-activity.png、v4-9-0-ui-activity.png这类带版本号的静态截图则天然属于特定发布说明用于展示那一版 UI当时的样貌二者用途不同。站点的播放接入模式营销站点播放剪辑时统一使用video src/media/xxx.mp4 muted loop playsinline preloadnone>所有已合并 PR 的标签已核对与修正且先于release notes 生成label first, generate second仓库根目录已生成RELEASE_NOTES_vX.Y.Z.md含改了什么 / 为什么重要 / PR 编号三段式风格与历史一致website/content/blog/ 下新增一篇发布博客front matter 含title、date、author、category: Release、tags、summary、extracss: [blog.css]博客只挑 23 个改变用户日常操作的变更展开所有论述均带 PR 编号不复述整份 changelog每个可见功能新后端 / UI 变更 / 新端点 / 实测提速有一段短屏录MP4、H.264、无音轨音频功能除外、1030 秒、可循环剪辑为真实录制基准套件或真实会话提速对比在同一台机器同一输入上完成剪辑按功能命名并放入 website/static/media/以muted loop playsinline preloadnone>发布公开与博客文章合并发生在同一天React UI 相关截图已由creating-localai-releases技能采集并嵌入笔记若有 UI 改动。按此清单推进一次 LocalAI 发布就能同时满足可读changelog 准确、可感有博客解释为什么值得关心、可视有真实演示三个维度——这既是原文档对发布完成度的定义也是开源项目让每个版本都被真正看见的关键工程细节。【免费下载链接】LocalAILocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.项目地址: https://gitcode.com/GitHub_Trending/lo/LocalAI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考