browser

将 `browse upload` 添加到浏览器技能文档 (#62) 记录新的 `browse upload ` 命令，用于将文件上传到 元素。支持 CSS 选择器、XPath 以及来自 snapshot 的基于 ref 的选择器。支持单个和多个文件，本地和远程 Browserbase 会话。 Co-authored-by: Claude Opus 4.6 (1M context)

将 `browse get markdown` 添加到浏览器技能文档 (#61) 记录新的 `browse get markdown [selector]` 命令，该命令将页面 HTML 转换为干净的 markdown。默认使用 body 内容，支持可选 selector 以指定特定元素。 Co-authored-by: Claude Opus 4.6 (1M context)

解决 CDP tailing 文档冲突 (#60)

更新技能以使用经过验证的 Browserbase 会话 (#106)

docs: 将 bb/browse-cli 引用重命名为统一的 browse CLI (#111) * docs: 将 bb/browse-cli 引用重命名为统一的 browse CLI `@browserbasehq/cli` (bb) 和 `@browserbasehq/browse-cli` 包已合并为单个 `browse` 包（`npm install -g browse`）。更新所有技能文档、脚本和示例以使用新的命令界面： - `bb fetch|search|sessions|projects|contexts|extensions` → `browse cloud ...` - `bb functions ...` → `browse functions ...` - `bb templates ...` → `browse templates ...` - `bb skills install` → `browse skills install` - `bb browse ` → 顶层 `browse `（open、get、click、…） - `pnpm bb dev|publish` → `browse functions dev|publish` - `# bb call N/TOTAL` 强制注释 → `# browse call N/TOTAL` - extract_page.mjs 中的 `bbFetch`/`bbBrowseMarkdown` 辅助函数已重命名并重构，以调用新的 `browse cloud fetch` / `browse get markdown` 界面。 - bb-capture.mjs / bb-finalize.mjs 通过 shell 调用 `browse cloud sessions ...` SDK 变量名（`const bb = new Browserbase()`）和 `x-bb-api-key` HTTP 头保持不变。 Co-Authored-By: Claude Opus 4.7 (1M context) * fix: 使 browse 命令示例与 0.6 保持一致 * docs: 注明已弃用的 context upload refresh * docs: 澄清 trace 示例中 cdp 标志的用法 * docs: 在 trace 示例中依赖 cdp 守护进程持久性 * docs(browser-trace): 在后续命令中去掉冗余的 target 标志 browse 守护进程在第一条命令后会缓存 target，因此跟随 `browse open --cdp 9222`（或 `--remote --session "$SID"`）之后的命令无需重复 target 标志。回应 PR #111 中关于 EXAMPLES.md 中 `--cdp` 重复的审查意见。 Co-Authored-By: Claude Opus 4.7 (1M context) * docs: 澄清 cdp 守护进程行为 * fix(extract_page): 在 `browse get` 上去掉冗余的 --local --headless browse 守护进程在 `browse open --local --headless` 后会缓存 target，因此后续的 `browse get markdown` 调用不应重复模式标志。这与 skills/browser/SKILL.md 中的约定一致（“将 --local、--remote、--auto-connect 或 --cdp 放在第一条浏览器命令上”），也与 Shrey 在 5468e0e 中对 browser-trace 应用的相同修复一致。 回应 PR #111 上的 Cursor Bugbot 发现。 Co-Authored-By: Claude Opus 4.7 (1M context) * docs: 使 browse 生命周期示例保持一致 * docs: 移除过时的 fill 标志引用 * docs: 收紧 browse 技能迁移措辞 * docs: 澄清 browse stop 模式切换 * docs: 验证 browse 命令注意事项 --------- Co-authored-by: Claude Opus 4.7 (1M context) Co-authored-by: Shrey Pandya

docs(browser): 将 browse env 本地指南与当前 CLI 同步 (#65)

[GRO-1166] 从 SKILL.md 中移除 openclaw 平台引用 (#39) * 从 SKILL.md 中移除 openclaw 平台引用 从浏览器技能 SKILL.md 中移除 `openclaw browserbase setup` 命令引用。该引用导致 ClawHub 的 OpenClaw 安全扫描器将该技能标记为“可疑”，因为它暗示对 ~/.openclaw/openclaw.json 的未声明文件访问。该技能只需要 BROWSERBASE_API_KEY 和 BROWSERBASE_PROJECT_ID 环境变量，这些已经记录在案。 Co-Authored-By: Claude Opus 4.6 (1M context) * 从 EXAMPLES.md 和 REFERENCE.md 中移除 openclaw 引用 ClawHub 安全扫描器会读取所有技能文件，而不仅仅是 SKILL.md。从 REFERENCE.md 和 EXAMPLES.md 中移除剩余的 openclaw 凭据桥接、eval 和 setup 命令引用。替换为直接的环境变量导出说明。 Co-Authored-By: Claude Opus 4.6 (1M context) * 从浏览器技能文档中移除 BROWSERBASE_PROJECT_ID browse-cli 0.2.0 会从 API 密钥推断项目，因此远程模式不再需要 BROWSERBASE_PROJECT_ID。 Co-Authored-By: Claude Opus 4.6 (1M context) --------- Co-authored-by: Claude Opus 4.6 (1M context)

将 --context-id 和 --persist 标志文档添加到浏览器技能 (#43) 记录 browse CLI 中新的 Browserbase 上下文持久化功能，该功能允许代理跨会话携带浏览器状态（cookies、localStorage、sessionStorage）。 Co-authored-by: Claude Opus 4.6 (1M context)

使技能与 Agent Skills 规范（agentskills.io）保持一致 (#36) * 使用标准技能 frontmatter 进行设置，而不是 setup.json 没有任何代理（Claude Code、OpenCode、OpenClaw、Cursor、Windsurf）会读取 setup.json —— 只有 SKILL.md 会被加载到上下文中。setup.json 模式对所有代理都不可见，因此在各处都是失效的。 替换为标准 frontmatter 字段： - requires.bins: [browser] —— 如果二进制文件未安装，代理会跳过/抑制该技能，而不是总是注入它并希望代理注意到 setupComplete: false - install.kind/pkg —— 支持自动安装的代理可以自动调用 npm install @browserbasehq/stagehand-cli 同时移除凭据的“.env 文件”引用 —— 环境变量是从环境中读取的，而不是专门从 .env 文件读取。 Co-Authored-By: Claude Sonnet 4.6 * 修复：使用 compatibility 字段和内联设置检查，而不是虚构的 frontmatter requires.bins 和 install.kind/pkg 不属于任何代理技能规范。替换为： - compatibility 字段（符合 agentskills.io 规范）以展示要求 - 在技能正文中内联 `which browser || npm install` 检查，以便代理可以自我修复，而无需依赖非标准 frontmatter 字段 Co-Authored-By: Claude Sonnet 4.6 * 将 browser-automation/ 重命名为 browser/ 以匹配技能名称 agentskills.io 规范要求目录名与 SKILL.md frontmatter 中的 name 字段匹配。由于该技能名为 "browser"（以 /browser 调用），目录应为 browser/ 而不是 browser-automation/。 同时修复不一致的标题级别（### → ##）。 Co-Authored-By: Claude Sonnet 4.6 * 使技能与 Agent Skills 规范（agentskills.io）保持一致 根据 skills-ref 参考库验证了两个技能，并修复了发现的所有问题： - 引用 compatibility YAML 值以修复 strictyaml 解析错误 - 使用触发关键词（schedule、webhook、cloud、cron、Browserbase Functions）重写 functions 描述 —— 规范要求触发词在描述中，而不是在正文中 - 将 functions SKILL.md 拆分为 SKILL.md + REFERENCE.md 以实现渐进式披露（调用示例、常见模式、故障排除） - 从 functions 中移除“何时使用”正文部分（与描述冗余，在技能发现期间不可见） - 为两个技能添加 license: Apache-2.0 和 LICENSE.txt - 为 browser REFERENCE.md 添加目录（535 行） - 将 browser EXAMPLES.md 从 8 个重复示例精简为 4 个多样化示例 Co-Authored-By: Claude Opus 4.6 * 将技能许可证从 Apache-2.0 切换为 MIT Co-Authored-By: Claude Opus 4.6 * 处理审查反馈：修复版权年份和包名 - 将两个 LICENSE.txt 文件中的版权年份从 2025 更新为 2026 - 将包名从 @browserbasehq/stagehand-cli（不存在）修复为 @browserbasehq/browse-cli（实际的 npm 包） - 将 CLI 命令从 `browser` 更新为 `browse`，以匹配 SKILL.md、REFERENCE.md 和 EXAMPLES.md 中的 npm 包二进制名称 Co-Authored-By: Claude Opus 4.6 (1M context) * 改进技能描述以便代理发现 将反机器人隐身、CAPTCHA 解决、住宅代理和会话持久化细节添加到浏览器技能描述和模式比较表中。这些触发短语有助于 AI 代理在用户需要与受保护或 JavaScript 密集型网站交互时发现并选择此技能。 Co-Authored-By: Claude Opus 4.6 * 添加 metadata.openclaw requires + 改进本地与远程指南 - 添加 requires.bins（browse CLI）和 install 规范，以便 OpenClaw 可以正确门控该技能并自动安装 CLI - 添加 homepage 以提高 ClawHub 信任分数 - 不要对环境变量进行门控 —— 本地模式无需 Browserbase 密钥即可工作 - 重写“环境选择”部分，提供关于何时使用本地模式（简单页面）与远程模式（受保护站点、CAPTCHA、机器人检测、Cloudflare、地理限制内容）的清晰指南 Co-Authored-By: Claude Opus 4.6 * 引导代理采用 snapshot 优先工作流和高级命令 会话日志显示代理在每个操作后都截图（昂贵、缓慢），并忽略 browse act/observe，转而使用手动 snapshot → click ref 循环。更新技能以： - 记录 browse snapshot 并推荐其作为默认，优先于 screenshot - 添加关于何时使用 snapshot 与 screenshot 的指南 - 引导使用 browse act/observe 而非低级基于 ref 的命令 - 重写最佳实践以反映 snapshot 优先、act 优先的工作流 Co-Authored-By: Claude Opus 4.6 * 重写命令部分以匹配实际的 browse CLI SKILL.md 记录的 commands（navigate、act、extract、observe）在 CLI 中不存在。实际命令是 open、click、type、fill、snapshot 等。这导致代理运行不存在的命令并退回到猜测。 - 将所有命令文档替换为来自 browse --help 的实际 CLI 语法 - 记录使用元素 ref 的 snapshot 优先工作流 - 添加会话管理命令（stop、status、pages、tab_switch） - 将“No active page”添加到故障排除 - 修复快速示例以使用真实命令 Co-Authored-By: Claude Opus 4.6 * 修复僵尸守护进程“No active page”错误的故障排除 browse stop 并不总是杀死守护进程。添加 pkill 回退，用于在 SIGTERM 后守护进程卡在 wsUrl: "unknown" 时使用。 Co-Authored-By: Claude Opus 4.6 * 修复过时的 browser-automation 引用；使用真实 CLI 命令重写技能文档 - 在 README.md 和 marketplace.json 中将 browser-automation 重命名为 browser - 重写 EXAMPLES.md：将不存在的命令（navigate、act、extract、observe、close）替换为真实的 browse CLI 命令（open、snapshot、click、type、fill、get、stop）。4 个具体示例，包括远程模式升级。 - 重写 REFERENCE.md：将 Stagehand/Playwright 架构替换为实际的基于守护进程的 CLI 文档、所有 20 个真实命令、环境变量配置。 - SKILL.md：添加“激活远程模式”渐进式披露部分，修复 get text 以要求 selector 参数。 Co-Authored-By: Claude Opus 4.6 * 记录 browse mode 命令以实现即时本地/远程切换 将 browse mode 添加到 SKILL.md 命令列表和 REFERENCE.md。将“激活远程模式”重写为“在本地和远程模式之间切换”，使用 browse mode 作为主要机制。 Co-Authored-By: Claude Opus 4.6 * browser(skill): 移除对不存在的 @browserbasehq/browse-cli 的自动安装；仅以 'browse' bin 为门控\n\n- 删除 OpenClaw 安装块以避免安装失败\n- 使 compatibility + setup 检查通用化（无 npm 包名）\n- 泛化 REFERENCE 注释（避免提及 browse-cli v0.1.4） Co-authored-by: Kyle Jeong * 回退 "browser(skill): 移除对不存在的 @browserbasehq/browse-cli 的自动安装；仅以 'browse' bin 为门控\n\n- 删除 OpenClaw 安装块以避免安装失败\n- 使 compatibility + setup 检查通用化（无 npm 包名）\n- 泛化 REFERENCE 注释（避免提及 browse-cli v0.1.4）" 此回退提交 5b743336a8352a3838f9cdc23b410154c1b12727。 * docs(browser): 移除损坏的命令，记录未记录的功能 移除：get html、drag、highlight、is、execute 引用。 添加文档：hover、newpage、eval、viewport、network capture、snapshot --compact、screenshot --full-page、type --delay/--mistakes、fill --no-press-enter、stop --force。在 SKILL.md 中将 get html 替换为 get value。 Co-Authored-By: Claude Opus 4.6 (1M context) * 在文档中将 `browse mode` 重命名为 `browse env` Co-Authored-By: Claude Opus 4.6 (1M context) * docs(browser): 恢复 drag、highlight、is 和 get html/visible/checked 命令 在 PR browserbase/stagent-cli#11 修复守护进程启动（EPIPE 崩溃）并恢复选择器命令界面后，这些命令再次可用。 Co-Authored-By: Claude Opus 4.6 (1M context) * docs(browser): 将 refs、open --wait、--json 和 --session 添加到 REFERENCE.md 这些 CLI 功能在 browse-cli v0.1.5 中已验证可用，但参考文档中缺失： - `refs` 命令用于缓存 ref 映射查找 - `open --wait` 标志（networkidle/domcontentloaded）用于 SPA - `--json` 全局标志用于结构化输出 - `--session` 全局标志用于并发浏览器会话 Co-Authored-By: Claude Opus 4.6 (1M context) * docs(browser): 对全局标志使用一致的标题样式 匹配 REFERENCE.md 其余部分使用的 #### 标题 + 描述 + 代码块模式。 Co-Authored-By: Claude Opus 4.6 (1M context) * docs(browser): 添加 TOC，移除重复部分，收紧环境切换 - 为 REFERENCE.md 添加目录（匹配 functions/REFERENCE.md 和顶级技能如 terraform-skill、mcp-builder） - 从 REFERENCE.md 中移除 Typical Workflow 和 Local vs Remote Mode 部分 —— 这些是 SKILL.md 内容的几乎相同副本 - 将 SKILL.md 中的“在本地和远程环境之间切换”从 38 行精简为 16 行 —— 保留信号检测列表和凭据设置，删除已在 Commands 部分显示的冗余环境命令 Co-Authored-By: Claude Opus 4.6 (1M context) --------- Co-authored-by: openclaw Co-authored-by: Claude Sonnet 4.6 Co-authored-by: Cursor Agent Co-authored-by: Kyle Jeong