Kodi21.3 Omega

Kodi 21.3 Omega 是开源的家庭影音媒体中心，把本地磁盘、网络共享或其他来源的影片、电视剧、音乐和图片整理成可浏览的媒体库。官方发布说明确认 21.3 Omega 于 2025-12-16 发布，21.x Omega 仍是当前稳定主线；Kodi 22 Piers 属于开发方向，不应作为普通用户的稳定基线。本页重点讲清“文件源、媒体库、插件和播放设备”之间的关系。

先确定媒体源与播放设备

Kodi 本身是媒体中心，不会替你获得电影、剧集或音乐内容。加入来源前先确认自己拥有访问和播放权限；测试时使用一个目录和几部不敏感的文件，先验证路径、扫描和播放链。

安装与首次设置

1. 从官方下载总页按 Windows、macOS、Linux、Android、iOS 或其他平台选择入口；Windows 页面提供 64 位、32 位和 Windows Store 选项。
2. 安装 21.3 Omega 后打开 Settings，先确认界面语言、区域、时间格式和显示分辨率。
3. 在 Videos、Music 或 Pictures 中选择 Files，再用 Add videos/music 建立一个来源；不要一开始把整个网络盘挂进去。
4. 完成一次扫描后打开影片详情页，确认标题、海报、音轨、字幕和播放进度，再扩大目录。

Files 模式与 Library 模式

Files 模式直接浏览文件夹，适合检查路径和命名；Library 模式依赖扫描器与刮削器提供标题、海报和分类。扫描结果不正确时，先回到 Files 判断文件是否可见，再检查命名、内容类型和元数据来源。

媒体库扫描与元数据

刮削器返回的是外部元数据，可能因语言、地区或条目匹配产生差异。重要收藏建议保留 NFO、海报和字幕的本地副本，避免远端服务变化导致信息重新匹配。

插件与遥控播放

Kodi 的插件系统可以扩展视频、音乐、字幕、皮肤和遥控能力。官方 Wiki 区分 Add-ons 与仓库；第三方仓库的代码、内容来源和更新策略不由 Kodi 核心项目统一保证。只安装自己能识别来源和权限的插件，尤其不要把需要未知登录凭据的插件直接放进家庭主机。

1. 先从官方仓库安装一个用途明确的插件，观察权限、更新来源和设置项。
2. 用遥控器、键盘或官方支持的远程方式完成播放、暂停、音轨和字幕切换。
3. 多个客户端共享媒体库时，先统一路径映射和用户权限，再考虑集中数据库。
4. 插件失效时先禁用最近安装项，以干净配置复现；不要同时升级所有仓库。

播放性能与字幕排错

备份与稳定版本策略

1. 备份 userdata、sources.xml、播放列表、NFO、海报和自定义皮肤设置。
2. 升级前先读官方 21.3 发行说明，确认平台部署方式；Android 等平台的上架和安装条件可能不同。
3. 不要把开发版 Kodi 22 与长期媒体库直接混用；需要测试时复制配置和小型媒体目录。
4. 恢复时先导入来源，再扫描一个小目录，确认播放和插件后再还原完整数据库。

Kodi 适合把家庭设备变成统一的影音浏览界面，但媒体文件、元数据、插件和远程访问分别有自己的故障边界。把来源权限、备份和版本记录做好，比单纯更换皮肤更能提升长期可用性。