Lxns：trophy 收藏品接口与 OIDC 支持 #3

New issue

Open

opened 2026-08-20 09:32:28 +00:00 by KumaAgent · 0 comments

KumaAgent commented

2026-08-20 09:32:28 +00:00

Member

背景

来自 Lxns（落雪咖啡屋）实现 vs 文档偏移审查。注意：本次没有拿到 Lxns 后端真实源码，以下结论完全基于文档，可信度弱于 DivingFish 部分的同类结论（DivingFish 部分用了真实后端源码复核）。

参考文档：

舞萌 DX API：https://maimai.lxns.net/docs/api/maimai
OAuth 接入指南：https://maimai.lxns.net/docs/oauth-guide
OAuth API：https://maimai.lxns.net/docs/api/oauth

Trophy（称号）收藏品接口整体缺失

src/Lxns/LxnsResourceClient.cs 为 icon/plate/frame 三种收藏品都实现了列表和详情方法（GetIconsAsync/GetIconAsync/GetPlatesAsync/GetPlateAsync/GetFramesAsync/GetFrameAsync），唯独没有 trophy（称号）对应的方法，也没有 TrophyListResponse/Trophy 类型：

GET /api/v0/maimai/trophy/list
GET /api/v0/maimai/trophy/{trophy_id}

玩家收藏品进度：trophy/icon/frame 三种类型缺失

src/Lxns/LxnsDeveloperClient.cs 的 GetNamePlateProgressAsync 只覆盖了 plate 一种收藏品类型的玩家进度查询，文档里 collection_type 实际可取 trophy/icon/plate/frame 四种：

GET /api/v0/maimai/player/{friend_code}/{collection_type}/{collection_id}

OIDC 服务发现与 UserInfo

以下均无任何实现：

服务发现文档（.well-known/openid-configuration 等）
GET /api/v0/oauth/userinfo
ID Token（JWKS）验签流程

与 DivingFish 一侧类似，但有个关键差异：DivingFish 一侧已经确认这套体系实际存在于独立域名 auth.diving-fish.com（不在 df-backend 仓库内）；Lxns 这边由于没有拿到后端源码，无法确认是类似的独立授权服务，还是这套逻辑就直接在 Lxns 主站后端里——这一点建议在实现前先弄清楚，而不是直接照搬 DivingFish 那边的架构假设。

## 背景来自 Lxns（落雪咖啡屋）实现 vs 文档偏移审查。**注意：本次没有拿到 Lxns 后端真实源码，以下结论完全基于文档，可信度弱于 DivingFish 部分的同类结论（DivingFish 部分用了真实后端源码复核）。** 参考文档： - 舞萌 DX API：https://maimai.lxns.net/docs/api/maimai - OAuth 接入指南：https://maimai.lxns.net/docs/oauth-guide - OAuth API：https://maimai.lxns.net/docs/api/oauth ## Trophy（称号）收藏品接口整体缺失 `src/Lxns/LxnsResourceClient.cs` 为 icon/plate/frame 三种收藏品都实现了列表和详情方法（`GetIconsAsync`/`GetIconAsync`/`GetPlatesAsync`/`GetPlateAsync`/`GetFramesAsync`/`GetFrameAsync`），唯独没有 trophy（称号）对应的方法，也没有 `TrophyListResponse`/`Trophy` 类型： - `GET /api/v0/maimai/trophy/list` - `GET /api/v0/maimai/trophy/{trophy_id}` ## 玩家收藏品进度：trophy/icon/frame 三种类型缺失 `src/Lxns/LxnsDeveloperClient.cs` 的 `GetNamePlateProgressAsync` 只覆盖了 `plate` 一种收藏品类型的玩家进度查询，文档里 `collection_type` 实际可取 `trophy`/`icon`/`plate`/`frame` 四种： - `GET /api/v0/maimai/player/{friend_code}/{collection_type}/{collection_id}` ## OIDC 服务发现与 UserInfo 以下均无任何实现： - 服务发现文档（`.well-known/openid-configuration` 等） - `GET /api/v0/oauth/userinfo` - ID Token（JWKS）验签流程与 DivingFish 一侧类似，但有个关键差异：DivingFish 一侧已经确认这套体系实际存在于独立域名 `auth.diving-fish.com`（不在 df-backend 仓库内）；Lxns 这边由于没有拿到后端源码，无法确认是类似的独立授权服务，还是这套逻辑就直接在 Lxns 主站后端里——这一点建议在实现前先弄清楚，而不是直接照搬 DivingFish 那边的架构假设。

KumaAgent added the

状态：待评估

label

2026-08-20 09:32:34 +00:00