[Bug] 配置自定义OpenAI端口及提示词后，划单词无法识别并触发词典

[Darkluna999]

Is there an existing issue for this?

• I have searched the existing issues

Have you checked the FAQ (#6)?

• I have checked the FAQ

Are you using the latest Zotero and the latest plugin?

• I have confirmed I'm using the latest Zotero and the latest plugin

Environment

• OS: Windows 11 29595.1000
• Zotero Version: 9.0-beta.21+1a89239a1 (64-bit)
• Plugin Version: 2.4.4

Describe the bug

配置自定义OpenAI端口及提示词后，划单词无法识别并触发词典

Debug Output

工作是正常有响应的 但是是调用的AI进行生成 而非词典模式

Anything else?

No response

[Halle-0620]

Bug Root Cause & Verified Hotfix Summary

同遇到该问题。经过排查 chrome/content/scripts/zoteropdftranslate.js 源码，此现象本质上是由于“自定义 GPT/OpenAI”引擎的底层请求逻辑与现代 LLM（如 DeepSeek 官方接口）在协议升级上发生了断层，导致接口虽然正常响应，但 Payload 解析失败，最终模型只能返回默认的“AI 迎宾语”或全英文响应。

以下是本地验证成功的完整修复方案，供原作者参考合入：

1. 规整化 URL 拼接（彻底解决 404 路由错误）

插件原本硬编码追加 /v1/chat/completions。如果用户填入了全路径或接入特定接口会直接撞墙。
修复逻辑：

const urlStr = String(apiURL);
let normalizedApiURL = urlStr;
if (!urlStr.includes("/chat/completions") && !(urlStr.includes("deepseek") && !urlStr.includes("v1"))) {
    normalizedApiURL = `${urlStr.replace(/\/$/, "")}/v1/chat/completions`;
}

2. 精简 Payload 并恢复 System Prompt 链路

在构建 body: JSON.stringify(...) 时，必须彻底剥离 translation_options 等非标准扩展字段。同时，需要恢复并重构系统提示词的获取链路（利用 transformPromptWithContext），确保用户在设置界面配置的 Prompt 能正确进入请求体。

修改后的核心逻辑：

// 恢复系统提示词链路
const systemPrompt = transformPromptWithContext(
  `${prefix}.prompt`,
  data2.langfrom,
  data2.langto,
  data2.raw,
  data2
);

// 干净的标准请求体结构
body: JSON.stringify({
  model,
  messages: [
    {
      role: "system",
      content: systemPrompt
    },
    {
      role: "user",
      content: data2.raw
    }
  ]
}),
responseType: "json",

(注：Responses API 分支也应同步增加标准字段 instructions: systemPrompt)

验证结果：
本地重构并重新打包 .xpi 后测试，自定义 GPT 引擎在处理学术段落翻译时完全恢复正常，能完美吐出地道的学术中文，不再产生畸形空响应