Web Video Sync

Web Video Sync 是一款由浏览器扩展和 Go 后端服务组成的开源工具，旨在实现跨浏览器、跨设备的 HTML5 视频播放进度同步。与传统的屏幕共享或视频流中继方案不同，它仅同步播放控制指令（如播放、暂停、跳转、倍速），让每位参与者在各自的设备上直接访问原始视频源。这种设计不仅极大地降低了带宽消耗，更从根本上保障了用户隐私和数据安全。

核心亮点

• 极速轻量同步：
  • 仅交换极小的元数据（播放状态、时间戳、倍速），不传输任何视频帧或音频流。
  • 无需下载、代理或解密视频内容，确保原生画质与流畅度。
• 极致隐私保护：
  • 零内容收集：视频和音频内容永远不会经过服务器或被工具收集。
  • 一次性房间：访客房间邀请令牌具有短生命周期且只能使用一次，防止未授权访问。
  • 最小化数据共享：仅共享必要的视频标识符和播放状态。
• 跨浏览器兼容：
  • 支持 Chrome、Edge 及其他基于 Chromium 的浏览器（Manifest V3）。
  • 已测试支持 Bilibili、YouTube 和 yfsp.tv (爱壹帆国际版)，其他 HTML5 视频网站有望通过通用适配逻辑运行。

工作原理

1. 主持人创建房间：在支持的网站打开视频，通过扩展程序生成一个一次性邀请令牌。
2. 跟随者加入：在另一台设备或浏览器上打开相同视频，输入邀请令牌。
3. 实时同步：主持人的所有操作（播放、暂停、拖拽进度条、调整倍速）会即时同步到跟随者端。

注意：邀请令牌是一次性的且有时效性，切勿在公开场合（如截图、日志、Issue）泄露有效令牌。

适用场景

• 远程观影派对：与朋友异地同步观看 YouTube 或 Bilibili 视频，享受“在一起”的感觉。
• 在线教学与培训：讲师可以精确控制学员的视频进度，确保所有人都在看同一帧画面。
• 协同审阅：团队共同审阅视频素材时，保持进度一致以便讨论特定细节。

技术架构

• 前端：Chrome 扩展程序（Manifest V3），负责检测视频元素、捕获用户操作并发送同步指令。
• 后端：Go 语言编写的轻量级服务，处理房间状态管理和信令转发。
• 缓存与状态：支持可替换的内存缓存接口，便于部署和扩展。