---
name: codex-chrome-proxy-fix
description: 修复这台 Ubuntu 电脑在 Codex/ChatGPT 升级后失效的 Chrome 浏览器控制插件连接，恢复仅作用于 CUA 进程的 v2rayN 代理，并通过原 Chrome 扩展连接测试网页操作。适用于 nodeRepl.fetch request failed、插件能识别但标签打不开；不用于全局代理、Codex CLI 登录或 CDP 配置。
---

# Codex Chrome 插件代理修复

沿用用户已经采用的本机修复方式。调用本技能要求修复时，检查、备份、补丁和验证直接执行；只询问连接状态的请求先测试和报告，不自动修改设置。不要为了这个流程安装扩展、启用远程调试或查找另一套官方配置方法。

## 已知的本机配置

- Chrome 正常使用的用户配置为 `戈`，通过 Codex 的 Chrome **extension** 连接控制。
- v2rayN HTTP 代理：`http://127.0.0.1:10808`。每次确认监听仍存在，不把旧记录当作当前事实。
- 软件包：`chatgpt`；CUA 启动文件：
  `/usr/lib/chatgpt/resources/cua_node/lib/node_modules/@oai/cua-repl/bin/cua-repl.mjs`
- 内置 Node：`/usr/lib/chatgpt/resources/cua_node/bin/node`。
- 备份目录：`/home/jiangge/.local/state/chatgpt-cua-proxy-backups/`。

软件包升级会覆盖启动文件。这是升级后重复应用的本地补丁，不保证永久保留。不要修改系统代理、Chrome 代理、APT 设置、其他软件、项目、会话或登录信息。

## 检查与修复

1. 读取 `dpkg-query -W -f='${Version}\n' chatgpt`、当前启动文件全文、v2rayN 的 `10808` 监听及 ChatGPT/Chrome 主进程的启动时间。区分：Chrome 未启动、代理未监听、补丁缺失、运行中的进程尚未加载补丁。
2. 当前入口应导入 `@oai/cua-repl`，并在 `try` 内调用一次 `await cua_repl.launch();`。先核对当前代码，再改动该调用前的环境变量。若新版入口不存在、调用位置不唯一、增加了冲突的代理逻辑或结构已不兼容，停止套用旧补丁，报告具体变化；不要直接把整个旧版脚本覆盖进去。
3. 如果以下变量已经以正确值在启动前设置，不重复添加。补丁缺失时，把当前文件复制为按版本和时间命名的独立备份；核对原件与备份 SHA-256 一致，并记录文件属主和权限。创建临时副本，用 `apply_patch` 只插入下面这段，保留新版的所有其他代码：

```javascript
  const proxy = "http://127.0.0.1:10808";
  Object.assign(process.env, {
    NODE_USE_ENV_PROXY: "1",
    HTTP_PROXY: proxy,
    HTTPS_PROXY: proxy,
    NO_PROXY: "127.0.0.1,localhost,::1",
    http_proxy: proxy,
    https_proxy: proxy,
    no_proxy: "127.0.0.1,localhost,::1",
  });
```

4. 用内置 Node 的 `--check` 检查临时脚本，查看原件与临时副本的差异，确认只有上述局部改动。若已经存在部分或不同值的代理代码，先理解来源，不能叠加互相覆盖的配置。
5. 使用 `pkexec /usr/bin/install` 安装审核过的临时脚本到**上述确切入口文件**，保留原属主、属组和权限（历史上为 `root:root 755`，当次重新确认）。这是本机已有且用户要求的修复，不另加确认轮次；管理员密码由用户在桌面的系统验证框输入。
   不在隐藏的命令会话里等待 `sudo` 密码，也不向用户展示一个未连接到等待命令的空终端。若系统验证框没有出现或被取消，报告未安装；取消本次等待的请求，不留下悬挂的授权进程。
6. 安装后再次校验内容 SHA-256、属主/权限和 Node 语法。语法失败时恢复本次备份，验证回退结果并报告。保留备份，清理仅由本次创建的临时副本。

## 加载与原连接验收

入口修改只会在新的 CUA 进程启动时生效。若应用主进程早于补丁，不强行退出当前聊天；明确告知用户保存内容后完全退出并重新打开 Codex/ChatGPT，随后继续验收。不能把“文件修好”说成“插件已正常”。

通过 `mcp__cua_repl.js` 测试用户原来的扩展连接；首次调用及重置后遵循工具的初始化规则，读取返回文档：

```javascript
await cua.getState();
```

从本次结果中选择 `name: Chrome`、`type: extension` 的用户配置，使用本次返回的浏览器 ID；不要硬编码旧 ID。继续读取标签，然后通过该 Chrome 连接打开公开测试页：

```javascript
await cua.listTabs({ browser: chromeBrowserId });
```

```javascript
let testTab = await cua.createBrowserTab(chromeBrowserId, "https://example.com/", {
  sessionName: "🔎 Chrome 插件修复测试",
});
```

```javascript
await testTab.getAXState();
```

这些是使用方式示例，实际调用遵循当次工具返回的文档。确认页面包含 `Example Domain` 和说明正文，才报告插件功能验收通过。

- Chrome 未出现：报告插件连接不可见，优先让用户打开正常的 Chrome 配置并保持窗口开启。
- 出现 `nodeRepl.fetch request failed` 或超时：记录失败阶段；检查补丁是否已加载、代理监听和节点连接，最多重试一次以确认。补丁已正确加载仍失败时，报告具体阻塞，不反复安装相同补丁。
- `agent-browser --auto-connect` 使用独立的 CDP 路径，不作为本扩展成功或失败的证据。不要用内置浏览器或新建隔离 Chrome 实例代替原插件验收。

最终简要报告：补丁是否安装、备份位置、是否需要重启、网页读写验收结果。创建本技能或通过语法检查本身不代表 Chrome 插件已修复。
