v1.0.0-rc.4 — webpage translation candidate; restart limitation

Known unresolved issue / 已知未解决问题： Restarting Codex resets the unpacked extension's loaded state in the reported Windows environment. It may disappear and require manually loading the same directory again. There is currently no verified persistence fix. 重启 Codex 后扩展可能消失，需要手动重新加载，目前没有可靠修复。 This is a prerelease, not a completed 1.0 release.

This candidate expands local webpage translation beyond the v0.3.0 article prototype:

• Full-page or article scope, including navigation, sidebars, lists and table text.
• Automatic source-language selection with visible decision source and manual correction; language availability still depends on the browser.
• Incremental translation of newly expanded menus and dynamic content.
• Bilingual/original/translation-only modes with original link and control preservation, cancellation and guarded restoration.
• Saved defaults and opt-in per-site automatic translation with revocable permissions.
• GitHub account/repository identifier protection and compact navigation layout fixes.

PDF translation remains disabled. Archived PDF source/tests are for development only and are excluded from the extension ZIP. No API key, agent prompt, CDP access or local server is required for normal webpage translation.

Install or upgrade / 安装与升级

1. Download codex-browser-translator-v1.0.0-rc.4.zip and extract it completely into a permanent directory.
2. Open Codex's browser extension manager, enable its Developer mode, choose Load unpacked, and select the extracted extension/ directory containing manifest.json.
3. Open an ordinary HTTPS page and click 网页翻译, or use 双语翻译此页 in the page context menu. Click Continue if the browser requests a user gesture or model preparation.
4. To upgrade, replace the complete previous extension contents, reload it in the manager and refresh existing webpages. Do not keep files from the suspended PDF version.
5. If it disappears after a normal Codex restart, load the same directory again. One saved default survived a user-run restart/reload; other preferences and site permissions remain unverified. This manual workaround does not fix persistence.

中文：完整解压 ZIP，在内置浏览器扩展管理页开启开发者模式，选择“加载未打包的扩展程序”，选中 extension/。更新后重新加载扩展并刷新网页；重启后消失时仍需手动加载同一目录。首次使用可能需要下载模型或点击继续。PDF 继续停用。

Do not use CRX drag-and-drop: it previously caused a user-reported whole-app exit/restart before installation completed. 不建议打包为 CRX 后拖入安装，已有整个 Codex 退出并重启的报告。No registry, alternate launcher, system-level setup or recovery Hook is part of this release.

Validation and limits

• 207 public regression tests passed, including archived PDF tests; those tests do not enable PDF.
• Build, syntax, permissions, active asset allowlist, source/runtime parity and ZIP checks passed.
• Prior native-page checks covered GitHub, MDN, an article, mixed languages, mode changes and restoration. These developer-runtime checks are distinct from installed-host acceptance.
• Restart persistence remains failed in the reported host. Exact pre/post-restart identity, other setting/permission retention, human-measured coverage, real 200% browser zoom and screen-reader acceptance remain pending.

The ZIP is 214,204 bytes, with 21 entries. SHA-256:

916899903314c91e45d65918d4cb076f94ad2d9b0efc8f2b8c08be5950d24edb

Download SHA256SUMS alongside the ZIP to verify it. Source archives are for development; the named extension ZIP is the installation package.

English README · 中文说明 · Installation · Restart limitation · Acceptance ledger

Independent community project, not an official OpenAI product. First-party code is MIT licensed; archived dependencies retain their own licenses.

v0.3.0 — Codex Browser Translator preview

Known unresolved issue / 已知未解决问题（2026-10-31）： In the reported Windows Codex environment, restarting Codex can remove the unpacked extension from its installed list. It must be loaded again; there is no verified persistence fix. 重启后扩展可能消失，需要手动重新加载，目前尚未解决。Do not use CRX drag-and-drop; whole-app exits were reported. This older preview is superseded by v1.0.0-rc.4, which also retains this limitation. Current known issue.

Codex Browser Translator v0.3.0 — early preview

Read English webpages in Chinese inside the Codex desktop app's built-in browser. This independent community extension uses the browser's native Translator API and supports toolbar/context-menu startup, paragraph bilingual view, translation-only view, and restoration of the original page.

Install without a build

1. Download codex-browser-translator-v0.3.0.zip below and extract it to a folder you will keep.
2. Open the Codex browser's extension manager, enable Developer mode, and select Load unpacked.
3. Select the extracted extension/ folder (the one containing manifest.json).
4. Open a normal English HTTPS webpage and click 网页翻译, or right-click and choose 双语翻译此页. If requested, click 重试 in the page panel.

No API key, Node.js, local server, agent prompt, or full CDP access is needed for normal use. The browser may download language packs on first use. The current direction is English → Simplified Chinese; controls are in Chinese.

English README · 中文说明 · Detailed installation

中文快速使用

下载下面的扩展 ZIP 并完整解压，在 Codex 内置浏览器的扩展管理页开启开发者模式，选择“加载未打包的扩展程序”，选中包内的 extension/ 文件夹。打开英文 HTTPS 网页，点击“网页翻译”图标或右键“双语翻译此页”即可使用。首次可能需要下载语言包，若提示页面操作，请点击“重试”。

无需 API Key、本地服务或对话指令。保留解压目录；更新后重新加载扩展并刷新网页。

Scope

• Windows Codex loading, translation entry and right-click startup confirmed by the tester.
• 35 automated tests and separate native-page runtime, restoration, and narrow-panel checks passed before publication. Validation details.
• English → Simplified Chinese only. Browser API and language-pack availability vary by host.
• Translation-only paragraphs hide original links/inline-code styling; switch to bilingual/original to use those links. Standalone code blocks stay visible.
• Limited extraction size; PDFs, cross-origin frames, complex SPA behavior and arbitrary-site coverage are not established.

SHA256SUMS contains the extension ZIP's SHA-256 checksum. This release is marked as a prerelease because host and website compatibility are still being expanded.

If it helps you, a Star and a reproducible issue report are welcome. MIT licensed; not an official OpenAI product.