Niangao-mihoyoApi

项目介绍#

Niangao-mihoyoApi 是我开发的米游社与原神国服 API 后端，基于 Java 17 和 Spring Boot，面向独立部署的网页及其他客户端提供 HTTP 接口，也是本站米哈游工具箱使用的后端项目。

项目已在 GitHub 公开，目前支持原神国服官服与 B 服。仓库提供后端源码、接口文档、请求示例和部署说明，前端独立部署。

主要功能#

• 米游社登录：短信验证码登录、流程状态查询，并支持用户手动完成安全验证。
• 关联游戏账号：读取授权账号绑定的游戏角色，区分官服与 B 服。
• 原神账号总览：展示成就、活跃天数、深境螺旋、幻想真境剧诗及世界探索等数据。
• 角色与装备详情：读取已拥有角色、等级、命之座、天赋、武器、圣遗物和属性面板。
• 工作台会话：使用 HttpOnly Cookie，结合 CSRF 与来源校验，凭证在服务端加密存储，支持会话恢复、续期和退出。
• 档案保存：将最近成功读取的总览、角色和装备数据保存至 MySQL，再次访问时可读取已保存档案。

技术栈#

Java 17、Spring Boot、Spring MVC、Spring JDBC、MySQL、Redis / Lua、Maven，以及 UIGF Java SDK。

Redis 用于会话与登录流程管理，MySQL 保存游戏档案及查询记录。登录凭证使用 AES-GCM 加密后保存，短信发送和验证码提交不会自动重试。

部署与使用#

运行环境需要 JDK 17+、Maven、MySQL 和 Redis。部署时先初始化档案表，再配置数据库连接、服务端密钥与允许访问的前端来源。

具体操作请参阅仓库中的部署指南；接入客户端时可结合接口文档和请求示例使用。

当前范围#

本项目为个人社区项目，与米哈游 / HoYoverse 无官方关联。数据字段与服务可用性受上游接口、账号权限和安全验证影响，仅用于本人或已获授权账号。

目前不支持国际服、每日历史快照或自动验证码识别。问题反馈与后续更新统一在 GitHub 仓库进行，请勿在 Issue 中提交登录凭证或其他敏感信息。