# NomoE2E 使用指南

## 🎯 安装方式

### 方式一：使用 uv（推荐）

```bash
# 安装最新版本（发布到 PyPI 后）
uv tool install nomo-e2e

# 或从本地安装
uv tool install -e .

# 或全局安装到系统 Python
uv pip install --system --break-system-packages nomo-e2e
```

### 方式二：使用 pip

```bash
pip install nomo-e2e
```

## 🚀 使用方法

安装后，你可以在任意目录下直接使用 `nomo-e2e` 命令：

```bash
# 查看帮助
nomo-e2e --help

# 连接 CDP 端点（基于CDP协议的WebView）
nomo-e2e open http://localhost:9222

# 连接 WebDriver 端点（Mac上的Tauri2应用程序）
nomo-e2e open --driver webdriver http://localhost:4445

# 页面操作
nomo-e2e snapshot          # 获取页面快照
nomo-e2e screenshot        # 截图
nomo-e2e click "#button"   # 点击元素
nomo-e2e fill "#input" "text"  # 填写表单

# 关闭连接
nomo-e2e close
```

## 📦 技能包安装

安装 AI Agent 技能包：

```bash
# 查看技能包位置
nomo-e2e skills

# 安装到 ~/.claude/skills/nomo-e2e
nomo-e2e skills --install
```

## 🔧 完整命令列表

查看所有可用命令：

```bash
nomo-e2e --help
```

主要命令：

- **连接**：`open` - 打开 WebView 连接
- **页面**：`snapshot`, `screenshot`, `url`, `title`, `reload`
- **导航**：`goto`, `go-back`, `go-forward`
- **交互**：`click`, `dblclick`, `hover`, `fill`, `type-text`
- **高级交互**：`drag`, `select`, `check`, `uncheck`, `upload`
- **键盘**：`press`, `keydown`, `keyup`
- **鼠标**：`mousedown`, `mouseup`, `mousemove`, `mousewheel`
- **存储**：`cookie-*`, `localstorage-*`, `sessionstorage-*`
- **开发工具**：`console`, `network`, `pdf`
- **会话**：`status`, `list`, `close`, `close-all`, `state-save`, `state-load`
- **配置**：`config-get`, `config-set`, `config-list`
- **技能**：`skills` - 管理 AI Agent 技能包

## 📚 文档

- [README.md](README.md) - 项目说明
- [CLI-API.md](CLI-API.md) - CLI 命令详解
- [API.md](API.md) - Python API 文档

## 🔗 相关项目

- 技能包：`src/nomo_e2e_skills/`
- 参考文档：`src/nomo_e2e_skills/references/`
