Files
douyin_guaji-main/docs/archive/optimization/ADB_EXECOUT_OPTIMIZATION.md
T
CodexandClaude Opus 4.7 9a51b41c3d docs: 归档过期报告 + 整体迁移 docs/optimization → docs/archive/optimization
A. docs/ 根目录下 5 篇过期/迁移类文档归档到 docs/archive/
  - LOGGING_IMPROVEMENTS.md         (日志系统迭代报告,与 archive/日志系统优化说明.md 重复)
  - OCR性能分析报告.md              (历史性能分析)
  - 统一截图和分数记录说明.md        (重构方案,已合并到代码)
  - AI_PROJECT_SUMMARY.md           (提到的 Underlying_Operations.py / path_config.py 路径已与 main 重构后不一致)
  - param_usage.md                  (模块使用说明,零引用,模块本身有 docstring)

B. docs/optimization/ 整目录归档为 docs/archive/optimization/(7 篇)
  - ADB_EXECOUT_OPTIMIZATION / OCR_PERFORMANCE_OPTIMIZATION
  - SCREENSHOT_PERFORMANCE_DIAGNOSIS / SCREENSHOT_VERIFICATION_GUIDE
  - STREAMING_SCREENSHOT_DISABLED / STREAMING_SCREENSHOT_COMPLETELY_DISABLED
  - optimize_file_replace
  全部是优化报告 / 已禁用功能记录,属于历史迭代而非活文档

C. docs/README.md 重写为按主题分组的索引,明确"活文档 vs 归档"边界

保留为活文档:
  - 日志系统规范文档.md(被 3 处引用)
  - 日志轮转功能说明.md(描述当前在用的轮转策略)
  - 截图服务日志说明.md(描述当前服务行为)
  - 完整技术文档.md / 流程图.md / 预约系统详细流程.md / 高价值房间重访功能说明.md

回归:纯文档归档不影响代码;140 .py 全量编译通过;
test_filter_logging / check_web_gui_config_sync 通过。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-21 11:19:28 +08:00

1.6 KiB
Raw Blame History

ADB exec-out 性能优化说明

优化内容

1. 使用 Popen + 流式读取

  • 之前:使用 subprocess.run() 等待整个命令完成
  • 现在:使用 subprocess.Popen() + 流式读取,边接收边写入
  • 效果:减少等待时间,提高响应速度

2. 增大缓冲区大小

  • 之前:默认缓冲区(通常 8KB)
  • 现在:256KB 缓冲区
  • 效果:减少系统调用次数,提高传输效率

3. 移除不必要的 fsync

  • 之前:每次写入后都调用 fsync() 强制同步到磁盘
  • 现在:依赖操作系统的自动同步机制
  • 效果:减少 10-50ms 的磁盘 I/O 等待时间

4. 优化文件写入

  • 之前:使用默认缓冲
  • 现在:使用 256KB 文件缓冲区
  • 效果:减少文件系统调用次数

预期性能提升

  • ADB exec-out 耗时:从 500-600ms → 400-500ms(减少 10-20%)
  • 整体截图耗时:从 1-2秒 → 0.8-1.5秒

注意事项

  1. fsync 移除:虽然移除了显式的 fsync,但现代文件系统(NTFS、ext4)会在适当时机自动同步,不会丢失数据
  2. 缓冲区大小:256KB 是经过测试的平衡值,既能提高性能又不会占用过多内存
  3. 流式处理:边接收边写入可以提前开始处理,减少总等待时间

进一步优化建议

如果还需要更快,可以考虑:

  1. 使用 minicap:专业的截图工具,可以在 100-200ms 内完成截图
  2. 使用 JPEG 格式:如果设备支持,JPEG 文件更小,传输更快
  3. 优化 ADB 连接:使用 USB 3.0 或更快的连接方式