房间
成员、播放列表、聊天、权限和当前播放状态都围绕房间组织。见 房间概念。
SyncTV 的日常入口是房间。用户在房间里同步观看视频、聊天、切换播放列表；房间管理员控制成员和权限；平台管理员维护账号、审核、Provider、直播和运行策略。
这份文档按真实任务组织。第一次使用先进入“使用 SyncTV”，接管实例先进入“管理 SyncTV”，上线部署先进入“安装与升级”，客户端接入先进入“开发与集成”。
使用 SyncTV 登录、加入房间、同步观看、聊天、添加媒体和管理个人设置。
管理实例 管理用户、房间、审核、Provider、直播、运行时设置和维护任务。
安装或升级 选择 Compose、源码运行或 Helm/Kubernetes 路径，并完成生产上线检查。
开发客户端 使用 OpenAPI、gRPC、WebSocket Realtime、ticket、播放信息和错误码。
| 目标 | 页面 |
|---|---|
| 登录并保护账号 | 登录与账号安全 |
| 创建或加入房间 | 创建和加入房间 |
| 处理播放不同步或失败 | 同步观看 和 用户排障 |
| 添加媒体源 | 添加媒体 |
| 管理用户、房间和审核 | 管理 SyncTV |
| 启动自托管实例 | 快速开始 |
| 接入客户端 | 客户端集成指南 |
理解 SyncTV
Section titled “理解 SyncTV”同步观看
服务端保存房间播放状态，客户端通过 Realtime 跟随播放、暂停、seek 和媒体切换。见 播放模型。
媒体源
Provider 把 Alist、Emby/Jellyfin、Bilibili、直链、远程服务或直播入口变成可播放结果。见 媒体源概念。
权限
全局角色、房间角色、成员覆盖和房间设置共同决定用户能做什么。见 权限模型。
生产部署清单
上线前确认 TLS、secret、PostgreSQL、Redis、备份、metrics、管理面和恢复流程。
运行边界
了解 PostgreSQL、Redis、secret、管理面、媒体代理和非目标，避免用错系统边界。
配置入口
配置文件、环境变量、runtime settings 和 CLI 覆盖的优先级不同，修改前先确认来源。
从本地试用到生产上线见 部署路径选择；运行依赖和非目标见 运行边界；完整字段见 配置总索引。
SyncTV 使用 MIT 许可证。完整条款见仓库根目录的 LICENSE 文件。