55 lines
2.3 KiB
Markdown
55 lines
2.3 KiB
Markdown
# 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
|