Skip to content

Commit f3d2117

Browse files
committed
docs: add update message
1 parent c1ca9b7 commit f3d2117

File tree

4 files changed

+83
-10
lines changed

4 files changed

+83
-10
lines changed

app/components/banner/account-system.vue

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<div class="bg-base-200/50 rounded-lg px-4 py-3 mb-6">
33
<p class="text-sm text-base-content/70 text-center">
44
UsagiPass 与 兔卡账号 已完成深度融合升级,您将体验更稳定、更精彩的兔兔服务!
5-
<a href="https://up.turou.fun/docs/notifications/account-system.html" target="_blank" class="link link-primary text-sm">【查看详情】</a>
5+
<a href="https://up.turou.fun/docs/announcement/account-system.html" target="_blank" class="link link-primary text-sm">【查看详情】</a>
66
</p>
77
</div>
88
</template>

docs/announcement/about-next.md

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
# 新版 UsagiPass 说明
2+
3+
UsagiPass 指 基于水鱼/落雪查分器的数据动态生成玩家的 DXPASS 相关服务。
4+
5+
UsagiCard 指 样式类似 DXPASS 的实体卡片以及围绕卡片提供的相关服务。
6+
7+
服务条款:https://up.turou.fun/docs/terms-of-use.html
8+
9+
隐私政策:https://up.turou.fun/docs/privacy-policy.html
10+
11+
## 前言
12+
13+
首先感谢所有支持 UsagiPass 的用户,正是因为有你们的支持,我们才有动力继续开发和维护这个项目。为了不再强制依赖水鱼和落雪查分器,并且为未来更多功能的开发打下基础,我们决定对 UsagiPass 进行一次重大的升级。主要涉及重构账号系统和服务内容两大方面。本次升级于 2026 年 1 月 2 日正式完成,现将相关变更说明如下:
14+
15+
1. 合并 UsagiPass 与 UsagiCard 的账号系统(UsagiPass 不再强制依赖水鱼 / 落雪账号)
16+
2. 合并 UsagiPass 与 UsagiCard 的图片系统(图片仅需上传一次,即可在两边使用)
17+
3. 使用 Nuxt 重构 UsagiPass 和 UsagiCard(使用服务端渲染提升首屏加载速度)
18+
4. 提升更新查分器的操作体验,点击小火箭即可在后台触发更新,不再在前台等待了
19+
5. 优化图片查找和上传体验,现在可以根据标签进行上传和筛选了
20+
6. 部分 UI 改进以及操作逻辑优化,添加了新手指引
21+
7. 重新设计 DXPASS 部分样式,更符合自适应需求
22+
23+
## 目前的情况
24+
25+
1. UsagiPass 已经完成升级,上述变更均已实装。
26+
2. UsagiCard 升级暂未完成,仍在进行中,目前 UsagiCard 仍然使用旧版系统,所有功能均未受影响。
27+
3. UsagiCard 新用户注册和订单创建已暂时关闭,预计在 2026 年 2 月底前完成升级,升级完成后将重新开放订单创建。
28+
29+
额外说明:2025 年 12 月底,华立开始给二维码页面使用 HTTPS,所以 UsagiPass 必须安装 CA 证书才能继续使用,这与本次升级无关。
30+
31+
## 账号迁移说明
32+
33+
UsagiPass 与 兔卡账号 已完成深度融合升级,现统一更名为 UsagiLab 账号。关于账号升级的详细说明,请查看[账号迁移说明](./account-system.md)
34+
35+
## 开发者相关
36+
37+
下面的内容仅面向对 UsagiPass / UsagiCard 感兴趣的开发者,介绍本次更新后 UsagiPass / UsagiCard 的整体架构设计和实现细节。
38+
39+
1. 原有的架构:
40+
41+
UsagiPass 与 UsagiCard 使用完全独立的账号系统、图片系统和查分系统。二者均为 Vue 3 + Vite 前端,后端使用 Python 开发。
42+
43+
2. 目前的情况:
44+
45+
UsagiPass 和 UsagiCard 使用 Nuxt + Nitro SSR 开发,Nitro 负责承载部分业务,以及转发 leporid 和 otoge-service 提供的 API 服务。
46+
47+
![](https://s2.loli.net/2026/01/02/mlyqvWZNP9tXMfz.png)
48+
49+
::: details UsagiPass 具体说明
50+
- 图片和账号系统:调用 leporid 提供的图片和账号相关 API 服务。
51+
- 查分相关功能:调用 otoge-service 提供的查分相关 API 服务。
52+
- 个人偏好系统:Nitro 直接存取 usagipass 数据库中的用户偏好数据表。
53+
:::
54+
55+
::: details UsagiCard 具体说明
56+
- 图片和账号、订单等内部系统:调用 leporid 提供的图片和账号相关 API 服务。
57+
- 查分、成绩等相关功能:调用 otoge-service 提供的查分相关 API 服务、部分逻辑由 Nitro 负责处理。
58+
- 个人偏好系统:Nitro 直接存取 usagipass 数据库中的用户偏好数据表。
59+
:::
60+
61+
在更新过后,您仍可以自行部署完整的 UsagiPass 服务。在默认情况下,虽然部署后将使用公共的 leporid 账号系统和图片系统,但您的个性化设置和 MITM 代理均运行在本地,仍可保证全链路安全。
62+
63+
在更新查分器时,默认会从本地数据库查出查分器账号信息,然后调用公共的 otoge-service 服务来上传成绩。如果您希望更进一步的安全,由于 maimai-prober 开源,您也可以自行搭建它。
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# 账号迁移说明
2+
3+
UsagiPass 与 兔卡账号 已完成深度融合升级,现统一更名为 UsagiLab 账号。
4+
5+
您的账号将发生以下变化:
6+
7+
1. 原 UsagiCard 账号直接变为 UsagiLab 账号。可以使用账号和密码登录。
8+
2. 原 UsagiPass 账号也会变成 UsagiLab 账号,但首次只能使用第三方登录。
9+
3. 原 UsagiPass 账号第三方登录后,将要求完善账号信息,完善后即可使用任意方式登录。
10+
11+
您的数据将发生以下变化:
12+
13+
1. 原有图片、个性化设置将保留。
14+
2. 原有的落雪查分器 Personal-Token 将保留,但水鱼查分器 Import-Token 需要重新绑定。
15+
16+
如果您同时拥有 UsagiPass 和 兔卡账号:
17+
18+
- 我们添加了账号合并功能。任意登录一个账号后,进入设置,点击头像后方的三个点进入菜单,选择账号合并即可。
19+
- 关于账号合并的更多信息,请进入账号合并页面查看详细说明。

docs/notifications/account-system.md

Lines changed: 0 additions & 9 deletions
This file was deleted.

0 commit comments

Comments
 (0)