Moesekai (原Snowy SekaiViewer)

这是一个基于 Next.js 和 Go 的 Project Sekai 查看器项目。

⚠️ 注意 / Note

作者能力有限，本项目仅作为个人练习与探索。代码中可能存在大量非最佳实践，敬请包涵。 The author has limited capabilities; this project is for personal practice and exploration. Please be aware that the code may contain non-optimal practices.

参考与致谢 / Credits

本项目参考了 Sekai Viewer 的设计与实现。 Sekai Viewer 采用 GPLv3 开源协议。

This project is inspired by and references Sekai Viewer. Sekai Viewer is licensed under GPLv3.

sekai-calculator 项目提供的组卡算法支持 sekai-calculator 采用 LGPL-2.1 开源协议。

项目算法也参考了Luna茶的相关组卡代码实现sekai-deck-recommend-cpp

表情包制作器参考了Parallel-SEKAI的PJSK-Sticker仓库 以及 TheOriginalAyaka的sekai-stickers仓库 PJSK-Sticker sekai-stickers

歌词头像版权 / Lyrics avatar credits

歌词页面中的外部歌唱者头像均为小尺寸头像裁切图，版权归各自权利人所有。官方来源与署名集中记录如下：

• GUMI — © Internet Co., Ltd. — 官方页面
• Kasane Teto / 重音テト — 重音テト © 線 / 小山乃舞世 / TWINDRILL — 官方插画 · 角色指南
• flower — © Gynoid — 官方素材页
• Nenerobo — 暂无已确认的独立官方头像素材，当前保留文字回退头像
• Kamui Gakupo — © Internet Co., Ltd. / 三浦建太郎 — 官方角色页
• KAFU — © Musical Isotope — 官方条款
• Gekiyaku — © KAMITSUBAKI STUDIO / Musical Isotope — 官方条款
• SEKAI — © Musical Isotope — 官方条款
• Zundamon / ずんだもん — © 東北ずん子・ずんだもんプロジェクト — 官方指南
• Kaai Yuki — © AH-Software Co. Ltd. — 官方角色页
• Adachi Rei — © m1namo — 官方页面
• RIME — © KAMITSUBAKI STUDIO / Musical Isotope — 官方条款
• Hanakuma Chifuyu — © TOKYO6 ENTERTAINMENT — 官方页面
• VY1 — © Yamaha Corporation — 官方指南
• SOLARIA — © Eclipsed Sounds — 官方页面
• Kotonoha Aoi / 琴葉葵 — © AHS Co. Ltd. — 官方页面
• Kotonoha Akane / 琴葉茜 — © AHS Co. Ltd. — 官方页面

以上已列出的身份均已使用对应公开素材裁切为歌词页头像；Nenerobo 因暂未找到可确认的独立官方头像素材，仍保留文字回退。

头像只做裁切、缩放和页面显示用途，不代表本项目拥有上述角色或素材的版权。

可核对来源见 docs/lyrics-external-avatar-sources.json。

谱面预览器参考了watagashi-uni的sekai-mmw-preview-web 及 mikumikuworld 的相关实现 sekai-mmw-preview-web MikuMikuWorld

免责声明 / Disclaimer

本项目包含大量由人工智能（AI）辅助生成的代码。

• 代码可能包含潜在的错误、逻辑漏洞或非最佳实践。
• 使用者请自行承担风险，建议在生产环境部署前进行充分的审查和测试。
• 维护者不对因使用本项目代码而导致的任何问题负责。

This project contains a significant amount of code generated with the assistance of Artificial Intelligence (AI).

• The code may contain potential errors, logical flaws, or non-best practices.
• Users should use it at their own risk and are advised to conduct thorough review and testing before deploying in a production environment.
• The maintainers are not responsible for any issues arising from the use of this project's code.

License

本项目的开源协议遵循所参考项目的要求（如适用），当前采用 AGPL-3.0。 AGPL-3.0

环境变量 / Environment Variables

基础后端配置 (Go API Server)

• PORT: 后端监听端口（默认 8080）
• REDIS_URL: Redis 地址（默认 localhost:6379）
• MASTER_DATA_PATH: 可选本地 masterdata 缓存路径（默认 ./data/master）。仓库不再提交完整 masterdata；本地文件缺失时 Go API 会从远端数据源加载。
• STATIC_ARCHIVE_DIR: Next.js 静态文件归档持久化目录（默认 ./data/static_archive）。在全量 Docker 容器部署时，启动脚本会自动将新构建的 .next/static 产物增量归档保存至该目录，防止新版本部署导致未刷新的在线客户端加载旧 Chunk JS 出现 404 错误。
• STATIC_CACHE_MAX_DAYS: 静态归档产物保留天数（默认 30）；设为 0 禁用过期清理，其他值必须是非负整数。
• HTML_CACHE_DIR: HTML 响应缓存目录；留空时回落到默认目录（容器内 /app/data/html_cache，否则 ./data/html_cache）。没有关闭磁盘 HTML 缓存的开关。
• MOESEKAI_API_URL: moesekai-api（登录与猜歌曲）的内网地址，例如 http://moesekai-api.zeabur.internal:8080。设置后 /api/auth/ 与 /api/guess-music/ 由 Go 后端同源转发：Cookie、Set-Cookie 与跳转地址原样透传，响应边收边发，X-Forwarded-For 末尾追加上一跳地址，CF-Connecting-IP 保持不变；上游不可达时返回 502 {"error":"upstream_unavailable"}。未设置时这两组路径返回 503 {"error":"unavailable"}。
• NEXTJS_PORT: 全量镜像内部 Next.js 监听端口（默认 3000），必须与外部 Go PORT 不同。

This is the beginning of the README. Read the rest at the original. Read the full README ↗