cyh-browser-skilllisted

# cyh-browser-skill 这是以 Codex 为当前优先入口、同时兼容 Claude Code 的真实浏览器 Skill；Codex 通过 `SKILL.md` 和 `agents/openai.yaml` 发现并调用它，Claude Code 通过 `.claude-plugin/` 元数据加载同一 Skill。所有真实浏览器操作统一由本 Skill 的本地 Rust Runtime 承担。扩展保留用户浏览器登录态，并将 Agent 创建的页面放入独立 Agent Window 和带 `Agent · <session>` 标题的彩色标签组；用户已有标签页通过 `/borrow` 的浏览器内确认取得临时控制权，完成后归还且不会加入 Agent 标签组。 ## 何时使用 本 Skill 接收明确的目标页面、操作和可观察成功条件，并执行需要真实浏览器的登录态内容读取、JS 动态渲染、交互流程、表单、截图、UI 验证或人工接管。普通公开网页、���索摘要和公开 API 使用静态工具。 开始真实操作前向用户展示： > 温馨提示：部分��点对浏览器自动化操作检测严格，存在账号封禁风险。已内置防护措施但无法完全避免，Agent 继续操作即视为接受。强烈建议社交平台用小号操作。 ## Runtime 优先调用 PATH 中的二进制；仓库根目录 `install.sh` 默认下载预编译 Runtime，不要求本机安装 Rust，只有 `--from-source` 才需要 Rust/Cargo： ```bash browser-skill serve curl -s http://127.0.0.1:3456/health ``` 页面操作的健康门槛是 `/health` 返回 `status=ok` 且 `connected=true`。`providers.extension.connected` 表示扩展可用，`providers.cdp.connected` 表示 CDP 侧车可用。失败时运行一次 `browser-skill doctor` 并根据结果处理，复用现有 bridge 和 managed 页面。 ## 强制生命周期 1. 整个用户需求使用一个稳定 session，并持续复用该 session 对应的 `Agent · <session>` 标签分组。记录本次持有的 created/borrowed target、显式 CDP lease、网络规则和临时模拟状态。先查询 `GET /targets?managed=1&session=<name>`，复用分组内适合继续操作的 managed 主 `targetId`；没有可复用页面时调用一次 `POST /new?session=<name>`。用户已有但尚未托管的页面通过 `/borrow` 获得确认，并保留在用户原窗口而非 Agent 分组。 2. 同一需求默认复用一个主标签页，后续 URL 通过主 target 的 `/navigate` 访问。用户明确要求多页面、需要并排对照，或被测流程要求新窗口/弹窗时才新增标签页；新增页沿用同一 session，用完立即关闭。 3. 每次页面变化后先 `/observe`；需要紧凑控件列表用 `/snapshot`，需要无障碍树或跨复杂结构诊断用 `/a11y`，视觉信息才用 `/screenshot`。 4. 优先用最新观察得到的 `@eN` 调用 `/click`、`/hover`、`/fill`、`/ty