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>
1.6 KiB
1.6 KiB
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秒
注意事项
- fsync 移除:虽然移除了显式的 fsync,但现代文件系统(NTFS、ext4)会在适当时机自动同步,不会丢失数据
- 缓冲区大小:256KB 是经过测试的平衡值,既能提高性能又不会占用过多内存
- 流式处理:边接收边写入可以提前开始处理,减少总等待时间
进一步优化建议
如果还需要更快,可以考虑:
- 使用 minicap:专业的截图工具,可以在 100-200ms 内完成截图
- 使用 JPEG 格式:如果设备支持,JPEG 文件更小,传输更快
- 优化 ADB 连接:使用 USB 3.0 或更快的连接方式