v2.1.0 可交互直播小窗 · 规则面板分组 · 数据桥端口回退

v2.1.0 更新说明

🖥 直播小窗升级：可交互镜像

• 小窗内可直接拖动/缩放视角（OrbitControls），操作实时回传主窗口，主画面跟着动
• 新增 SceneChannel 信令模块；数据通道断线自动重连
• 画面方向四档（横屏/竖屏 × 720P/1080P）与小窗尺寸联动同步

🎛 打印规则面板设置分组化

• 独立样式分组卡片，每个开关带说明文字
• 演示引擎支持规则参数覆盖（数量 / 尺寸 / 优先级可自定义）

🎁 礼物插队规则参数化

• 礼物插队打印逻辑参数化，配套专项测试

🌐 数据桥稳定性

• 端口占用自动回退（8765 被占时自动尝试相邻端口）+ /health 健康检查端点
• 多实例测试覆盖（test-bridge-ports.mjs）

🖼 其他

• YouTube / TikTok 视频封面（1280×720 与 1080×1920）及生成源码
• README 与使用教程页新增 B 站零基础入门全流程视频教程入口

下载

• 3d-printer-live-v2.1.0.zip：解压后双击 start-all.bat（需 Python + Node.js）

v2.0.0 直播功能大版本：头像直读 100% · 中英双语 · 直播专用小窗 · 画质预设

v2.0.0 直播功能大版本

🎯 头像抓取：实时评论 100% 带头像

• 修复协议级解码三处根因（信封误杀 / 昵称张冠李戴 / 事件广播未定义），评论者头像直接从直播协议流读取，零点击零延迟
• 活跃观众榜单帧批量入库头像；新增头像持久缓存（跨重启、跨房间，回访观众秒出头像）
• 资料卡补取强化（冷却 4 秒、全页查找、每昵称多批重试）；挂接前历史弹幕不打印只补头像

🎛 打印规则面板（全部可改、自动记忆）

• 评论 / 进场 / 点赞 / 关注 / 礼物是否打印、礼物语音、进场欢迎、30 秒无互动补位，共 8 个开关
• 评论与礼物默认打印；礼物按张数出大图并自动插队；规则面板设置分组化

🌏 中英双语（TikTok 直播适用）

• index-en.html 独立英文版 + gift-speech-en.mjs 英文语音（进出场/礼物/打印播报全英文）
• 页头 English / 中文 一键切换；两版代码完全独立，可分别调试

📺 直播专用小窗（OBS 抓取）

• 单独弹出的纯 3D 画面应用窗口：无任何界面元素，⚙ 设置静默自动隐藏
• 可交互镜像：小窗内可直接拖动视角（OrbitControls + 数据通道回传主窗口）
• 横屏 / 竖屏 × 720P / 1080P 四档窗口尺寸，选择自动记忆
• 主窗口照常运行不受影响；多窗口自动选举，绝不重复打印

🖼 画质五档预设

• 极速低配（关反射/阴影/扫光特效）/ 标准 / 2×精细 / 4×超清 / 8×影院

🌐 浏览器全功能模式

• 浏览器打开打印页即可完成开播全流程：打开直播窗口 / 开始抓取 / 停止抓取全部由本地服务直拉，绕开弹窗拦截（带同源安全防护）

🛠 稳定性与修复

• 数据桥自动跟随直播间切换（无需重启）；修复启动僵尸进程、断线重连崩溃、场景模式失效等问题
• 自动测试 47 项全部通过；弹窗专项测试 10/10 通过

下载

• 3d-printer-live-v2.0.zip：解压后双击 start-all.bat（需 Python + Node.js）