本项目基于 DrissionPage 与 声明式注解状态机(Annotation-Driven Flow) 架构,专为 TLScontact 等复杂多步骤、带 Cloudflare 挑战与动态页面流转的签证预约场景设计。
@on(url=..., title=..., ele=..., not_ele=..., priority=...):声明页面状态与触发动作。@guard(...):高优先级异常守卫(处理 502/504、Cloudflare Challenge、Session 过期)。@fatal(...):命中特定错误(如未添加申请人、账号锁定)时立即终止。@done:命中成功终态时自动提交并成功退出。ungoogled-chromium-148.0.7778.215-1-x86_64_linux/chrome,无需复杂安装。.
├── config.yaml # 运行时主配置文件
├── config.example.yaml # 配置文件模板
├── flow_annotated.py # 注解流驱动核心引擎 (BaseFlow, @on, @guard, @done, @fatal)
├── cf_bypasser.py # Cloudflare Turnstile / 5秒盾自动绕过模块
├── tls_flow.py # TLScontact 业务流程状态机实现 (TlsContactFlow)
├── mock_server.py # 本地离线 Mock 服务端
├── main.py # 主程序命令行启动入口
├── requirements.txt # Python 依赖清单
└── ungoogled-chromium-* # 内置免安装 Chromium 浏览器
pip install -r requirements.txt
无需配置真实账号或连接外部网络,运行本地模拟测试:
# 无头模式快速测试
python main.py --mock --headless
# 有头模式可视化测试 (观察浏览器真实点击与跳转)
python main.py --mock
编辑 config.yaml 填写您的实际信息:
auth:
username: "your_email@example.com"
password: "your_secure_password"
target:
url: "https://visas-de.tlscontact.com/visa/gb/gbLON2de/home"
login_url: "https://visas-de.tlscontact.com/visa/gb/gbLON2de/login"
flow:
interval: 1.0
max_steps: 45
preferred_dates:
- "2026-09"
启动正式流程:
python main.py
--mock / --test:启动本地 Mock 服务进行端到端测试。--headless:强制使用无头模式运行。--config <path>:指定自定义配置文件路径(默认 config.yaml)。--username <user> / --password <pwd>:命令行覆盖账号密码。--url <url>:命令行覆盖目标入口 URL。