WHC系列：Quizz --- 自托管实时多人问答互动平台

🎯 What —— 这是什么？

• 🏷️ 一句话定位：自托管的实时多人问答互动游戏平台
• 🚀 核心优势
  • ✨ 零门槛参战：无需下载任何 App 或注册繁琐账号，输入房间码一秒加入
  • ⚡ 刺激的计分机制：自带抢答速度分加成与连对（Streak）爆分机制，氛围感拉满
  • 🔒 极致干净纯粹：完全私有化部署，没有广告打扰，数据和题库自己掌控
• 📊 适用场景：专为朋友聚会破冰、周末轰趴、团队建设设计，最适合大家坐在客厅里一起拿着手机抢答吐槽。

🛠️ How —— 怎么用？

聚会前准备：配置“惊喜”题库（管理员）

1. 首次建议使用浏览器打开应用，进入应用需要在配置向导设置账号密码，也可以按照默认（admin/admin）即可。

2. 进入应用后，登录的是用户界面
   

3. 需要替换网页地址为https://quizz.你的盒子名.heiyu.space/admin ，进入后台管理员界面。你会看到 Dashboard (我的题库)，如果还没有题目，直接点击亮紫色的 + Create Quiz 按钮。
   

4. 在创建题库界面，你有两种高效构建的方法：

   • JSON Import（极速模式）：你可以把关于朋友名字、梗的关键词丢给 Deepseek/千问，让其按界面提供的格式生成 JSON，直接在此处整段粘贴！
     
   • Manual Builder（精雕细琢）：如果想自己手动编辑，切换到此面板。你可以选择 Multiple Choice (单选题)、True/False (判断题) 或者 Open Text (问答题)。系统还允许你为每道题单独设置好 Time (倒计时)（比如只有 5 秒！）和 Base Score (基础分)。
     

5. 建议准备一些关于出席朋友的“黑历史”或八卦问题，喜剧效果极佳）。

💡 八卦/黑历史问题参考示例，可以点击Add Question来增加问题：
只要题目够狠，气氛绝对能 High 起来，建议配置至少 10 道类似下面这样的题：

• [单选题 - Multiple Choice]：“去年跨年夜，李雷喝醉后做的第一件事是什么？”（选项：A.抱着路灯唱好汉歌；B.给前女友发88个微表情；C.在群里发了500块钱红包；D.睡在客厅洗手间门口。答案：C）
• [判断题 - True/False]：“王梅曾用三天时间拼好了一个两千块的乐高，然后不小心一屁股坐碎了，这件事是真的吗？”（答案：True，搭配个 15 秒倒计时看着他们纠结）
• [问答题 - Open Text]：“说出张三大学时期暗恋过的同班女生名字！”（这题可以把 Base Score 设置为 1000 分，谁打字快并且不顾及张三死活的，谁就能拿走高分！）

聚会破冰：建立房间与摇人

1. 大家在客厅坐好后，你在管理面板的 Dashboard 列表中找到准备好的爆笑题库，点击右侧绿色的 ▶ Start 按钮。
   
2. 此时会弹出一个 Game Settings (游戏设置) 窗口，为了让场面更刺激，建议配置好以下选项：
   • Streak bonus (连击奖励)：强烈建议勾选！设定连续答对后每题能叠加的额外分数（比如 50 分），让保持全对纪录的朋友分数起飞。
   • Jokers (道具卡/小丑牌)：系统提供 Pass (跳过当前题并强制给予基础分) 和 50/50 (仅限单选题，排除两个错误选项) 两种管理员主动发放的道具。勾选开启后，可在游戏过程中由你作为“上帝”决定何时给全员放水！

3. 配置完毕后，点击弹窗的绿色 Start → 按钮，系统会跳转至 Waiting for players（等待大厅） 面板。
4. 此时，大屏左侧会亮出巨大的 Game PIN (房间号)！你可以直接把这块屏幕投到电视上。如果你觉得大家懒得手打地址，可以点击下方的 Copy 按钮，一键将玩家专属的直达链接丢进微信/聊天群里。
   
5. 朋友们只需点击直达链接（或自行访问玩家入口输入 Game PIN），然后敲上自己的 昵称
   
6. 选择一个头像，然后点击Join Game，即可加入对局。
   
7. 待所有朋友进入后，点击Start Game即可开始游戏。
   

巅峰对决：抢答与实时排行榜

1. 进入游戏后，大屏（管理端）和你点击 下一题，所有人手机上都会同步显示题目和倒计时。
   
2. 朋友们火速在各自的手机上 点击正确选项。动作要快！系统会根据谁先点对，自动发放 速度奖励分 (Speed bonus)；连续答对还有额外的 连击加分 (Streak bonus)！
   
   
3. 每答完一题，大屏幕上会自动展示本轮的正确答案和实时 积分排行榜，大家可以在此刻尽情互相嘲讽或欢呼。
   

🧩 Conclusion —— 一句话总结

Quizz 是一款门槛极低、趣味性极高的开源聚会互动神器，无需注册一秒开局，配上速度与连击的竞技机制，绝对是让朋友派对瞬间升温的终极秘密武器。