版本与功能范围

当前文档基线

手册按这些组件的当前实际行为编写。具体构建标识以 Lite“关于”页面和 GitHub Release 中的七位构建码为准；排查问题时应同时提供版本号和构建码。

尚未发布的 Snapshot 功能不会提前写入稳定版使用说明。使用快照版时，应以对应 Release 的测试说明为补充，并在更新前备份完整 data 目录。

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

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

“与上游一致”表示当前 Lite 已按实际实现核对，所述行为可按同一方式使用。
“上游兼容”只表示文中明确列出的版本、数据或接口可以迁移或调用，不代表镜像、数据库和后台实现完全相同。
“Lite-agent”表示 nuomiiiii/Lite-agent 独立仓库的配套 Agent；协议中的旧字段或请求头仅为兼容，不代表仍使用旧 Agent 发布源。
“本项目官方脚本”表示 nuomiiiii/lite 仓库发布的安装脚本，不是上游仓库的脚本。
Lite 与上游确有差异时，页面会直接标注差异和适用范围，不要求读者自行判断。

不要混用两个项目的 Docker 镜像地址，也不要让两个项目同时读写同一份数据目录。从上游切换到 Lite 前必须备份；当前已适配的迁移来源见更新与数据库迁移。第三方主题和外部集成应使用公共接口，不应直接依赖内部数据库结构。