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.5 KiB
1.5 KiB
文件替换耗时优化分析
问题分析
从日志可以看到文件替换耗时约 1.5秒,主要原因:
-
重试等待时间过长:
- 第1次重试:等待 0.05秒
- 第2次重试:等待 0.2秒
- 第3次重试:等待 0.45秒
- 第4次重试:等待 0.8秒
- 第5次重试:等待 1.25秒
如果文件被占用,可能需要多次重试,累计等待时间可达 2.75秒
-
文件被占用:
- 第一次替换失败(result=False)
- 第二次成功但耗时1.5秒,说明经历了多次重试
- 日志显示"目标文件验证失败: size=0",说明替换可能有问题
-
可能的并发读取:
- 多个模块可能在同时读取 screenshot.png
- Windows文件锁定机制导致替换时需要等待
优化方案
方案1:减少重试等待时间(快速修复)
将等待时间从平方增长改为线性增长,并减少初始等待时间:
- 当前:0.05 * (attempt+1)² = 0.05, 0.2, 0.45, 0.8, 1.25秒
- 优化:0.01 * (attempt+1) = 0.01, 0.02, 0.03, 0.04, 0.05秒
方案2:添加文件占用检查(推荐)
在替换前检查文件是否被占用,如果被占用则快速失败或使用备用方法。
方案3:使用更快的替换方法
优先使用 os.replace(原子操作),如果失败则直接复制而不是多次重试。
建议实施
优先实施方案1(减少等待时间),因为:
- 修改简单,风险低
- 立即见效
- 不影响功能正确性
如果需要进一步优化,再实施方案2和3。