主题管理
主题管理用于导入、启用、更新、配置和移除公开大屏主题。主题市场与已安装主题位于同一管理流程中，避免跳转后失去当前上下文。
从 2.2.1 起，系统 Web UI 与主题已经解耦：主题只影响公开大屏，不会替换管理后台、初始化、远程终端、文件管理或 404 等系统页面。Lite-web 独立控制这些界面，公开大屏由当前启用主题提供。
导入与启用
- 打开“外观与主题 → 主题管理”。
- 导入主题压缩包或按主题说明安装。
- 在已安装主题中选择并启用。
- 回到公共首页确认实际主题已经切换。
全新安装默认提供 Lite-Theme。它与其他主题一样支持更新和删除，但只有在系统中还存在另一个可用主题时才能删除。主题管理始终要求至少保留一个可用主题，避免公开大屏没有渲染入口。
默认 Lite-Theme 会按 CPU 核心数判断负载颜色，可选显示卡片带宽；单线路概览只使用所选探测任务，首页和网络页签会复用实时状态缓存，并能忽略非 JSON WebSocket 消息，避免单条异常消息中断页面更新。
原经典主题不再捆绑在 Lite 中。如需使用，可单独安装 lite-Classic；它是独立提取版本，不代表后续一定持续维护。
导入成功但首页仍是默认主题时，检查：
- 主题是否只是安装而没有启用。
- 浏览器或 Cloudflare 是否缓存旧首页和 Service Worker。
- 主题清单是否声明了正确入口文件。
- 主题文件是否与当前 Lite 版本兼容。
- 主题包根目录是否包含优先使用的
Lite-theme.json，或用于旧主题兼容的komari-theme.json。
主题设置
主题的语言、布局和外观选项由主题自己提供。后台语言切换不能自动翻译主题内部硬编码文本；主题作者应在自己的配置和公共页面中提供所需翻译。
主题设置入口只在主题清单声明了有效配置时显示。Logo、预览图、国家/地区图标和配置页资源应使用主题包内的正确相对路径，避免在子路径部署或更新主题后丢失。
主题配置除开关、选择、数字、文本和富文本外，还可以声明节点选择器和 Ping 任务选择器，直接关联当前实例中的服务器或延迟监测任务。清单中的名称、作者和描述可以写成多语言对象；后台优先匹配当前语言，缺少对应条目时回退到可用文本。
Lite 优先读取 Lite-theme.json。为兼容旧主题，只有 komari-theme.json 的主题包仍可安装；同一主题同时存在两个清单时以 Lite-theme.json 为准。新主题应使用新文件名。
备份恢复、首次安装恢复和主题上传对大文件使用分段传输。进度会显示已传输字节和百分比，达到 100% 后再进入服务端处理；网络中断后只需重试失败部分。
仪表盘跳转
仪表盘排行通过当前启用主题的清单读取服务器详情、网络总览和 Ping 任务参数，不与 Lite-Theme 或其他具体主题绑定：
- 平均时延和延迟抖动是多任务综合结果，进入服务器网络总览。
- 近 15 分钟丢包进入该服务器最差的具体 Ping 任务。
- 其他服务器排行进入服务器详情。
未声明导航能力的旧主题会回退到兼容的服务器详情地址。跳转是当前标签页中的完整页面导航，不会改成后台内部路由；从大屏返回后，后台仪表盘会恢复最近一次会话快照并静默刷新。
PWA 与站点信息
公开大屏安装到主屏幕时，会使用后台设置的站点名称、描述和网站图标。后台改名后如果主屏幕仍显示旧名称，卸载后重新安装即可。
流量字段
公共接口会把兼容额度字段映射为本周期有效额度，包括本周期追加的重置流量额度。主题应直接使用接口结果，不要再读取内部设置或重复相加。
服务器实际上传、下载和当前周期用量也应从公共接口读取。
国家/地区图标
服务器手动设置国家/地区代码后，公共接口优先返回该值，用于修正 GeoIP 错误和广播 IP 场景。主题应将两位代码标准化为大写后再映射旗帜或地区名称。