Releases: hubo1989/hyper-agent-browser
Releases · hubo1989/hyper-agent-browser
v0.4.0 - Download Features & Skills Enhancement
🎉 What's New
Download Commands
- Implemented file download functionality with
hab downloadandhab download-url - Supports authenticated downloads via browser context
- Proper error handling and progress reporting
New Skills Documentation
- Login Detection - Intelligent authentication state detection
- Retry Strategy - Robust operation retry patterns
- Download Guide - File download best practices
- CAPTCHA Handling - Human intervention workflow
- Web Monitoring - Page change detection and monitoring
Documentation
- Added English README for international users
- Reorganized documentation structure
Installation
npm install -g hyper-agent-browser@0.4.0Full Changelog: v0.3.2...v0.4.0
v0.3.1 - BrowserPool 和选择器修复
修复内容
🐛 Bug 修复
-
BrowserPool headed 选项一致性检查
- 修复了从无头模式切换到有头模式时浏览器不重建的问题
- 现在切换
--headed选项会自动关闭旧浏览器并创建新实例
-
dom-extractor 选择器生成逻辑
- 修复了生成无效 CSS 选择器的 bug(错误的
nth-child链式选择器) - 使用
nth-of-type替代,确保元素能被正确定位 - 解决了
click命令 30 秒超时的问题
- 修复了生成无效 CSS 选择器的 bug(错误的
📝 文档更新
- 更新 Skill 安装路径为
~/.claude/skills/hyper-agent-browser/skill.md - 更新安装文档中的目录结构
🧪 测试
- 修复测试用例超时问题
- 修复 screenshot 测试断言
安装
npm install -g hyper-agent-browser@0.3.1完整更新日志
v0.3.0: 数据提取与网络监听能力升级
✨ 新特性
1. 结构化数据提取
extract-table: 自动识别 HTML 表格与 ARIA grid。extract-list: 智能检测重复结构,支持商品/文章列表提取。extract-form: 批量读取表单字段状态。extract-meta: 一键获取 SEO/OG/Schema.org 元数据。
2. 智能等待策略
wait-idle: 网络空闲 (networkidle) + DOM 稳定 (MutationObserver) 双重校验。wait-element: 支持 attached/detached/visible/hidden 四种状态。
3. 网络请求监听
network-start/stop: 通过 CDP 拦截 XHR/Fetch,直接捕获 API 原始数据。
🛠️ 稳定性优化
- 修复了 Daemon 在重启后会话锁死和连接丢失的问题。
- 强化了 BrowserManager 的重连机制,支持会话自动恢复。
📚 文档更新
- 新增
docs/EXTRACTION_GUIDE.md详尽指南。 - 更新了 AI Agent Skill 模板。
v0.1.0 - Initial Release
hyper-agent-browser v0.1.0 🎉
纯浏览器自动化 CLI,专为 AI Agent 设计
✨ 核心功能
- 🎯 @en 元素引用 - 无需手写选择器,自动生成
@e1,@e2等引用 - 🔐 Session 持久化 - 保持登录状态,支持多账号隔离
- 🎭 反检测 - 基于 Patchright,绕过自动化检测
- ⚡ 快速启动 - Bun 运行时,冷启动 ~25ms
- 🤖 AI Agent 友好 - 设计用于 Claude Code 等 AI Agent 调用
🔒 安全特性
- ✅ evaluate 命令沙箱加固(白名单 + 增强黑名单)
- ✅ Session 文件权限保护(0o600)
- ✅ 配置文件权限保护(0o600)
- ✅ Chrome 扩展安全验证
- ✅ 系统 Keychain 隔离
- ✅ 配置键白名单验证
📦 支持的平台
- macOS (ARM64 / x64)
- Linux (x64 / ARM64)
- Windows (x64)
🚀 快速开始
macOS (ARM64)
```bash
curl -L https://github.com/hubo1989/hyper-agent-browser/releases/download/v0.1.0/hab-macos-arm64 -o hab
chmod +x hab
./hab --headed open https://google.com
```
Linux (x64)
```bash
curl -L https://github.com/hubo1989/hyper-agent-browser/releases/download/v0.1.0/hab-linux-x64 -o hab
chmod +x hab
./hab --headed open https://google.com
```
Windows (x64)
下载 hab-windows-x64.exe 并运行:
```powershell
hab-windows-x64.exe --headed open https://google.com
```
📖 文档
🤝 贡献
欢迎提交 Pull Requests!
📄 许可证
MIT
技术栈: Bun 1.2.21 + Patchright 1.57.0 + TypeScript 5.9.3