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>
3.5 KiB
3.5 KiB
流式截图完全禁用说明
📋 当前状态
流式截图已完全禁用,系统回到最原始的直接截图模式。
修改内容
-
截图服务方法禁用
ScreenshotService.get_screenshot()直接返回False- 不再自动启动后台服务
- 不再检查设备ID变更
-
截图操作默认行为
get_screenshot()默认use_service=False- 所有调用都使用直接ADB命令
-
移除所有服务启动代码
- 移除
douyin_fudai.py的服务启动 - 移除
douyin_main_flow.py的服务启动 - 移除
fudai_detail_reader.py的服务重启
- 移除
🔄 如何恢复流式截图
如果您想要重新启用流式截图功能,请按以下步骤操作:
步骤1: 恢复截图服务方法
# 文件: operations/screenshot_service.py
# 恢复 get_screenshot() 方法的完整实现
# 替换当前的 return False 为完整的缓存和等待逻辑
步骤2: 修改截图方法默认值
# 文件: operations/screenshot_operations.py
# 第47行修改
def get_screenshot(self, device_id, path="pic", use_service: bool = True) -> bool: # 改为 True
步骤3: 恢复后台服务启动
# 文件: douyin/core/douyin_fudai.py
# 恢复第336-370行的后台服务启动代码
# 文件: douyin/core/douyin_main_flow.py
# 恢复第60-76行的后台服务启动代码
步骤4: 恢复设备ID检查
# 文件: operations/screenshot_service.py
# 恢复 get_screenshot() 方法中的设备ID变更检查和自动启动逻辑
📊 性能对比
| 模式 | 响应时间 | 系统负载 | 稳定性 | 功能复杂度 |
|---|---|---|---|---|
| 当前模式 (完全禁用) | ~1.5秒 | 低 | 最高 | 最低 |
| 流式截图 (缓存) | ~0.4秒 | 中等 | 中等 | 高 |
| 原始直接截图 | ~1.5秒 | 低 | 高 | 最低 |
✅ 当前优势
- 绝对稳定: 不会有后台服务导致的任何问题
- 简单可靠: 每次截图都是独立的ADB调用
- 无缓存问题: 避免缓存过期、文件损坏等问题
- 易调试: 所有截图操作都有明确日志
🎯 适用场景
当前模式适合:
- 🔍 问题排查: 需要确定截图功能本身是否正常
- 🛠️ 稳定运行: 对截图稳定性要求极高
- 🐛 调试阶段: 排除后台服务干扰进行测试
流式截图适合:
- ⚡ 高性能: 需要快速响应的生产环境
- 🔄 频繁截图: 短时间内多次截图操作
- 📈 优化体验: 提升用户响应速度
🔧 技术细节
当前实现
# 截图服务完全禁用
def get_screenshot(self, device_id: str, force: bool = False) -> bool:
return False # 让调用方使用直接截图
# 所有截图都使用直接ADB命令
def get_screenshot(self, device_id, path="pic", use_service=False):
return self._get_screenshot_direct(device_id, path)
原始流式实现
# 后台服务 + 缓存机制
def get_screenshot(self, device_id: str, force: bool = False) -> bool:
# 检查缓存 -> 等待后台截图 -> 直接截图回退
pass
📝 注意事项
- 性能差异: 当前模式比流式截图慢约3倍
- 网络影响: 直接ADB调用更受网络波动影响
- 日志简化: 不再有复杂的缓存命中/等待日志
- 功能完整: 所有截图功能完全正常,只是变慢了
当前系统已回到最稳定的直接截图模式。如需性能优化,可按上述步骤恢复流式截图功能。