| name | i18n |
| description | i18n (internationalization) toolkit for projects using i18next. Provides three main functions: (1) i18n-check - Detect hardcoded Chinese text in HTML/JS files, (2) i18n-fix - Replace hardcoded text with i18n markers, (3) i18n-sync - Align translation keys across multiple languages (zh-CN, zh-TW, en, ja, ko, ru, es, pt). Use when working on internationalization tasks, detecting untranslated strings, or syncing locale files. |
i18n Toolkit
Complete i18n (internationalization) toolkit for projects using i18next.
Architecture
- i18n library: i18next
- Locale files:
static/locales/ (zh-CN, zh-TW, en, ja, ko, ru, es, pt)
- HTML attributes:
data-i18n, data-i18n-placeholder, data-i18n-title, data-i18n-alt
- JS function:
window.t() or i18next.t()
- Progress file:
.claude/i18n-progress.json
Three Main Commands
1. i18n-check - Detect Issues
Check frontend files for hardcoded Chinese text.
/i18n-check <module> [options]
Modules: main, live2d, voice, steam, settings, chat, custom
Options: --status, --reset, --files=<path>, --html, --js, --strict
See references/check-modules.md for module file mappings.
2. i18n-fix - Fix Issues
Replace hardcoded Chinese with i18n markers.
/i18n-fix <module> [--add-keys]
Fix patterns:
- HTML: Add
data-i18n="key" attributes
- JS: Use
window.t('key') with fallback
See references/fix-patterns.md for examples.
3. i18n-sync - Sync Languages
Align translation keys across all languages.
uv run python scripts/i18n_sync.py
uv run python scripts/i18n_sync.py --apply
Quick Workflow
- Check:
/i18n-check steam - Find hardcoded strings
- Fix:
/i18n-fix steam - Replace with i18n markers
- Verify:
/i18n-check steam - Confirm fixes
- Sync:
/i18n-sync - Sync to other languages
Detection Rules
Check for:
- HTML: Chinese text in elements or attributes
- JS: Chinese strings not wrapped in
window.t()
Skip:
- Already has
data-i18n* or window.t() wrapper
console.log/error/warn debug messages- Third-party libs (
static/libs/)
- Comments
- Internal logic strings (e.g.,
includes('已离开'))
- Data keys (e.g.,
data['档案名'])
