docs

项目文档索引。

文档列表

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

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

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

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

快速开始

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

# 批量求解 + 可视化（输出 src/out/L/）
.venv/bin/python src/method_l_shape.py

# 结果验证（叠加轮廓图，输出 src/out/L/verify/）
.venv/bin/python src/verify_result.py

相关目录

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