迁移到 oh-my-webbridge

oh-my-webbridge 的每个命令都指定一个会话、一个动作，以及一个参数 JSON 对象。本页的表格把其他工具的常用命令对应到这些动作。搬移任务之前，请先在与其他工具比较中确认 oh-my-webbridge 没有提供的功能。

开始之前复制锚点链接

1. 安装 daemon 与扩展程序，并配对浏览器。请见快速开始。
2. 以 omw install-skill ~/.agents/skills 安装 Agent 技能。关闭原本工具的技能或 MCP 服务器，让 Agent 在一项任务中只使用一个工具。
3. 运行 omw status。它为每个浏览器输出一行，例如 chrome: connected (156.0.8078.80)。

所有工具共通的变更复制锚点链接

• 会话。 每项任务使用一个会话名称，例如 checkout。第一个命令会打开会话，它的标签页在背景打开，并放进同一个标签页分组。任务结束时发送 close_session。所有会话都使用你的浏览器个人资料与其中的 cookie。
• 引用。 引用的格式为 @e<generation>.<index>，来自该标签页最新一次的 snapshot。以 @e 开头、来自其他工具或较旧快照的引用会以 stale_ref 失败。不带 @ 的引用（例如 e12）会被当成 CSS 选择器。导航之后请重新取得快照。
• 定位器。 selector 参数接受 CSS 与文字定位器，Playwright 定位器可以对应到这些形式。role= 完全比对名称，而 getByRole 在未设置 exact: true 时比对子字符串。串接的定位器与 .filter() 没有对应形式。请见选择器。

• JavaScript。 evaluate 接受表达式，而不是函数。请发送 document.title，或把函数包成调用：(() => document.title)()。使用 await 的代码放进异步函数调用：(async () => (await fetch("/api")).status)()。
• 文件。 screenshot 与 save_as_pdf 接受绝对路径 path 并传回它，不会覆写已存在的文件。
• 期限。 命令默认在 30 秒后失败。HTTP 请求本文的 timeoutMs 字段，或 omw call 的 --timeout-ms，可设置 1 到 120000 毫秒。时间用尽的 wait 会以 wait_timeout 失败。
• Firefox。 部分动作在 Firefox 中响应 unsupported。请见 Firefox。

从 Kimi 浏览器扩展程序迁移复制锚点链接

请求格式与大多数动作名称相同，地址、token 与部分参数不同。

同一个 navigate 请求送往两个 daemon 的写法：

# Kimi 浏览器扩展程序
curl -s -X POST http://127.0.0.1:10086/command \
  -H 'Content-Type: application/json' \
  -d '{"action":"navigate","args":{"url":"https://example.com","group_title":"Research"},"session":"research"}'

# oh-my-webbridge
TOKEN=$(omw connection | sed -E 's/.*"token":"([^"]+)".*/\1/')
curl -s -X POST http://127.0.0.1:17373/command \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"session":"research","action":"navigate","args":{"url":"https://example.com","group_title":"Research"}}'

# oh-my-webbridge 命令行
omw call research navigate '{"url":"https://example.com","group_title":"Research"}'

以下动作的名称与参数不变：navigate、find_tab、list_tabs、close_tab、close_session、mouse_click、fill、key_type、hover、drag、find、cdp、screenshot、save_as_pdf、upload 与 network。以下动作有变更：

从 MCP 浏览器服务器迁移复制锚点链接

oh-my-webbridge 没有 MCP 服务器。Agent 依技能说明，在 shell 中运行 omw call。一次工具调用对应一个命令：

omw call checkout click '{"selector":"role=button[name=\"Pay\"]"}'

Chrome DevTools MCP 的页面工具还需要 pageId，默认为必填。下表省略这个参数。

• Browser MCP 的一次调用可以包含多行命令。batch 在一个请求中依序运行最多 64 个步骤，遇到第一个错误即停止：omw call checkout batch '{"steps":[{"action":"fill","args":{"selector":"label=Email","value":"a@example.com"}},{"action":"send_keys","args":{"keys":"Enter"}}]}'。screenshot、save_as_pdf 与 close_session 要分开发送。
• 带 submit: true 的 browser_type 对应为 fill，接着发送 keys 为 Enter 的 send_keys。
• console 在 Chrome 中使用，传回 start 之后记录的消息。请在会记录消息的步骤之前发送 start。
• Chrome DevTools MCP 的性能追踪、Lighthouse 与堆积快照，以及 Playwright MCP 的响应模拟、追踪与代码产生，没有内置动作。这类任务请保留原本的服务器。页面连接接受 chrome.debugger 允许的协议域名，例如以 Fetch 拦截请求。

从 agent-browser 与 PinchTab 迁移复制锚点链接

oh-my-webbridge 不启动浏览器，因此没有对应 --headed、--profile、--state、个人资料管理或运行个体的功能。命令在你使用的浏览器的背景标签页中运行，沿用其中的登录状态。omw call 的第一个参数是会话名称。PinchTab 的 Agent 会话设置身分与权限；最接近 oh-my-webbridge 会话的是 PinchTab 的运行个体或标签页。

从 Playwright 或 Puppeteer 脚本迁移复制锚点链接

在扩展程序模式下，daemon 在 /json/list 列出页面目标，并在 /devtools/page/{tabId} 提供单一标签页。它的 /json/version 没有 webSocketDebuggerUrl。Playwright 的 chromium.connectOverCDP 与 Puppeteer 带 browserURL 的 puppeteer.connect 会读取这个字段来找到浏览器端点（Playwright 源代码、Puppeteer 源代码）。这类脚本有两种搬移方式。

让脚本使用原生模式复制锚点链接

原生模式通过 daemon 转送浏览器端点。以 --remote-debugging-port=9222 与另一个 --user-data-dir 启动 Chrome，再以 http://127.0.0.1:9222/json/version 中的浏览器 URL 启动 daemon：

omw serve --cdp ws://127.0.0.1:9222/devtools/browser/8b0d3f7c-...

Playwright 在 headers 中带上 token 连接，写法请见 CDP。Puppeteer 则传入 browserURL: "http://127.0.0.1:17373"，并在 wsOptions.headers 中带上同一个标头。这样脚本操作的是那个另外启动的 Chrome，而不是你平常使用的个人资料。

把脚本改用 SDK复制锚点链接

SDK 通过扩展程序操作你使用的浏览器中的标签页。

import { connect } from "./dist/sdk.mjs";

const task = await connect("checkout");
await task.navigate("https://example.com/cart");
await task.click('role=button[name="Pay"]');
await task.close();

在扩展程序模式下需要原始协议时，请用 cdp 动作发送命令，或以带 Bearer 标头的 WebSocket 客户端打开 /devtools/page/{tabId}。请见 CDP。