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