# docs

项目文档索引。

## 文档列表

- [solution.md](solution.md) — 最终方案：算法原理、API 用法、结果验证方法、10 样本结果与已知边界
- [experiments.md](experiments.md) — 实验演进记录（A→L）：各方法失败原因、转折点实验、调试坑、无真值交叉验证方法
- [retrospective.md](retrospective.md) — ★ 全项目复盘：四阶段演进、决定性发现、踩坑清单、方法论沉淀与未竟事项

## 浏览器自动化经验（browser-automation/）

一条经验一个文档，自动化操作中探索到的可复用经验：

- [cdp-browser-use-basics.md](browser-automation/cdp-browser-use-basics.md) — CDP 9222 连接与 browser-use 基础 API、js() 顶层变量坑
- [douyin-captcha-detection.md](browser-automation/douyin-captcha-detection.md) — 验证码 iframe 预加载机制与「已触发」的判定方法
- [douyin-comment-input.md](browser-automation/douyin-comment-input.md) — 视频页评论框输入（DraftEditor 假 INPUT 坑、坐标点击、Ctrl+Enter 提交）
- [douyin-captcha-trigger-attempts.md](browser-automation/douyin-captcha-trigger-attempts.md) — 触发验证码的早期尝试记录（无效方法清单）
- [captcha-screenshot-capture.md](browser-automation/captcha-screenshot-capture.md) — wasm/GPU 渲染图片的 fromSurface=False 截图采集法（已被网络层法取代）
- [human-drag-path.md](browser-automation/human-drag-path.md) — 拟人拖动路径生成算法（非直线/非匀速/过冲瞄准三要素）
- **[captcha-auto-solve-pipeline.md](browser-automation/captcha-auto-solve-pipeline.md) — ★ 最新：密码登录触发法、网络层样本采集、tip_y 真值校准、自动闭环与 5014 行为风控现状**
- **[captcha-image-acquisition.md](browser-automation/captcha-image-acquisition.md) — 对接方视角：如何获取验证码大图与 mark 小图（/captcha/get 取 URL、DevTools 手动采集、触发与限流、踩坑清单）**

## 快速开始

```bash
# 单样本求解（base64 或文件路径）
.venv/bin/python src/captcha_solver.py <大图> <mark>

# 结果验证（叠加轮廓图）
.venv/bin/python src/verify_result.py
```

## 相关目录

| 目录 | 用途 |
| --- | --- |
| `captchas/` | 原始样本（只读） |
| `src/` | 最终交付物：求解 API、核心算法、验证工具及其输出 |
| `try/` | 实验脚本与中间产物（历史方法 A~K） |