Chuyển đến nội dung chính

​
Mục tiêu

Tạo một i18n.jsonc, thực hiện lập kế hoạch dịch một cách an toàn, tạo kết quả đầu ra và kiểm tra trạng thái.

​
1. Khởi tạo cấu hình

hyperlocalise init
Điều này ghi lại i18n.jsonc trong thư mục hiện tại của bạn.

​
2. Cấu hình thông tin xác thực nhà cung cấp

hyperlocalise tự động đọc thông tin đăng nhập từ .env và .env.local trong thư mục dự án hiện tại của bạn. Biến shell đã xuất vẫn được ưu tiên. Ví dụ: 
export OPENAI_API_KEY="your-openai-api-key"
OpenAI: 
export OPENAI_API_KEY="your-openai-api-key"
Azure OpenAI: 
# Example: https://<resource>.openai.azure.com/openai/v1
export AZURE_OPENAI_BASE_URL="https://<resource>.openai.azure.com/openai/v1"
export AZURE_OPENAI_API_KEY="your-azure-openai-api-key"
Gemini: 
export GEMINI_BASE_URL="https://generativelanguage.googleapis.com/v1beta/openai"
export GEMINI_API_KEY="your-gemini-api-key"
Anthropic: 
export ANTHROPIC_BASE_URL="https://api.anthropic.com/v1"
export ANTHROPIC_API_KEY="your-anthropic-api-key"
LM Studio: 
export LM_STUDIO_BASE_URL="http://127.0.0.1:1234/v1"
export LM_STUDIO_API_KEY="lm-studio"
Ollama: 
export OLLAMA_BASE_URL="http://127.0.0.1:11434/v1"
export OLLAMA_API_KEY="ollama"
Groq: 
export GROQ_BASE_URL="https://api.groq.com/openai/v1"
export GROQ_API_KEY="your-groq-api-key"

​
3. Khô-chạy trước

hyperlocalise run --config i18n.jsonc --dry-run
Kiểm tra planned_total, executable_total, và danh sách tasks.

​
4. Thực hiện tạo dữ liệu

hyperlocalise run --config i18n.jsonc
Điều này ghi bản dịch và cập nhật .hyperlocalise.lock.json. Để biết chi tiết, xem Hợp đồng khóa tệp.

​
5. Trạng thái đánh giá

hyperlocalise status --config i18n.jsonc --output csv
Sử dụng needs_review các hàng để xác định các mục vẫn cần được biên tập thủ công.

​
6. Đánh giá chất lượng bản dịch khi cần thiết

hyperlocalise eval run --eval-set ./eval-set.json --output ./eval-report.json
Sử dụng điều này khi so sánh lựa chọn lời nhắc/hồ sơ/nhà cung cấp hoặc trước khi cập nhật bản dịch lớn.

​
Tiếp theo