mcpField
W
wsl2-browser-setup

wsl2-browser-setup

github.com/arthurzakirov开发1167 次安装2 周前更新
代码仓库

关于 wsl2-browser-setup

wsl2-browser-setup 是用于配置和排查 WSL2 浏览器访问的技能，适合需要交互式浏览或连接自动化工具的用户。它区分原生 Chrome、Windows 浏览器桥接和可选的 agent-browser 层。

主要功能

  1. 01配置 WSL 原生 Chrome
  2. 02设置 Windows 浏览器桥接
  3. 03添加 agent-browser 层
  4. 04运行只检查不修改的检查
  5. 05查阅故障排查指南

适用场景

  1. 01在 WSL 中进行交互式浏览和登录
  2. 02让 WSL 工具控制 Windows Chrome 或 Edge
  3. 03诊断现有浏览器和桥接配置
  4. 04将 agent-browser 连接到已验证的浏览器

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/arthurzakirov/agentdesk --skill wsl2-browser-setup

安装后在 Claude Code 中输入/wsl2-browser-setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
agent-browser.md
architecture.md
dead-ends.md
troubleshooting.md
scripts/
connect-windows-browser.sh
ensure-portproxy.ps1
ensure-wslconfig.ps1
invoke-portproxy-admin.ps1
launch-host-browser.ps1
setup-agent-browser-runtime.sh
setup-agent-browser-wsl2.sh
setup-native-wsl-chrome.sh
setup-windows-host-browser-bridge.sh

详细介绍

WSL2 浏览器设置

使用此技能完成 WSL2 浏览器配置流程，包括确保浏览器可用，以及按需设置 agent-browser。

选择路径

需求从这里开始成功标志
在 WSL 中交互式浏览或登录原生 WSL ChromeLinux Chrome 能正常显示 HTTPS 网站和目标登录页面。
WSL 工具必须控制 Windows Chrome 或 EdgeWindows 主机浏览器桥接WSL 能访问桥接的 /json/version 端点。
请求的客户端是 agent-browser先建立任一浏览器路径，再添加客户端层agent-browser 能打开或附加到所选浏览器，并返回快照。

不确定应选择哪条路径时，请阅读 references/architecture.md。

原生 WSL Chrome

运行：

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 (when available) 不算关闭。重新打开 Chrome，并验证普通 HTTPS 网站以及真实目标页面或登录页面。

Windows 主机浏览器桥接

运行：

bash "${CODEX_HOME:-$HOME/.codex}/skills/wsl2-browser-setup/scripts/setup-windows-host-browser-bridge.sh"

该脚本会查找 Windows Edge 或 Chrome，以远程调试模式启动浏览器，请求提升 Windows 权限以设置端口代理和防火墙规则，并等待 CDP 端点可从 WSL2 访问。它会公开一个通用浏览器端点；附加客户端是单独的步骤。

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

深入指南

评论

支持 Markdown