源代码的版本并不是设计给普通用户使用的（我还没有完全测试）

如果你愿意，可以尝试，但是普通用户请在此处下载：全自动安装

• 前段时间存储库消失是因为GitHub给我封号了

• 【PotPlayer AI翻译插件安装教程-哔哩哔哩】 https://b23.tv/ntF2dxu

安装 📦

全自动安装（推荐） ⚡

1. 下载安装程序： 安装程序 (安装程序是开源的，所以你可以查看源代码)
2. 运行安装程序 (installer.exe)：
   • 双击 installer.exe 启动。
   • 如果Windows提示权限请求，请批准管理员提示。
3. 确认PotPlayer插件文件夹：
   • 向导会自动检测你的PotPlayer安装路径。
   • 请确认目标文件夹为： ...\PotPlayer\Extension\Subtitle\Translate
   • 如果你将PotPlayer安装在自定义位置，请浏览到正确的 Translate 文件夹。
4. 选择插件版本：
   • 带上下文（翻译质量更好，但延迟稍高）。
   • 无上下文（速度更快，但缺乏上下文感知能力）。
5. 配置模型和API端点：
   • 模型名称： 输入模型ID（例如：gpt-4.1-nano）。
   • 自定义API基础URL（可选）： 使用 ModelName|API Base URL。
   • 无需密钥的端点： 将密钥留空并点击“验证”；如果测试成功，安装程序会注入 nullkey。
6. 输入API密钥（如需）：
   • 将你的API密钥粘贴到安装程序字段中。
   • 如果你的端点不需要密钥，请将其留空，并使用“验证”功能测试空密钥；成功后，安装程序会注入 nullkey。
7. 完成安装：
   • 点击“安装”以复制文件。
   • 你还可以选择注册卸载程序条目，以便日后干净地移除插件。
   • 注意：安装程序的默认设置只写入一次；之后在PotPlayer面板中进行的任何更改都会覆盖安装程序的初始值。

安装完成后，请在PotPlayer中验证设置：

1. 打开PotPlayer偏好设置： 按下 F5 键。
2. 导航到扩展功能： 扩展 > 字幕翻译。
3. 选择插件： 选择 ChatGPT Translate。
4. 根据需要设置源语言和目标语言。

手动安装 🔧

1. 下载ZIP文件： 从本仓库下载最新的ZIP文件。
2. 解压ZIP文件： 将内容解压到一个临时文件夹。
3. 复制文件： 将 ChatGPTSubtitleTranslate.as 和 ChatGPTSubtitleTranslate.ico 复制到以下目录：

   C:\Program Files\DAUM\PotPlayer\Extension\Subtitle\Translate
   

   如果你需要将PotPlayer安装在自定义路径下，请相应地替换路径。
4. 复制完成后配置PotPlayer：
   1. 打开PotPlayer的偏好设置（按下 F5 键）。
   2. 进入 扩展 > 字幕翻译。
   3. 选择 ChatGPT Translate。
   4. 根据需要配置 模型名称、API URL 和 API密钥。
   5. 设置 源语言 和 目标语言。

ℹ️ 如果你在带上下文和无上下文脚本之间切换，务必同时替换两个 .as 文件。 之前使用共享 FormatFailureTranslation 名称的旧版本可能会导致PotPlayer在加载任一脚本时报告冲突（通常是标准的上下文版本）。当前文件使用带有唯一前缀的帮助函数来避免这种情况。

(返回顶部)

配置参考 ⚙️

1. 模型名称： 您可以直接输入模型名称，系统将使用默认的 API URL。 示例：

   gpt-4.1-nano
   

   或者，您也可以使用以下格式指定自定义的 API URL：

   模型名称|API 基础 URL
   

   示例：

   gpt-4.1-nano|https://api.openai.com/v1/chat/completions
   

   注意： 在 v1.5 及更高版本中，如果您使用的是无需 API 密钥的自托管或第三方 API，可以在末尾添加 nullkey：

   gpt-4.1-nano|nullkey
   

   或：

   qwen2.5:7b|http://127.0.0.1:11434/v1/chat/completions|nullkey
   

   可选调优参数（v1.7+）： 您可以附加额外的参数，用 | 分隔：

   • delay_ms（仅数字）：在每次请求前增加延迟
   • retryN（N = 0–3）：重试模式
     • retry0：不重试
     • retry1：当响应为空时尝试一次
     • retry2：持续重试直至获得响应（无延迟）
     • retry3：持续重试，每次尝试前有延迟
   • cache=auto / cache=off：上下文缓存模式（仅适用于上下文版本；如果不受支持，则自动回退到聊天模式）
   • smallmodel=0 / smallmodel=1：启用小型模型模式（为小型模型优化提示）
   • checkhallucination=0 / checkhallucination=1：启用幻觉检查（如果翻译长度超过原文的 5 倍则重试）

   包含所有选项的示例：

   gpt-4.1-nano|https://api.openai.com/v1/chat/completions|nullkey|500|retry1|cache=auto|smallmodel=1|checkhallucination=1
   

2. API 密钥： 如需，请在此处输入您的 API 密钥。 如果您的端点不需要密钥，请留空；安装程序会在成功进行空密钥测试后自动注入 nullkey。

   您可以使用 keytest.obanarchy.org 测试您的 API 密钥，以确保其有效。

3. 设置源语言和目标语言： 根据需要配置源语言和目标语言。

可用模型（示例）

请使用以下格式：

模型名称|API 基础 URL|nullkey（可选）|delay_ms（可选）|retryN（可选）|cache=auto/off（可选）|smallmodel=0/1（可选）|checkhallucination=0/1（可选）

以下是支持的模型列表：

OpenAI GPT-5：gpt-5|https://api.openai.com/v1/chat/completions
OpenAI GPT-5 Mini：gpt-5-mini|https://api.openai.com/v1/chat/completions
OpenAI GPT-5 Nano：gpt-5-nano|https://api.openai.com/v1/chat/completions
OpenAI GPT-4.1：gpt-4.1|https://api.openai.com/v1/chat/completions
OpenAI GPT-4.1 Mini：gpt-4.1-mini|https://api.openai.com/v1/chat/completions
Gemini Flash：gemini-3-flash-preview|https://generativelanguage.googleapis.com/v1beta/openai/chat/completions
OpenAI GPT-5：gpt-5|https://api.openai.com/v1/chat/completions
OpenAI GPT-5 Mini：gpt-5-mini|https://api.openai.com/v1/chat/completions
OpenAI GPT-5 Nano：gpt-5-nano|https://api.openai.com/v1/chat/completions
OpenAI GPT-4.1：gpt-4.1|https://api.openai.com/v1/chat/completions
OpenAI GPT-4.1 Mini：gpt-4.1-mini|https://api.openai.com/v1/chat/completions
Gemini Flash：gemini-3-flash-preview|https://generativelanguage.googleapis.com/v1beta/openai/chat/completions
Deepseek：deepseek-chat|https://api.deepseek.com/v1/chat/completions
通义千问：qwen-plus|https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
SiliconFlow：siliconflow-chat|https://api.siliconflow.cn/v1/chat/completions
ERNIE Bot（文心一言）：ernie-4.0-turbo-8k|https://qianfan.baidubce.com/v2/chat/completions
Gemini：gemini-2.0-flash|https://generativelanguage.googleapis.com/v1beta/openai/chat/completions
ChatGLM：chatglm-6b|https://api.chatglm.cn/v1/chat/completions
LLaMA：llama-13b|https://api.llama.ai/v1/chat/completions
Code LLaMA：code-llama-34b|https://api.llama.ai/v1/code/completions
OpenAI GPT-4o：gpt-4o|https://api.openai.com/v1/chat/completions
OpenAI GPT-4 Turbo：gpt-4-turbo|https://api.openai.com/v1/chat/completions
OpenAI GPT-3.5 Turbo：gpt-3.5-turbo|https://api.openai.com/v1/chat/completions
Claude 3 Sonnet：claude-3-sonnet-20240229|https://api.anthropic.com/v1/messages
Mistral Large：mistral-large|https://api.mistral.ai/v1/chat/completions
Groq Llama 3：llama3-70b-8192|https://api.groq.com/openai/v1/chat/completions
Perplexity Sonar Large：pplx-70b-online|https://api.perplexity.ai/chat/completions
Fireworks Mixtral：accounts/fireworks/models/mixtral-8x7b-instruct|https://api.fireworks.ai/inference/v1/chat/completions
Moonshot v1：moonshot-v1-128k|https://api.moonshot.cn/v1/chat/completions
Yi 34B Chat：yi-34b-chat|https://api.lingyi.ai/v1/chat/completions
本地部署（无需 API 密钥）：模型名称|http://127.0.0.1:PORT/v1/chat/completions|nullkey

安装程序中的模型名称会尽可能以您选择的语言显示。

您可以根据需要扩展或替换这些模型，使用任何兼容 OpenAI 并支持 chat/completions 端点的模型。

(返回顶部)

关于本项目 💬

PotPlayer_ChatGPT_Translate 是一款集成 ChatGPT API 的 PotPlayer 插件，能够提供实时、上下文感知的字幕翻译。与传统翻译工具不同，该插件会考虑上下文、习语和文化差异，从而生成更准确的翻译。该项目的核心采用 AngleScript 实现，同时利用 ChatGPT API 和 PotPlayer API 进行深度集成。

此插件也兼容任何遵循与 ChatGPT 相同 API 调用格式的 AI 模型。

🔍 Google 翻译 vs ChatGPT 翻译

使用 ChatGPT 进行字幕翻译的一大优势在于它能够理解上下文和文化引用。对比以下结果：

• 原始字幕：

  "You're gonna old yeller my f**king universe."

• Google 翻译结果：

  "你要老了我他妈的宇宙吗?" (荒谬且错误)

• ChatGPT 翻译结果：

  "你要像《老黄犬》一样对待我的宇宙?" (正确捕捉了引用和原意)

🧐 ChatGPT 无上下文 vs. ChatGPT 有上下文对比

• 原始字幕：

  "But being one in real life is even better."

• ChatGPT 翻译（无上下文）：

  "但是，在现实生活中成为一个人甚至更好。" (直译，未能传达隐含意义)

• ChatGPT 翻译（有上下文）：

  "但在现实生活中成为一个反派更好。" (准确把握了上下文含义)

(返回顶部)

视频教程 🎥

点击下方链接，在哔哩哔哩观看教程：

(返回顶部)

graph TD
    %% --- 初始化阶段 ---
    Start([开始：翻译]) --> InitConfig[加载配置与令牌规则]
    InitConfig --> CheckAuth{API密钥已配置？}
    CheckAuth -- 否 --> RetError([返回错误信息])
    CheckAuth -- 是 --> UpdateHist[更新字幕历史]

    %% --- 上下文管理 ---
    UpdateHist --> ContextMode{插件版本？}

    subgraph ContextLogic [上下文处理]
        direction TB
        ContextMode -- “无上下文” --> NoContextPrompt[无上下文]
        ContextMode -- “有上下文” --> CalcBudget[计算令牌预算]
        CalcBudget --> TrimHist[修剪历史\n（丢弃最旧内容 / 智能修剪）]
        TrimHist --> BuildBlock[构建上下文块]
    end

    %% --- 提示词工程 ---
    subgraph PromptEng [提示词构造]
        direction TB
        BuildBlock --> SmallModel{小型模型模式？}
        NoContextPrompt --> SmallModel

        SmallModel -- 是 --> StrictPrompt[系统：身份 + 上下文 + 指令\n用户：仅字幕文本]
        SmallModel -- 否 --> StdPrompt[系统：身份 + 上下文\n用户：指令 + 字幕文本]

        StrictPrompt --> EscapeJSON[字符串转义为 JSON 格式]
        StdPrompt --> EscapeJSON
        EscapeJSON --> BuildPayload[构建 JSON 请求体]
    end

    BuildPayload --> InitLoop[初始化重试计数 = 0]

    %% --- 统一执行循环 ---
    subgraph RetrySystem [统一执行与重试循环]
        direction TB
        LoopCond{尝试次数 <= 最大值？}
        LoopCond -- 否 --> FailFinal([返回失败信息])

        LoopCond -- 是 --> DelayCheck{是否为重试？}
        DelayCheck -- 是 --> Wait[等待配置的延迟时间]
        DelayCheck -- 否 --> CacheBranch
        Wait --> CacheBranch

        %% 缓存分支
        CacheBranch{缓存模式已启用？}
        CacheBranch -- 是 --> ReqCache[POST /responses]
        CacheBranch -- 否 --> ReqChat

        ReqCache --> RespCache{响应是否正常？}
        RespCache -- 是 --> ParseCache[提取 'output_text']
        RespCache -- 否 --> LogCacheFail[记录失败] --> ReqChat[POST /chat/completions]

        ParseCache --> HallucinationCheck

        %% 标准聊天分支
        ReqChat --> NetCheck{网络是否正常？}
        NetCheck -- 否 --> IncRetry[增加重试次数] --> LoopCond
        NetCheck -- 是 --> ParseJSON{是否为有效 JSON？}

        ParseJSON -- 不是 --> IncRetry
        ParseJSON -- 出错 --> LogAPIError[记录 API 错误] --> IncRetry
        ParseJSON -- 成功 --> ExtractContent[提取内容]

        ExtractContent --> HallucinationCheck{是否检查幻觉？}

        HallucinationCheck -- “长度 > 5倍原文” --> LogHallu[记录警告：幻觉] --> IncRetry
        HallucinationCheck -- 合格 --> SuccessBreak[退出循环]
    end

    %% --- 后处理 ---
    SuccessBreak --> PostProc[后处理]
    PostProc --> FixNewlines[修剪尾部换行符\n（Gemini 修复）]
    FixNewlines --> FixRTL[插入 Unicode RLE 符号\n（阿拉伯语/希伯来语修复）]
    FixRTL --> ReturnSuccess([返回翻译结果])

构建技术 🛠

• AngleScript – 用于开发插件的脚本语言
• ChatGPT API – 提供上下文感知的翻译能力
• PotPlayer API – 实现与 PotPlayer 的无缝集成

(返回顶部)

使用方法 ▶️

当在 PotPlayer 中播放带有字幕的视频时，插件会自动调用 ChatGPT API 对字幕进行实时翻译。通过处理上下文、习语和文化差异，插件能够提供更准确的翻译。

例如：

• 输入： "You're gonna old yeller my f**king universe."
  • 传统翻译工具可能会输出直译或生硬的翻译。
  • ChatGPT 翻译则捕捉了电影引用和上下文，给出更贴切的翻译。

(返回顶部)

路线图 🗺

• 将 ChatGPT API 与 PotPlayer API 集成，实现字幕实时翻译。
• 支持更多 AI 模型（计划中，但暂不紧急）。
• 优化上下文处理，进一步提升翻译准确性。

(返回顶部)

贡献 🤝

欢迎贡献！提交拉取请求时，请清晰描述更改的目的。 如果您有改进建议或 bug 修复，请在修改前先创建一个议题。

(返回顶部)

许可证 📄

根据 GPLv3 许可证发布。更多信息请参阅 LICENSE 文件。

(返回顶部)

联系方式 📞

个人网站：obanarchy.org

(返回顶部)

致谢 🙏

• 感谢 OpenAI 提供强大的 ChatGPT API。
• 感谢 PotPlayer 团队打造优秀的媒体播放器。
• 感谢所有为改进本项目提出建议或贡献代码的人士（贡献者详情将在此处更新）。

(返回顶部)

星标历史

PotPlayer_ChatGPT_Translate 快速上手指南

PotPlayer_ChatGPT_Translate 是一款基于 AngleScript 开发的 PotPlayer 插件，利用 ChatGPT API（或兼容接口）实现实时、具备上下文感知的字幕翻译。相比传统翻译工具，它能更准确地处理俚语、文化梗和语境。

环境准备

• 操作系统: Windows
• 核心软件: PotPlayer (需已安装)
• API 密钥:
  • OpenAI API Key，或
  • 任何兼容 OpenAI 格式的第三方/本地大模型接口地址及密钥（如 DeepSeek, Moonshot, Local LLM 等）。
• 网络环境: 能够访问所选 AI 模型的 API 端点。

安装步骤

推荐普通用户使用全自动安装程序，无需手动配置文件路径。

方法一：全自动安装（推荐）

1. 下载安装器 前往 Releases 页面 下载最新的 installer.exe。

2. 运行安装向导 双击运行 installer.exe，若弹出管理员权限提示请点击“是”。

3. 确认插件目录 安装程序会自动检测 PotPlayer 安装路径。请确认目标文件夹为： ...\PotPlayer\Extension\Subtitle\Translate (若 PotPlayer 安装在非默认路径，请手动浏览至正确的 Translate 文件夹)

4. 选择插件模式

   • With context: 翻译质量更高，能理解上下文（推荐），延迟略高。
   • Without context: 速度更快，但缺乏上下文关联。

5. 配置模型与接口 在安装界面输入以下信息：

   • Model Name: 模型 ID（例如：gpt-4.1-nano 或 deepseek-chat）。
   • Custom API base URL (可选): 格式为 ModelName|API Base URL。
     • 示例：gpt-4.1-nano|https://api.openai.com/v1/chat/completions
   • 免密钥接口: 如果接口不需要 Key，留空密钥栏并点击 Verify。验证成功后，安装程序会自动注入 nullkey。
   • API Key: 如果需要密钥，直接粘贴即可。

6. 完成安装 点击 Install 复制文件。可选择注册卸载项以便日后清理。

方法二：手动安装

1. 从仓库下载最新 ZIP 包并解压。
2. 将 ChatGPTSubtitleTranslate.as 和 ChatGPTSubtitleTranslate.ico 复制到 PotPlayer 插件目录：

   C:\Program Files\DAUM\PotPlayer\Extension\Subtitle\Translate
   

   (请根据实际安装路径调整)
3. 启动 PotPlayer 进行配置（见下文）。

注意: 若在“带上下文”和“不带上下文”版本间切换，请务必同时替换 .as 文件，避免脚本冲突。

基本使用

安装完成后，需在 PotPlayer 内部进行简单配置即可开始使用。

1. 启用插件

1. 打开 PotPlayer，按 F5 进入偏好设置。
2. 导航至：扩展 (Extensions) > 字幕翻译 (Subtitle translation)。
3. 在列表中选择 ChatGPT Translate。

2. 配置参数

在右侧设置面板中填写关键信息：

• 模型名称 (Model Name):

  • 直接使用默认接口：输入模型名，如 gpt-4o。
  • 使用自定义接口：格式为 模型名 | 接口地址。
  • 高级格式 (v1.7+): 支持追加延迟、重试及缓存策略。

    gpt-4.1-nano|https://api.openai.com/v1/chat/completions|nullkey|500|retry1|cache=auto
    

    • nullkey: 表示无需 API Key。
    • 500: 每次请求前延迟 500ms。
    • retry1: 空响应时重试一次。
    • cache=auto: 自动管理上下文缓存。

• API Key: 填入你的密钥。若接口无需密钥且安装时未自动处理，可尝试留空或填入 nullkey（视具体接口要求而定）。

• 语言设置: 设定源语言（Source）和目标语言（Target，如 Chinese）。

3. 开始观看

加载带有字幕的视频文件，插件将自动拦截字幕流并调用 AI 进行实时翻译。你可以通过 PotPlayer 的字幕菜单切换显示原始字幕或翻译后的字幕。

常用模型配置示例

(注：表格中的 \| 在实际填写时请直接使用 | 符号)