diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md new file mode 100644 index 0000000..9885f8e --- /dev/null +++ b/.planning/REQUIREMENTS.md @@ -0,0 +1,46 @@ +# Requirements: v1.4 Zhihu Anti-Crawler + +**Defined:** 2026-03-18 +**Core Value:** 绕过知乎反爬检测,让爬虫正常工作 + +## v1 Requirements + +### 指纹伪装 (Stealth) + +- [ ] **STEALTH-01**: 隐藏 navigator.webdriver 属性 +- [ ] **STEALTH-02**: 移除 Playwright 特有的 JS 属性(__playwright, pwInspect 等) +- [ ] **STEALTH-03**: 模拟正常浏览器的 Chrome 属性 +- [ ] **STEALTH-04**: 修改 User-Agent 为正常浏览器格式 + +### 集成验证 (Verify) + +- [ ] **VERIFY-01**: ZhihuCrawler 集成指纹伪装后能正常访问问答页面 +- [ ] **VERIFY-02**: 保持现有功能不变(登录、Cookie、内容爬取) + +## Out of Scope + +| Feature | Reason | +|---------|--------| +| 其他平台适配 | 本里程碑只针对知乎 | +| 验证码识别 | 知乎主要用二维码登录,验证码场景少 | +| 代理池扩展 | v1.3 已实现,本版本不改动 | +| 行为伪装(鼠标轨迹等) | 先用最小改动验证效果,如需要再加 | + +## Traceability + +| Requirement | Phase | Status | +|-------------|-------|--------| +| STEALTH-01 | Phase 11 | Pending | +| STEALTH-02 | Phase 11 | Pending | +| STEALTH-03 | Phase 11 | Pending | +| STEALTH-04 | Phase 11 | Pending | +| VERIFY-01 | Phase 11 | Pending | +| VERIFY-02 | Phase 11 | Pending | + +**Coverage:** +- v1 requirements: 6 total +- Mapped to phases: 6 +- Unmapped: 0 ✓ + +--- +*Requirements defined: 2026-03-18*