为 Codex++ Windows 启用 Computer Use Guard（已适配 1.2.7）

[YUANLITONGZAI]

摘要

这个 PR 是基于当前 Codex++ 1.2.5 / upstream main 重新适配的 Windows Computer Use Guard 方案，用于改善 Codex++ 启动 Codex 后 Computer Use 插件不可用的问题。

之前的 #906 是较早基线上的实现记录。由于 upstream 已更新到 1.2.5，本 PR 重新基于 1.2.5 代码移植，并尽量保留 1.2.5 已有的 standalone Codex 检测、launcher 结构和现有行为。

主要改动

• 在 Windows 启动路径加入 Computer Use preflight：
  • 修复 ~/.codex/config.toml UTF-8 BOM。
  • 确保 [features] js_repl = true。
  • 确保 browser@openai-bundled、chrome@openai-bundled、computer-use@openai-bundled 启用。
  • 确保 root notify 指向实际存在的 codex-computer-use.exe。
• 在 relay config live 写入路径中保留 Computer Use 必需配置，避免切换 relay profile 后覆盖掉插件配置。
• 增加 CDP readiness / target 判断，减少误注入其他 CDP page 的风险。
• 增加 Windows bundled runtime exports 兼容修复，用于处理当前 @oai/sky package exports 缺少 Computer Use 内部 subpath 的情况。
• existing-instance 路径也执行 guard，并整理 helper / watchdog 生命周期。
• 非 Windows 平台保持 no-op，避免影响跨平台构建。

验证情况

本 PR 的代码由 Codex 辅助完成和验证。验证结果不是官方验证，仍需要维护者审查。

已在本地 Windows/MSVC 环境对 1.2.5 适配分支运行：

git diff --check
cargo +stable-x86_64-pc-windows-msvc test -p codex-plus-core launcher
cargo +stable-x86_64-pc-windows-msvc test -p codex-plus-core computer_use_guard
cargo +stable-x86_64-pc-windows-msvc test -p codex-plus-core relay_config
cargo +stable-x86_64-pc-windows-msvc test -p codex-plus-launcher --no-run

以上通过。

也在 Linux 远程环境做过命令行回归测试：

git diff --check
cargo test -p codex-plus-core launcher
cargo test -p codex-plus-core computer_use_guard
cargo test -p codex-plus-core relay_config
cargo test -p codex-plus-launcher --no-run

Linux 测试只能证明跨平台编译和单元测试通过，不能证明 Windows WebView2 / CDP / Computer Use 鼠标控制端到端可用。

说明

• 本 PR 不包含本地安装路径、私有仓库说明、备份 exe、二进制产物或私有配置。
• 不修改 public upstream 分支，不要求直接合并。
• 如果维护者认为这个方案过大，可以继续拆分为：
  • config guard
  • CDP readiness
  • runtime exports compatibility
  • tests

[YUANLITONGZAI]

补充验证说明：

在本地 Windows 环境中，我已将基于 Codex++ 1.2.5 的 Computer Use Guard 构建产物替换到本机安装版 launcher 后重新验证。

验证结果：

• 57321/backend/status 返回 status=ok，版本为 1.2.5
• 9229/json 返回 Codex page target，并包含 websocket
• config.toml 中 js_repl=true，browser/chrome/computer-use bundled 插件启用
• @oai/sky runtime exports 兼容补丁存在
• 通过官方 Computer Use 插件对 Windows Calculator 做了轻量 E2E：1 + 2 =，最终结果显示为 3

说明：

• 以上是本地环境验证，不是官方验证。
• 代码和验证过程由 Codex 辅助完成，仍需要维护者审查。
• 本 PR 不会也不能直接合并到主仓库，是否接受、拆分或调整由维护者决定。

[BigPizzaV3]

修复了电脑操控？

[YUANLITONGZAI]

您好大佬，我没有修改 Windows 鼠标/键盘底层控制逻辑，而是修复 Codex++ 启动 Codex 后，官方 Computer Use 插件在 Windows 上无法启用的问题。主要处理了配置启用、CDP 调试端口、页面 target 选择、注入链路，以及 @oai/sky runtime exports 兼容问题。
这部分代码和验证是在我本机环境中借助 Codex 辅助完成的。本机 Windows 1.2.5 安装版已用 Calculator 做过一次 Computer Use 端到端验证：可以列出应用、读取窗口状态，并完成击测试（其实就是让codex启动电脑自带的计算器进行数值计算，判断是否能在codex++中顺利使用computer use的功能）。但这只是本地验证，不是官方 CI 或维护者环境验证。
若我的提交存在缺陷、漏洞或者别的问题，欢迎批评与指出不足。

[YUANLITONGZAI]

补充验证说明：

该 PR 分支已同步到 upstream 当前 main（包含 v1.2.6），并解决了与主分支的冲突。冲突点主要在 crates/codex-plus-core/src/lib.rs，处理后保留了 upstream 新增的 codex_sqlite 模块，也保留了本 PR 的 computer_use_guard 模块。

本地验证结果：

• PR 分支 HEAD：01c3a3c
• upstream main：935ea02，包含 v1.2.6
• git diff --check origin/main..HEAD 通过
• Windows/MSVC 下通过：
  • cargo +stable-x86_64-pc-windows-msvc test -p codex-plus-core launcher
  • cargo +stable-x86_64-pc-windows-msvc test -p codex-plus-core computer_use_guard
  • cargo +stable-x86_64-pc-windows-msvc test -p codex-plus-core relay_config
  • cargo +stable-x86_64-pc-windows-msvc test -p codex-plus-launcher --no-run
• release launcher 构建通过
• 本机 Windows 安装版验证通过：
  • backend status 返回 version=1.2.6
  • CDP 9229/json 返回 Codex page target
  • Computer Use 官方插件可初始化
  • Calculator 做了 1 + 2 = 3 的端到端验证

说明：这些验证是在我的本机 Windows 环境中借助 Codex 辅助完成的，不代表官方 CI 或维护者环境验证。PR 仍请维护者按项目标准审查。

[YUANLITONGZAI]

补充验证说明（Codex++ 1.2.7）：

我已将这个 PR 分支重新适配到 upstream 1.2.7，并且只推送到我的 fork / PR 分支，没有合并或修改主仓库分支。

目前完成的验证：

• Windows/MSVC 本地源码级测试和 launcher release build 已通过。
• 本机安装版替换为 1.2.7 Guard 构建后，57321 backend、9229 CDP target、config.toml、bundled Computer Use 插件和 @oai/sky runtime exports 兼容补丁均通过只读检查。
• 通过 Codex 的官方 Computer Use 通道做过本机 Windows GUI E2E：
  • Calculator 执行 1 + 2 = 3（codex操作本地计算器进行数值计算）
  • Notepad 输入并确认 Computer Use 1.2.7 E2E OK（codex打开记事本输入“Computer Use 1.2.7 E2E OK”的文本）
• 附件视频展示的是另一次 Computer Use 桌面操作流程：由 Codex 借助 Computer Use 打开录制软件、打开 GitHub PR 页面、输入本条验证评论并结束录制。该视频用于补充说明 Computer Use 能实际操控桌面应用和浏览器流程，并不是 Calculator / Notepad 测试本身的录像。

这些验证是在我的本机环境中借助 Codex 完成的，不是官方 CI，也不是维护者环境验证。请维护者按项目标准继续审查、拆分或要求调整；是否合并仍完全由主仓库维护者决定。

另外，原始录屏文件较大，GitHub 评论附件无法直接上传。我将原始视频保存在外部网盘，供维护者需要时查看：
原始录屏：https://1drv.ms/v/c/2213c9e21e113ca1/IQAjklESO_rQSbbqeng5U5iJAe2Bpb-IsZoJge9PjTeiMlo?e=hpjdM9

附件视频建议二倍速查看：因为computer use功能虽然可用，但是codex执行提交评论的速度表现较慢。
附件视频（GitHub 附件，约 480p 压缩版）：
查看压缩录屏视频

[BigPizzaV3]

已经合并

[YUANLITONGZAI]

已经合并

感谢大佬的认可

[hongweifon]

终于合了！，感谢楼主感谢owner，computer use下版可以用了吧

[YUANLITONGZAI]

终于合了！，感谢楼主感谢owner，computer use下版可以用了吧

你好，这个computer use的修复我是在本地电脑进行的，期间有尝试过上传自己修复的代码到远程服务器（Linux环境进行测试），但我尚不清楚是否能在别的环境下（比如其他人的电脑、其他的API key供应商下）实现codex利用computer use，若你们尝试了并证明确实可行，那么我也算做出了一些贡献。若确实在你们的环境下无法使用，可选择利用本地AI进行代码的修改，或者在codex++相关内容下留言，都可以。

[YUANLITONGZAI]

owner在1.2.8和1.2.9版本更新了computer use的功能，在coedx++页面增强中选择启用Windows computer use guard后点击重启codex++即可启用

[hongweifon]

可以可以，感谢感谢 洪伟 ***@***.***