taiko.su/README.md

taiko.su

taiko.su 是 taiko.asia 的彩蛋站点代码仓库。

当前站点提供一个精简的单曲活动入口：页面完成开屏加载和 setup 后，自动进入管理员指定的歌曲；游玩结束后生成并保存彩蛋码，用户领取后返回加载完成页面。

功能

• 开屏加载与 setup 完成页
• 管理员指定单首歌曲和固定难度
• 单人游玩与结算
• 彩蛋码生成、持久化及领取
• Token + 彩蛋码双认证 API
• 管理员活动设置与彩蛋码记录

站点版本标识为 vSU? ??.??.??。

运行

项目需要 MongoDB。Redis 为可选依赖，未连接时使用本地文件会话。

python -m pip install -r requirements.txt
python app.py 34801 -b 127.0.0.1

生产环境可使用：

sudo bash setup.sh

首次部署时，脚本会引导创建管理员。管理员入口为 /1128admin1128，后台可以选择数据库中已启用的歌曲、固定游玩难度，并设置彩蛋码验证 Token。

彩蛋码验证 API

POST /api/easter-eggs/verify
Authorization: Bearer <管理员设置的 Token>
Content-Type: application/json

{"code":"AI4-XXXX-XXXX"}

也可以通过 X-Verification-Token 请求头传递 Token。

• Token 与彩蛋码均正确：返回 HTTP 200 和 {"success":true}
• Token 缺失或错误：返回 HTTP 401
• Token 正确但彩蛋码无效：返回 HTTP 200 和 {"success":false}

数据集合

• 歌曲：songs
• 活动设置：experience_settings
• 彩蛋码：easter_egg_codes
• 管理员：users 集合中 user_level >= 50 的账号

项目范围

本仓库只维护 taiko.su 彩蛋站点所需的加载、单曲游玩、彩蛋码和管理员配置功能，不包含歌曲上传、用户中心、排行榜、社交、多人、AI 对战或谱面编辑器。

仓库

项目现已迁移至：

https://code.taiko.im/Superories/taiko.su.git