1 line
27 KiB
JSON
1 line
27 KiB
JSON
{"repo": "castlepower666/potplayer-plugin-aitranslate", "files": {"README.md": {"3832a531a4efde620c547f787f9b2c8cdb46f81d": {"t": 1785674116.2313066, "n": 14083, "h": "6ce8a2c98a0bfea6", "c": "# PotPlayer AI字幕翻译插件\n\n> **版本：v1.1.3** | **状态：Official Release** ✅\n\n## 📖 简介\n\n这是一套用于PotPlayer的AI字幕实时翻译插件，支持接入主流AI大模型API进行字幕翻译。\n\n**核心特性**：\n- 🤖 **多模型支持** - 支持OpenAI、DeepSeek、通义千问、火山引擎、SiliconFlow等兼容API\n- 💬 **口语化翻译引擎** - 优先自然日常表达，强制使用口语粒子（啦/呀/呢/吧/嘛）\n- 🎯 **用户自定义提示词** - 革命性的个性化翻译控制，用户请求优先机制\n- 🎬 **8种内容类型适配** - anime、scifi、drama、horror等专业领域翻译优化\n- 📚 **智能上下文管理** - 自动判断是否需要历史信息，避免误导翻译\n- 🔍 **6步质量检查** - 包括平淡度、一致性、清晰度等完整质量评估\n- 🔄 **自动场景检测** - 可配置1-60000ms阈值，智能清空过时上下文\n- 💾 **完整缓存机制** - 避免重复调用，提升翻译效率\n- ⚙️ **灵活配置系统** - 支持上下文条数、场景阈值、内容类型等参数调整\n\n**v1.1.3 新功能亮点**：\n- 适配火山引擎、智谱厂商，现在火山和智谱能正常使用；适配deepseek新版的api\n- 添加报错提示，可以直接在字幕处观察到报错，不会再手足无措了\n\n**感谢b站网友[BAB3L](https://space.bilibili.com/90462124?spm_id_from=333.40164.0.0)的提议与支持**\n\nBAB3L提议将播放视频的文件名加入提示词，这个功能应该会很有用。\n\n并向potplayer作者请求相关的api开放，作者答应在下一个版本提供相关的api。\n\nBAB3L还帮忙制作了插件的图标，非常感谢！\n\n这里也预告一下，下一个版本出来之后，插件也会跟进，加入这个功能。\n\n\n## 🚀 安装方法\n\n1. 找到PotPlayer安装目录下的扩展文件夹：\n ```\n PotPlayer安装目录\\Extension\\Subtitle\\Translate\\\n ```\n \n2. 将 `.as` 插件文件复制到该目录\n\n3. 重启PotPlayer\n\n## ⚙️ 配置方法\n\n### 方法一：在PotPlayer中配置（推荐）\n\n1. 打开PotPlayer\n2. 右键 → 字幕 → 字幕翻译 → 选择\"AI大模型翻译\"\n3. 点击\"账户设置\"\n4. 按以下格式输入配置\n\n**配置格式**：\n```\nURL|Model|ContextCount|Genre|SceneThreshold|CustomPrompt\nAPI Key\n```\n\n**参数说明**：\n- `URL` - API服务地址（**必填**）\n- `Model` - 模型名称（**必填**，不填写会直接报错）\n- `Context` - 上下文条数，0-20（可选，默认5）\n- `Genre` - 内容类型（可选，默认general）\n- `SceneThreshold` - 场景切换检测时间，1-60000ms（可选，默认6000ms）\n- `CustomPrompt` - 用户自定义提示词（可选，会追加到系统提示词末尾）\n\n**重要提示**：必须保留所有 `|` 分隔符。`Model` 为必填项，不能留空。\n\n**配置示例**：\n```\n# 标准配置（动漫，5条上下文，6秒场景检测，自定义提示词）\nhttps://api.deepseek.com|deepseek-chat|5|anime|6000|请使用更口语化的表达，加入更多网络流行语\nsk-xxxxxxxxxxxxx\n\n# 火山引擎 Ark（自动附加 reasoning_effort=minimal，意思是关闭思考模式，下同）\nhttps://ark.cn-beijing.volces.com/api/v3|doubao-seed-1-6-250615|5|general|6000|\nsk-xxxxxxxxxxxxx\n\n# 智谱 BigModel（自动附加 thinking.type=disabled）\nhttps://open.bigmodel.cn/api/paas/v4|glm-5.1|5|general|6000|\nsk-xxxxxxxxxxxxx\n\n# 通义千问 DashScope 兼容模式（自动附加 enable_thinking=false）\nhttps://dashscope.aliyuncs.com/compatible-mode/v1|qwen-plus|5|general|6000|\nsk-xxxxxxxxxxxxx\n\n# SiliconFlow（自动附加 enable_thinking=false）\nhttps://api.siliconflow.cn/v1|Qwen/Qwen3-8B|5|general|6000|\nsk-xxxxxxxxxxxxx\n```\n\n**厂商请求地址汇总**：\n- deepseek https://api.deepseek.com\n- 阿里百炼 https://dashscope.aliyuncs.com/compatible-mode/v1\n- 智谱 https://open.bigmodel.cn/api/paas/v4 \n- 硅基流动 https://api.siliconflow.cn/v1\n- 火山引擎 https://ark.cn-beijing.volces.com/api/v3\n\n*插件把这些厂商的思考模式关了，不然用不了*\n\n任何兼容OpenAI API格式的服务都可以使用（请使用非思考模型），只需修改API地址即可。\n\n### 方法二：直接修改插件代码\n\n编辑 `.as` 文件，修改以下变量：\n\n```angelscript\nstring g_apiKey = \"你的API Key\";\nstring g_baseUrl = \"https://api.deepseek.com\"; // 或其他API地址\nstring g_model = \"deepseek-chat\"; // 必填，不可留空\n```\n\n## 🎬 使用方法\n\n1. 打开视频文件\n2. 加载外挂字幕文件（.srt, .ass, .ssa等）\n3. 右键 → 字幕 → 字幕翻译\n4. 选择你安装的AI翻译插件\n5. 选择源语言和目标语言\n6. 字幕将自动实时翻译\n\n## 🌍 支持的语言\n\n自动检测、English、简体中文、繁體中文、日本語、한국어、Français、Deutsch、Español、Русский、Português、Italiano、العربية、ไทย、Tiếng Việt\n\n## 💡 提示词系统改进 \n\n### 多语言英文提示词\n\n所有提示词已转换为英文，确保在任何语言的翻译中都能获得一致的高质量指导。系统不再依赖中文提示词，而是使用**英文提示词框架**，这样可以：\n\n- ✅ 支持多语言翻译目标（中文、日文、韩文、法文等）\n- ✅ 避免提示词本身的语言歧义\n- ✅ 通过明确的英文指导确保质量一致性\n\n### 6步质量检查流程\n\n翻译引擎现在包含完整的质量检查机制：\n\n1. **情感真实性检查** - 情感与原文是否一致？\n2. **一致性验证** - 角色语音、术语是否一致？\n3. **清晰度评估** - 表达是否清晰易懂？\n4. **平淡度检查** NEW - 是否避免了平淡生硬的表达？\n5. **文化适配验证** - 是否符合目标语言文化？\n6. **最终质量评分** - 综合评估翻译质量\n\n### 口语化粒子强制应用\n\n系统现在明确要求在中文翻译中使用：\n- `啦` - 完成性/确定感（搞定啦、来啦）\n- `呢` - 疑问/思考（咋整呢、怎么办呢）\n- `吧` - 建议/不确定（走吧、这样吧）\n- `嘛` - 强调/理所当然（这不是嘛、谁都知道嘛）\n- `呀` - 感叹（真的呀、天哪呀）\n\n这些粒子使翻译更具自然感，避免生硬和平淡。\n\n## 🎬内容类型（Genre）功能详解\n\nGenre 是一个可选参数，根据内容类型自动调整翻译风格。8种内容类型都已用英文提示词重新设计，确保多语言适配一致性。\n\n### 支持的9种内容类型\n\n#### 1. **anime**（日本动漫）\n- **适用**：日本动画、日系漫画改编作品\n- **特点**：NATURAL DIALOGUE、CHARACTER DIFFERENTIATION、ACTION SCENES with power words\n- **关键原则**：角色对话要自然，不同角色有不同的说话风格\n\n#### 2. **western-comic**（欧美动画/漫画）\n- **适用**：美国漫画、欧美动画、好莱坞风格内容\n- **特点**：HUMOR LANDS（笑点必须好笑）、CASUAL LANGUAGE（粗俗/俚语可用）、ONE-LINERS（简洁有力）\n- **关键原则**：笑点落地，讽刺明显，动感十足\n\n#### 3. **scifi**（科幻）\n- **适用**：科幻电影、未来题材\n- **特点**：CONSISTENT JARGON（术语一致）、FUTURISTIC FEEL（未来感）、SIMPLIFY COMPLEX（简化复杂概念）\n- **关键原则**：术语必须一致，解释技术的用途和意义\n\n#### 4. **disney**（迪士尼）\n- **适用**：儿童电影、家庭内容\n- **特点**：WARMTH IS PRIMARY（亲切感）、GENTLE WORD CHOICE（包容感）、LAUGHTER IS KINDNESS（善良的幽默）\n- **关键原则**：温暖、积极、充满希望，不是被教育而是被吸引\n\n#### 5. **fantasy**（奇幻）⭐ ENHANCED\n- **适用**：魔幻剧集、冒险故事\n- **特点**：史诗感，奇幻术语（魔法、精灵、龙），宏大英勇\n- **关键原则**：保留世界观一致性，术语翻译统一\n\n#### 6. **drama**（剧情）\n- **适用**：电视剧、现代故事\n- **特点**：DIALOGUE AUTHENTICITY（真实对白）、SUBTEXT IS KEY（潜台词）、COLLOQUIAL EXTREME（极度口语）\n- **关键原则**：自然、细腻、有感情，对话要真实可信\n\n#### 7. **horror**（恐怖）\n- **适用**：恐怖电影、惊悚内容\n- **特点**：ATMOSPHERE OVER PLOT（气氛比情节重要）、SHORT SENTENCES（短句制造紧张）、COLD THREATS（冷酷威胁）\n- **关键原则**：压抑、诡异、很有张力，不靠吓而靠造势\n\n#### 8. **gamedev**（游戏开发教程）\n- **适用**：Unity、Unreal Engine 等游戏开发教程\n- **特点**：TERMINOLOGY PRECISION（术语精准）、PROGRESSION（循序渐进）、HONEST BUT SUPPORTIVE（坦诚但鼓励）\n- **关键原则**：清楚、鼓励、实用，像朋友在教你代码\n\n#### 9. **general**（通用，默认）\n- **适用**：不确定的内容\n- **特点**：DIALOGUE FIRST（优先自然对白）、MEANING NOT WORDS（意思而非字对字）、CHARACTER VOICE（保持人物个性）\n- **关键原则**：自然、真实、好听，如果听起来好就是对的\n\n### 翻译效果对比示例\n\n**原文**：The mage cast a powerful spell to save the day.\n\n| Genre | 翻译结果 | 风格 |\n|-------|---------|------|\n| anime | 法师施展了强大的魔法来拯救局面。| 日漫术语 |\n| western-comic | 魔法师释放了强大的能量来挽救局面。| 欧美漫画风格 |\n| scifi | 魔法师释放了强大的能量脉冲来扭转局势。| 科技色彩 |\n| disney | 小仙女释放了美妙的魔力来拯救大家。| 温暖梦幻 |\n| fantasy | 大法师施放了一个强大的咒语来挽救局面。| 史诗感 |\n| drama | 那个法师施展魔法拯救了局面。| 自然真实 |\n| horror | 黑暗法师释放了可怕的诅咒魔法...| 诡异压抑 |\n| gamedev | （游戏开发教程术语）| 游戏术语 |\n| general | 法师施展了强大的法术来挽救局面。| 平衡标准 |\n\n**游戏开发教程例子**：You need to attach a Collider component to enable physics interactions.\n\n| Genre | 翻译结果 |\n|-------|---------|\n| gamedev | 你需要附加一个 Collider 组件来启用物理交互。|\n| general | 你需要附加一个碰撞器组件来启用物理交互。|\n\n### Genre 使用注意事项\n\n- 无效的 Genre 会直接报错，请使用有效值：`anime|western-comic|scifi|disney|fantasy|drama|horror|gamedev|general`\n- 添加 Genre 会增加约 5-10% 的 API 成本（因为 Prompt 变长）\n- 更改 Genre 无需重启，重新登录新配置即可生效\n\n\n### 上下文条数建议\n\n- **0条**：无上下文，最快翻译（可能缺乏连贯性）\n- **3-5条**：标准配置，平衡质量和速度（推荐）\n- **8-10条**：长对话场景，更好的连贯性（增加API成本）\n- **15+条**：超长对话序列（高成本）\n\n### 场景切换阈值建议 \n\n| SceneThreshold | 适用场景 | 特点 |\n|---|---|---|\n| 1000-2000ms | 快速切换类（动作片、竞技游戏教程） | 反应灵敏，快速清空历史 |\n| 3000-6000ms | 一般电影/电视剧（**默认6000**） | 平衡反应和上下文保留 |\n| 8000-12000ms | 对话密集剧（悬疑剧、法庭剧） | 保留更长对话上下文 |\n| 15000-30000ms | 长剧情片、教学内容 | 维持超长对话一致性 |\n| 40000-60000ms | 长纪录片、讲座 | 极长上下文保留 |\n\n**建议配置组合**：\n- 快速切换内容：`|deepseek-chat|0||2000` (无上下文，2秒检测)\n- 一般看剧：`|deepseek-chat|5||6000` (5条上下文，6秒检测)\n- 高质量剧情：`|deepseek-chat|8|drama|10000` (8条上下文，10秒检测)\n- 教学视频：`|deepseek-chat|5|gamedev|15000` (5条上下文，15秒检测)\n\n## 🎯 用户自定义提示词功能 \n\n### 功能概述\n\n用户自定义提示词功能允许用户在系统提示词的基础上追加个性化的翻译指导，实现更精细的翻译风格控制。\n\n### 配置方式\n\n在配置的第6个参数中添加自定义提示词：\n```\nURL|Model|Context|Genre|SceneThreshold|CustomPrompt\n```\n\n### 技术实现\n\n#### 提示词构建流程\n1. **系统提示词** - 构建专业翻译规则和质量检查流程\n2. **内容类型指导** - 根据 Genre 添加特定领域指导\n3. **用户自定义提示词** - 在末尾追加个性化指导\n4. **完整提示词** - 发送给 AI 模型\n\n#### 优先级处理机制\n系统采用智能优先级处理机制，确保用户需求与系统规则的最佳结合：\n\n**冲突处理原则**：\n- **当用户请求与系统规则冲突时** → 用户请求优先\n- **当用户请求与系统规则互补时** → 结合使用\n- **当用户请求是系统规则的细化时** → 结合使用\n\n**具体示例**：\n- **冲突场景**：用户要求\"使用正式学术用语\" vs 系统默认\"口语化优先\" → 遵循用户请求\n- **互补场景**：用户要求\"请保持术语一致性\" + 系统\"口语化优先\" → 结合使用\n- **细化场景**：用户要求\"请使用更生动的比喻\" + 系统\"口语化优先\" → 结合使用\n\n**AI接收的优先级说明**：\n```\n=== USER CUSTOM PROMPT ===\nUSER'S REQUEST HAS HIGHER PRIORITY WHEN CONFLICTS OCCUR. \nIf user's request conflicts with system rules (colloquial speech, \ngenre guidelines, etc.), FOLLOW USER'S REQUEST. \nOtherwise, combine both system rules and user preferences.\n\n用户自定义的翻译指导\n```\n\n\n## 💬 口语化翻译原则\n\n插件优先使用自然、日常的中文表达，而不是生硬的文言文。\n\n### 核心原则\n\n1. **日常自然** - 优先使用常用词汇，避免晦涩古文\n - ❌ 不：「此人乃一智者也」\n - ✅ 是：「这个人真聪明」\n\n2. **避免文言** - 摒弃之乎者也，用现代口语\n - ❌ 不：「汝何故如斯」\n - ✅ 是：「你怎么这样啊」\n\n3. **保留人物性格** - 翻译要体现角色个性和口吻\n - 原文：\\\"I ain't got no time for this\\\" (粗鲁角色)\n - ✅ 是：「老子没空搭理你这破事」(保留粗鲁风格)\n\n4. **允许不完整句子** - 真实对话中存在省略和断句\n - ✅ 接受：「不行...太危险了」（不必完全成句）\n\n5. **语调和表情** - 保持原文的语气和情感\n - 原文：\\\"Oh come on!\\\" (轻松玩笑)\n - ✅ 是：「拜托啦」(轻松调侃)\n\n### 场景应用示例\n\n**日常对话**：\n```\n原文：Hey, what's up?\n✅ 翻译：嘿，怎么样？\n❌ 反例：喂，汝今日如何？\n```\n\n**强调语气**：\n```\n原文：I literally died laughing!\n✅ 翻译：我笑死了！\n❌ 反例：我奋笔疾书地死亡而笑也。\n```\n\n**俏皮表达**：\n```\n原文：That's so fetch!\n✅ 翻译：超级带劲儿！\n❌ 反例：该事物乃卓越不凡。\n```\n\n## 🎭 俚语与成语处理\n\n### 俚语识别系统\n\n插件在翻译前进行俚语预检查，包含以下红旗警告：\n\n**动物相关成语**：\n- \\\"go ape\\\" → 发疯\n- \\\"rat out\\\" → 背叛\n- \\\"dog days\\\" → 难熬的日子\n- \\\"bug out\\\" → 惊吓\n\n**身体部位成语**：\n- \\\"cost an arm and a leg\\\" → 非常昂贵\n- \\\"break a leg\\\" → 祝演出顺利\n- \\\"lose your head\\\" → 失控\n- \\\"get cold feet\\\" → 临阵退缩\n\n**天气和自然现象**：\n- \\\"raining cats and dogs\\\" → 下倾盆大雨\n- \\\"under the weather\\\" → 身体不适\n- \\\"weather the storm\\\" → 度过难关\n\n**\\\"like\\\" 短语**：\n- \\\"like a fish out of water\\\" → 如鱼离水\n- \\\"like clockwork\\\" → 准时如钟\n- \\\"like there's no tomorrow\\\" → 尽情享受\n\n### 翻译原则\n\n1. **保留精神** - 传达原成语的精神含义而非字面意思\n2. **适应文化** - 用中文成语或比喻替代，而非生硬直译\n3. **维持语调** - 幽默、俏皮或严肃的语气必须保留\n\n### 场景示例\n\n**电影对白**：\n```\n原文：I'm not gonna spill the beans, so cool your jets.\n预检查：识别到\\\"spill the beans\\\"（泄露秘密）和\\\"cool your jets\\\"（别急）\n✅ 翻译：我不会泄露秘密的，别急。\n```\n\n**漫画对话**：\n```\n原文：When life gives you lemons, make lemonade!\n预检查：识别到常见生活俚语\n✅ 翻译：生活给你酸柠檬，就把它做成柠檬茶！\n```\n\n## 🌍 多语言文化适配 \n\n系统根据源语言自动调整文化背景，确保翻译符合该文化的表达习惯。\n\n### 英文（English）- 好莱坞与美英文化\n\n**特点**：\n- 美式文化、好莱坞电影词汇\n- 英式和美式英语表达差异\n- 讽刺和黑色幽默常见\n\n**示例**：\n```\n原文：This is totally mental! (英式)\n✅ 翻译：这太疯狂了！\n```\n\n**常见习语**：\n- \\\"fancy\\\" → 喜欢/高级（英式）vs \\\"cool\\\" → 酷（美式）\n- \\\"knock someone up\\\" → 敲门（英式）vs 使怀孕（美式）\n\n### 日文（日本語）- 动漫与敬语文化\n\n**特点**：\n- 动漫常用术语（魔法、法师、幻兽）\n- 敬语系统（-san, -chan, -sama, -sensei）\n- 参考笑料和文化梗（宫崎骏、龙珠等）\n\n**示例**：\n```\n原文：これはすごい！(日文)\n✅ 翻译：这太厉害了！(保留日本动漫的热情感)\n原文：田中さん (带敬语)\n✅ 翻译：田中先生 (恰当翻译敬语)\n```\n\n### 韩文（한국어）- K文化与阶级制度\n\n**特点**：\n- K-pop、K-drama 流行语\n- 韩文中的敬语和阶级关系\n- \\\"应援\\\"（追星应援）、\\\"偶像\\\"等文化概念\n\n**示例**：\n```\n原文：화이팅! (加油)\n✅ 翻译：加油！(保留韩文的战斗精神)\n```\n\n### 法文（Français）- 浪漫与诗意\n\n**特点**：\n- 浪漫优雅的表达\n- 诗意和哲学气质\n- 法国电影和文学风格\n\n**示例**：\n```\n原文：C'est magnifique!\n✅ 翻译：这太精妙绝伦了！(诗意表达)\n```\n\n## 🔍 上下文智能判断系统\n\n### 工作原理\n\n插件会智能判断是否需要使用上下文：\n\n1. **判断场景一致性** - 检查是否在同一场景/对话\n2. **评估上下文相关性** - 判断历史字幕是否有帮助\n3. **条件性使用** - 相关时使用历史，无关时独立翻译\n\n### 典型场景\n\n**✅ 应该使用上下文**：\n```\n字幕1：\\\"These ancient ruins hold the secret.\\\"\n字幕2：\\\"Let's explore them.\\\"\n↓\n上下文有助于理解\\\"them\\\"指什么，翻译时需要用上前文\n```\n\n**❌ 不应该使用上下文**：\n```\n电影1：\\\"The mission is complete.\\\" (第一部电影结尾)\n[场景切换20分钟]\n电影2：\\\"Let's start the new mission.\\\"\n↓\n上下文无关，应该独立翻译，不受前面的影响\n```\n\n### 配置建议\n\n- **连续对话** → 使用 5-8 条上下文\n- **独立场景** → 使用 0-2 条上下文\n- **文艺作品** → 使用 3-5 条上下文（保持节奏）\n\n## 🔍 AI自检机制\n\n### 自检项目\n\n翻译完成后，AI会在返回结果前进行以下检查：\n\n1. **语法检查** - 确保中文表达正确\n - 成分残缺：主语、谓语、宾语完整\n - 搭配恰当：词语搭配自然流畅\n - 标点正确：逗号、句号、问号使用恰当\n\n2. **逻辑检查** - 确保意思准确\n - 因果关系正确\n - 顺序逻辑合理\n - 不产生矛盾含义\n\n3. **一致性检查** - 确保风格和用词统一\n - 同一概念用词一致\n - 人物性格表达一致\n - 术语选择一致\n\n4. **拼写与错别字检查**\n - 没有生僻错别字\n - 常见词语正确\n - 专有名词准确\n\n5. **格式检查**\n - 只返回翻译文本，不含解释\n - 不含多余换行\n - 符合字幕显示格式\n\n### 示例\n\n```\n原文：\\\"I can't even begin to express how much I love you.\\\"\n\n第一遍生成：\\\"我甚至无法开始表达我有多爱你。\\\"\n↓ 自检发现：\\\"甚至无法开始\\\"显得生硬\n自纠正为：\\\"我真的无法言喻有多爱你。\\\"\n↓ 再次检查：语法✓ 逻辑✓ 一致✓\n最终返回：\\\"我真的无法言喻有多爱你。\\\"\n```\n\n#### 最终提示词结构\n```\n系统专业翻译规则...\n质量检查流程...\n内容类型指导...\n\n=== USER CUSTOM PROMPT ===\n用户自定义的翻译指导\n```\n## ⚠️ 注意事项\n\n1. **网络要求**：需要稳定的网络连接访问API服务\n2. **费用**：AI API通常按使用量收费，请注意控制成本\n3. **延迟**：由于需要网络请求，翻译会有一定延迟\n4. **准确性**：AI翻译质量取决于所选模型，建议使用GPT-4或DeepSeek-chat\n5. **场景检测**：自定义SceneThreshold时，1000ms太快易误触，30000ms+太慢可能不清缓存\n\n## 🔧 常见问题\n\n### Q: 翻译没有反应？\nA: 检查API Key是否正确，网络是否通畅\n\n### Q: 翻译速度慢？\nA: \n- 减少上下文条数（改为 0-3）\n- 尝试使用更快的模型（如gpt-3.5-turbo）\n- 尝试使用更近的API节点\n\n### Q: 翻译结果不准确？\nA: \n- 尝试更换为更强大的模型（如gpt-4、deepseek-chat）\n- 增加上下文条数（改为 5-8）\n- 选择更准确的 Genre 类型\n\n### Q: Genre 功能有什么用？\nA: Genre 帮助AI理解内容类型，使用更合适的术语和表达方式。例如看动漫时用 `anime`，看科幻时用 `scifi`，看游戏开发教程时用 `gamedev`，翻译质量会更好。\n\n### Q: Genre 拼错了会怎样？\nA: 无效的 Genre 会直接报错，请检查并改为有效值：`anime|western-comic|scifi|disney|fantasy|drama|horror|gamedev|general`。\n\n### Q: 如何快速切换 Genre？\nA: 重新登录时输入新的 Genre 参数即可，无需重启软件。\n\n### Q: 如何查看调试信息？\nA: 在插件中使用 `HostOpenConsole()` 打开调试控制台\n\n### Q: 什么是 SceneThreshold 场景切换检测？ ⭐ NEW\nA: SceneThreshold 是指多久没有新字幕时自动清空翻译历史。\n- 1000ms (1秒) - 反应灵敏，快速场景切换\n- 6000ms (6秒) - 默认值，适合大多数内容\n- 10000ms (10秒) - 慢速场景，避免过早清除上下文\n- 30000ms (30秒) - 长剧情片，保持更长的对话记录\n\n### Q: 口语化翻译会影响专业术语吗？ ⭐ NEW\nA: 不会被忽视，但不能100%保证。系统有机制保留专业术语（通过一致性检查、Genre指导等），但最终取决于AI模型的理解。建议在科幻、技术等专业领域使用足够的上下文（5-8条）来确保术语准确性。\n\n### Q: 俚语识别有遗漏怎么办？ ⭐ NEW\nA: 内置识别 15+ 常见英文俚语和成语。如果有遗漏，AI 会根据上下文和文化背景推断含义。建议在 Genre 中选择对应的文化背景（anime/western-comic/scifi等）以获得更准确的俚语翻译。\n\n### Q: 上下文智能判断会不会判断错误？ ⭐ NEW\nA: AI 会基于以下因素判断：对话连贯性、时间间隔（通过 SceneThreshold 检测）、场景和角色一致性。虽然极少数情况可能判断错误，但可以通过调整 ContextCount 来手动控制（0 = 完全不用上下文）。\n\n### Q: 是否支持自定义俚语库？ ⭐ NEW\nA: 目前暂不支持直接自定义俚语库，但可以通过提高 ContextCount 和选择合适的 Genre 来改善俚语翻译。未来可能添加自定义俚语库功能。\n\n### 成本优化建议\n\n- 成本敏感：使用 general 或较少上下文\n- 质量优先：选择准确的 Genre + 足量上下文\n- 平衡方案：选择 Genre + 中等上下文（5条）\n\n\n### 配置持久化\n\n所有配置会自动保存到PotPlayer本地存储：\n- API Key（`AI_Trans_Key`）\n- API地址（`AI_Trans_Url`）\n- 模型名称（`AI_Trans_Model`）\n- 上下文条数（`AI_Trans_History`）\n- 内容类型（`AI_Trans_Genre`）\n\n\n### 注意事项\n\n1. **分隔符必须保留** - 省略参数时使用空位 `|` 表示\n2. **提示词长度** - 过长的自定义提示词可能增加 API 成本\n3. **效果验证** - 建议先测试小段文字验证翻译效果\n4. **参数顺序** - 必须按照固定顺序填写参数\n\n## 📝 开发说明\n\n插件基于AngelScript开发，主要函数：\n\n| 函数 | 说明 |\n|------|------|\n| `GetTitle()` | 返回插件名称 |\n| `GetVersion()` | 返回版本号 |\n| `GetDesc()` | 返回插件描述 |\n| `ServerLogin()` | 处理登录/配置 |\n| `Translate(text)` | 核心翻译函数 |\n\n## 📜 许可证\n\nMIT License - 可自由使用和修改\n\n---\n\n**最后更新**：2026年4月 \n**维护者**：castlepower666 \n**协作**：GitHub Copilot \n**状态**：Production Ready ✅\n\n---\n\n## 🎯 完整功能矩阵 ⭐ NEW\n\n| 功能 | 状态 | 版本 | 说明 |\n|------|------|------|------|\n| 基础翻译 | ✅ | 1.0+ | OpenAI 兼容 API |\n| 多模型支持 | ✅ | 1.0+ | GPT/DeepSeek/通义千问/Gemini |\n| 上下文感知 | ✅ | 1.0+ | 0-20 条历史记录 |\n| 场景检测 | ✅ | 1.0+ | 可配置 1-60000ms |\n| Genre 分类 | ✅ | 1.0+ | 9 种内容类型 |\n| 完整缓存 | ✅ | 1.0+ | 避免重复调用 |\n| 口语化翻译 | ✅ | 1.0+ | 日常自然表达 |\n| 俚语识别** | ✅ | 1.0+ | 15+ 成语库 + 预检查 |\n| 文化适配** | ✅ | 1.0+ | 4种语言文化背景 |\n| 上下文智能 | ✅ | 1.0+ | 自动判断相关性 |\n| AI自检 | ✅ | 1.0+ | 5项质量检查 |\n\n---\n\n## 📈 版本历史\n\n### v1.1.0 - User Custom Prompts \n**最新发布版本（个性化翻译控制）**\n\n- ✅ **用户自定义提示词功能** - 革命性的个性化翻译控制\n- ✅ **智能优先级处理机制** - 用户请求与系统规则智能结合\n- ✅ **配置持久化增强** - 一次配置，永久使用\n- ✅ **向后兼容保障** - 不影响现有用户正常使用\n- ✅ 实时AI字幕翻译（支持OpenAI、DeepSeek、通义千问、Gemini）\n- ✅ 8种内容类型特定翻译模式\n- ✅ 口语化翻译引擎（避免平淡生硬）\n- ✅ 智能上下文管理与场景检测\n- ✅ 完整翻译缓存机制\n- ✅ 6步质量检查流程\n- ✅ 英文提示词系统（多语言适配）\n- ✅ 自动平淡度检查机制\n\n### v1.0.0 - Official Release\n**稳定发布版本（生产环境推荐）**\n\n- ✅ 实时AI字幕翻译（支持OpenAI、DeepSeek、通义千问、Gemini）\n- ✅ 8种内容类型特定翻译模式\n- ✅ 口语化翻译引擎（避免平淡生硬）\n- ✅ 智能上下文管理与场景检测\n- ✅ 完整翻译缓存机制\n- ✅ 6步质量检查流程\n- ✅ 英文提示词系统（多语言适配）\n- ✅ 自动平淡度检查机制\n\n### v0.9.0 - Beta\n**测试版（不再维护）**\n\n- 基础翻译功能\n- 多模型支持\n- 上下文感知（初级）\n- 9 种 Genre 分类\n- 完整缓存机制\n"}}}} |