Repository navigation
v1.0.0-rc.4 — webpage translation candidate; restart limitation
Pre-releaseKnown 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 / 安装与升级
- Download
codex-browser-translator-v1.0.0-rc.4.zipand extract it completely into a permanent directory. - Open Codex's browser extension manager, enable its Developer mode, choose Load unpacked, and select the extracted
extension/directory containingmanifest.json. - 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.
- 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.
- 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.