rhfbgfgfdg999999/3d-printer-live

项目用途

这是一个本地运行的 3D 打印机直播可视化项目。观众在抖音、快手或 TikTok 直播间发表评论、点赞、送礼或关注后，Three.js 场景会把对应观众的头像逐层打印出来，再打分并送到前方传送带上。项目附带规则演示台、打印记录、镜头视角、五档画质和中英双语页面，英文版面向 TikTok 场景。头像来自直播间资料，并缓存在本地，回访观众可以更快显示。

另有一个数据桥进程，从已登录的浏览器直播间窗口读取弹幕，并通过本地 WebSocket 推送给打印页面。README 描述了头像的三层获取方式：直接解码直播间协议帧、从页面多来源采集、点击资料卡补取；都拿不到时生成彩色首字头像作为兜底。

快速开始

1. 安装 Python。使用 WebView2 桌面版时还需安装 Node.js、pywebview 和 WebView2 Runtime。
2. 双击 start.bat，然后打开 http://127.0.0.1:8080 。不要直接双击 HTML 文件，浏览器会限制本地 ES modules。
3. 页面会自动加载 8 个测试头像并开始打印，不连接直播间也能先查看场景效果。
4. 接入真实直播间时双击 start-all.bat，它会启动打印服务、弹出可扫码登录的 Chrome 直播间窗口，并以应用窗口打开打印程序；也可以分开运行 start.bat 和 start-bridge.bat。
5. 在「直播连接」面板填写房间号或完整直播间链接。页面连接 ws://127.0.0.1:8765，连上后会显示数据桥已连接和当前房间号。

完整的零基础视频教程见 哔哩哔哩。服务启动后，打印台顶部还提供功能页和教程入口，README 中给出的逐步教程地址为 http://127.0.0.1:8080/guide.html。

使用约束

• 必须安装 Python；WebView2 桌面版还需要 Node.js、pywebview 和 WebView2 Runtime。
• 页面必须通过 HTTP 访问，直接双击 HTML 无法运行。
• 首次使用新版 WebView2 前，应关闭旧版 ServerGuard、BridgeGuard 和旧数据桥，避免端口占用。新窗口使用独立登录配置，需要重新登录。
• 数据桥只读取公开弹幕，不会替你登录、发弹幕或送礼物；登录操作在直播间窗口内完成。
• 采集依附于数据桥的浏览器窗口，关闭该窗口即停止采集。挂接前已经滚过的历史弹幕不会打印，只同步头像。
• 画面中的评分是娱乐性质的随机分数，不代表真实评价。
• 项目采用 MIT 许可证。

定制说明

README 声明软件免费开源，同时也提供 600～1800 元的付费定制，并列出个人微信联系方式。如果只是使用开源程序，无需付费。

HotRepo 点评

2026-11-02，该项目出现在 HotRepo 新项目榜的 JavaScript 语言记录中，当时共有 111 Stars 和 52 Forks，在 UTC 07:45 至 09:45 约两小时的窗口内净增 8 Stars。这是一次较快的早期增长，但只有一条榜单单次记录和一个短窗口，不足以判断长期趋势。Fork 数相对 Star 数偏高，说明有人不只是收藏，还可能复制或基于它继续开发；README 中的付费定制服务可能是部分用户 Fork 的原因之一。项目更实用的部分是直播间到 3D 场景的数据桥，README 对它的描述也比画面部分更具体。