freeguy2006's picture
feat(insane): 支援極難難度戰績回報與後端 Replay 驗證
67057ab
Raw History Blame Contribute Delete
4.72 kB
/**
* 遊客本機統計:未登入時存這台瀏覽器;與帳號的權威統計分離、不互相污染。
*
* applyRunToStats 是「不碰 localStorage 的純聚合函式」(與後端 applyRun 規則相同),
* 把 I/O 與邏輯分開 → 聚合與相容兜底都能用單元測試保護(web 端這份是獨立實作,server 測試不覆蓋)。
*/
import type { RunSummary } from "@wcg/battle-core";
import type { OnlineRunReport, RunRecord, UserStats } from "./api.js";
export const GUEST_STATS_KEY = "wcg.guestStats";
export function emptyStats(): UserStats {
return { plays: 0, clears: 0, peakAtk: 0, peakDef: 0, maxReachedStage: 0, maxStageByMode: {}, totalTurns: 0, classPlays: {}, recentClasses: [], runs: [] };
}
/** 「敵人×難度」統計 key:normal=campaign;hard=加 :hard;insane=加 :extreme。與後端 stageModeKey 一致。 */
export function stageModeKey(campaign: string, hardMode?: boolean, extreme?: boolean): string {
if (extreme) return `${campaign}:extreme`;
return hardMode ? `${campaign}:hard` : campaign;
}
/** 把一場 RunSummary 聚合進統計(純函式;規則與後端 applyRun 相同)。 */
export function applyRunToStats(prevIn: UserStats, s: RunSummary, nowIso: string): UserStats {
// 與後端 applyRun 一致:先用 emptyStats() 補齊舊資料可能缺的欄位(recentClasses/runs/…),避免 spread undefined。
const prev = { ...emptyStats(), ...prevIn };
return {
plays: prev.plays + 1,
clears: prev.clears + (s.cleared ? 1 : 0),
peakAtk: Math.max(prev.peakAtk, s.peakAtk),
peakDef: Math.max(prev.peakDef, s.peakDef),
maxReachedStage: s.cleared ? prev.maxReachedStage : Math.max(prev.maxReachedStage, s.reachedStage),
// 各敵人×難度的最高 Stage(含破關),普通/困難分開累積。
maxStageByMode: (() => {
const prevStage = prev.maxStageByMode ?? {};
const k = stageModeKey(s.campaign, s.hardMode, s.extreme);
return { ...prevStage, [k]: Math.max(prevStage[k] ?? 0, s.reachedStage) };
})(),
totalTurns: prev.totalTurns + s.turns,
// 動態累加:以 classType 為 key 累加 → 日後新增職業不必改這裡。
classPlays: { ...prev.classPlays, [s.classType]: (prev.classPlays[s.classType] ?? 0) + 1 },
// 最近 100 場職業(環形緩衝,最新在尾)→ 算「前 100 場最常使用職業」。
recentClasses: [...prev.recentClasses, s.classType].slice(-100),
// 逐場紀錄(只留最近 100 場)→ 統計頁「遊玩紀錄」彈窗。
runs: [...(prev.runs ?? []), { ...s, at: nowIso }].slice(-100),
lastPlayedAt: nowIso,
};
}
/** 讀遊客統計;以 emptyStats 兜底:舊版本缺欄位(如新加的 totalTurns)→ 補預設、不會是 undefined。 */
export function loadGuestStats(): UserStats {
try {
const raw = localStorage.getItem(GUEST_STATS_KEY);
if (raw) {
const parsed: unknown = JSON.parse(raw);
// 僅接受純物件(防被竄改成陣列/字串/null 時 spread 出畸形 stats)。
if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
return { ...emptyStats(), ...(parsed as Partial<UserStats>) };
}
}
} catch {
/* localStorage 不可用 / 壞 JSON → 用預設 */
}
return emptyStats();
}
/** 聚合一場戰績到遊客統計並寫回本機。 */
export function saveGuestStats(s: RunSummary): UserStats {
const next = applyRunToStats(loadGuestStats(), s, new Date().toISOString());
try {
localStorage.setItem(GUEST_STATS_KEY, JSON.stringify(next));
} catch {
/* 容量/隱私模式 → 略過 */
}
return next;
}
/** 把一場連線(pvp/pve)結果聚合進統計:只進逐場紀錄與職業計數,不污染單人關卡/峰值聚合(與後端 applyOnlineRun 規則相同)。 */
export function applyOnlineRunToStats(prevIn: UserStats, o: OnlineRunReport, nowIso: string): UserStats {
const prev = { ...emptyStats(), ...prevIn };
const rec: RunRecord = { at: nowIso, kind: o.kind, classType: o.classType, cleared: o.cleared, enemyName: o.enemyName };
return {
...prev,
classPlays: { ...prev.classPlays, [o.classType]: (prev.classPlays[o.classType] ?? 0) + 1 },
recentClasses: [...prev.recentClasses, o.classType].slice(-100),
runs: [...(prev.runs ?? []), rec].slice(-100),
lastPlayedAt: nowIso,
};
}
/** 聚合一場連線戰績到遊客統計並寫回本機。 */
export function saveGuestOnlineRun(o: OnlineRunReport): UserStats {
const next = applyOnlineRunToStats(loadGuestStats(), o, new Date().toISOString());
try { localStorage.setItem(GUEST_STATS_KEY, JSON.stringify(next)); } catch { /* 略過 */ }
return next;
}