docs: 将反检测作为核心设计原则,全面更新架构和文档

- architecture.md: 新增反检测为核心第一性原理,新增 §3 反检测设计(13 个指纹维度全覆盖)
- anti-detection.md: 新增反检测专项文档(14 节,详尽列举检测方式和应对策略)
- api.md: POST /pages 新增 profile 参数,新增 GET /profiles 端点
- cli.md: 新增 --profile 全局选项,新增 visionl profiles 命令
- contributing.md: 新增反检测开发规范、检测站点验证要求
- README.md: 更新项目定位和特性描述
This commit is contained in:
2026-08-12 20:21:53 +08:00
parent 0c437a96f1
commit 985860b2a2
6 changed files with 896 additions and 236 deletions
+22 -2
View File
@@ -20,6 +20,7 @@ cd packages/cli && npm link
|------|------|
| `--pretty` | 人类可读格式输出(默认 JSON) |
| `--port <n>` | daemon 端口(默认 9527 |
| `--profile <id>` | 指纹配置模版(默认 desktop-chrome |
| `--help` | 查看帮助 |
---
@@ -31,13 +32,13 @@ cd packages/cli && npm link
打开新页面。
```bash
visionl page open <url> [--alias <name>]
visionl page open <url> [--alias <name>] [--profile <id>]
```
**示例:**
```bash
visionl page open https://www.baidu.com --alias baidu
visionl page open https://www.baidu.com --alias baidu --profile desktop-windows
# {"ok":true,"data":{"id":"p_a1b2c3d4","url":"https://www.baidu.com","alias":"baidu","title":"百度一下,你就知道","status":"active"}}
```
@@ -184,6 +185,25 @@ visionl html <id|alias>
---
## 指纹配置
### `visionl profiles`
列出可用的指纹配置模版。
```bash
visionl profiles
# {"ok":true,"data":[{"id":"desktop-chrome","name":"桌面 Chrome (通用)"},{"id":"desktop-windows","name":"Windows 10 Chrome"},...]}
```
| 模版 ID | 说明 | UA 平台 |
|---------|------|---------|
| `desktop-chrome` | 桌面 Chrome 通用(默认) | Linux x86_64 |
| `desktop-windows` | Windows 10 Chrome | Windows NT 10.0 |
| `desktop-mac` | macOS Chrome | Macintosh Intel |
---
## Daemon 管理
### `visionl daemon start`