---
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**。

```ts
formatWcaResult(value, eventId, 'single' | 'average', opts?)
formatWcaResultK(value, eventId, 0 | 1, opts?)   // kind 是 0/1 的 caller (rank tables / H2H)
```

`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` 表格。