PotPlayer本地AI字幕翻译插件
- 实时翻译 PotPlayer 播放的视频字幕
- 支持多种语言之间的互译
- 使用本地部署的 AI 模型,保护用户隐私
- 专业的翻译提示词,提高翻译质量
- PotPlayer 1.7.21505 或更高版本
- 本地部署的 AI 服务(如 LocalAI、Ollama 等)
- 支持的 AI 模型(如 qwen3-4b-instruct 等)
- 确保已安装并运行本地 AI 服务
- 将
SubtitleTranslate - LocalAI.as文件复制到 PotPlayer 的插件目录:- 通常位于
C:\Program Files\DAUM\PotPlayer\Extensions\Subtitle - 或者 PotPlayer 安装目录下的相应文件夹
- 通常位于
- 重新启动 PotPlayer
- 在 PotPlayer 中启用插件:
- 打开 PotPlayer 设置
- 转到 "字幕" -> "翻译"
- 选择 "Local AI translate" 作为翻译引擎
在首次使用插件时,需要配置以下参数:
- Model Name: AI 模型名称(例如:qwen3-4b-instruct-2507)
- API URL: 本地 AI 服务的 API 地址(例如:http://localhost:12340/v1/chat/completions)
- API Key: 如果本地 AI 服务需要认证,请输入相应的 API 密钥
- 在 PotPlayer 中打开带有字幕的视频文件
- 确保字幕已启用并显示
- 在字幕设置中选择目标语言进行翻译
- 字幕将实时翻译并显示在视频上
插件支持多种语言的翻译,包括但不限于:
- 中文 (zh-CN, zh-TW)
- 英语 (en)
- 日语 (ja)
- 韩语 (ko)
- 法语 (fr)
- 德语 (de)
- 西班牙语 (es)
- 俄语 (ru)
- 阿拉伯语 (ar)
- 等等...
插件使用专业的翻译提示词来指导 AI 模型:
You are a professional translator. Please translate the following text accurately while preserving the original meaning, tone, and context. Ensure the translation is natural and fluent in the target language.
插件向本地 AI 服务发送的请求格式如下:
{
"model": "模型名称",
"messages": [
{
"role": "system",
"content": "专业翻译提示词"
},
{
"role": "user",
"content": "翻译请求:Translate from [源语言] to [目标语言]: [文本]"
}
],
"temperature": 0.5
}-
插件无法加载
- 确认插件文件放置在正确的目录中
- 检查 PotPlayer 版本是否符合要求
-
翻译功能无响应
- 检查本地 AI 服务是否正在运行
- 验证 API URL 和模型名称是否正确
- 确认网络连接正常
-
翻译质量不佳
- 尝试更换其他 AI 模型
- 检查本地 AI 服务的资源配置
- 确认模型支持所选语言
如果遇到问题,可以查看 PotPlayer 的日志文件以获取更多信息:
- 日志通常位于 PotPlayer 安装目录或用户配置目录中
- 添加了专业的翻译提示词,提高翻译质量
- 优化了与本地 AI 服务的通信
- 修复了 JSON 请求格式问题
- 改进了错误处理机制
- 初始版本发布
- 基本的字幕翻译功能
- 支持多种语言
本插件默认配置使用以下模型和API端点:
- 默认模型:
qwen3-4b-instruct-2507 - 默认API端点:
http://localhost:12340/v1/chat/completions
使用者可以根据自己搭建的AI模型情况自行更改模型名称和API端点地址。
感谢 Felix3322/PotPlayer_ChatGPT_Translate 项目的作者,本插件参考了该项目的源代码实现。
本项目基于 MIT 许可证发布。
欢迎提交 Issue 和 Pull Request 来改进这个插件。
如有问题或建议,请通过以下方式联系:
- 提交 GitHub Issue








