版本与功能范围

稳定版

当前手册以 2.2.1 为稳定基线。这个版本在既有存储、迁移和流量校准能力上，重点包含：

• 可视化仪表盘配置、预制布局、模块排序、卡片宽度和 Top 5/10/15/20 排行。
• 近 15 分钟丢包、平均时延、延迟抖动、资源和计费流量等排行模块。
• 实时概览与历史图表独立刷新周期、短时结果缓存和返回页面后的无闪烁恢复。
• 系统 Web UI 与公共大屏主题解耦，主题只影响公开页面，并至少保留一个可用主题。
• 当前主题声明的服务器详情、网络总览和 Ping 任务跳转能力，以及旧主题安全回退。
• 仪表盘和公开接口的批量历史查询、历史指标清理安全修复及低资源主控适配。
• 新节点首次编辑时默认使用双向流量总和，已保存节点配置保持不变。
• 远程终端整卡入口、服务器删除确认和内置 HTTPS 生命周期修复。

具体构建标识以“关于”页面和 Release 中的七位构建码为准。同一个版本号可能有同版本更新，排查问题时只提供 2.2.1 不够，还应同时提供七位构建码。

快照版

截至 2.2.1 Release 已列出的功能均已纳入稳定版。后续 Snapshot 仍用于公开测试尚未转正的新功能，具体差异会在对应 Release 和文档页面中明确标注。

不要把 Snapshot 当成自动升级通道

生产环境升级前应阅读对应 Release，备份完整 data 目录，并确认快照是否包含数据库迁移。快照文档会明确标注与稳定版的差异。

与上游的关系

本分支基于 komari-monitor/komari 持续开发，但数据库结构、后台界面、Agent 更新源和部分公共接口兼容逻辑已经不同。

本手册统一使用以下口径：

• “与上游一致”表示当前 Lite 已按实际实现核对，所述行为可直接按同一方式使用。

• “上游兼容”只表示文中明确列出的版本、数据或接口可以迁移或调用，不代表镜像、数据库和后台实现完全相同。

• “官方 Agent”表示上游官方 Agent 的行为；当前 nuomiiiii/komari-agent 与其协议和默认行为一致，并已与 Lite 服务端核对。

• “本项目官方脚本”表示 nuomiiiii/komari 仓库发布的安装脚本，不是上游仓库的脚本。

• Lite 与上游确有差异时，页面会直接标注差异和适用版本，不要求读者自行判断。

• 不要混用两个项目的 Docker 镜像地址。

• 从上游切换到本分支前必须备份。

• 本分支会尽量兼容上游数据迁移；是否支持应以目标版本 Release 为准。

• 第三方主题应使用公共接口，不应直接依赖内部数据库结构。