Repository navigation
Expand file tree
/
Copy pathaccountService.ts
More file actions
626 lines (582 loc) · 16.2 KB
/
Copy pathaccountService.ts
File metadata and controls
626 lines (582 loc) · 16.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
import { invoke } from '@tauri-apps/api/core';
import logger, { logError } from "./logger";
import { trackStartupTask } from "@/utils/startupProgress";
import {
clearAccountUnavailable,
reasonFromApiKind,
setAccountUnavailable,
} from "./accountAvailability";
import type { ApiHealthSnapshot } from "./crashReporting";
/**
* 角色所属游戏。
*
* 与后端 `models::role::GAME_*` 常量、`AccountInfo.game` / `RoleDisplayInfo.game` 同源:
* - `endfield`:《明日方舟:终末地》,有 `/api/v1/game/endfield/card/detail` 详情接口
* - `arknights`:《明日方舟》,**没有**对应的详情接口,昵称/等级只来自森空岛绑定接口
*/
export type GameId = "endfield" | "arknights";
/**
* 账户信息接口
*/
export interface Account {
id: string;
avatar: string;
nickname: string;
level: number;
server: string;
status: 'online' | 'offline' | 'loading';
syncStatus?: 'SYNCING' | 'FAILED' | 'HYTOKEN_EXPIRED' | null; // 同步状态
cred?: string;
token?: string;
userId?: string;
serverId?: string;
/** 所属游戏(老缓存缺该字段时按终末地处理) */
game?: GameId;
}
export interface SklandAccount {
userId: string;
gameRoleCount: number;
/** 已缓存的森空岛昵称(未获取过时为空) */
nickname?: string;
/** 已缓存的森空岛头像地址(未获取过时为空) */
avatar?: string;
/** 首次登录时记录的手机号(用于重新登录自动填充) */
phone?: string;
}
/**
* 森空岛用户在单个游戏下的等级/积分
*/
export interface SklandGameScore {
gameId: number;
level: number;
iconUrl: string;
darkModeIconUrl: string;
checkedDays: number;
score: number;
gameName: string;
levelUrl: string;
}
/**
* 森空岛头像挂件
*/
export interface SklandPendant {
id: number;
iconUrl: string;
title: string;
description: string;
}
/**
* 森空岛个人主页背景
*/
export interface SklandBackground {
id: number;
url: string;
resourceKind: number;
}
/**
* 森空岛社区互动数据(接口以字符串返回数值)
*/
export interface SklandUserStats {
liked: string;
collect: string;
comment: string;
follow: string;
fans: string;
black: string;
pub: string;
}
/**
* 森空岛游戏基础信息(GET /web/v1/game)
*/
export interface SklandGameInfo {
gameId: number;
name: string;
iconUrl: string;
backgroundUrl: string;
}
/**
* 森空岛用户资料(GET /web/v1/user)
*/
export interface SklandUserInfo {
id: string;
nickname: string;
profile: string;
avatar: string;
avatarCode: number;
backgroundCode: number;
isCreator: boolean;
status: number;
operationStatus: number;
identity: number;
kind: number;
latestIpLocation: string;
moderatorStatus: number;
moderatorChangeTime: number;
gender: number;
birthday: string;
hgId: string;
showId: string;
scoreInfoList: SklandGameScore[];
pendant?: SklandPendant;
stats?: SklandUserStats;
background?: SklandBackground;
}
/**
* 角色展示信息接口
*/
export interface RoleDisplayInfo {
roleId: string;
userId: string;
serverId: string;
nickname: string;
level: number;
avatarUrl: string;
/**
* 角色所属游戏(老数据缺该字段时按终末地处理)。
*
* 明日方舟角色**没有头像**(后端不请求终末地的详情接口),前端要用首字母占位,
* 并且不能拿它去查终末地的角色数据。
*/
game?: GameId;
/**
* 该角色所属的**渠道绑定 uid**(官服 / B 服各一个)。
* 抽卡令牌按它换取,官服与 B 服因此能各拿各的令牌。
*/
bindingUid?: string;
/** 渠道主 ID(1 = 官服,2 = B 服),仅用于展示 */
channelMasterId?: string;
/** 渠道名(来自绑定接口 `channelName`),仅用于展示 */
channelName?: string;
/** 该角色是否已授权抽卡数据访问(纯开关,不含凭据) */
u8Authorized?: boolean;
}
/**
* 按角色授权抽卡数据的结果
*
* - `authorized`:已验证该角色能换到抽卡令牌,授权已记下(令牌不落盘,每次同步现换)
* - `failed`:换取失败,通常是通行证未绑定该渠道或 hytoken 已过期
*/
export type RoleU8AuthStatus = "authorized" | "failed";
export interface RoleU8AuthResult {
status: RoleU8AuthStatus;
message?: string;
}
/**
* 登录请求接口
*/
export interface LoginRequest {
phone: string;
password: string;
/** 重新登录时用于校验登录结果是否为目标森空岛账户 */
expectedUserId?: string;
}
/**
* 登录结果接口
*/
export interface LoginResult {
success: boolean;
errorMessage?: string;
account?: Account;
availableRoles?: RoleDisplayInfo[];
cred?: string;
token?: string;
userId?: string;
}
/**
* 刷新结果接口
*/
export interface RefreshResult {
success: boolean;
errorMessage?: string;
accounts: Account[];
refreshTime: string;
}
/**
* 发送验证码请求接口
*/
export interface SendCodeRequest {
phone: string;
type: number;
}
/**
* 验证码登录请求接口
*/
export interface CodeLoginRequest {
phone: string;
code: string;
/** 重新登录时用于校验登录结果是否为目标森空岛账户 */
expectedUserId?: string;
}
/**
* 扫码登录信息接口
*/
export interface ScanLoginInfo {
scanId: string;
scanUrl: string;
}
/**
* 扫码登录状态接口
*/
export interface ScanStatus {
status: number;
scanCode?: string;
msg?: string;
}
/**
* 获取所有账户
*
* 后端 `get_accounts` 内部会捕获 API 失败并返回告警账户,因此这里不在成功时清除
* 账户不可用状态(避免「熔断期间刷新一次就误判为已恢复」);恢复由
* `applyApiHealthSnapshot`(后端熔断已解除)、重新登录成功或显式重试驱动。
* @returns 账户列表
*/
export async function getAccounts(): Promise<Account[]> {
try {
return await trackStartupTask(invoke<Account[]>('get_accounts'));
} catch (error) {
logError('Failed to get accounts:', error);
setAccountUnavailable('unknown', String(error));
return [];
}
}
export async function getSklandAccounts(): Promise<SklandAccount[]> {
try {
return await invoke('get_skland_accounts');
} catch (error) {
logError('Failed to get Skland accounts:', error);
return [];
}
}
export async function saveSklandAccount(
cred: string,
token: string,
userId: string,
): Promise<boolean> {
try {
return await invoke('save_skland_account', { cred, token, userId });
} catch (error) {
logError('Failed to save Skland account:', error);
return false;
}
}
export async function getSklandAccountRoles(userId: string): Promise<LoginResult> {
try {
return await invoke('get_skland_account_roles', { userId });
} catch (error) {
logError('Failed to get Skland account roles:', error);
return { success: false, errorMessage: String(error) };
}
}
/**
* 获取森空岛账户的用户资料(昵称、头像、游戏等级/积分、社区互动数据)
* @param userId 森空岛用户 ID
* @returns 用户资料
*/
export async function getSklandUserInfo(userId: string): Promise<SklandUserInfo> {
return await invoke('get_skland_user_info', { userId });
}
/**
* 获取森空岛游戏列表(游戏图标等基础信息,后端带缓存)
* @param userId 用于鉴权的森空岛用户 ID
* @param force 是否强制刷新缓存
* @returns 游戏列表
*/
export async function getSklandGames(
userId: string,
force: boolean = false,
): Promise<SklandGameInfo[]> {
return await invoke('get_skland_games', { userId, force });
}
/**
* 添加账户(登录)
* @param loginRequest 登录请求(手机号和密码)
* @returns 登录结果
*/
export async function addAccount(loginRequest: LoginRequest): Promise<LoginResult> {
try {
const result = await invoke<LoginResult>('add_account', { loginRequest });
if (result.success) clearAccountUnavailable();
return result;
} catch (error) {
logError('Failed to add account:', error);
return {
success: false,
errorMessage: String(error),
account: undefined,
};
}
}
/**
* 登出单个账户
* @param accountId 账户ID
* @param keepDeviceToken 是否保留设备认证(保留则下次密码登录跳过新设备验证)
* @returns 是否成功
*/
export async function logoutAccount(
accountId: string,
keepDeviceToken: boolean = true,
): Promise<boolean> {
try {
return await invoke('logout_account', { accountId, keepDeviceToken });
} catch (error) {
logError('Failed to logout account:', error);
return false;
}
}
/**
* 批量登出账户
* @param accountIds 账户ID列表
* @returns 是否成功
*/
export async function batchLogout(accountIds: string[]): Promise<boolean> {
try {
return await invoke('batch_logout', { accountIds });
} catch (error) {
logError('Failed to batch logout:', error);
return false;
}
}
/**
* 刷新账户数据
* @returns 刷新结果
*/
export async function refreshAccounts(): Promise<RefreshResult> {
try {
return await invoke<RefreshResult>('refresh_accounts');
} catch (error) {
logError('Failed to refresh accounts:', error);
setAccountUnavailable('unknown', String(error));
return {
success: false,
errorMessage: String(error),
accounts: [],
refreshTime: new Date().toISOString(),
};
}
}
// 别名导出,兼容前端代码的旧命名
export const refreshAccountData = refreshAccounts;
export const batchLogoutAccounts = batchLogout;
/**
* 发送验证码
* @param request 发送验证码请求
* @returns 是否成功
*/
export async function sendVerificationCode(request: SendCodeRequest): Promise<boolean> {
try {
return await invoke('send_verification_code', { request });
} catch (error) {
logError('Failed to send verification code:', error);
return false;
}
}
/**
* 通过验证码添加账户
* @param loginRequest 验证码登录请求
* @returns 登录结果
*/
export async function addAccountByCode(loginRequest: CodeLoginRequest): Promise<LoginResult> {
try {
const result = await invoke<LoginResult>('add_account_by_code', { loginRequest });
if (result.success) clearAccountUnavailable();
return result;
} catch (error) {
logger.error('Failed to add account by code: ' + error, "AccountService");
return {
success: false,
errorMessage: String(error),
account: undefined,
};
}
}
/**
* 生成扫码登录二维码
* @returns 扫码登录信息(scanId 和 scanUrl)
*/
export async function genScanLogin(): Promise<ScanLoginInfo | null> {
try {
return await invoke('gen_scan_login');
} catch (error) {
logError('Failed to generate scan login:', error);
return null;
}
}
/**
* 查询扫码登录状态
* @param scanId 扫码登录 ID
* @returns 扫码登录状态
*/
export async function scanStatus(scanId: string): Promise<ScanStatus | null> {
try {
return await invoke('scan_status', { scanId });
} catch (error) {
logError('Failed to get scan status:', error);
return null;
}
}
/**
* 通过扫码添加账户
* @param scanCode 扫码登录成功后返回的扫描码
* @param expectedUserId 重新登录时要求登录到该森空岛账户,授权账号不一致时后端拦截
* @returns 登录结果
*/
export async function addAccountByScan(
scanCode: string,
expectedUserId?: string,
): Promise<LoginResult> {
try {
const result = await invoke<LoginResult>('add_account_by_scan', {
scanCode,
expectedUserId: expectedUserId ?? null,
});
if (result.success) clearAccountUnavailable();
return result;
} catch (error) {
logger.error('Failed to add account by scan: ' + error, "AccountService");
return {
success: false,
errorMessage: String(error),
account: undefined,
};
}
}
/**
* 校验并同步账户可用性快照(供前端调用 `get_api_health` 后使用)
*
* 账户数据获取频繁失败时,应用照常进入,但账户页会显示「账号不可用」,
* 并区分是登录凭证失效还是数美设备指纹异常(需要重启电脑并同步时区)。
* 后端熔断已解除(`blocked=false`)时清除不可用状态。
*/
export function applyApiHealthSnapshot(snapshot: ApiHealthSnapshot | null | undefined): void {
if (!snapshot) return;
if (!snapshot.blocked) {
clearAccountUnavailable();
return;
}
setAccountUnavailable(
reasonFromApiKind(snapshot.kind),
snapshot.message ?? "",
);
}
/**
* 用刚登录得到的 cred/token 读取森空岛用户资料(确认绑定页面展示头像/昵称)
* @param cred 刚登录得到的凭证
* @param token 刚登录得到的令牌
*/
export async function getSklandUserInfoByCred(
cred: string,
token: string,
): Promise<SklandUserInfo | null> {
try {
return await invoke<SklandUserInfo>('get_skland_user_info_by_cred', { cred, token });
} catch (error) {
logError('Failed to get Skland user info by cred:', error);
return null;
}
}
/**
* 保存用户选择的角色
* @param cred 凭证
* @param token 令牌
* @param userId 用户ID
* @param selectedRoles 选中的角色列表
* @returns 创建的账户列表
*/
export async function saveSelectedRoles(
cred: string,
token: string,
userId: string,
selectedRoles: RoleDisplayInfo[]
): Promise<Account[]> {
try {
return await invoke('save_selected_roles', { cred, token, userId, selectedRoles });
} catch (error) {
logger.error('Failed to save selected roles: ' + error, "AccountService");
throw error;
}
}
/**
* 获取当前选中的账户 ID
* @returns 选中的账户 ID
*/
export async function getSelectedAccount(): Promise<string | null> {
try {
return await trackStartupTask(invoke<string | null>('get_selected_account'));
} catch (error) {
logger.error('Failed to get selected account: ' + error, "AccountService");
return null;
}
}
/**
* 设置当前选中的账户 ID
* @param accountId 账户 ID
* @returns 是否成功
*/
export async function setSelectedAccount(accountId: string): Promise<boolean> {
try {
return await invoke('set_selected_account', { accountId });
} catch (error) {
logger.error('Failed to set selected account: ' + error, "AccountService");
return false;
}
}
/**
* 彻底删除一个森空岛账户(父账户 + 全部角色绑定 + 全部凭据)
*
* 与 `logoutAccount` 的区别:后者只解绑**单个角色**、保留父账户与凭据。
* 删除只作用于本机,不会去鹰角/森空岛注销任何东西。
*
* @param userId 森空岛用户 ID
* @returns 是否确实删除成功
*/
export async function deleteSklandAccount(userId: string): Promise<boolean> {
try {
return await invoke<boolean>('delete_skland_account', { userId });
} catch (error) {
logError('Failed to delete Skland account:', error);
return false;
}
}
/**
* 检查并刷新指定用户的 cred
* @param userId 用户 ID
* @returns 新的 cred 和 token(如果刷新了),或 null(如果无需刷新)
*/
export async function checkAndRefreshCred(userId: string): Promise<[string, string] | null> {
try {
return await invoke('check_and_refresh_cred', { userId });
} catch (error) {
logger.error('Failed to check and refresh cred: ' + error, "AccountService");
throw error;
}
}
/**
* 为某个角色授权 / 取消授权抽卡数据访问
*
* 授权只记一个开关,**不保存任何令牌**:u8token 生命周期很短,每次同步现换。
* 官方服与渠道服走同一条链路、同一个 hytoken,差异只在渠道绑定 uid,
* 因此渠道服角色同样可以直接授权。
*
* @param roleId 角色 ID
*/
export async function authorizeRoleU8Token(roleId: string): Promise<RoleU8AuthResult> {
try {
return await invoke<RoleU8AuthResult>('authorize_role_u8token', { roleId });
} catch (error) {
logError('Failed to authorize gacha access:', error);
return { status: 'failed', message: String(error) };
}
}
/**
* 取消某个角色的 u8token 授权
* @param roleId 角色 ID
* @returns 是否确实删掉了授权
*/
export async function revokeRoleU8Token(roleId: string): Promise<boolean> {
try {
return await invoke<boolean>('revoke_role_u8token', { roleId });
} catch (error) {
logError('Failed to revoke u8token:', error);
return false;
}
}