文本翻译

单条文本翻译。完整流程：缓存查询 → 扣点 → RAG 增强 → 引擎翻译 → 写缓存存档。

usedPoints = max(1, ceil(字符数 / 1000))    // text-chars-per-point = 1000
// 缓存命中：不扣点（usedPoints = 0）
// Mock 引擎：返回后自动全额退回
// 点数不足且会员额度不足：HTTP 402 INSUFFICIENT_POINTS

{
  "sourceText": "人工智能正在改变世界",
  "sourceLanguage": "zh",
  "targetLanguage": "en",
  "translationEngine": "QWEN",
  "useTerminology": true,
  "domain": "TECHNOLOGY"
}

批量文本翻译。请求体为 TranslationRequest 数组，逐条独立计费，响应为结果数组（顺序与请求一致）。userId 同样被服务端上下文强制覆盖。

// 请求体：数组
[
  { "sourceText": "第一句", "sourceLanguage": "zh", "targetLanguage": "en" },
  { "sourceText": "第二句", "sourceLanguage": "zh", "targetLanguage": "ja" }
]
// 响应 data：TranslationResponse 数组，顺序对应
[ { "translationId": 101, "translatedText": "Sentence one", ... },
  { "translationId": 102, "translatedText": "第二文", ... } ]

检测文本语言。注意：请求体为纯文本字符串（JSON String），不是对象。

"Hello, world!"

非空；长度 ≤ 1000 字符（超出返回 400 VALIDATION_ERROR）。

{
  "language": "en",
  "languageName": "English",
  "confidence": 0.98,
  "success": true,
  "processingTime": 120,
  "errorMessage": null
}

对既有机器翻译结果做二次润色：按术语库强制对齐术语译法，并按风格要求改写。

{
  "polishedText": "润色后的译文",
  "termHits": [ { "sourceTerm": "AI", "targetTerm": "人工智能", ... } ],
  "appliedTermsCount": 2,
  "qualityScore": 92.5,
  "errorMessage": null
}

返回支持语言列表。

[
  { "languageCode": "zh", "languageName": "中文", "nativeName": "中文", "isActive": true, "sortOrder": 1 },
  { "languageCode": "en", "languageName": "English", "nativeName": "English", "isActive": true, "sortOrder": 2 }
  // ... 共 10 种
]

返回可用引擎代码列表。

["QWEN", "ALIBABA_CLOUD"]

校验某语言对是否受支持。

{ "sourceLanguage": "auto", "targetLanguage": "zh", "supported": true }

翻译服务健康检查（免登录白名单外接口，仍需 Token；系统级探活请用 /actuator/health）。

{ "timestamp": 1725600000000, "service": "Translation Service", "version": "1.0.0" }

分页查询当前登录用户的翻译历史，支持多维筛选。响应 data 为 TranslationRecord 实体数组。

{
  "data": [ {
    "id": 1001, "userId": 1,
    "sourceLanguage": "zh", "targetLanguage": "en",
    "sourceText": "你好", "translatedText": "Hello",
    "translationType": "TEXT", "translationEngine": "QWEN",
    "qualityScore": 95, "processingTime": 800, "characterCount": 2,
    "useTerminology": true, "status": "SUCCESS",
    "errorMessage": null, "createdAt": "2026-09-01T10:30:00", "updatedAt": "..."
  } ],
  "page": 0, "size": 20, "totalPages": 5, "totalElements": 96
}

删除单条翻译记录（校验归属当前用户）。

true

清空当前登录用户的全部翻译历史。

37    // 实际删除的记录条数（未登录返回 0）

首页平台统计。免认证白名单接口。

{
  "totalTranslations": 12580,     // 累计翻译次数
  "totalDocuments": 326,          // 累计文档数
  "totalTerminologies": 1420,     // 术语总条数
  "activeUsers": 89,              // 活跃用户数
  "recentTranslations": [ ... ]   // 最近翻译列表
}