常见问题
常见问题翻译基于 Classic Editor 的长文章失败

翻译基于 Classic Editor 的长文章失败

基于 Classic Editor 的长文章在使用最大 token 数量较少的 API 时可能会翻译失败(例如:DeepSeek V3 仅提供 8K 最大 token)。

原因在于 Classic Editor 将所有 HTML 内容作为单个整体进行翻译。如果该字符串超过最大 token 数量,则无法通过请求发送。

此时,您将在日志中看到以下错误信息:

🔴 ERROR [Query "translate-customposts"] Execution with errors: String to translate exceeds max length of '...': ...

作为解决方案,您可以:

  • 切换到提供更多最大 token 数量的 API 服务
  • 切换到 Gutenberg 编辑器,将单个 HTML 内容迁移到多个 Gutenberg html 块,确保每个块不超过 8000 个字符

基于 Gutenberg 编辑器的文章通过块进行组织,各块的属性可以独立翻译。由于大量字符串被拆分为多个请求,文章再长也不会有问题。