Skip to content

Releases: hubo1989/hyper-agent-browser

v0.4.0 - Download Features & Skills Enhancement

22 Jan 05:25

Choose a tag to compare

🎉 What's New

Download Commands

  • Implemented file download functionality with hab download and hab 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.0

Full Changelog: v0.3.2...v0.4.0

v0.3.1 - BrowserPool 和选择器修复

21 Jan 10:43

Choose a tag to compare

修复内容

🐛 Bug 修复

  1. BrowserPool headed 选项一致性检查

    • 修复了从无头模式切换到有头模式时浏览器不重建的问题
    • 现在切换 --headed 选项会自动关闭旧浏览器并创建新实例
  2. dom-extractor 选择器生成逻辑

    • 修复了生成无效 CSS 选择器的 bug(错误的 nth-child 链式选择器)
    • 使用 nth-of-type 替代,确保元素能被正确定位
    • 解决了 click 命令 30 秒超时的问题

📝 文档更新

  • 更新 Skill 安装路径为 ~/.claude/skills/hyper-agent-browser/skill.md
  • 更新安装文档中的目录结构

🧪 测试

  • 修复测试用例超时问题
  • 修复 screenshot 测试断言

安装

npm install -g hyper-agent-browser@0.3.1

完整更新日志

v0.3.0...v0.3.1

v0.3.0: 数据提取与网络监听能力升级

21 Jan 03:02

Choose a tag to compare

✨ 新特性

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

20 Jan 10:26

Choose a tag to compare

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