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>
47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# 文件替换耗时优化分析
|
||
|
||
## 问题分析
|
||
|
||
从日志可以看到文件替换耗时约 **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。
|
||
|