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

谱面预览器参考了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）

前端配置 (Next.js Web - 静态导出 Pages 部署)

• NEXT_PUBLIC_API_URL: 关联活动/卡池等 API 的后端基准地址（在静态导出 Pages 部署时必填，例如 https://api.pjsk.moe；若使用本地开发或内置代理反代则无需配置）。

Docker 部署 (Go 后端独立部署)

当您在 Pages (如 Cloudflare Pages) 部署了前端静态文件后，可以使用全新的 Dockerfile.go 将 Go 后端作为独立服务构建和部署。

1. 构建 Docker 镜像

docker build -t pjsk-go-backend -f Dockerfile.go .

2. 启动容器

docker run -d \
  -p 8080:8080 \
  --name pjsk-backend \
  -e PORT=8080 \
  -e REDIS_URL=localhost:6379 \
  -v $(pwd)/data:/app/data \
  pjsk-go-backend