@ happyvertical/ 翻译器
标准化翻译界面支持Google Translate,DeepL,和Libre Translate. 采用工厂/适应器模式,采用统一 Translator 对所有提供者进行接口。 Google 和 DeepL 的供应商包括自动内存缓存 @happyvertical/cache。 。 。 .
安装
pnpm add @happyvertical/translator
快速启动
环境变量
export HAVE_TRANSLATOR_PROVIDER=deepl
export DEEPL_API_KEY=your_key
import { getTranslator } from '@happyvertical/translator';
const translator = await getTranslator();
const result = await translator.translate('Hello, world!', 'es');
console.log(result.translatedText); // "¡Hola, mundo!"
明确选项
// Google Translate
const translator = await getTranslator({
provider: 'google',
apiKey: process.env.GOOGLE_TRANSLATE_API_KEY!,
});
// DeepL
const translator = await getTranslator({
provider: 'deepl',
apiKey: process.env.DEEPL_API_KEY!,
freeApi: true,
});
// LibreTranslate (no API key required for public instances)
const translator = await getTranslator({
provider: 'libretranslate',
apiUrl: 'https://libretranslate.com',
});
模板函数
为重复使用创建预配置的翻译功能 :
const t = translator.templateFunction('en', 'es');
const greeting = await t('Hello, world!'); // "¡Hola, mundo!"
const farewell = await t('Goodbye!'); // "¡Adiós!"
API 密码
getTranslator(options?): Promise<Translator>
工厂功能. 读取 HAVE_TRANSLATOR_* 环境变量,与明确选项(明显胜出)合并.
Translator 接口
interface Translator {
translate(text: string, targetLang: string, sourceLang?: string): Promise<TranslationResult>;
detectLanguage(text: string): Promise<LanguageDetectionResult>;
getSupportedLanguages(): Promise<SupportedLanguage[]>;
translateBatch(texts: string[], targetLang: string, sourceLang?: string): Promise<TranslationResult[]>;
templateFunction(sourceLang?: string, targetLang?: string): (text: string) => Promise<string>;
}
TranslationResult
interface TranslationResult {
translatedText: string;
sourceText: string;
sourceLanguage: string;
targetLanguage: string;
confidence?: number;
alternatives?: string[];
detectedSourceLanguage: boolean;
raw: any;
}
LanguageDetectionResult
interface LanguageDetectionResult {
language: string;
confidence: number;
alternatives?: Array<{ language: string; confidence: number }>;
raw: any;
}
错误分类
全部扩展 TranslationError数字 :
TranslationError——基础出错code财务报告和审定财务报表provider字段UnsupportedLanguageError——语言代码无效QuotaExceededError——供应商配额限制AuthenticationError- 错误或缺失 API 密钥InvalidTextError— 空或无效的输入文本
环境变量
| 变量 | 说明 |
|---|---|
HAVE_TRANSLATOR_PROVIDER | google, (中文(简体) ), deepl,或 libretranslate |
HAVE_TRANSLATOR_TIMEOUT | 请求超时( ms) |
HAVE_TRANSLATOR_MAX_RETRIES | 最大重试尝试 |
HAVE_TRANSLATOR_API_URL | 自由翻译实例 URL |
HAVE_TRANSLATOR_FREE_API | 深 L 自由级( E)true编号 :false(中文(简体) ) |
HAVE_TRANSLATOR_PROJECT_ID | 谷歌云项目ID |
GOOGLE_TRANSLATE_API_KEY | 谷歌翻译 API 密钥 |
DEEPL_API_KEY | 深 L API 密钥 |
工具出口
LANGUAGE_NAMES– ISO 639-1 编码到英文名的地图isValidLanguageCode(code)——验证两字母语言代码getLanguageName(code)从代码中查找语言名称normalizeConfidence(score)——将分数常态化为 0–1 范围isValidText(text)——检查文本为非空truncateText(text, maxLength)— 有椭圆形的调值
许可证
公务员制度委员会