# OpenCLI Integration - 通用CLI集成技能

集成 OpenCLI 能力，将任何网站、Electron应用转换为命令行接口，供AI Agent调用。

## 🎯 功能特性

- ✅ **网站CLI化** - 将任意网站转换为CLI工具
- ✅ **Electron应用控制** - 控制Antigravity等Electron应用
- ✅ **AI自动发现** - 自动探索网站API并生成适配器
- ✅ **浏览器复用** - 复用Chrome登录态，零风控
- ✅ **动态适配器** - 支持.yaml声明式和.ts编程式适配器

## 🚀 使用方法

### 前置要求

```bash
# 1. 安装Node.js >= 20.0.0
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 2. 安装OpenCLI
npm install -g @jackwener/opencli

# 3. 确保Chrome正在运行且已登录目标网站
```

### 命令行使用

```bash
# 探索网站API
python3 /home/ubuntu/.nanobot/workspace/skills/opencli-integration/opencli_adapter.py explore https://www.xiaohongshu.com

# 生成适配器
python3 /home/ubuntu/.nanobot/workspace/skills/opencli-integration/opencli_adapter.py synthesize xiaohongshu

# 执行CLI命令
python3 /home/ubuntu/.nanobot/workspace/skills/opencli-integration/opencli_adapter.py exec xiaohongshu search "关键词"

# 诊断状态
python3 /home/ubuntu/.nanobot/workspace/skills/opencli-integration/opencli_adapter.py doctor
```

### Python API

```python
from opencli_adapter import OpenCLIAdapter

adapter = OpenCLIAdapter()

# 探索网站
result = adapter.explore("https://www.xiaohongshu.com")

# 生成适配器
adapter.synthesize("xiaohongshu")

# 执行命令
result = adapter.execute("xiaohongshu", "search", query="关键词")
```

## 📋 内置支持

OpenCLI官方支持的网站/应用：
- B站 (bilibili)
- 知乎 (zhihu)
- 小红书 (xiaohongshu)
- Twitter/X
- Reddit
- YouTube
- Antigravity (Electron)

## 🔧 高级用法

### 自定义适配器

```python
# 创建自定义适配器
adapter.create_custom_adapter(
    name="mysite",
    base_url="https://example.com",
    selectors={
        "search_box": "input[name='q']",
        "search_button": "button[type='submit']"
    }
)
```

### Electron应用控制

```python
# 控制Electron应用
adapter.control_electron("antigravity", "open_file", path="/path/to/file")
```

## ⚠️ 注意事项

- 需要Chrome浏览器正在运行
- 需要Node.js >= 20.0.0
- 新网站可能需要手动登录
- AI发现API的准确性需要验证

## 📚 参考

- OpenCLI GitHub: https://github.com/jackwener/opencli
- npm包: https://www.npmjs.com/package/@jackwener/opencli