i18n

Stars12

Forks0

UpdatedJuly 21, 2026 at 07:41

Use when adding/editing user-visible text in the React client (core/packages/client). 站点只服 en + zh-Hans(简体);繁体已移除。文案统一走 tr({en,zh}) / <T en zh /> / useT() 的 t(zh,en) / t('ns.key')+en.json/zh.json。禁内联 isZh/i18n.language 文案三元(CI ratchet + PreToolUse hook 双守)。右上角 lang+theme 用 <HeaderToggles />。Triggers: "中英双语", "双语", "i18n", "translate", "翻译", "add Chinese/English", "isZh", "tr(", "useT", "LangToggle", "HeaderToggles", "主题切换", "右上角", "en.json", "zh.json", "useTranslation", new page, new user-facing string.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

2017YANR02

2017YANR02/cuberoot.me

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name

i18n

description

i18n（core/packages/client，主工作区）

站点只服 en + zh-Hans(简体)。繁体(zh-Hant)2026-06-14 已彻底移除,源码禁写任何繁体字。

四种合法写法（按场景挑）

tr({ en, zh }) → string,@/i18n/tr。行内短文案首选(组件内/外都能用,读全局 i18n.language)。
<T en={…} zh={…} /> → ReactNode,@/i18n/tr。分支含 JSX(<strong>/<TeX>/链接)时用。
const t = useT(); t(zh, en) → @/hooks/useT。组件内一个变量重复多段文案时省 tr({}) 噪音。
t('ns.key') + i18n/en.json & i18n/zh.json → 跨页复用 / {{var}} 插值 / 长列表。两文件 key 必须一一对应(CI i18n-removal-guard 守)。
双语数据对象 { en, zh } → 直接 tr(obj)。

禁区(以后的 AI 强制遵守)

禁内联 UI 语言文案三元:isZh ? '中文' : 'English'、i18n.language.startsWith('zh') ? x.zh : x.en、i18n.language === 'zh' ? <>…</> : <>…</> 一律改走上面四种。双层守卫:写入即拦 PreToolUse hook(.claude/hooks/block-handwritten-trad.ps1 → core/packages/client/scripts/hook-detect-traditional.mjs)+ CI ratchet tests/i18n-no-isz-text-ternary.test.ts(全局语言文案三元计数只降不升;迁移后把 BASELINE 调低)。
禁单语裸字(切语言会断)、禁繁体字(hook + tests/i18n-removal-guard.test.ts)。

唯一允许的 isZh:函数参数(util 契约)

非组件模块(lib/ util / store)需要语言时,把 isZh(或 lang)当参数传进 —— 这是函数契约,不是内联文案三元,合法且不计入 ratchet。例:displayCuberName(name, isZh)。
但 util 若产可见文案,优先返回 { en, zh } 让调用方 tr(),而不是内部 isZh ? '中' : 'en'。
组件内取语言:const isZh = i18n.language.startsWith('zh') 仅用于非文案逻辑(字号/locale code/选数据);一旦右边是文案就必须 tr()/<T>。

右上角切换器 / 链接

lang + theme 一律 <HeaderToggles className="…" />(@/components/HeaderToggles,自带布局);禁手写 <LangToggle /> <ThemeToggle /> 配 wrapper。className 只传定位。
站内跳转用 @/components/AppLink(Pattern B:en 出裸 URL、zh 补 /zh),禁裸 next/link 手拼 lang 前缀。

魔方术语(termbase)

zh 魔方术语唯一权威 = app/[lang]/wiki/glossary.json(713+ 条社区中英对照)。写含魔方术语的 zh 文案先 grep 它(结构化字段 headZh/bodyZh = 权威译法),禁按通用语感直译。
glossary.json 是 DB 导出,非手改:真源 = PG wiki_terms(结构化 head_en/head_zh/body_en/body_zh);词条在 /wiki 页登录后用 en/zh 双框编辑,改完跑 pnpm --filter @cuberoot/server gen-glossary 重导出(手改会被覆盖)。首页全站搜索(lib/site-search.ts)运行时 import 它。
高频陷阱:Overwork=复用;Corner Cutting=容错;Commutator=换位子;Conjugate=共轭子;Finger Trick=指法;Lookahead=预判;Regrip=换手;POP=飞棱;Buffer=缓冲块;Inspection=观察;OLL/PLL Skip=跳O/跳P;Scramble/Setup=打乱;Extra scrambles=备打(UI 简称);Alg=公式;Xcross=拓展十字。
方法名:Roux=桥式(FB=左桥,SB=右桥,Last Pair=末槽);LBL=层先法;Petrus=彼得鲁斯法;CFOP/ZZ/DR/EOLR/CMLL/LSE 留原名。zh UI 落中文名。
守卫:CI tests/i18n-cubing-term-blacklist.test.ts(已修错译黑名单,发现新错译修完即加入);豁免行内 allow-cubing-term: <理由>;外部作品原标题《…》自动豁免。

命名空间

看 i18n/en.json 顶层。复用优先 common.*(loading / back / loadFailed / unknownError / cases)。新 t() 键必须同时进 en.json + zh.json,{{x}} 两边都要有。

More from this repository

same repository

sim-add-puzzle

2017YANR02/cuberoot.me

给 /sim 加一个新魔方「模拟器」=站内 3D 渲染 + 转角动画 + 拖拽转动的新「类型」(不是一次性 HTML 页面)。当用户说"造某某魔方模拟器""给 /sim 加 X 魔方""新魔方类型""X cube simulator"时用。覆盖 SQ1/Ivy 模板契约、必改文件、Three.js 几何、拖拽转动(raycast+方向)、招式对接 solver、必踩的坑。区分:造"求解器"引擎走 skill new-substep-solver;本 skill 只管 /sim 的渲染+动画+交互集成。Triggers "造魔方模拟器", "造X魔方模拟器", "枫叶魔方模拟器", "给 /sim 加魔方", "sim 加魔方", "新魔方类型", "add puzzle to sim", "X cube simulator", "/sim 新增魔方", "魔方模拟器", "sim 拖拽转动".

2026-07-2512

benchmark-sites

2017YANR02/cuberoot.me

Use when user asks how mainstream/major sites or '业界/大厂' handle something (i18n、SEO/路由、定价、某 UX 模式、某功能) and expects AI to already know which sites to check. 按用途从下表挑 6-10 个,跨「巨头 + 本站近邻(开发者工具/SaaS/AI)」两类,然后亲自 WebFetch/WebSearch 核实再下结论,禁凭记忆。Triggers: "主流网站", "大厂", "业界怎么做", "别的网站怎么做", "对标", "benchmark", "mainstream sites", "how do big sites", "industry standard".

2026-07-1512

update-scramble-stats

2017YANR02/cuberoot.me

用户要更新 /scramble/stats(打乱难度 / 步数分布)的数据时执行本地手动增量刷新管道(按需触发,非定时)。覆盖三阶阶段难度(十字/F2L/EO/DR 等)+ 非 3x3 整解最优步数(二阶/金字塔/斜转/SQ1)+ 三阶整解最优 HTM(333 方法,cubeopt WASM,solver/333opt)三条管道。只能本地跑(三阶需 solver 34GB 表 / 333 需 cubeopt 表)。Triggers: "更新统计", "更新打乱统计", "重跑打乱统计", "更新打乱分布", "更新打乱难度", "update scramble stats", "全部刷新统计", "更新十字统计", "重跑十字统计", "跑十字管道", "更新 puzzle 统计", "更新二阶/金字塔/斜转统计", "更新 sq1 统计", "更新 SQ1 统计", "更新 sq1 分布", "刷新 sq1 精确分布", "sq1 精确分布", "sq1 精确档", "跑SQ1怪物", "跑 sq1 怪物", "啃怪物", "啃 sq1 怪物", "sq1 怪物", "grind sq1 monsters", "补 xcross 变体", "双色底 10f xcross", "backfill_xcross_variant", "pseudo_f2leo 回填", "难打乱补变体", "更新333统计", "更新 333 统计", "更新 333 整解统计", "333 整解最优", "333 HTM 分布", "333opt".

2026-07-1212

timeline-update

2017YANR02/cuberoot.me

Use when user wants to fill in /code/architecture 第 11 节的日历 + 列表 — 从 JSON 最后一条日期之后开始, 把每个有 commit 的日子补上中英 1 行总结 (日历); 每个新页面/路由上线都加进 TIMELINE 数组 (列表)。Triggers: "/timeline-update", "更新 timeline", "补日历", "补 timeline", "update commit calendar".

2026-07-0312

wca-format-result

2017YANR02/cuberoot.me

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 / 比赛纪录.

2026-06-3012

update-regulation

2017YANR02/cuberoot.me

Use when the user wants to add, rewrite, or refresh a chapter of the illustrated WCA Regulations guide at /regulation (hub + one page per chapter), OR when acting on a `regulation-drift` GitHub issue / the monthly drift check (official WCA regs changed). The user typically says "更新规则" then names the chapter(s) (e.g. 第十二章转动表示方法 / 第四章打乱 / Article 9 Events / Appendix B 盲拧). Covers: the sync/drift system (reg:check snapshot diff + the regulation_drift CI issue), the per-chapter full-clause data layer (reg:clauses + FullClauses), locating the chapter slug, fetching + paraphrasing the official article bilingually, building the page on the shared scaffold, the visualization toolkit, and the strict zh-Hant generator recipe. Triggers: "更新规则", "更新規則", "/update-regulation", "加规则章节", "刷新规则页", "改规则页", "WCA 规则页", "regulation 章节", "第N章规则", "规则漂移", "regulation-drift", "reg:check", "reg:clauses", "完整条款", "update regulation", "add regulation chapter", "regulation page", "/regulation".

2026-06-2912

name

i18n

description

i18n（core/packages/client，主工作区）

站点只服 en + zh-Hans(简体)。繁体(zh-Hant)2026-06-14 已彻底移除,源码禁写任何繁体字。

四种合法写法（按场景挑）

tr({ en, zh }) → string,@/i18n/tr。行内短文案首选(组件内/外都能用,读全局 i18n.language)。
<T en={…} zh={…} /> → ReactNode,@/i18n/tr。分支含 JSX(<strong>/<TeX>/链接)时用。
const t = useT(); t(zh, en) → @/hooks/useT。组件内一个变量重复多段文案时省 tr({}) 噪音。
t('ns.key') + i18n/en.json & i18n/zh.json → 跨页复用 / {{var}} 插值 / 长列表。两文件 key 必须一一对应(CI i18n-removal-guard 守)。
双语数据对象 { en, zh } → 直接 tr(obj)。

禁区(以后的 AI 强制遵守)

禁内联 UI 语言文案三元:isZh ? '中文' : 'English'、i18n.language.startsWith('zh') ? x.zh : x.en、i18n.language === 'zh' ? <>…</> : <>…</> 一律改走上面四种。双层守卫:写入即拦 PreToolUse hook(.claude/hooks/block-handwritten-trad.ps1 → core/packages/client/scripts/hook-detect-traditional.mjs)+ CI ratchet tests/i18n-no-isz-text-ternary.test.ts(全局语言文案三元计数只降不升;迁移后把 BASELINE 调低)。
禁单语裸字(切语言会断)、禁繁体字(hook + tests/i18n-removal-guard.test.ts)。

唯一允许的 isZh:函数参数(util 契约)

非组件模块(lib/ util / store)需要语言时,把 isZh(或 lang)当参数传进 —— 这是函数契约,不是内联文案三元,合法且不计入 ratchet。例:displayCuberName(name, isZh)。
但 util 若产可见文案,优先返回 { en, zh } 让调用方 tr(),而不是内部 isZh ? '中' : 'en'。
组件内取语言:const isZh = i18n.language.startsWith('zh') 仅用于非文案逻辑(字号/locale code/选数据);一旦右边是文案就必须 tr()/<T>。

右上角切换器 / 链接

lang + theme 一律 <HeaderToggles className="…" />(@/components/HeaderToggles,自带布局);禁手写 <LangToggle /> <ThemeToggle /> 配 wrapper。className 只传定位。
站内跳转用 @/components/AppLink(Pattern B:en 出裸 URL、zh 补 /zh),禁裸 next/link 手拼 lang 前缀。

魔方术语(termbase)

zh 魔方术语唯一权威 = app/[lang]/wiki/glossary.json(713+ 条社区中英对照)。写含魔方术语的 zh 文案先 grep 它(结构化字段 headZh/bodyZh = 权威译法),禁按通用语感直译。
glossary.json 是 DB 导出,非手改:真源 = PG wiki_terms(结构化 head_en/head_zh/body_en/body_zh);词条在 /wiki 页登录后用 en/zh 双框编辑,改完跑 pnpm --filter @cuberoot/server gen-glossary 重导出(手改会被覆盖)。首页全站搜索(lib/site-search.ts)运行时 import 它。
高频陷阱:Overwork=复用;Corner Cutting=容错;Commutator=换位子;Conjugate=共轭子;Finger Trick=指法;Lookahead=预判;Regrip=换手;POP=飞棱;Buffer=缓冲块;Inspection=观察;OLL/PLL Skip=跳O/跳P;Scramble/Setup=打乱;Extra scrambles=备打(UI 简称);Alg=公式;Xcross=拓展十字。
方法名:Roux=桥式(FB=左桥,SB=右桥,Last Pair=末槽);LBL=层先法;Petrus=彼得鲁斯法;CFOP/ZZ/DR/EOLR/CMLL/LSE 留原名。zh UI 落中文名。
守卫:CI tests/i18n-cubing-term-blacklist.test.ts(已修错译黑名单,发现新错译修完即加入);豁免行内 allow-cubing-term: <理由>;外部作品原标题《…》自动豁免。

命名空间

看 i18n/en.json 顶层。复用优先 common.*(loading / back / loadFailed / unknownError / cases)。新 t() 键必须同时进 en.json + zh.json,{{x}} 两边都要有。