{{ message }}
Repository navigation
Releases: sleepinginsummer/agent-browser-cli
Releases · sleepinginsummer/agent-browser-cli
Release list
v0.3.7
v0.3.7
- Preserve page Content-Security-Policy in the Chrome extension: stop stripping CSP headers and meta tags, and clean up the legacy dynamic rule on upgrade. Fixes a YouTube renderer CPU spin on Chrome 150 when Tampermonkey is active; CSP-restricted page execution keeps using the existing CDP fallback.
v0.3.6
- Support opening and controlling local files
v0.3.5
- Reduce Chrome debugger notification flicker by delaying idle CDP detach for 30 seconds.
- Reuse active debugger sessions across consecutive commands.
- Keep immediate detach for cleanup paths such as tab close, WebSocket loss, and debug clear.
- Guard batch CDP commands without tabId.
- Document delayed debugger detach behavior in the bundled skill.
v0.3.4
v0.3.4
- 调整 agent-browser-cli skill 默认流程:浏览器任务优先直接执行 tabs/open/exec/scan,由 CLI 按需自动启动 daemon。
- 明确 daemon_not_running/running=false 是未常驻状态,未执行目标命令前不应阻塞任务。
- 将 status/doctor/logs 收敛为目标命令失败、连接异常或明确排障时才使用的诊断入口。
v0.3.3
v0.3.3
新增
- 新增
tabtree:按 browser → profile → tab 查看当前连接的浏览器树。- 全量查看:
agent-browser-cli tabtree - 查看完整 URL 和
session_key:agent-browser-cli tabtree --full - 按条件过滤:
--tab <tab_id>、--profile <profile_id-or-label>、--browser <browser_id>
- 全量查看:
- 新增
lookup:反查 tab、browser、profile 的归属信息。agent-browser-cli lookup tab <tab_id>agent-browser-cli lookup browser <browser_id>agent-browser-cli lookup profile <profile_id-or-label>
- 新增
profile-label:通过 CLI 设置或清除 Profile Label。agent-browser-cli profile-label set <label> --profile <profile_id-or-label>agent-browser-cli profile-label clear --profile <profile_id-or-label>
- Chrome 扩展 popup 支持设置 Profile Label,并提示推荐用 CLI 设置以校验当前 daemon 内 label 唯一性。
调整
tabtree默认使用 compact 输出,长 URL 会截断,并默认不显示session_key,减少输出体积和 token 消耗。alert/confirm/prompt不再被扩展默认改写;CLI 执行页面命令期间会临时抑制弹窗,命令结束后恢复。- 平台 npm 包体积进一步缩小。
移除
- 移除临时的
profiles/browsers摘要命令,统一使用tabtree/lookup。
v0.3.2
fix: prevent snapshot refs expiring on long urls
v0.3.1
v0.3.1-beta.2
feat: add multi profile sessions and window open beta
v0.3.1-beta.1
v0.3.1-beta.1
这是一个 beta 预发布版本,用于验证 Agent 浏览器操作、产物导出、调试监听和 skill 安装链路。npm 发布标签为 beta,不会覆盖 latest。
新增
- 新增
logs:读取~/.agent-browser-cli/logs/daemon.log,支持--tail。 - 新增
doctor:输出 JSON 诊断信息,不自动启动 daemon。 - 新增
install-skill:从 npm 包内置skills/agent-browser-cli安装 skill,支持--dry-run和--yes。 - 增强
status:新增healthy、summary、message。 - 新增
snapshot:基于 Chrome Accessibility Tree 生成@e操作引用,支持分页和--details。 - 新增高层操作命令:
click、fill、send-keys、mouse-click。 - 新增
screenshot:支持视口截图、全页截图、元素截图、PNG/JPEG。 - 新增
save-pdf:支持纸张、横向、缩放、打印背景和默认文件名清理。 - 新增
network调试命令:start、list、detail、clear、stop。 - 新增
console调试命令:start、list、clear、stop。 open新增--session和--group-title,支持 Chrome 原生 tab group。- 新增
close --tab <tabId>,通过扩展原生chrome.tabs.remove关闭标签页。 - Chrome 扩展新增 bot 图标,显示名改为
Agent Browser CLI Bridge。 - daemon 退出时清理 daemon 缓存,并通知扩展清理 network/console 调试缓存。
调整
- daemon stdout/stderr 日志固定写入用户目录,不再写到当前目录或 npm 包目录。
- npm wrapper 设置
AGENT_BROWSER_CLI_PACKAGE_DIR,确保全局 npm 安装后能找到内置 skill。 network stop/console stop会停止监听并清理对应缓存。AI_INSTALL.md明确:skill 从 npm 包内置目录复制安装,不需要从 GitHub 拉取SKILL.md。- skill 文档重写为 Agent 操作 SOP,明确
scan、snapshot、exec/CDP的职责边界。 - 命令命名收敛为
open/close,移除new-tab/close-tab外部命令。 - GitHub Actions 发布流程支持预发布 tag:预发布版本自动标记 GitHub Pre-release,npm 使用
betadist-tag,避免污染latest。
验证
已覆盖真实 Chrome 场景:
- 百度搜索并抓取前五条结果正文
- 页面扫描、DOM 定位、输入、点击
@e引用、selector 操作、键盘输入- 截图、PDF 导出
- network/console 监听、列表、详情、清理
- tab group 创建
- daemon 退出缓存清理
- 测试 tab 关闭
本地检查已通过:
cargo fmt --checkcargo checkcargo testnode --check assets/tmwd_cdp_bridge/background.jsnode --check assets/tmwd_cdp_bridge/content.jsnpm pack --dry-run
安装 beta
npm install -g @sleepinsummer/agent-browser-cli@beta
agent-browser-cli install-skill --dry-run
agent-browser-cli install-skillChrome 扩展请从该 GitHub Pre-release 下载 chrome-extensions.zip 后重新加载。
v0.2.10-extension
默认不聚焦浏览器窗口
本次更新调整浏览器操作的默认行为:CLI 触发新开标签页、切换标签页、CDP 操作时,默认不再主动将 Chrome/浏览器窗口拉到最前方,避免打断当前正在使用的窗口。
变更内容
- 默认不聚焦浏览器窗口,防止浏览器在操作过程中主动弹出到前台。
- 新增
allowFocus参数,用于显式控制是否允许聚焦浏览器。 openTab、tabs switch默认只在浏览器内部执行标签页操作,不抢占系统前台焦点。- CDP
Page.bringToFront默认会被跳过,只有传入allowFocus:true时才会真正执行。
需要聚焦时的用法
agent-browser-cli exec '{"cmd":"openTab","url":"https://www.baidu.com","active":true,"allowFocus":true}'agent-browser-cli exec '{"cmd":"cdp","tabId":303987837,"method":"Page.bringToFront","allowFocus":true}'本地更新方式
这次不需要重新安装或更新 npm 包。
只需要:
- 更新并重新加载 Chrome 插件 zip。
- 更新本地
agent-browser-cliskill 文件。
重新加载插件后,新行为立即生效。
