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

75 lines
2.0 KiB
Markdown

# 流式截图暂时禁用说明
## 📋 当前状态
**流式截图已暂时禁用**,系统现在使用直接截图模式。
### 修改内容
1. **截图方法默认行为变更**
- `get_screenshot()` 默认 `use_service=False`
- 所有截图调用都使用直接ADB命令
2. **后台服务启动移除**
- 移除 `douyin_fudai.py` 中的后台服务启动代码
- 移除 `douyin_main_flow.py` 中的后台服务启动代码
3. **性能影响**
- **截图响应时间**: 从 ~0.4秒增加到 ~1.5秒
- **系统负载**: 从中等降低到较低
- **稳定性**: 提高(避免后台服务复杂性)
## 🔄 如何恢复流式截图
如果您想要恢复流式截图功能,请按以下步骤操作:
### 步骤1: 修改截图方法默认值
```python
# 文件: operations/screenshot_operations.py
# 第47行修改
def get_screenshot(self, device_id, path="pic", use_service: bool = True) -> bool: # 改为 True
```
### 步骤2: 恢复后台服务启动
```python
# 文件: douyin/core/douyin_fudai.py
# 恢复第336-370行的后台服务启动代码
# 文件: douyin/core/douyin_main_flow.py
# 恢复第60-76行的后台服务启动代码
```
### 步骤3: 重新启用循环优化(可选)
如果需要恢复循环期间停止服务的优化:
```python
# 在 douyin/core/douyin_fudai.py 中恢复循环服务管理代码
```
## 📊 性能对比
| 模式 | 平均响应时间 | 系统负载 | 稳定性 | 复杂度 |
|------|-------------|----------|--------|--------|
| 流式截图 | 0.4秒 | 中等 | 较复杂 | 高 |
| 直接截图 | 1.5秒 | 低 | 稳定 | 低 |
## 🎯 使用建议
- **临时调试**: 使用直接截图模式更稳定
- **生产环境**: 建议使用流式截图提升性能
- **网络不稳定**: 直接截图模式更可靠
## 🔧 技术细节
- 直接截图: `adb exec-out screencap -p`
- 流式截图: 后台线程持续截图 + 缓存机制
- 缓存有效期: 4秒
- 后台间隔: 1.5秒(可配置)
---
*如需恢复流式截图,请按照上述步骤操作,或运行恢复脚本。*