用途：该技能覆盖 WSL2 下完整的浏览器访问链路，从浏览器可用性到可选的 agent-browser 接入，并提供排查指引。
主要能力与路径选择：
- 原生 WSL Chrome：适合在 WSL 内交互浏览或登录。运行 bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-native-wsl-chrome.sh"，脚本会校验 WSL2、按需安装 Linux google-chrome、写入标准 Windows .wslconfig 网络设置，并提示是否需要重启 WSL。配置变更后由人工执行 wsl --shutdown，重开 WSL 并启动 google-chrome；在 chrome://settings/security 中把 Use secure DNS 完全关闭（OS default 不算关闭），重开 Chrome 验证普通 HTTPS 站点与目标登录页。
- Windows 主机浏览器桥接：适合 WSL 工具需控制 Windows Chrome 或 Edge 的场景。运行 bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-windows-host-browser-bridge.sh"，脚本查找 Windows Edge 或 Chrome、以远程调试方式启动、请求 Windows 提权以设置端口代理与防火墙规则，并等待 CDP 端点可从 WSL2 访问；成功信号是 WSL 能访问桥接的 /json/version。该桥接只暴露通用浏览器端点，客户端接入是单独步骤。
- agent-browser：仅在原生 Chrome 浏览或 Windows 桥接验证通过后再添加。参见 references/agent-browser.md 了解运行时安装、交互式上游技能步骤、原生检查、桥接接入与兼容包装。
安全排查：诊断既有环境时先用非变更检查： bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-native-wsl-chrome.sh" --check-only bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-windows-host-browser-bridge.sh" --check-only bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-agent-browser-runtime.sh" --check-only
深入指引：浏览器能启动但浏览、登录、桥接访问或 agent-browser 仍失败时，读 references/troubleshooting.md；尝试底层 DNS、防火墙、软件包或客户端变通前，先读 references/dead-ends.md。仅当确实需要旧版一次性 Windows 桥接流程时，才使用 scripts/setup-agent-browser-wsl2.sh。
限制：资料未提供具体支持的系统版本、依赖版本、收费或性能数据；路径选择不明确时建议先读 references/architecture.md。