Bitzsoft.Integrations.Translation.All 1.0.0

Bitzsoft.Integrations.Translation.All

翻译服务聚合包 -- 一次注册按配置自动装配全部翻译供应商：

net5.0 资产仅含传统机翻与裸 HTTP AI 翻译（Tongyi / 百度大模型 / 火山引擎）；OpenAI / Anthropic 依赖 Microsoft.Extensions.AI，仅在 net8+ 可用。

安装

dotnet add package Bitzsoft.Integrations.Translation.All

配置样例：多供应商并存（appsettings.json）

{
  "Translation": {
    "Aliyun": {
      "AppId": "your-access-key-id",
      "AppSecret": "your-access-key-secret",
      "ApiEdition": "Professional",
      "Scene": "legal"
    },
    "Baidu": {
      "AppId": "your-baidu-appid",
      "AppSecret": "your-baidu-secret"
    },
    "DeepL": {
      "ApiKey": "your-deepl-auth-key",
      "Plan": "Pro"
    },
    "Google": {
      "ApiKey": "your-google-api-key"
    },
    "Tencent": {
      "AppId": "your-secret-id",
      "AppSecret": "your-secret-key"
    },
    "Tongyi": {
      "ApiKey": "sk-your-dashscope-key",
      "Model": "qwen-mt-plus",
      "DefaultDomains": "The text is from legal contract domain."
    },
    "BaiduAi": {
      "AppId": "your-baidu-appid",
      "ApiKey": "your-baidu-api-key",
      "DefaultReference": "使用正式法律文书风格翻译"
    },
    "Volcengine": {
      "ApiKey": "your-volcengine-api-key",
      "GlossaryTableName": "legal-terms"
    },
    "OpenAI": {
      "ClientName": "translation",
      "ModelId": "glm-4.6",
      "DefaultDomainHint": "法律合同"
    }
  }
}

只有出现在配置里的供应商才会注册；AI 网关（OpenAI / Anthropic）还需宿主另行 AddBitzChatClient（见对应包 README）。

注册服务

using Microsoft.Extensions.DependencyInjection;

builder.Services.AddBitzsoftTranslationAll(builder.Configuration);

按语言 / 用途路由

public class TranslationRouter(ITranslationProviderFactory factory)
{
    // 用途 → 供应商：法律文书走术语强约束的通义，站内消息走阿里云，批量外发走 Google
    private static readonly IReadOnlyDictionary<string, string> RouteByUsage = new Dictionary<string, string>
    {
        ["legal"] = TranslationProviderCode.Tongyi,    // 原生术语干预
        ["message"] = TranslationProviderCode.Aliyun,  // 场景化、低成本
        ["batch"] = TranslationProviderCode.Google,    // 原生批量 + 检测
        ["europe"] = TranslationProviderCode.DeepL,    // 欧洲语系质量
    };

    public async Task<string> TranslateAsync(string usage, string text, string targetLanguage)
    {
        var provider = factory.GetProvider(RouteByUsage[usage]);

        var result = await provider.TranslateAsync(new TranslationTextRequest
        {
            Text = text,
            SourceLanguage = "auto",
            TargetLanguage = targetLanguage,
            Terms = usage == "legal"
                ? new[] { new TranslationTerm("force majeure", "不可抗力") }
                : null,
        });

        if (result.IsSuccess)
            return result.Data!.TranslatedText;

        // 统一错误码驱动降级：配额 / 限流时回落到低成本通道
        if (result.ErrorCode is TranslationErrors.QuotaExceeded or TranslationErrors.RateLimited)
        {
            var fallback = await factory.GetProvider(TranslationProviderCode.Baidu)
                .TranslateAsync(new TranslationTextRequest { Text = text, TargetLanguage = targetLanguage });
            if (fallback.IsSuccess)
                return fallback.Data!.TranslatedText;
        }

        throw new InvalidOperationException($"{result.ErrorCode}: {result.ErrorMessage}");
    }
}

健康巡检

foreach (var code in factory.GetRegisteredCodes())
{
    var health = await factory.GetProvider(code).CheckHealthAsync();
    logger.LogInformation("翻译供应商 {Code} 状态 {Status}（{Elapsed}ms）", code, health.Status, health.ElapsedMilliseconds);
}

相关包

• Bitzsoft.Integrations.Translation.Abstractions -- 抽象层契约
• 各供应商独立子包（Translation.Aliyun / .Baidu / .Tencent / .Youdao / .DeepL / .Google / .AI.Tongyi / .AI.Baidu / .AI.Volcengine / .AI.OpenAI / .AI.Anthropic）-- 按需精简引用