Felix3322/PotPlayer_ChatGPT_Translate

DolOffer - 一站式数字订阅充值平台

主营 GPT、Claude 等 AI 服务会员正版订阅充值。
💰 使用折扣码：AI8888
🚀 极速发货，售后无忧。

安装 📦

全自动安装（推荐） ⚡

1. 下载安装程序： 安装程序 (安装程序是开源的，你可以查看其源码)
2. 运行安装程序（installer.exe）：
   • 双击 installer.exe 启动。
   • 如有提示，请授予管理员权限。
3. 确认插件目录：
   • 安装器会自动检测 PotPlayer 安装路径。
   • 确认目标目录为： ...\PotPlayer\Extension\Subtitle\Translate
   • 若你安装在自定义路径，请手动选择正确的 Translate 目录。
4. 选择插件版本：
   • 有上下文（翻译质量更好，延迟略高）。
   • 无上下文（速度更快，连贯性略弱）。
5. 配置模型与 API 地址：
   • **模型名称：**填写模型 ID（例如：gpt-4.1-nano）。
   • **自定义 API 地址（可选）：**使用 模型名称|API 地址 的格式。
   • **无需 Key 的接口：**请先留空并进行验证，验证通过后会写入 nullkey。
6. 输入 API Key（如需要）：
   • 将 API Key 粘贴到输入框。
   • 若接口无需 Key，请留空并点击 验证，通过后安装器会写入 nullkey。
7. 完成安装：
   • 点击 Install 复制文件。
   • 可选择写入卸载信息，方便后续卸载。
   • 注意：安装器写入的默认配置只会写入一次；之后在 PotPlayer 面板中修改会覆盖安装器默认值。

安装后请在 PotPlayer 中核对设置：

1. **打开 PotPlayer 首选项：**按 F5。
2. **进入扩展设置：**选择 扩展 > 字幕翻译。
3. **选择插件：**选中 ChatGPT 翻译。
4. 设置源语言与目标语言。

手动安装 🔧

1. 下载 ZIP 文件： 从本仓库下载最新的 ZIP 文件。

2. 解压 ZIP 文件： 将内容解压到临时文件夹中。

3. 复制文件： 将 ChatGPTSubtitleTranslate.as 和 ChatGPTSubtitleTranslate.ico 复制到以下目录：

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

   如果你的 PotPlayer 安装在其他位置，请将 C:\Program Files\DAUM\PotPlayer 替换为相应路径。

4. 在 PotPlayer 中配置：

   1. 打开 PotPlayer 首选项（按 F5）。
   2. 进入 扩展 > 字幕翻译。
   3. 选择 ChatGPT 翻译。
   4. 按需配置 模型名称、API 地址 与 API Key。
   5. 设置源语言与目标语言。

(返回顶部)

配置参考 ⚙️

1. 模型名称： 你可以仅输入模型名称，这时会使用默认的 API 接口 URL。 示例：

   gpt-4.1-nano
   

   或者，你也可以通过指定自定义 API 接口 URL，格式为：

   模型名称|API 地址
   

   示例：

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

   备注： 在新版插件中（版本 1.5），如果需要支持第三方 API 接口且不使用 API Key，可以在第二个参数中填写 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：持续重试且每次都等待延迟
   • context=3：上下文版本使用，表示发送最近 3 条历史字幕；设为 0 则不发送历史字幕
   • cache=auto / cache=off：上下文缓存模式（仅上下文版本适用；auto 不支持时自动回退到 chat）
   • smallmodel=0 / smallmodel=1：启用小模型模式（针对小模型优化的提示词）
   • checkhallucination=0 / checkhallucination=1：启用幻觉检测（若翻译长度 > 原文5倍则重试）

   完整示例：

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

2. API Key： 输入你的 API Key。 若接口无需 Key，可留空并通过安装器验证空 Key；验证通过后会写入 nullkey。

   你可以使用 keytest.obanarchy.org 测试 API Key 是否有效。

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

DeepSeek 思考模式（更新后的源码脚本）

在 PotPlayer 插件面板的“模型名称”中填写：

deepseek-flash|https://api.deepseek.com/chat/completions|thinking=disabled

此参数需要更新后的 .as 脚本。请先备份并替换 PotPlayer\Extension\Subtitle\Translate 中对应的脚本，重启 PotPlayer 后在插件面板设置；仅在旧版安装包中追加文字不会生效，安装器界面暂不配置此选项。

• thinking=disabled：Chat Completions 请求添加顶层 "thinking":{"type":"disabled"}；上下文版本的 Responses 路径使用 "reasoning":{"effort":"none"}
• thinking=enabled：开启思考；Responses 路径使用 high
• thinking=auto 或重新提交时不填写此参数：不发送上述字段，恢复服务商默认行为；只有验证成功才保存，失败不会覆盖已保存的思考设置
• reasoning_effort 用于控制思考强度，关闭思考不需要再设置一个 effort 参数；当前补丁不提供单独的强度控制
• 插件直接发送 JSON，不需要 Python SDK 的 extra_body 包装；cache=off 不会关闭思考
• 上述格式依据 DeepSeek 官方 API 文档，第三方服务商或中转接口可能不同，请勿假定所有 OpenAI 兼容接口均支持此参数

截至 2026-09-30，官方文档列出的模型为 deepseek-flash / deepseek-v4-pro；旧 deepseek-chat / deepseek-reasoner 已公告于 2026-07-24 停用，不建议再用切换旧模型名的方式关闭思考。

参考：思考模式、Chat Completions、Responses、旧模型停用公告。

模型填写示例列表

使用格式如下：

模型名称|API 地址|nullkey（可选）|delay_ms（可选）|retryN（可选）|context=3（可选）|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
DeepSeek Flash: deepseek-flash|https://api.deepseek.com/chat/completions|thinking=disabled
通义千问: qwen-plus|https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
硅基流动: siliconflow-chat|https://api.siliconflow.cn/v1/chat/completions
文心一言: 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 Key）：模型名称|http://127.0.0.1:端口/v1/chat/completions|nullkey

你也可以根据需要扩展其他兼容 OpenAI 接口的模型，确保它们支持 chat/completions 接口。

(返回顶部)

关于项目 💬

PotPlayer_ChatGPT_Translate 是一个 PotPlayer 插件，它整合了 ChatGPT API，以实现实时、上下文感知的字幕翻译。与传统翻译工具不同，该插件能够考虑上下文、惯用语和文化差异，从而提供更准确的翻译。项目的核心部分使用 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 翻译结果（有上下文）：

  "但在现实生活中成为一个反派更好。" (准确捕捉语境)

(返回顶部)

视频教程 🎥

点击下面的视频链接，在 Bilibili 上观看教程：

(回到顶部)

graph TD
    %% --- Initialization Phase ---
    Start([开始: Translate]) --> InitConfig[加载配置与Token规则]
    InitConfig --> CheckAuth{检查 API Key?}
    CheckAuth -- 否 --> RetError([返回错误信息])
    CheckAuth -- 是 --> UpdateHist[更新字幕历史]

    %% --- Context Management ---
    UpdateHist --> ContextMode{插件版本?}

    subgraph ContextLogic [上下文处理]
        direction TB
        ContextMode -- "无上下文版" --> NoContextPrompt[无上下文]
        ContextMode -- "带上下文版" --> ReadCount[读取字幕条数设置]
        ReadCount --> TrimHist[保留最近历史字幕]
        TrimHist --> BuildBlock["构建上下文块\n最多配置的最近条数"]
    end

    %% --- Prompt Engineering ---
    subgraph PromptEng [提示词构建]
        direction TB
        BuildBlock --> SmallModel{启用小模型模式?}
        NoContextPrompt --> SmallModel

        SmallModel -- 是 --> StrictPrompt["System: 翻译指令\nUser: <CONTEXT>/<CURRENT> 边界"]
        SmallModel -- 否 --> StdPrompt["System: 翻译指令\nUser: <CONTEXT>/<CURRENT> 边界"]

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

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

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

        LoopCond -- 是 --> DelayCheck{是重试吗?}
        DelayCheck -- 是 --> Wait["休眠 (DelayMs)"]
        DelayCheck -- 否 --> CacheBranch
        Wait --> CacheBranch

        %% Cache Branch
        CacheBranch{启用缓存模式?}
        CacheBranch -- 是 --> ReqCache[请求 /responses 端点]
        CacheBranch -- 否 --> ReqChat

        ReqCache --> RespCache{响应成功?}
        RespCache -- 是 --> ParseCache[提取 'output_text']
        RespCache -- 否 --> LogCacheFail[记录失败] --> ReqChat[请求 /chat/completions]

        ParseCache --> HallucinationCheck

        %% Standard Chat Branch
        ReqChat --> NetCheck{网络连接正常?}
        NetCheck -- 否 --> IncRetry[尝试次数++] --> LoopCond
        NetCheck -- 是 --> ParseJSON{JSON 有效?}

        ParseJSON -- 否 --> IncRetry
        ParseJSON -- Error --> LogAPIError[记录 API 错误] --> IncRetry
        ParseJSON -- Success --> ExtractContent[提取内容]

        ExtractContent --> HallucinationCheck{幻觉检测?}

        HallucinationCheck -- "长度 > 原文5倍" --> LogHallu[警告: 检测到幻觉] --> IncRetry
        HallucinationCheck -- 正常 --> SuccessBreak[跳出循环]
    end

    %% --- Post Processing ---
    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 翻译 则能捕捉电影引用和上下文，提供更贴切的翻译结果。

(返回顶部)

开发计划 🗺

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

(返回顶部)

贡献指南 🤝

欢迎所有贡献！在提交 Pull Request 时，请清楚描述你所做的修改内容。 如果你有改进建议或 Bug 修复，请在修改前先通过 Issue 进行讨论。

(返回顶部)

许可证 📄

本项目采用 GPLv3 许可证进行分发。更多信息请参阅 LICENSE 文件。

(返回顶部)

联系方式 📞

个人网站：obanarchy.org

(返回顶部)

致谢 🙏

• 感谢 OpenAI 提供强大的 ChatGPT API。
• 感谢 PotPlayer 团队打造出色的媒体播放器。
• 感谢所有对本项目提出建议或贡献代码的朋友（贡献者名单会在此更新）。

(返回顶部)

Star History

翻译前过滤字幕

在 PotPlayer 的 Extension/Subtitle/Translate/ 目录（即 .as 脚本所在目录）创建 UTF-8 文本文件 ChatGPT-subtitle-filter.txt。两个版本共用该文件；它独立于脚本，不属于安装程序覆盖的文件。例如：

# 每行一条规则，等号后的空格也属于规则
contains=my name is
exact=skip this
word=cat

contains= 删除所有字面匹配的片段；exact= 仅在字幕去掉首尾空白后整条相同时跳过；word= 仅在文字两边是文本边缘或 ASCII 空白、标点时删除。例如 word=cat 会匹配 cat!，不会匹配 cats、cat_1，也不会匹配与非 ASCII 字符紧邻的情况；这不是按语言分词。所有匹配区分大小写；先执行整句规则，再执行单词规则，最后执行片段规则，每组按文件顺序处理。空值和未知行忽略；支持 CRLF、LF 和 UTF-8 BOM，等号后的空格有意义。

每次翻译都会重新读取规则；文件不存在时不启用过滤，无法读取或超过 256 KiB 时忽略该文件。过滤后只剩空白的字幕不会发给模型，也不会进入上下文。卸载或更换安装目录前请备份个人规则。Windows 可能要求管理员权限才能在脚本目录创建文件。