发布说明

除 GitHub 变更记录之外，每个版本带升级影响说明的整理版。

这页不复述变更列表——完整的逐条改动一直在 GitHub 上，而且比这里更新得快。这页只回答一件事：升到某个版本，我需要动什么。

整理到 v9.1.1（2026-08-18）。比它新的版本请直接看 GitHub。

权威变更记录在哪

你想看的	去哪
每个版本的完整改动	GitHub Releases
两个版本之间的所有提交	每篇发布说明底部的 Full Changelog 链接
数据库表结构的逐版本变更	仓库里的 `docker/migratesql/migrate.sql`，按 `/* vX.Y.Z */` 注释分段
某个改动为什么这么做	发布说明里的 PR 编号，点进去看讨论

夜莺启动后会去 GitHub 查一次最新的 tag，和自己的版本比。开源版的页面顶栏会显示当前版本号；有更新时版本号上带一个红点，鼠标悬上去提示「有新的版本可更新 vX.Y.Z」，点进去就是 GitHub Releases。

「系统配置 → 关于产品」页分别列出前端版本和后端版本。两个版本号应该一致；不一致通常意味着升级时只换了一半，或者浏览器缓存了旧的前端资源（强刷一次浏览器）。

只列需要你动手的东西。 功能改进不在这里，在 GitHub 的发布说明里。

版本	日期	升级前必须处理
v9.1.1	2026-08-18	无。纯修复版本，直接换二进制重启
v9.1.0	2026-08-06	① 判定记录默认开启，告警引擎写本地 `./evallog`，保留 8 天、上限 20 GB——磁盘要留量，或在 `[Alert.EvalLog]` 里关掉；② 内置时序库不会被自动打开，`[EmbeddedTSDB]` 只存在于新版 `etc/config.toml`，沿用旧配置就等于没开；③ `notification_record` 的两个索引在启动后在线创建，大表上要跑一阵
v9.0.0	2026-07-25	① Redis 必须 ≥ 5.0（AI 助手依赖 Redis Streams），Cluster 用户建议 7.0+；② 用 telegraf 的，写入地址要追加 `ignore_host=false`，否则那些机器不再进设备列表；③ 跑了 `n9e-edge` / `n9e-pushgw` 的要同批升级

完整的升级步骤、验证和回退见 v8 升级 v9。

各版本的主要功能（一句话版，细节看 GitHub）：

v9.0.0：Nightingale AI（助手、技能市场、大模型配置）；告警规则「试运行」；屏蔽规则新增「只屏蔽通知」；内置 /mcp 端点；导航、布局和表格全面重做；告警规则 / 屏蔽 / 订阅 / 通知规则表单重构。
v9.1.0：内置时序库；从 Grafana 一键导入数据源；逐轮判定记录；通知媒介可测试、消息模板可预览；工作流支持模拟事件试跑；内置告警规则模板大幅扩充。
v9.1.1：列表页把当前页码记进 URL；日志查看器改用虚拟列表；一批修复。

GitHub 上每篇发布说明结构是固定的，升级前至少读这三段：

Upgrade note ⚠️ / Notes —— 唯一会写「你必须先做什么」的地方，比如 Redis 版本要求、必须手工补的配置段。跳过这段是升级出事的头号原因。
Schema changes —— 说明表结构怎么变。数据库账号有建表权限的话可以略过，夜莺启动时会自己改表；没有权限的要把 migrate.sql 交给 DBA。
What's Changed 里带 fix: 前缀的条目 —— 确认你正在忍受的那个 bug 是不是被修了。

vMAJOR.MINOR.PATCH，另有 -beta.N 的预发布 tag。