| name | wca-format-result |
| description | Use when raw WCA result value (centiseconds/FMC/MBLD encoding) → display string. Single entry: utils/wca_format_result.ts. Triggers: "WCA 成绩", "成绩格式化", "formatWcaResult", "centiseconds", "FMC", "MBLD", "333mbf", "333fm", "DNF", "DNS", "0.28", "33.00", "slice(1,3)", "padStart(10", 渲染 WCA 成绩 / 纪录值 / PR / 比赛纪录. |
WCA 成绩值格式化
唯一入口：core/packages/client/lib/wca-format-result.ts。任何把 raw WCA 数值变字符串的地方都走它,不要再手写 (v/100).toFixed(2) 或对 MBLD 数字做 slice。
formatWcaResult(value, eventId, 'single' | 'average', opts?)
formatWcaResultK(value, eventId, 0 | 1, opts?)
opts:fmcAverage: 'decimal'|'rounded'、zero: 'dash'|'empty'、failure: 'dnf'|'dash'。
WCA 编码雷区(选错一个就全错)
- DNF=
-1 / DNS=-2 / no result=0(不是 null)
- 时间项:centiseconds,8653 = 1:26.53
- FMC single = 整数 moves(不是 cs!),FMC average =
moves × 100
- MBLD 两种编码,按数值大小分流(≥1e9=旧、<1e9=新),不是按 event id!
333mbo 历史里两种都有(同一行 attempts 都能混),按 event 强解旧格式 → 24/8 这种 solved>attempted 的鬼值。333mbf 也走同一磁分流。逻辑见 formatMbld,与 stats-build/src/core/solve_time.ts 一致
- 新格式
DDTTTTTMM(<1e9):missed=末2、TTTTT=中5、diff=99-DD,solved=diff+missed,attempted=solved+missed
- 旧格式
1SSAATTTTT(≥1e9):solved=99-SS、attempted=AA、TTTTT=秒(99999=未知)
Top10 图表轴刻度走另一个
lib/top10-axis.ts 的 tickLabel / axisFor —— 简洁版(整秒、FMC avg 不带小数),专供 Top10 历史图。其他场景一律 formatWcaResult。
不要做的事
- 手写
if (eventId === '333fm') (v/100).toFixed(2) —— 漏 single/average 区分(就是 H2H 之前的 bug:0.28 应该是 28)
- 自己 padStart + slice MBLD —— slice(0,2) 错位 bug(format_result.ts 历史教训)
- 假定 WCA results API attempts 是 cs —— FMC attempts 是 raw moves(
fetchAttempts 现有 /100 对 FMC 错,记一笔不是这 skill 的范围)
已经按规矩做的参考
PersonDetailPage PR 表 / UpcomingCompsPage 纪录列表 / Top10HistoryPage bar list / H2HMode 表格。
