mirror of
https://github.com/decolua/9router.git
synced 2026-05-08 12:01:28 +00:00
feat: add auto README translation workflow with streaming
- Add GitHub Actions workflow to auto-translate README.md - Support Vietnamese and Simplified Chinese - Use GLM-5 API with streaming mode - Auto-commit translations to i18n/ folder - Trigger on README.md changes or manual dispatch Made-with: Cursor
This commit is contained in:
decolua
188
.github/scripts/translate-readme.js
vendored
Executable file
188
.github/scripts/translate-readme.js
vendored
Executable file
@@ -0,0 +1,188 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
// ============ CONFIGURATION ============
|
||||
const API_ENDPOINT = process.env.GLM_API_ENDPOINT || 'https://api.z.ai/api/anthropic/v1/messages';
|
||||
const API_MODEL = process.env.GLM_API_MODEL || 'glm-5';
|
||||
const API_KEY = process.env.GLM_API_KEY;
|
||||
const MAX_TOKENS = parseInt(process.env.GLM_MAX_TOKENS || '32000');
|
||||
const TEMPERATURE = parseFloat(process.env.GLM_TEMPERATURE || '0.3');
|
||||
|
||||
const SUPPORTED_LANGUAGES = {
|
||||
vi: 'Vietnamese',
|
||||
'zh-CN': 'Simplified Chinese'
|
||||
};
|
||||
|
||||
// ============ VALIDATION ============
|
||||
if (!API_KEY) {
|
||||
console.error('Error: GLM_API_KEY environment variable not set');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const targetLangs = process.argv.slice(2);
|
||||
if (targetLangs.length === 0) {
|
||||
console.error('Usage: node translate-readme.js <lang1> [lang2] ...');
|
||||
console.error(`Supported languages: ${Object.keys(SUPPORTED_LANGUAGES).join(', ')}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
for (const lang of targetLangs) {
|
||||
if (!SUPPORTED_LANGUAGES[lang]) {
|
||||
console.error(`Unsupported language: ${lang}`);
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
// ============ TRANSLATION FUNCTION ============
|
||||
async function translateToLanguage(readmeContent, targetLang) {
|
||||
const langName = SUPPORTED_LANGUAGES[targetLang];
|
||||
console.log(`\n[${targetLang}] Translating to ${langName}...`);
|
||||
console.log(`[${targetLang}] README size: ${readmeContent.length} characters`);
|
||||
|
||||
const prompt = `Translate this entire Markdown document to ${langName}.
|
||||
|
||||
CRITICAL RULES:
|
||||
- Keep ALL markdown syntax EXACTLY as is (##, \`\`\`, -, *, |, tables, etc.)
|
||||
- Do NOT modify code blocks, ASCII diagrams, or code fences
|
||||
- Only translate human-readable text content
|
||||
- Keep all URLs, links, and technical terms unchanged
|
||||
|
||||
${readmeContent}`;
|
||||
|
||||
const response = await fetch(API_ENDPOINT, {
|
||||
method: 'POST',
|
||||
headers: {
|
||||
'Content-Type': 'application/json',
|
||||
'x-api-key': API_KEY,
|
||||
'anthropic-version': '2023-06-01'
|
||||
},
|
||||
body: JSON.stringify({
|
||||
model: API_MODEL,
|
||||
messages: [{ role: 'user', content: prompt }],
|
||||
temperature: TEMPERATURE,
|
||||
max_tokens: MAX_TOKENS,
|
||||
stream: true
|
||||
})
|
||||
});
|
||||
|
||||
if (!response.ok) {
|
||||
const error = await response.text();
|
||||
throw new Error(`[${targetLang}] API Error: ${response.status} ${error}`);
|
||||
}
|
||||
|
||||
console.log(`[${targetLang}] Receiving translation stream...`);
|
||||
|
||||
let translatedContent = '';
|
||||
let chunkCount = 0;
|
||||
const reader = response.body.getReader();
|
||||
const decoder = new TextDecoder();
|
||||
|
||||
while (true) {
|
||||
const { done, value } = await reader.read();
|
||||
if (done) break;
|
||||
|
||||
const chunk = decoder.decode(value, { stream: true });
|
||||
const lines = chunk.split('\n');
|
||||
|
||||
for (const line of lines) {
|
||||
if (line.startsWith('data: ')) {
|
||||
const data = line.slice(6);
|
||||
if (data === '[DONE]') continue;
|
||||
|
||||
try {
|
||||
const parsed = JSON.parse(data);
|
||||
if (parsed.type === 'content_block_delta' && parsed.delta?.text) {
|
||||
translatedContent += parsed.delta.text;
|
||||
chunkCount++;
|
||||
if (chunkCount % 100 === 0) {
|
||||
process.stdout.write(`\r[${targetLang}] Received ${translatedContent.length} chars...`);
|
||||
}
|
||||
}
|
||||
} catch (e) {
|
||||
// Skip invalid JSON
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
process.stdout.write('\n');
|
||||
|
||||
console.log(`\n[${targetLang}] Stream complete, received ${translatedContent.length} characters`);
|
||||
|
||||
if (!translatedContent) {
|
||||
throw new Error(`[${targetLang}] No translation received`);
|
||||
}
|
||||
|
||||
console.log(`[${targetLang}] Fixing image paths...`);
|
||||
|
||||
// Fix image paths
|
||||
translatedContent = translatedContent
|
||||
.replace(/!\[([^\]]*)\]\(\.\/images\//g, '
|
||||
.replace(/!\[([^\]]*)\]\(\.\/public\//g, '
|
||||
.replace(/<img src="\.\/images\//g, '<img src="../images/')
|
||||
.replace(/<img src="\.\/public\//g, '<img src="../public/');
|
||||
|
||||
const i18nDir = path.join(__dirname, '../../i18n');
|
||||
if (!fs.existsSync(i18nDir)) {
|
||||
fs.mkdirSync(i18nDir, { recursive: true });
|
||||
}
|
||||
|
||||
const outputPath = path.join(i18nDir, `README.${targetLang}.md`);
|
||||
fs.writeFileSync(outputPath, translatedContent, 'utf8');
|
||||
|
||||
console.log(`[${targetLang}] ✅ Complete: ${outputPath}`);
|
||||
return { lang: targetLang, success: true, path: outputPath };
|
||||
}
|
||||
|
||||
// ============ MAIN ============
|
||||
async function main() {
|
||||
console.log('='.repeat(60));
|
||||
console.log('README Translation Tool (Streaming Mode)');
|
||||
console.log('='.repeat(60));
|
||||
console.log(`API Endpoint: ${API_ENDPOINT}`);
|
||||
console.log(`Model: ${API_MODEL}`);
|
||||
console.log(`Max Tokens: ${MAX_TOKENS}`);
|
||||
console.log(`Languages: ${targetLangs.join(', ')}`);
|
||||
console.log('='.repeat(60));
|
||||
|
||||
const readmePath = path.join(__dirname, '../../README.md');
|
||||
const readmeContent = fs.readFileSync(readmePath, 'utf8');
|
||||
|
||||
// Translate languages sequentially (streaming doesn't work well in parallel)
|
||||
const results = [];
|
||||
for (const lang of targetLangs) {
|
||||
try {
|
||||
const result = await translateToLanguage(readmeContent, lang);
|
||||
results.push({ status: 'fulfilled', value: result });
|
||||
} catch (error) {
|
||||
results.push({ status: 'rejected', reason: error, lang });
|
||||
}
|
||||
}
|
||||
|
||||
console.log('\n' + '='.repeat(60));
|
||||
console.log('SUMMARY');
|
||||
console.log('='.repeat(60));
|
||||
|
||||
results.forEach((result) => {
|
||||
if (result.status === 'fulfilled') {
|
||||
console.log(`✅ ${result.value.lang}: ${result.value.path}`);
|
||||
} else {
|
||||
console.log(`❌ ${result.lang}: ${result.reason.message}`);
|
||||
}
|
||||
});
|
||||
|
||||
const failed = results.filter(r => r.status === 'rejected').length;
|
||||
if (failed > 0) {
|
||||
console.log(`\n⚠️ ${failed} translation(s) failed`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
console.log('\n✅ All translations completed successfully!');
|
||||
}
|
||||
|
||||
main().catch(err => {
|
||||
console.error('Fatal error:', err);
|
||||
process.exit(1);
|
||||
});
|
||||
38
.github/workflows/translate-readme.yml
vendored
Normal file
38
.github/workflows/translate-readme.yml
vendored
Normal file
@@ -0,0 +1,38 @@
|
||||
name: Translate README
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- master
|
||||
paths:
|
||||
- 'README.md'
|
||||
workflow_dispatch:
|
||||
|
||||
jobs:
|
||||
translate:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout code
|
||||
uses: actions/checkout@v4
|
||||
with:
|
||||
token: ${{ secrets.GITHUB_TOKEN }}
|
||||
|
||||
- name: Setup Node.js
|
||||
uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: '20'
|
||||
|
||||
- name: Translate README to all languages
|
||||
env:
|
||||
GLM_API_KEY: ${{ secrets.GLM_API_KEY }}
|
||||
run: |
|
||||
node .github/scripts/translate-readme.js vi zh-CN
|
||||
|
||||
- name: Commit translations
|
||||
run: |
|
||||
git config --local user.email "github-actions[bot]@users.noreply.github.com"
|
||||
git config --local user.name "github-actions[bot]"
|
||||
git add i18n/
|
||||
git diff --staged --quiet || git commit -m "chore: auto-translate README to vi, zh-CN"
|
||||
git push
|
||||
Reference in New Issue
Block a user