Files
douyi_guaji_main/tools
CodexandClaude Opus 4.5 8fe7ff0585 refactor: 根目录核心模块迁移到 douyin/core/ 和 douyin/logging/
将 4 个根目录核心模块迁移到合理位置:
- path_config.py    -> douyin/core/path_config.py
- version.py        -> douyin/core/version.py
- Underlying_Operations.py -> douyin/core/underlying_operations.py
- unified_logger.py -> douyin/logging/unified_logger.py

配套更新所有 import:
- path_config: 41 处 import 改为 douyin.core.path_config
- version: 4 处改为 douyin.core.version
- unified_logger: 5 处改为 douyin.logging.unified_logger
- Underlying_Operations: 14 处改为 douyin.core.underlying_operations

修复 path_config.PROJECT_ROOT 计算(向上 2 级而非当前目录)。

验证:python -m compileall 全项目通过。

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-21 00:23:14 +08:00
..

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),人工核查用。