i18n

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          # 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['档案名'])