Files
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.5 KiB
Raw Permalink Blame History

文件替换耗时优化分析

问题分析

从日志可以看到文件替换耗时约 1.5秒,主要原因:

  1. 重试等待时间过长:

    • 第1次重试:等待 0.05秒
    • 第2次重试:等待 0.2秒
    • 第3次重试:等待 0.45秒
    • 第4次重试:等待 0.8秒
    • 第5次重试:等待 1.25秒

    如果文件被占用,可能需要多次重试,累计等待时间可达 2.75秒

  2. 文件被占用:

    • 第一次替换失败(result=False)
    • 第二次成功但耗时1.5秒,说明经历了多次重试
    • 日志显示"目标文件验证失败: size=0",说明替换可能有问题
  3. 可能的并发读取:

    • 多个模块可能在同时读取 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。