一、log-lottery 长什么样？先给你看成品#

先上图，感受一下效果：

1️⃣ 人员管理界面：支持导入、筛选、标记是否中奖。

![[log-lottery-4.png]]

2️⃣ 3D 抽奖球体：所有名字组成一个会旋转的「粉色星球」，现场氛围直接拉满。

![[log-lottery-2.png]]

3️⃣ 名单墙模式：抽奖前先把所有人铺满屏幕，给到一种「我真的在场」的参与感。

![[log-lottery-1.png]]

4️⃣ 开奖瞬间 + 彩带特效：中奖人会从球体中「飞出来」，配合背景音乐，非常适合拍照和录屏。

![[log-lottery-3.png]]

如果你也在为年底年会、团建、部门活动准备抽奖环节，这套 UI 基本可以直接当成「现成模板」来用。

二、log-lottery 到底是个啥？#

• 🔗 项目主页 / 文档：log-lottery 项目介绍
• 🎯 核心定位：基于「日志驱动」的可视化抽奖大屏；
• 🧩 典型用途：
  • 公司年会、团建、团建晚宴抽奖；
  • 直播间的弹幕 / 礼物 / 评论抽奖；
  • 社群签到、内部活动随机点名；
• ✨ 特色亮点：
  • 支持多档奖项配置（如三等、二等、一等、超级大奖、特别奖）；
  • 人员、奖项、外观、音乐都可配置；
  • 有 3D 球体、名单墙等多种展示形态。

一句话总结：你把候选人喂给 log-lottery，它帮你把抽奖过程变成一场表演。

三、从「名单」到「抽奖池」：怎么把人塞进去？#

年会最麻烦的一步，从来不是抽奖，而是——名单对不上人。
log-lottery 的玩法比较灵活，你可以：

• 从 HR 导出的 Excel、OA 系统导出的报表里，生成一份指定格式的文本 / CSV；
• 或者直接用脚本把数据库里的用户信息写成「日志行」；
• 再或者，小团队直接手动维护一份列表文件也行。

一般会包含这些字段：

• 员工编号 / 工号；
• 姓名；
• 部门 / 组别；
• 备注（比如：是否有资格参与某档奖项）。

整理好之后，把这份「日志」放到 log-lottery 约定的位置，它就能把每一行解析成一个「候选人卡片」，在前端页面里展示出来。

上面那张「人员管理界面」截图，就是把这些人加载进系统之后的状态——你可以：

• 勾选 / 排除某些人；
• 批量标记「已中奖不可再次参与」；
• 导出中奖结果，方便后续做统计。

四、年会现场实战流程：我怎么用它撑住一场抽奖？#

结合这次公司内部年会，我大致是这么设计流程的，你可以直接抄作业：

五、部署 & 使用建议（适合 NAS / 服务器）#

log-lottery 更像是一个前端为主的可视化应用，但非常适合部署在 NAS / 小主机上当做「内网抽奖站」：

• 🐋 建议使用 Docker 部署，方便升级和迁移；
• 🗂️ 把人员日志文件、配置文件挂载到宿主机目录，方便提前准备和备份；
• 🔐 如果要从公网访问，记得加一层反向代理 + 访问控制（比如只允许 VPN / 零信任登录后访问）。

1
docker run -d -p 9279:80 log-lottery

七、最后的小建议#

• 提前至少一周搭好环境，多演练几轮，熟悉每个奖项的节奏；
• 抽奖当天准备一台备用电脑 / 备用浏览器窗口，防止临时崩溃；
• 记得全程录屏，既能做存档，也方便之后剪成年会回顾视频。

年底临近，如果你还在为「抽什么工具」「怎么抽得有排面」犯愁，不妨试试这套 log-lottery。
说不定，今年年会结束后，大家都会记住：那场抽奖好像还挺酷的。👀