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

47 lines
1.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 文件替换耗时优化分析
## 问题分析
从日志可以看到文件替换耗时约 **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。