一、常见问题（FAQ）

1) 支持哪些网站与内容类型？

支持通过 WPML 管理的多语言内容，包括文章、页面与 WPML 支持的自定义内容类型（以站点实际配置为准）。
翻译任务以 WPML 队列中的 XLIFF 任务为准，完成后自动交付回 WPML。

2) 免费版与付费版的主要区别是什么？

• 免费：仅支持神经网络翻译（MT）。
• 付费订阅：支持大模型LLM 翻译、可选择 Prompt 模板（b2b / b2c / tech_doc / creative）、支持补充网站资料； 并允许自定义引擎（不消耗订阅额度）。

3) LLM 翻译如何计费？为什么消耗比预期少/多？

LLM 按实际输入/输出 Tokens 结算，费用与所选模型单价相关。
由于系统会抽取可翻译文本/节点并尽量减少无效内容（如 HTML 标签与结构），通常会比“整段文本直接翻译”更省 Tokens。
若消耗偏高，常见原因包括：内容重复、长段落、包含大量可见文本、重试次数增加等。最终以消费明细记录为准。

4) 为什么任务会失败？失败是否会扣费？

失败可能由以下原因触发：

• 模型输出不稳定、服务端限流/超时
• 内容结构复杂（占位符、嵌套标签、异常编码）
• 自定义第三方引擎 API Key 无效 / 余额不足 / 权限不足 / 地区限制
• 网络异常或站点回推权限不足

失败任务也可能产生已发生的部分消耗（例如请求已发送并返回部分结果），结算以系统记录的实际消耗为准。

5) 启用自定义LLM引擎 后还会扣订阅额度吗？

启用自定义LLM引擎后，翻译请求使用自定义API Key，不消耗订阅额度。费用由第三方服务商计入自带 Key 账单。
系统仍会记录任务、状态与消费明细（用于对账与排障）。

6) Prompt 模板怎么选？网站资料写什么？

• b2b：产品/解决方案、企业服务、偏专业严谨
• b2c：面向消费者、偏自然亲和
• tech_doc：技术文档/帮助中心、偏准确一致
• creative：营销/创意文案、偏表达与风格
• general：通用翻译方案

填写网站资料推荐包含：

• 品牌语气（简洁 / 权威 / 活泼等）
• 目标受众与产品背景
• 术语偏好与禁用表达
• 标题 / 按钮 / CTA 的风格偏好

7) 术语表支持吗？

术语表功能即将上线。上线后将以功能页面说明与引擎支持情况为准。

二、排障指南（按症状快速定位）

症状 A：WPML 队列里有任务，但任务列表里看不到 / 一直不处理

优先检查：

1. 站点是否绑定成功：进入「站点管理」确认状态正常
2. 站点授权/密钥是否失效：若有更换域名、HTTPS、缓存策略，建议重新校验绑定
3. WPML 队列是否真的进入“待翻译”：确认任务已派发到队列且未被其他翻译服务接管
4. 站点任务是否超过套餐站点上限：超出上限可能导致任务不被接管
5. 系统是否有队列延迟：高峰期可能存在排队；可稍后刷新任务状态

如仍无效：导出问题任务的时间点、任务 ID（或任务标题/语言对）提交工单。

症状 B：任务显示“失败 / 异常”

按顺序排查：

1. 查看失败原因：在「翻译任务」中打开任务详情，记录错误提示
2. 确认引擎与权限
   • 免费套餐：确认没有选择 LLM 引擎
   • 自带 API Key：确认 Key 有效、额度充足、权限正确
3. 降低复杂度重试
   • 先用机器翻译验证流程是否通
   • 再切回大模型 LLM，并使用更稳定的 Prompt（优先 tech_doc 或 b2b）
4. 内容结构问题
   • 若内容包含大量占位符/短码/复杂 HTML，建议拆分页面或减少一次任务的内容量
5. 限流 / 超时
   • 更换引擎/模型
   • 避免短时间批量提交超多任务

症状 C：翻译完成但没有回推到 WPML / WPML 中看不到结果

重点检查：

1. WPML 是否允许接收回写：站点权限、WPML 状态是否正常
2. 站点防火墙 / WAF / 安全插件拦截：常见于回调接口被拦截
3. 缓存导致显示延迟：清理页面缓存/对象缓存后重试
4. 任务是否处于“等待审核”状态：部分 WPML 流程需要人工确认才能发布

症状 D：翻译后出现格式错乱 / 标签异常 / 占位符丢失

建议处理：

1. 优先改用 general 模板
2. 若问题只出现在少数页面：可选择更高级模型进行重试
3. 如可复现：提供原始页面类型与语言对，提交支持定位

症状 E：扣费与预期不一致 / 额度下降过快

核对步骤：

1. 在「任务消费明细」查看是否存在：
   • 多次重试产生额外消耗
   • 同一任务重复执行
   • 模型输出较长导致输出 Tokens 上升
2. 确认是否启用了自带 API Key（自带 Key 不走订阅额度，但第三方账单可能增加）
3. 若怀疑异常：提交“任务 ID + 时间范围 + 引擎/模型”以便核查

三、可提供的技术支持范围

支持渠道（建议在页面落地）

• 工单/邮件支持（推荐）：用于排查失败原因、回推异常、扣费核对
• 文档与 FAQ：常见配置、排障步骤、最佳实践

可协助的内容

• 安装与绑定问题排查（站点验证、权限、回调失败）
• 队列不处理 / 任务失败的原因定位与建议
• 引擎配置与 Prompt 使用建议（按场景选型）
• 消费明细核对与异常排查（基于任务记录与日志）

不在支持范围（建议明确）

• 代为修改 WPML 配置或第三方插件代码
• 第三方模型供应商（自带 API Key）的账单争议与退款
• 与站点安全策略冲突的强制绕过（如禁用防火墙规则等）