v1.9 Installer / 安装包

[Felix3322]

📢 PotPlayer ChatGPT Translate v1.9.0

本次更新为累积更新，包含了从 v1.8 到 v1.9.0 的所有改进。
带来了架构级的重构、针对小模型的深度优化，以及修复了此前版本中存在的严重字符处理 Bug。

📦 下载地址 / Download

渠道 (Channel)	下载链接 (Download Link)
GitHub (Global)	👉 Download Latest Installer (v1.9.0)
Gitee (China)	🚀 国内镜像快速下载

---

✨ 新增特性 / New Features (v1.9.0)

1. [重构] 统一重试循环 (Unified Retry Loop)
彻底重构了核心翻译逻辑，现在网络错误、API 报错和幻觉检测共享同一个重试计数器。这意味着如果网络偶尔超时，或者模型偶尔产生幻觉，脚本都能智能地利用剩余的重试机会自动恢复，再也不会因为单一类型的失败而卡死。

🛠️ 点击查看逻辑流程图 / Logic Flowchart

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 -- "带上下文版" --> CalcBudget[计算 Token 预算]
        CalcBudget --> TrimHist["裁剪历史\n(丢弃旧的 / 智能裁剪)"]
        TrimHist --> BuildBlock[构建上下文块]
    end

    %% --- Prompt Engineering ---
    subgraph PromptEng [提示词构建]
        direction TB
        BuildBlock --> SmallModel{启用小模型模式?}
        NoContextPrompt --> SmallModel
        
        SmallModel -- 是 --> StrictPrompt[System: 身份 + 上下文 + 指令\nUser: 仅字幕原文]
        SmallModel -- 否 --> StdPrompt[System: 身份 + 上下文\nUser: 指令 + 字幕原文]
        
        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 修复)"]
    PostProc --> FixRTL["插入 Unicode RLE\n(阿拉伯语/希伯来语修复)"]
    FixRTL --> ReturnSuccess([返回翻译结果])

Loading

2. [新增] 反幻觉机制 (Anti-Hallucination)
新增了专门针对模型“幻觉”的检测功能。如果模型输出了长度异常（超过原文 5 倍）的内容，插件会将其视为失败并自动重试。此功能可在安装时选择开启或关闭。

3. [新增] 小模型优化模式 (Small Model Mode)
专为 gpt-4o-mini, gemini-flash 等轻量级模型设计。开启后，插件会严格分离 System Prompt（指令/上下文）和 User Prompt（仅原文），防止小模型将翻译指令误认为是需要翻译的文本，大幅提升小模型的指令遵循能力。

4. [优化] 上下文缓存命中率 (Cache Hit Rate)
针对支持 Context Caching 的模型（如 DeepSeek, OpenAI），优化了 Prompt 结构，确保 System Prompt 前缀更加稳定，从而显著提高缓存命中率，降低 API 成本并提升速度。

---

💎 累积更新与核心修复 / Cumulative Fixes (v1.8 & v1.9)

以下修复包含在此版本中，强烈建议升级以解决潜在的乱码和报错问题：

🛡️ 稳定性修复 (Critical Fixes)

• [严重 Bug 修复] JSON 转义失效问题：修复了一个导致特殊字符（如引号、反斜杠、换行符）无法正确转义的严重 bug。

• 技术细节：现在完全支持退格符 (\b) 和换页符 (\f) 的转义，符合严格 JSON 规范。

• [严重 Bug 修复] CJK 字符截断问题：重写了 Smart Trim 算法。此前版本在裁剪历史上下文时可能错误切断 UTF-8 多字节字符（如中文、韩文），导致乱码或 API 报错。现在算法会自动检测 UTF-8 边界。

• [修复] AngelScript 逻辑错误：修正了 string.replace 返回值未被重新赋值的低级错误，确保字符串处理逻辑按预期执行。

⚙️ 配置与体验优化

• [优化] 默认关闭上下文缓存：默认将 Context Cache 设置为 关闭，避免在不支持非标准端点的 API 上造成卡顿。
• [优化] 安装逻辑修复：修复了安装包预设配置在首次运行时可能未被正确加载的问题。
• [安全] 重试逻辑安全网：为网络重试机制添加了硬性的循环上限（10次），即使在极端的网络配置下也能保证播放器主线程不会卡死。

---

📸 预览 / Screenshots

<hr /><em>This discussion was created from the release <a href='https://github.com/Felix3322/PotPlayer_ChatGPT_Translate/releases/tag/'>v1.9 Installer / 安装包</a>.</em>