# VisionL

面向 AI 智能体的开源可持久化浏览器 —— **让 LLM 访问页面不被简单人机验证拦截**。

LLM 通过 `VisionL-cli` 工具调用操控网页。内置多层反检测机制，覆盖 Navigator 属性、
Canvas/WebGL/Audio 指纹、HTTP 请求头、屏幕视口、权限状态、鼠标键盘行为等全部维度，
使自动化访问尽可能不被 Cloudflare、Akamai 等反爬服务识别。

## 特性

- **反检测优先**：所有可被页面 JS 读取的浏览器特征均有模拟值，不留自动化痕迹
- **指纹模版化**：内置多套指纹配置（桌面 Chrome/Win/Mac），智能体可按需选择
- **智能体优先**：CLI 子命令专为 LLM 工具调用设计，输出结构化 JSON
- **页面持久化**：页面存活不受客户端断连影响
- **全功能自动化**：点击、输入、滚动、截图、JS 执行

## 文档

| 文档 | 说明 |
|------|------|
| [快速开始](docs/usage/quickstart.md) | 安装和基本使用 |
| [LLM 集成](docs/usage/llm-integration.md) | 在智能体中集成 VisionL |
| [使用示例](docs/usage/examples.md) | 典型场景 |
| [架构设计](docs/development/architecture.md) | 整体架构 + 反检测设计 |
| [反检测设计](docs/development/anti-detection.md) | 指纹覆盖详情、绕过原理 |
| [API 文档](docs/development/api.md) | REST + WebSocket 接口 |
| [CLI 命令](docs/development/cli.md) | 命令参考 |
| [开发规范](docs/development/contributing.md) | 贡献指南 + 反检测开发要求 |

## 技术栈

TypeScript + Node.js + Playwright + playwright-extra + stealth 插件 + 自研 stealth 模块

## 已验证功能

| 功能 | 状态 | 说明 |
|------|------|------|
| 页面打开/关闭/列表 | ✅ | 支持别名引用 |
| 文本提取 | ✅ | body.innerText |
| HTML 提取 | ✅ | documentElement.outerHTML |
| 截图 | ✅ | PNG base64 输出 |
| JS 执行 | ✅ | 任意代码 eval |
| 点击/输入/滚动 | ✅ | CSS 选择器定位 |
| 等待 | ✅ | 选择器或毫秒 |
| Cookie 管理 | ✅ | 查看/设置/删除 |
| 网络请求监控 | ✅ | 实时请求/响应日志 |
| 控制台监控 | ✅ | 实时 console 输出 |
| 指纹模版切换 | ✅ | 3 套内置配置 |
| WebSocket 实时推送 | ✅ | 页面事件广播 |
| 反检测 (navigator/screen/canvas/headers) | ✅ | 7 个 stealth 模块 |

## License

Apache-2.0