新增: - CHANGELOG.md:Keep a Changelog 1.1.0 格式,回填 V3.0.0–V3.3.3 历史 - tools/dev/bump_version.py:一键 bump major/minor/patch, 同步 version.py / pyproject.toml / CHANGELOG.md,并创建 git tag。 支持 --dry-run / --no-tag。 - tests/test_version_consistency.py:9 个用例确保 version.py、pyproject.toml、CHANGELOG.md 三处版本号一致 修改: - pyproject.toml 加 [project] 元数据,version=3.3.3(PEP 440 形式, 与 douyin/core/version.py 同步;后者带 V 前缀,是单一事实来源) 后续会给 V3.0.0 → V3.3.3 补打 git tag。 回归:353 个 pytest 用例通过;bump_version dry-run 三种模式(patch/minor/major/set) 全部输出正确。 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
tools/ 工具脚本目录
按功能分组组织,与主代码分离。tools/ 不被业务代码 import。
目录结构
| 子目录 | 用途 | 典型脚本 |
|---|---|---|
diagnostics/ |
环境/配置/依赖诊断 | check_system_config.py、check_dependencies.py、diagnose_runtime_flags.py |
logs/ |
日志分析与查看 | analyze_step_times.py、color_log_viewer.py、log_filter.py |
coords/ |
坐标拾取与区域选择 | pick_coords.py、region_selector.py、scan_coords.py |
cleanup/ |
代码清理工具 | cleanup_unused_files.py、fix_trailing_whitespace.py |
adb/ |
ADB / 输入法相关 | auto_connect_wifi_adb.py、ADBKeyboard.apk |
windows/ |
Windows 系统修复脚本 | fix_start_menu_win11.ps1 等(与本项目无关,仅备份) |
dev/ |
开发辅助 / 运行时探测 | param_usage_tool.py、simulate_swipe_trigger.py、merge_configs.py |
常用入口
# 系统/依赖诊断
python tools/diagnostics/check_system_config.py
python tools/diagnostics/check_dependencies.py
# 坐标扫描
python tools/coords/scan_coords.py
# 日志分析
python tools/logs/log_filter.py
python tools/logs/color_log_viewer.py
# 参数使用追踪
python tools/dev/param_usage_tool.py show --limit 200
注意
windows/下的脚本是本机环境的修复工具,与抖音挂机功能无关,保留作为环境备份。coords/scan_coords.py输出tools/coords/coords_report.csv(已 gitignore),人工核查用。