comp-names-zh

name

comp-names-zh

description

Use when regenerating `stats/comp_names_zh.json`, debugging Chinese comp names, or rendering a competition name anywhere in the UI (must go through `lib/comp-localize.ts`, never raw `c.name`; the year in the name must not duplicate a date shown next to it). Triggers: "中国比赛中文", "localizeCompName", "comp_names_zh", "fetch_comp_names_zh", "比赛名本地化", "stripWcaPrefix", "CompCell", "比赛名年份", "比赛名重复年份", "stripCompYear", "localizeCity", "CITY_ZH".

中国比赛名中文化

前端显示规则全在 core/packages/client/lib/comp-localize.ts 的 JSDoc（localizeCompName / stripWcaPrefix）。新代码渲染比赛名一律走它，禁止裸 c.name。compNameZh() 命中前先 await loadFlagData()。

年份不重复（全站规则，issue #65）

比赛年份已经显示在页面上（同行日期列 / 卡片日期 / 年份分组标题）时，比赛名里就不再出现年号：夹江公开赛2026 + 2026-07-25 → 显示 夹江公开赛。

• 表格 / 列表用 <CompCell … date={comp.start_date} />；date 必填（string | null），逼你表态。
• 其它渲染点 localizeCompName(id, name, isZh, { date })。
• 页面上没写年份的地方（搜索下拉、无日期列的榜单、比赛详情页 H1 与复制名）传 null / 不传 —— 那里年号是唯一的区分信息。
• 唯一实现是 stripCompYear，禁在调用点手写 /\s*20\d\d\s*$/ 之类正则。守卫：写入即拦 .claude/hooks/block-comp-name-year-regex.ps1 + CI tests/comp-year-single-source.test.ts。

数据：stats/comp_names_zh.json

由 core/packages/stats-build/src/bin/fetch_comp_names_zh.ts 生成（在 core/packages/stats-build 下跑）。

npx tsx src/bin/fetch_comp_names_zh.ts           # 全量
npx tsx src/bin/fetch_comp_names_zh.ts --refresh # 增量（清第 1 页 + WCA API 缓存）

• 键同时存 WCA name 和 short_name，值是 cubing.com 中文名。
• 匹配：_alias_to_wca_id_candidates（原始 / 去 "Open" / 去 "Cubing" 前缀）→ 失败回退 start_date + country=CN；强差异老比赛靠 ALIAS_TO_WCA_ID_OVERRIDE 硬编码。
• 缓存目录 .comp_names_zh_cache/（.gitignore）。

爬虫已知坑

• cubing.com 临近开赛会把 URL 从 /competition/ 切到 /live/，scraper 正则两种都要收。
• 日期格式有三种：~DD（同月）/ ~MM-DD（同年跨月）/ ~YYYY-MM-DD（跨年，如 2025-12-31~2026-01-01）—— 正则三种都要兼容。
• WCA API name（全名）vs short_name（短名）必须都作 key，否则 all_past_comps.json（用 name）查不到。
• 页面没更新？看 Deploy Core 是否失败、dist/_assets/*.js 是否含新代码。

城市名（兄弟模块）

lib/city-localize.ts::localizeCity(city, isZh)，新增城市直接往 CITY_ZH 加键。