fix(browser): harden multi-tab routing and target isolation

- make daemon command ids collision-resistant and retry duplicate pending ids\n- add explicit tab targeting with validated select/close flows and saved default targets\n- scope browser network detail cache per target and clear stale page bindings on close\n- document the tab workflow and add unit/e2e coverage for concurrent multi-tab execution

Author: freemandealer

README.md

@@ -95,7 +95,9 @@ In practice:
 - start with `opencli-explorer` when the agent needs a reusable command for a site (it covers both automated and manual flows)
 - use `opencli-browser` when the agent needs to inspect or steer the page directly
 
-Available browser commands include `open`, `state`, `click`, `type`, `select`, `keys`, `wait`, `get`, `screenshot`, `scroll`, `back`, `eval`, `network`, `init`, `verify`, and `close`.
+Available browser commands include `open`, `state`, `click`, `type`, `select`, `keys`, `wait`, `get`, `screenshot`, `scroll`, `back`, `eval`, `network`, `tab list`, `tab new`, `tab select`, `tab close`, `init`, `verify`, and `close`.
+
+Use `opencli browser tab list` to inspect tab target IDs, then pass `--tab <targetId>` to route a command to a specific tab. `tab new` creates a new tab without changing the default browser target; only `tab select <targetId>` promotes that tab to the default target for later untargeted `opencli browser ...` commands.
 
 ## Core Concepts
 

README.zh-CN.md

@@ -93,7 +93,9 @@ npx skills add jackwener/opencli --skill opencli-oneshot
 - 需要把某个站点收成可复用命令时，优先走 `opencli-explorer`（涵盖自动和手动两种路径）
 - 需要直接检查页面、操作页面时，再走 `opencli-browser`
 
-`browser` 可用命令包括：`open`、`state`、`click`、`type`、`select`、`keys`、`wait`、`get`、`screenshot`、`scroll`、`back`、`eval`、`network`、`init`、`verify`、`close`。
+`browser` 可用命令包括：`open`、`state`、`click`、`type`、`select`、`keys`、`wait`、`get`、`screenshot`、`scroll`、`back`、`eval`、`network`、`tab list`、`tab new`、`tab select`、`tab close`、`init`、`verify`、`close`。
+
+可以先用 `opencli browser tab list` 查看 tab 的 target ID，再通过 `--tab <targetId>` 把命令明确路由到某个 tab。`tab new` 只会新建 tab，不会改变默认浏览器目标；只有显式执行 `tab select <targetId>`，才会把该 tab 设为后续未指定 target 的 `opencli browser ...` 命令的默认目标。
 
 ## 核心概念
 

docs/guide/browser-bridge.md

@@ -25,6 +25,27 @@ That's it! The daemon auto-starts when you run any browser command. No tokens, n
 opencli doctor            # Check extension + daemon connectivity
 ```
 
+## Tab Targeting
+
+Browser commands run inside the shared `browser:default` workspace unless you explicitly choose another tab target.
+
+```bash
+opencli browser tab list
+opencli browser tab new https://www.baidu.com/
+opencli browser eval --tab <targetId> 'document.title'
+opencli browser tab select <targetId>
+opencli browser get title
+opencli browser tab close <targetId>
+```
+
+Key rules:
+
+- `opencli browser tab list` prints the current tab `targetId` values.
+- `--tab <targetId>` routes a single browser command to that specific tab.
+- `tab new` creates a new tab but does not change the default browser target.
+- `tab select <targetId>` makes that tab the default target for later untargeted `opencli browser ...` commands.
+- `tab close <targetId>` removes the tab; if it was the current default target, the stored default is cleared.
+
 ## How It Works
 
 ```

docs/zh/guide/browser-bridge.md

@@ -23,6 +23,27 @@ OpenCLI 通过轻量级 **Browser Bridge** Chrome 扩展 + 微守护进程连接
 opencli doctor            # 检查扩展 + 守护进程连接
 ```
 
+## 多 Tab 定位
+
+浏览器命令默认运行在共享的 `browser:default` workspace 中；如果需要操作指定 tab，可以显式传目标 target。
+
+```bash
+opencli browser tab list
+opencli browser tab new https://www.baidu.com/
+opencli browser eval --tab <targetId> 'document.title'
+opencli browser tab select <targetId>
+opencli browser get title
+opencli browser tab close <targetId>
+```
+
+规则如下：
+
+- `opencli browser tab list` 会打印当前 tab 的 `targetId`。
+- `--tab <targetId>` 会把单条 browser 命令路由到对应 tab。
+- `tab new` 只会新建 tab，不会改变默认浏览器目标。
+- `tab select <targetId>` 会把该 tab 设为后续未显式指定 target 的 `opencli browser ...` 命令默认目标。
+- `tab close <targetId>` 会关闭该 tab；如果它正好是当前默认目标，会一并清掉这条默认绑定。
+
 ## Daemon 生命周期
 
 Daemon 在首次运行浏览器命令时自动启动，之后保持常驻运行。