企业官网建设流程全解析

jev-browser-use是一款专为 Codex 打造的浏览器自动化 Skill：Jev 负责点击、导航和滚动，Codex 负责规划、输入文本并验证结果，实测可将重复性浏览器操作提速 5–10 倍。本文带你用 3 分钟完成安装，逐一详解 4 种安装方式、API 配置步骤与常见故障排查，新手照着做即可上手。

一、为什么值得装：Jev 与 Codex 的分工

传统做法里，AI 代理每点一次按钮、滚一次页面，都要消耗一次大模型的"思考回合"，慢且贵。jev-browser-use 把这个循环拆开：

• 🖱️Jev（快速机械操作）：选择可见的导航、点击、开关、滚动等动作，通过现有的 Computer Use 连接执行；
• 🧠Codex（思考与验证）：规划任务、输入文字、识别图片、最终独立验证结果；
• 💸更省钱：Jev 1.13 输入价仅 $0.042/百万 tokens，约为 GPT-5.6 Terra 的 1/48，输出免费。

一句话理解：Jev 点击，Codex 思考和验证。它不是独立的浏览器驱动，而是复用你已有的浏览器连接，无需额外 driver 和 npm 依赖。

二、开始安装前：先备齐 3 个条件

三、安装方式一：Codex 一行命令安装（推荐）

最快路线，一条命令搞定：

npx skills add wy-coliney/jev-browser-use -g -a codex -y

👉 安装完成后配置好 Jev API（见第七节），开启一个新的 Codex 任务即可加载 Skill。

后续更新同样一条命令：

npx skills update jev-browser-use -g

更新不会动你的~/.config/jev-browser-use/config.json和凭据文件。

💡 如果暂时想用 Claude Code：npx skills add wy-coliney/jev-browser-use -g -a claude-code -y可以先装好 Skill，但其浏览器执行能力还在路上，目前仍依赖 Codex Computer Use 运行时。

四、安装方式二：原生 Codex 插件（Marketplace）

如果你的 Codex CLI 支持codex plugin命令，可以走原生插件路线：

codex plugin marketplace add wy-coliney/jev-browser-use && codex plugin add jev-browser-use@jev-browser-use

✅ 装完重启 Codex。也可以只执行第一条命令，再在桌面插件目录中选择Jev Browser Use。

⚠️二选一原则：插件（plugin）和独立 Skill（standalone Skill）不要同时装，避免指令重复；两者共用同一份 Jev 配置。插件的元信息见 plugin.json，更新方式为codex plugin marketplace upgrade jev-browser-use后重新添加并重启。

五、安装方式三：让 Codex 自动替你装好并配置

懒人路线：把下面这段提示词直接粘贴给 Codex，由它按 INSTALL.md 的安装指南完成克隆、安装与配置：

Install Jev Browser Use following the INSTALL.md guide in this repository. Preserve existing configuration. Ask for my chosen provider and local credential file path if needed.Never ask me to paste an API key in chat.

✅ 它会自动检查 Node.js 与 Git、克隆仓库、运行安装器，并保留已有配置；缺什么会向你询问，但绝不会让你在聊天里粘贴 API Key。

六、安装方式四：手动安装（git clone 或 ZIP）

适合想完全掌控过程的读者：

git clone https://gitcode.com/gh_mirrors/je/jev-browser-use cd jev-browser-use node scripts/install.mjs

• 安装器位于 scripts/install.mjs，会把 Skill 文件装入~/.agents/skills/jev-browser-use；
• 交互式安装会依次询问 3 个问题：提供商（typesafe / openrouter）、模型、本地凭据 dotenv 文件路径；
• 已有config.json会被自动保留；凭据始终留在 Skill 目录之外；
• 不想交互可加--no-config：node scripts/install.mjs --no-config，之后再按第七节手动配置。

也可以直接解压仓库 ZIP 包，运行同一条 Node 命令。

七、四种方式通用：3 步配好 Jev API

所有安装方式共享同一份配置文件：~/.config/jev-browser-use/config.json，包含 3 个字段：

1. 选对 provider：API Key 是谁发的就选谁，二者不通用（TypeSafe 的 Key 放进 OpenRouter 无法认证）；
2. 填对凭据变量：Key 存放在envFile指向的本地 dotenv 文件中，不要写进 config.json；
3. 选对模型：TypeSafe 默认jev-latest，OpenRouter 默认~typesafe/jev-latest（前缀~表示自动使用最新兼容版本）。

TypeSafe 示例配置：

{ "envFile": "/absolute/path/to/your/credentials.env", "provider": "typesafe", "model": "jev-latest" }

完整配置指南（含各阶段故障诊断）：provider-configuration.md。

八、验证安装：跑第一个浏览器任务

配置完成后，把这类任务丢给 Codex 试试：

Use Jev Browser Use on the settings page. Open the filters, switch views, scroll through the results, and restore the original state. Independently verify the result.

预期表现：Jev 执行"打开过滤器 → 切换视图 → 滚动结果"，Codex 输入必要文本并在最后独立核对结果。当某一步需要"思考"（如输入文字、识别图片）时，Codex 会接管，随后 Jev 在同一会话中继续，进度不丢失。

💡 进阶用法示例（准备内容但先不发布）：让 Codex 用 Jev 打开你 Chrome 中已打开的标签页、检查草稿与配图、停止在发布前，交由你人工确认。

九、安装失败速查

十、小结

装好之后，导航、翻页、滚动这些重复操作交给 Jev 循环，把 Codex 的回合留给真正需要判断的环节——这就是 5–10 倍提速与显著成本下降的来源。

延伸阅读：

• 完整 Skill 行为说明：skills/jev-browser-use/SKILL.md
• 核心桥接逻辑：skills/jev-browser-use/bridge.mjs
• Agent 自动安装指南：INSTALL.md