i18n

# 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](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](references/fix-patterns.md) for examples. ### 3. i18n-sync - Sync Languages Align translation keys across all languages. ```bash uv run python scripts/i18n_sync.py # Check status uv run python scripts/i18n_sync.py --apply # Apply changes ``` ## Quick Workflow 1. **Check**: `/i18n-check steam` - Find hardcoded strings 2. **Fix**: `/i18n-fix steam` - Replace with i18n markers 3. **Verify**: `/i18n-check steam` - Confirm fixes 4. **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['档案名']`)