feat(v2.4.0): 新增 E_BLOCKED 错误码——细分 fetch 403 反爬拦截

真实环境问题: 抓取被墙/反爬站点 (如 baike.baidu.com) 返回 403 时,
classify_error 统一归为 E_AUTH, AI Agent 会误判为凭证问题而做无效的
认证重试。被封锁不是认证失败。

改动:
- common.py: 新增 E_BLOCKED 错误码 + recovery_hint (提示换 URL/镜像/
  用 Wayback 兜底/--exclude-domain); 新增 classify_fetch_error() 与
  _extract_status_code(): fetch 场景 403→E_BLOCKED, 401→E_AUTH,
  其余委托 classify_error (搜索场景 403 仍为 E_AUTH, 不变)
- fetch.py main(): 错误路径改用 classify_fetch_error (替代 classify_error)
- search.py: fetch_page 与 fetch_top_results 线程错误路径同样切换
- 新增 11 个测试 (test_v240_blocked_code.py), 全量 572 测试通过
- 真实环境验证: baike 403 → E_BLOCKED, 正常站点不受影响
- 文档同步 (SKILL.md/README.md 错误码表, 版本号 2.4.0)

This commit is contained in:

thzxx

2026-08-05 20:24:25 +08:00

parent 4df521dc9d

commit 471818074d

7 changed files with 177 additions and 9 deletions

									
										scripts/_config.py
									
		+1
		-1
	
												View File
												
				@@ -7,7 +7,7 @@ Retry settings and shared HTTP utilities now live in ``common.py`` so that

				both ``search.py`` and ``fetch.py`` share one consistent implementation.

				"""

				VERSION = "2.3.0"

				VERSION = "2.4.0"

				SCHEMA_VERSION = "1.0"

				USER_AGENT = f"searxng-cli/{VERSION}"