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
+24 -2
View File
@@ -64,7 +64,8 @@ POST /pages
```json
{
"url": "https://example.com",
"alias": "demo" // 可选
"alias": "demo", // 可选
"profile": "desktop-chrome" // 可选,指纹配置模版 ID,默认 "desktop-chrome"
}
```
@@ -78,7 +79,8 @@ POST /pages
"url": "https://example.com",
"alias": "demo",
"title": "Example Domain",
"status": "active"
"status": "active",
"profile": "desktop-chrome"
}
}
```
@@ -310,6 +312,25 @@ GET /pages/:id/html
## Daemon 管理
### 指纹配置列表
```
GET /profiles
```
**响应:**
```json
{
"ok": true,
"data": [
{ "id": "desktop-chrome", "name": "桌面 Chrome (通用)", "platform": "Linux x86_64" },
{ "id": "desktop-windows", "name": "Windows 10 Chrome", "platform": "Windows NT 10.0" },
{ "id": "desktop-mac", "name": "macOS Chrome", "platform": "Macintosh" }
]
}
```
### 健康检查
```
@@ -343,3 +364,4 @@ ws://127.0.0.1:9527/ws
| `page:navigated` | daemon → 客户端 | 页面 URL 发生变化 |
| `page:crashed` | daemon → 客户端 | Playwright 页面崩溃 |
| `page:console` | daemon → 客户端 | 页面控制台输出(调试) |
| `page:detection:warning` | daemon → 客户端 | 页面可能检测到自动化特征 |