Codex Plugin Translator
为 Codex 插件页面提供中英双语翻译，基于 Codex++ 用户脚本运行。插件简介可由 Google Free 自动翻译，详情页可按需翻译；需要更自然的结果时，可选择用 DeepSeek 手动重译。英文原文始终保留。
本项目当前运行于 Codex++ 用户脚本环境，需要通过 Codex++ 加载。
- Google Free 自动翻译插件简介，无需 API Key
- 点击后一次翻译完整插件详情，并按 Provider 和完整正文 hash 缓存
- 可选 DeepSeek 手动重译简介和详情
- IndexedDB 本地缓存；已经缓存的译文在 Helper 未启动时仍能显示
- Helper 自动发现与配对，无需复制端口或 Session Token
- 不修改 Codex++ 本体
- Windows x64
- Codex++（当前验证版本：1.2.50）
- ASP.NET Core Runtime 10 x64
- DeepSeek 是可选功能；只有使用它时才需要自己的 API Key
Helper 使用 Kestrel 和 Microsoft.AspNetCore.App，因此需要 ASP.NET Core Runtime 10 x64。不需要 .NET SDK、Visual Studio 或 .NET Desktop Runtime。Release 不包含 Runtime。
普通用户推荐通过 **Codex++ Script Market（脚本市场）**安装用户脚本：
- 打开 Codex++。
- 进入 Script Market / 脚本市场。
- 搜索“Codex 插件翻译器”。
- 点击安装；Codex++ 会自动下载
codex-plugin-translator.js，并默认启用该用户脚本。
-
前往本项目的 GitHub Releases，下载 Windows x64 Helper 压缩包。
-
把压缩包完整解压到任意固定文件夹，例如：
D:\CodexPluginTranslatorHelper这只是示例路径，可以放到其他固定位置。Helper 不需要放到 Codex 或 Codex++ 目录。
-
在解压后的文件夹中双击：
CodexPluginTranslatorHelper.exe -
保持 Helper 运行，然后打开 Codex++；用户脚本会自动发现并连接 Helper。
-
如果系统提示缺少 Runtime，前往微软官方下载页面，选择 ASP.NET Core Runtime 10 → Windows → x64。
Codex++ Script Market 只负责分发 codex-plugin-translator.js，不能同时分发或安装 EXE、ZIP 或其他 Helper 文件。因此，正式分发方案是：
- JavaScript 用户脚本计划并推荐通过 Codex++ Script Market 分发。
- Windows x64 Helper 通过本项目 GitHub Releases 分发。
- Helper 当前仍需用户手动下载、完整解压和启动，但不要求固定安装路径。
不使用 Script Market，或需要进行开发、迁移和故障排查时，可以下载完整项目/发布包并运行：
.\scripts\install.ps1该脚本负责安装用户脚本和 Helper，但不是普通用户的首选安装方式。完整说明见 安装文档。安装脚本不需要管理员权限，不创建开机启动，也不修改 Codex++ 本体。
如果 PowerShell 的 Execution Policy 阻止高级安装脚本，可只对这一次进程使用：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1这不会永久修改系统或当前用户的 Execution Policy。
- 启动 Helper。
- 打开 Codex++。
- 打开 Codex 的插件页面。
- 用户脚本自动发现并连接本地 Helper。
- Google Free 开始以低并发队列翻译插件简介；插件详情由用户按需翻译。
- DeepSeek 是可选功能；如需使用，在“翻译设置”中输入一次 API Key 并保存。
正常首次使用不需要点击“重新加载用户脚本”。如果市场安装后脚本没有加载，可将“重新加载用户脚本”作为故障排查步骤，或重启 Codex++。
日常只需：启动 Helper → 打开 Codex++。无需复制端口或 Token。
如果只阅读已缓存译文，可以不启动 Helper；IndexedDB 中已有的中文仍会恢复。
Google Free 无需 API Key。本项目使用非正式的 Google 免费翻译端点，并非 Google Cloud Translation API，也不代表 Google 官方支持。端点可能限流、因地区或网络不可用，或在未来失效，不提供 SLA。
DeepSeek 完全可选，只在用户手动点击重译或测试连接时调用。API Key 保存在当前 Windows 用户的 Credential Manager 中；Renderer 只能查询“是否已配置”，不能重新取得完整 Key。详见 DeepSeek 配置。
翻译文本保存在 Codex Chromium Profile 内的 IndexedDB CodexPluginTranslatorDB。缓存按 Provider、内容类型、插件标识和原文哈希区分，不保存 API Key 或 Session Token。
- Helper 仅监听
127.0.0.1 - 固定 discovery 端口只负责短期 challenge 配对
- 翻译与凭据接口使用随机高位业务端口
- Session Token 每次 Helper 启动都会变化，不持久化
- DeepSeek Key 使用 Windows Credential Manager
- 不修改 Codex++ 本体，不提供任意 URL 代理
- 项目代码不包含遥测
详见 安全与隐私。
- 仅用于 Codex++，原版 Codex 不会加载此用户脚本
- Helper 当前需要用户手动启动
- Google Free 是非正式端点，稳定性不受本项目控制
- Codex++ 页面 DOM 结构变化后，脚本可能需要更新
- 当前主要在 Windows x64、Codex++ 1.2.50 上验证
常见问题见 故障排查。
本项目采用 MIT License。你可以使用、复制、修改、合并、发布和分发本项目，但须保留原始版权与许可声明。软件按“原样”提供，不附带任何明示或默示担保。