杨豪
6902be04d4
- 合并 matcher_core + solve 为自包含单文件 captcha_solver.py， 对外仅暴露 solve_slide()（base64 进、JSON 出），内部实现细节不外泄 - 新增 README_3rd.md：接入步骤、返回字段、像素换算、鼠标操作规范、 轨迹形态要求、踩坑清单与验收基线 - 删除内部 CLI 批量工具与调试字段（candidates/method）， 返回清洗后的 quality/alternatives - try/live_solve.py 改用新模块路径；docs 同步更新引用
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/captcha_solver.py <大图> <mark>
# 结果验证（叠加轮廓图）
.venv/bin/python src/verify_result.py
相关目录
| 目录 | 用途 |
|---|---|
captchas/ |
原始样本（只读） |
src/ |
最终交付物：求解 API、核心算法、验证工具及其输出 |
try/ |
实验脚本与中间产物（历史方法 A~K） |