# LiveFlow **Repository Path**: tsbc/LiveFlow ## Basic Information - **Project Name**: LiveFlow - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-18 - **Last Updated**: 2026-11-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# LiveFlow 浏览器侧直播播放连续性与实时叠加层工具库。
媒体连续性、结构化弹幕、实时事件卡,三个互相独立的有界引擎。 [English](./README.en.md) · [报告问题][github-issues-link] · [更新日志][changelog-link] · [文档][docs-link] [![][github-stars-shield]][github-stars-link] [![][github-forks-shield]][github-forks-link] [![][github-issues-shield]][github-issues-link] [![][github-license-shield]][github-license-link]
[![][github-contributors-shield]][github-contributors-link] [![][github-lastcommit-shield]][github-lastcommit-link] [![][github-ci-shield]][github-ci-link] [![][node-shield]][node-link]
目录 #### TOC - [✨ 特性](#-特性) - [📋 边界](#-边界) - [📦 安装](#-安装) - [🚀 快速开始](#-快速开始) - [🧩 入口](#-入口) - [📖 接口](#-接口) - [🔧 配置](#-配置) - [🔍 关键行为](#-关键行为) - [🌐 浏览器基线](#-浏览器基线) - [📚 文档](#-文档) - [🛠 开发](#-开发) - [❓ 常见问题](#-常见问题) - [📝 许可证](#-许可证) ####
## ✨ 特性 - **无闪烁换源。** 候选媒体实例隐藏预热,由 generation 计数器门禁,首帧到达时原子交接,失败 则回退到原实例。 - **播放连续性。** 柔性追帧、卡顿防抖,恢复请求受冷却时间和硬性次数上限双重约束。 - **结构化弹幕。** 灯牌、等级、昵称和正文各自保持独立 DOM 节点,身份语义不会被拍平成一段 格式化文本。 - **有界实时事件。** 优先级、去重、过期、按 `kind` 注册的 renderer registry,以及一个不使用 `innerHTML` 的安全 DOM renderer。 - **跨实例预算。** 四路或九路播放网格通过页面显式创建的协调器,共享完整卡片与高成本动画的 全局上限。 - **天然延迟加载。** 根入口、三个引擎和五个播放器 adapter 都是独立 ESM 子路径,用户不开始 播放就不下载任何一个。 - **零运行时依赖。** 模块求值不触碰 DOM、计时器和全局对象,因此在服务端渲染环境导入核心入口 是安全的。
[![][back-to-top]](#readme-top)
## 📋 边界 LiveFlow 解决两类问题:在弱网、短断流、换线路、换画质和媒体代际变化时让直播播放尽量连续; 以及在直播画面上以有界、可扩展的方式展示实时弹幕和结构化事件卡。 它不绑定任何播放器。原生 `