用途：通过 Tor SOCKS5 代理进行无头浏览器自动化，访问 .onion 站点与匿名网页，可用于安全研究、威胁情报、公开暗网资源抓取、.onion 可达性测试及隐私保护型自动化。
前提：Tor 服务需在端口 9050 提供 SOCKS5 代理，Python 3.8+，并安装 Playwright 与 Chromium。
安装：sudo apt install tor && sudo systemctl start tor；pip install playwright；playwright install chromium。
命令行用法：tor-browser check-tor 检查连接；tor-browser open <url> [--proxy socks5://host:port] 打开页面；tor-browser snapshot 获取快照，加 -i 仅取表单按钮链接等交互元素；tor-browser links 提取链接；tor-browser gettext 或 gettext --ref @e5 获取文本；tor-browser click @e1 点击；tor-browser fill @e2 "text" 填写；tor-browser wait 2000 等待；tor-browser screenshot，可加 -o 文件名与 --full 全页截图。
Python API：从 scripts.tor_browser 导入 TorBrowser 与 Config，配置 tor_proxy、headless、timeout 等，通过 asyncio 调用 start、navigate、get_snapshot、fill、click、extract_links、close。默认代理 socks5://127.0.0.1:9050，默认 headless 为 true，timeout 30000 毫秒。
限制与合规：仅限合法用途，需遵守站点服务条款，不得用于未授权访问，须符合当地关于暗网访问的法律。.onion 站点可能较慢，需增大超时或重启 Tor 更换线路；部分站点有验证码或屏蔽自动化。提供 Docker 部署方式与故障排查说明，采用 MIT 许可。