夜雨聆风---
## 项目概述
这是一个私域录播仿直播 H5 系统。将预先录制好的视频以仿直播形式呈现给观看者，提供实时聊天互动、点赞、在线人数等直播特征，让录播内容获得直播的参与感和氛围。
---
## 观看端功能（H5 移动端页面）
**访问入口**：根路径 `/`，面向普通观众。
**昵称弹窗**：首次进入或刷新页面时弹出昵称输入框，支持手动输入或随机生成（格式为"学员XXXX"四位数字编号）。历史用户自动预填上次昵称，标题变为"欢迎回来"。昵称持久化到 localStorage。
**仿直播视频播放**：
- 视频从播放列表随机选择一个开始播放，播放起点在 15% 到 80% 之间随机选取，模拟"正在直播中"的感觉。
- 每集播完后自动切换到下一集循环播放。
- 播放器禁止观众拖动进度条，检测到 seek 操作（偏移超过 2 秒）会自动复位，维持直播不可回放的体验。
- 页面切到后台再恢复时自动续播。
- 视频加载失败时自动跳过尝试下一个，超时时间 8 秒。
- 支持 HLS（m3u8）和 MP4 两种格式，HLS 优先。云端视频直接使用原始 URL 播放，本地视频优先使用已转码的 HLS 地址。
- 播放器高度自动适配视频自身宽高比，不产生上下黑边。
**声音控制**：默认静音播放（遵循浏览器自动播放策略）。点击"进入直播间"后尝试有声播放，失败则静音兜底。聊天区头部有音量切换按钮，可随时切换静音/有声状态。
**实时聊天**：通过 WebSocket（Socket.IO）实现实时消息广播。消息类型包括：
- 用户消息：黄色昵称加白色内容，左对齐显示。
- 系统消息：居中显示灰色小字（加入/离开直播间、点赞事件）。
- 系统通知：红色醒目样式，带铃铛图标，由管理员后台推送。
- 机器人消息：自动回复和定时消息，以普通用户消息样式呈现。
**消息历史**：服务端保留最近 30 条消息。新用户加入时自动收到历史记录，不会看到一片空白。
**点赞功能**：观众可点击点赞按钮，实时广播给所有在线用户，聊天区显示"某某点了个赞"。
**在线人数**：基于实际 WebSocket 连接数，前端应用乘数放大算法（1-3 人乘 50 倍，4-10 人乘 20 倍，逐级递减），使冷启动时也能营造人气氛围。同时加入 8-15 秒随机波动，模拟自然起伏。
**移动端适配**：
- 竖屏：视频在上方占自适应高度，聊天区在下方占据剩余空间。
- 横屏：视频全屏铺满，聊天区隐藏。
- 平板及以上（宽度大于 768px）：左右分栏，视频 70%，聊天 30%。
- iOS Safari 键盘弹起时视频区自动缩小，聊天输入框保持在可见区域。
- 全面屏安全区域适配（safe-area-inset）。
---
## 管理后台功能（SPA 管理端）
**访问入口**：`/admin`，需要登录认证。默认账号 admin，默认密码 123456。
**登录认证**：
- Cookie 认证机制，有效期 24 小时。
- 路由守卫：未登录无法访问任何管理页面，自动跳转登录页。
- API 拦截器：cookie 过期或服务端返回 401 时自动清除登录状态并跳转。
- 支持修改密码，持久化到 config.json 文件。
- 支持退出登录。
**概览标签页**：
- 实时数据显示：当前在线用户数、累计点赞数（通过 WebSocket 实时推送）。
- 视频资源统计：节目单视频总数、已转 HLS 数量、云端视频数量。
- 修改密码功能。
**节目单标签页**：
- 左半部分：上传本地视频。支持填写标题，上传后自动加入播放列表并启动 HLS 转码。
- 右半部分：添加云端视频。输入视频 URL 和标题，支持 m3u8 和 mp4 格式。云端视频免转码直接播放。
- 底部表格：当前节目单列表，显示名称、来源类型（云端/本地/转码状态），支持置顶、置底排序和删除，点击保存排序按钮持久化。
**机器人标签页**：
- 系统通知区：输入内容后点击发送，立即以红色字体广播到所有在线观众的聊天区。发送记录保存到通知列表中，可逐条删除，删除时会同步从所有观众的聊天区移除。
- 关键词回复区：添加关键词和对应回复内容，一个关键词可配置多条回复，匹配时随机选取一条。当观众发送的消息包含关键词时（大小写不敏感），机器人智能助手延迟 1 秒后自动回复。支持删除单条回复或整个关键词。
- 定时自动回复区：配置模拟用户定时发言。每条规则包含用户名、回复内容、间隔秒数三个字段。首次发送有随机延迟避免整齐刷屏。支持逐条添加，也支持从 TXT 文件批量导入（每行格式：用户名|回复内容|间隔秒数）。
---
## 服务端核心机制
**视频管理**：
- 上传的视频存储到 public/videos 目录，文件名自动生成为 video-时间戳-随机数.扩展名。
- 上传后自动触发 HLS 转码（ffmpeg），将 MP4 转为 m3u8 分片，转码完成后自动删除原始 MP4 节省空间。
- 可查询 HLS 转码状态（pending/converting/done/error）。
- 支持删除视频，删除文件同时从播放列表中移除对应条目。
**播放列表管理**：
- 数据结构支持两种来源：source 为 local 表示本地视频，source 为 cloud 表示云端视频。
- 向下兼容旧格式（纯字符串数组自动转为对象数组）。
- 持久化到 playlist.json 文件，服务启动时加载到内存。
- 提供 GET/POST API，管理后台修改后同时更新内存和文件。
**机器人配置管理**：
- 包含三类数据：系统通知历史、关键词回复映射、定时自动回复规则。
- 持久化到 robot-config.json 文件。
- 定时回复在服务启动时自动开启，配置更新后自动重启定时器。
- 定时器管理采用"首次随机延迟 + 后续定时间隔"模式，每条规则独立控制。
**WebSocket 实时通信**：
- 用户加入时：登记到在线用户表，下发聊天历史和当前点赞数，广播加入消息。
- 用户发送消息时：先检测关键词触发机器人回复，然后广播用户消息，1 秒后发送机器人回复。
- 用户点赞时：累加点赞计数，广播更新和点赞消息。
- 用户离开时：从在线表中移除，广播离开消息和在线人数。
**认证中间件**：
- 公开 API 豁免：登录接口、获取播放列表（GET）、获取最新视频（GET）无需认证。
- 其他 API 接口需检查 cookie 中的 authenticated 字段。
- 管理页面请求未认证时服务端 302 重定向到登录页。
- 管理 API 请求未认证时返回 401 JSON 响应。
---
**核心功能类**
私域录播仿直播系统源码 录播变直播 自带聊天互动点赞
微信私域伪直播全套源码 视频轮播 实时弹幕 在线人数模拟
录播仿直播H5源码 支持本地视频和云端链接混合编排播放
私域直播系统源码 视频自动轮播 HLS流媒体转码 多格式兼容
仿直播互动系统全套源码 点赞 弹幕 在线人数 一键部署
---
**自动化运营类**
私域直播自动互动系统源码 智能机器人关键词回复 定时发言
录播仿直播自动化运营源码 模拟真实用户聊天 营造活跃氛围
私域直播间机器人系统源码 关键词触发回复 定时自动评论 批量导入话术
带智能互动的伪直播源码 自动聊天 自动点赞 人气值智能放大
私域录播无人值守直播系统源码 全自动轮播 自动互动 7x24运行
---
**部署与变现类**
自建私域直播平台源码 免平台抽成 数据完全自主可控
独立部署私域仿直播系统源码 不依赖抖音快手 微信直接打开
私域流量变现直播工具源码 微信H5即开即看 无需下载APP
免平台私域直播全套解决方案源码 一键部署 极速上线
私域直播间搭建成品源码 支持宝塔面板 带完整管理后台
---
**场景应用类**
知识付费私域直播系统源码 课程录播仿直播 学员互动聊天
老年社群私域直播间源码 养生讲座录播轮播 自动关怀话术
私域电商直播带货源码 录播商品讲解 自动引导互动下单
企业内部私域培训直播源码 视频录播 员工互动 数据保密
微信群私域直播配套系统源码 H5页面即开即播 易传播易裂变
---
**差异化卖点类**
支持云端视频的私域直播源码 阿里云OSS直链播放 免转码免存储
真正免平台费的私域直播系统源码 一次部署终身使用 无抽成无限制
私人域名私域直播源码 品牌完全自主 客户数据不外流
