Skip to content

Commit ff5e867

Browse files
committed
docs: clarify i18n validation loop
1 parent 75f3892 commit ff5e867

1 file changed

Lines changed: 27 additions & 5 deletions

File tree

AGENTS.md

Lines changed: 27 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -80,11 +80,33 @@
8080

8181
- 本项目使用 **Biome** 进行代码格式化与 Lint 检查,使用 pnpm 包管理器。
8282
- 本项目使用 **i18next-cli** 进行国际化字符串的检查和剔除无用键值对。
83-
- 如果涉及国际化字符串的修改或添加,必须使用以下命令进行检查和剔除:
84-
```bash
85-
pnpm i18n:status en-US --hide-translated # 还有 ja-JP 和 zh-TW,不需要 zh-CN
86-
pnpm i18n:sync # 剔除无用键值对
87-
```
83+
- 如果涉及国际化字符串的修改或添加,按以下循环检查并规范 locale 文件:
84+
85+
1. 先运行总览 status:
86+
```bash
87+
pnpm i18n:status
88+
```
89+
90+
2. 如果某个目标语言不是 100%,按需运行对应命令查看缺失项并补全:
91+
```bash
92+
pnpm i18n:status en-US --hide-translated
93+
pnpm i18n:status ja-JP --hide-translated
94+
pnpm i18n:status zh-TW --hide-translated
95+
```
96+
97+
3. 翻译完整后运行:
98+
```bash
99+
pnpm i18n:sync
100+
pnpm i18n:extract
101+
```
102+
103+
4. 因 status 可能漏报 `__MISSING__`,必须额外检查:
104+
```bash
105+
rg "__MISSING__" src/locales
106+
```
107+
108+
5. 若发现缺失翻译或 `__MISSING__`,修复后从第 1 步重新执行,直到全部通过。
109+
88110
- 完成代码修改和国际化字符串检查后,按需验证代码规范和执行类型检查:
89111
```bash
90112
pnpm check # 该指令已经包含了代码格式化、Lint 检查和类型检查

0 commit comments

Comments
 (0)