i18n

星标12

分支0

更新时间2026年7月21日 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.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

来源

2017YANR02

2017YANR02/cuberoot.me

打开 GitHub 仓库查看创作者相关仓库

下载

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}} 两边都要有。

同仓库更多 Skills

同仓库

comp-names-zh

2017YANR02/cuberoot.me

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".

2026-07-3112

theme-tokens

2017YANR02/cuberoot.me

Use when writing/editing CSS color values, backgrounds, borders, text colors, or dark/light theme behavior. shadcn-style token system + color-mix derivations + dark-locked page list. Triggers: "颜色", "color", "background", "background-color", "border", "text color", "--background", "--foreground", "--muted", "--accent", "dark mode", "light mode", "theme", "主题", "暗色", "深色", "dark/light", "shadcn", "hex", "rgba", "color-mix", "#888", "#aaa", "#fff", "prefers-color-scheme", "data-theme".

2026-07-3012

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-3012

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-2612

alg-admin-api

2017YANR02/cuberoot.me

Use when AI/脚本管理 alg DB (create/update/del/reorder/batch-validate/dedup) 免 OAuth。X-Admin-Key 通道 + 4 个 admin endpoints + 直 SQL playbook。Triggers: "alg admin", "X-Admin-Key", "reorder cases", "del alg case", "alg dup", "批量校验 alg", "AdminCaseEditor", "alg_cases SQL".

2026-07-2612

new-substep-solver

2017YANR02/cuberoot.me

用户要造一个新求解器时用。**先分流**:3x3 子阶段 / 大状态空间(需 Rust+WASM+大表+真题统计管道)= 范本 block222,完整流程 solver/VARIANT_PLAYBOOK.md;非 WCA 小状态整解(可整枚举,如枫叶 Ivy 29,160 态)= 纯 TS 全 BFS,**不碰 Rust/WASM/管道**,范本 packages/client/lib/ivy-solver.ts(见正文 §0)。Triggers: "造个 X 求解器", "新求解器", "枫叶魔方求解器", "ivy 求解器", "非 wca 求解器", "小魔方求解器", "roux s1 求解器", "eoline 求解器", "petrus 求解器", "new substep solver", "加一个 step solver", "块求解器", "新变体", "new variant solver".

2026-07-2612

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}} 两边都要有。