# 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 解决两类问题:在弱网、短断流、换线路、换画质和媒体代际变化时让直播播放尽量连续;
以及在直播画面上以有界、可扩展的方式展示实时弹幕和结构化事件卡。
它不绑定任何播放器。原生 `