Files
douyi_guaji_main/docs/archive/optimization/STREAMING_SCREENSHOT_DISABLED.md
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

2.0 KiB

流式截图暂时禁用说明

📋 当前状态

流式截图已暂时禁用,系统现在使用直接截图模式。

修改内容

  1. 截图方法默认行为变更

    • get_screenshot() 默认 use_service=False
    • 所有截图调用都使用直接ADB命令
  2. 后台服务启动移除

    • 移除 douyin_fudai.py 中的后台服务启动代码
    • 移除 douyin_main_flow.py 中的后台服务启动代码
  3. 性能影响

    • 截图响应时间: 从 ~0.4秒增加到 ~1.5秒
    • 系统负载: 从中等降低到较低
    • 稳定性: 提高(避免后台服务复杂性)

🔄 如何恢复流式截图

如果您想要恢复流式截图功能,请按以下步骤操作:

步骤1: 修改截图方法默认值

# 文件: operations/screenshot_operations.py
# 第47行修改
def get_screenshot(self, device_id, path="pic", use_service: bool = True) -> bool:  # 改为 True

步骤2: 恢复后台服务启动

# 文件: douyin/core/douyin_fudai.py
# 恢复第336-370行的后台服务启动代码

# 文件: douyin/core/douyin_main_flow.py
# 恢复第60-76行的后台服务启动代码

步骤3: 重新启用循环优化(可选)

如果需要恢复循环期间停止服务的优化:

# 在 douyin/core/douyin_fudai.py 中恢复循环服务管理代码

📊 性能对比

模式 平均响应时间 系统负载 稳定性 复杂度
流式截图 0.4秒 中等 较复杂 高
直接截图 1.5秒 低 稳定 低

🎯 使用建议

  • 临时调试: 使用直接截图模式更稳定
  • 生产环境: 建议使用流式截图提升性能
  • 网络不稳定: 直接截图模式更可靠

🔧 技术细节

  • 直接截图: adb exec-out screencap -p
  • 流式截图: 后台线程持续截图 + 缓存机制
  • 缓存有效期: 4秒
  • 后台间隔: 1.5秒(可配置)

如需恢复流式截图,请按照上述步骤操作,或运行恢复脚本。