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>
44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
# 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 或更快的连接方式
|
||
|