# 翻译模块

  **快速上手**：见 `docs/QUICKSTART.md` 第 3.4 节。

  ## 环境变量

  ```bash
  # Qwen（默认）

  DASHSCOPE_API_KEY=sk-xxx
  
  # DeepL
  DEEPL_AUTH_KEY=xxx
  

  # 可选

  TRANSLATION_MODEL=qwen  # 或 deepl
  ```
  

  > **重要限速说明（Qwen 机翻）**  
  > 当前默认的 Qwen 翻译后端使用 `qwen-mt-flash` 云端模型，**官方限速较低，约 RPM=60（每分钟约 60 请求）**。  
  > - 推荐通过 Redis 翻译缓存复用结果，避免对相同文本重复打云端  
  > - 高并发场景需要在调用端做限流 / 去抖，或改为离线批量翻译  
  > - 如需更高吞吐，可考虑 DeepL 或自建翻译服务
  

  ## Provider 配置

  Provider 与 URL 在 `config/config.yaml` 的 `services.translation`。详见 [QUICKSTART.md](./QUICKSTART.md) §3 与 [DEVELOPER_GUIDE.md](./DEVELOPER_GUIDE.md) §7.2。