Files
douyi_guaji_main/douyin/utils/douyin_helpers.py
T

507 lines
21 KiB
Python
Raw 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.
"""工具方法模块
============
职责:通用工具方法
- 点击操作封装
- OCR检查开奖结果
- 处理开奖结果
- 截图并诊断
- 读取像素阶段状态
"""
from __future__ import annotations
import os
import time
import shutil
import json
from typing import Any, Optional, Tuple, Dict, Union
from datetime import datetime
from douyin.detection.douyin_pixel import read_pixel_stage_state_from_screenshot
from douyin.handlers import douyin_screenshot_handler
class HelperFunctions:
"""工具函数集合:通用工具方法"""
@staticmethod
def click(analyser: Any, x: int, y: int) -> None:
"""兼容原版 fudai_analyse.click:转发到底层 operation.click。
参数:
analyser: 分析器对象
x: X坐标
y: Y坐标
"""
start_time = time.time()
try:
analyser.operation.click(analyser.device_id, int(x), int(y))
elapsed = time.time() - start_time
if elapsed > 0.1: # 只记录耗时较长的点击操作
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"操作",
"点击操作",
log_type="OP",
x=int(x),
y=int(y),
elapsed_seconds=round(elapsed, 2),
)
except (AttributeError, TypeError, OSError):
# 仅捕获调用/参数/IO相关的常见异常,避免吞掉所有异常
pass
@staticmethod # type: ignore[misc]
def read_pixel_stage_state(
analyser: Any, return_details: bool = False
) -> Union[Dict[str, Any], Tuple[Dict[str, Any], Dict[str, Any]]]:
"""读取像素阶段状态(用于阶段诊断)。
参数:
analyser: 分析器对象
return_details: 是否返回每个检测步骤的详细信息(包括分数)
返回:
dict: 检测结果(return_details=False时)
tuple[dict, dict]: (检测结果, 详细信息)(return_details=True时)
"""
# 使用统一的截图路径配置
try:
from douyin.core import path_config
pic_path = path_config.get_screenshot_path()
except (ImportError, ModuleNotFoundError, AttributeError):
# 回退到旧路径(向后兼容)
base_dir = os.path.dirname(__file__)
pic_path = os.path.join(base_dir, "pic", "screenshot.png")
# 获取分辨率比例和y偏移参数
resolution_ratio_x = int(getattr(analyser, "resolution_ratio_x", 1080) or 1080)
resolution_ratio_y = int(getattr(analyser, "resolution_ratio_y", 2400) or 2400)
y_pianyi = int(getattr(analyser, "y_pianyi", 0) or 0)
lucky_threshold = float(
getattr(analyser, "lucky_draw_red_ratio_threshold", 0.9) or 0.9
)
# 获取模板匹配阈值(优先使用福袋详情页专用阈值)
fudai_template_threshold = float(
getattr(analyser, "fudai_detail_template_threshold", None)
or getattr(analyser, "fudai_template_match_threshold", 0.7)
or 0.7
)
if fudai_template_threshold < 0.0:
fudai_template_threshold = 0.0
if fudai_template_threshold > 1.0:
fudai_template_threshold = 1.0
return read_pixel_stage_state_from_screenshot(
pic_path,
resolution_ratio_x,
resolution_ratio_y,
y_pianyi,
lucky_threshold,
fudai_template_threshold,
return_details=return_details,
analyser=analyser,
)
@staticmethod # type: ignore[misc]
def check_lottery_result_by_ocr(analyser: Any) -> Optional[str]:
"""通过OCR识别开奖结果按钮区域,返回识别到的文本类型。
参数:
analyser: 分析器对象
返回:
"我知道了" - 识别到"我知道了"按钮
"立即领取奖品" - 识别到"立即领取奖品"按钮
None - 未识别到相关文本
"""
try:
if not bool(getattr(analyser, "ocr_lottery_result_enabled", True)):
try:
analyser._log_kv("开奖结果", "开奖结果OCR已关闭,跳过识别")
except Exception:
pass
return None
from douyin.fudai.core.coords import get_lottery_result_confirm_profile
profile = get_lottery_result_confirm_profile(
getattr(analyser, "fudai_detail_ui_mode", "auto")
)
x1, y1, x2, y2 = tuple(profile.get("button") or (181, 1261, 890, 1389))
# 裁剪区域用于OCR识别(通过cut_pic会自动保存到debug_captures)
douyin_screenshot_handler.ScreenshotHandler.cut_pic(
analyser, x1, y1, x2, y2, "", "开奖结果按钮", 0
)
# OCR识别
from douyin.utils.ocr_preprocess import preprocess_for_ocr # type: ignore
name_res = preprocess_for_ocr(analyser, "开奖结果按钮")
ocr_text = str(analyser.operation.analyse_pic_word(name_res, 0) or "")
analyser._log_kv("开奖结果", "OCR识别结果", text=ocr_text, log_type="SCREENSHOT") # type: ignore[attr-defined, reportPrivateUsage]
# 检查识别到的文本
if "我知道了" in ocr_text:
return "我知道了"
elif (
"立即领取奖品" in ocr_text
or "领取奖品" in ocr_text
or "立即领取" in ocr_text
):
# 检查是否为误识别(检查相似字记录)
if HelperFunctions._is_false_positive_prize_text(ocr_text):
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"识别到相似字,判定为误识别",
text=ocr_text,
log_type="SCREENSHOT",
)
return None
# 如果文本不完全匹配"立即领取奖品",记录相似字用于后续检查
if ocr_text.strip() != "立即领取奖品":
HelperFunctions._save_false_positive(ocr_text)
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"记录相似字文本",
text=ocr_text,
log_type="SCREENSHOT",
)
return "立即领取奖品"
else:
# 尝试模式1识别
ocr_text_1 = str(
analyser.operation.analyse_pic_word("开奖结果按钮", 1) or ""
)
if "我知道了" in ocr_text_1:
return "我知道了"
elif (
"立即领取奖品" in ocr_text_1
or "领取奖品" in ocr_text_1
or "立即领取" in ocr_text_1
):
# 检查是否为误识别(检查相似字记录)
if HelperFunctions._is_false_positive_prize_text(ocr_text_1):
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"识别到相似字,判定为误识别",
text=ocr_text_1,
log_type="SCREENSHOT",
)
return None
# 如果文本不完全匹配"立即领取奖品",记录相似字用于后续检查
if ocr_text_1.strip() != "立即领取奖品":
HelperFunctions._save_false_positive(ocr_text_1)
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"记录相似字文本",
text=ocr_text_1,
log_type="SCREENSHOT",
)
return "立即领取奖品"
return None
except Exception as e:
analyser._log_kv("开奖结果", "OCR识别异常", error=str(e), log_type="ERR") # type: ignore[attr-defined, reportPrivateUsage]
return None
@staticmethod # type: ignore[misc]
def _get_false_positive_file_path() -> str:
"""获取误识别记录文件路径"""
try:
from douyin.core import path_config
pic_dir = path_config.get_pic_dir()
except (ImportError, ModuleNotFoundError, AttributeError):
base_dir = os.path.dirname(__file__)
pic_dir = os.path.join(base_dir, "pic")
false_positive_file = os.path.join(
pic_dir, "lottery_prize_captures", "false_positives.json"
)
return false_positive_file
@staticmethod # type: ignore[misc]
def _load_false_positives() -> set[str]:
"""加载误识别文本记录"""
false_positive_file = HelperFunctions._get_false_positive_file_path()
if not os.path.exists(false_positive_file):
return set()
try:
with open(false_positive_file, "r", encoding="utf-8") as f:
data = json.load(f)
return set(data.get("false_positives", []))
except (OSError, json.JSONDecodeError):
return set()
@staticmethod # type: ignore[misc]
def _save_false_positive(text: str) -> None:
"""保存误识别文本到记录文件"""
false_positive_file = HelperFunctions._get_false_positive_file_path()
os.makedirs(os.path.dirname(false_positive_file), exist_ok=True)
false_positives = HelperFunctions._load_false_positives()
false_positives.add(text.strip())
try:
with open(false_positive_file, "w", encoding="utf-8") as f:
json.dump(
{"false_positives": list(false_positives)},
f,
ensure_ascii=False,
indent=2,
)
except OSError:
# 写文件失败时忽略(非关键路径)
pass
@staticmethod # type: ignore[misc]
def _is_false_positive_prize_text(text: str) -> bool:
"""检查文本是否为误识别的"立即领取奖品"相似字"""
false_positives = HelperFunctions._load_false_positives()
text_clean = text.strip()
# 检查是否在误识别列表中
if text_clean in false_positives:
return True
# 检查是否包含误识别文本
for fp_text in false_positives:
if fp_text in text_clean or text_clean in fp_text:
return True
return False
@staticmethod # type: ignore[misc]
def handle_lottery_result_by_ocr(analyser: Any, result_type: str) -> None:
"""根据OCR识别结果处理开奖结果。
参数:
analyser: 分析器对象
result_type: "我知道了" 或 "立即领取奖品"
"""
start_time = time.time()
try:
if result_type == "我知道了":
# 识别到"我知道了",点击按钮,切换下一个直播间
from douyin.fudai.core.coords import get_lottery_result_confirm_profile
profile = get_lottery_result_confirm_profile(
getattr(analyser, "fudai_detail_ui_mode", "auto")
)
rx = int(getattr(analyser, "resolution_ratio_x", 1080) or 1080)
ry = int(getattr(analyser, "resolution_ratio_y", 2400) or 2400)
click_x, click_y = tuple(profile.get("click") or (532, 1289))
btn_x = int(click_x * rx // 1080)
btn_y = int(click_y * ry // 2400)
# OCR识别到结果,执行实际点击并等待生效
try:
HelperFunctions.click(analyser, btn_x, btn_y)
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果", "已通过OCR执行点击", log_type="OP", x=btn_x, y=btn_y
)
except Exception as e:
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"OCR点击执行失败,继续后续处理",
log_type="ERR",
x=btn_x,
y=btn_y,
error=str(e),
)
# 等待点击生效,优先使用配置项 fudai_click_wait_seconds 回退到 0.8 秒
try:
delay_sec = float(
getattr(analyser, "fudai_click_wait_seconds", 0.8) or 0.8
)
except Exception:
delay_sec = 0.8
analyser.operation.delay(delay_sec)
# 记录统计:识别到"我知道了"算作成功参与一次
try:
analyser._log_kv(
"统计",
"metric",
metric="fudai_attend",
metric_type="success",
run_id=getattr(analyser, "_run_id", ""),
source="lottery_result",
result_type=result_type,
)
except Exception:
pass
# 记录未中奖日志,用于GUI统计
analyser._log_kv("开奖结果", "没有抽中,关闭弹窗", log_type="RESULT")
# 切换下一个直播间
try:
needswitch = bool(getattr(analyser, "needswitch", True))
except Exception:
needswitch = True
if needswitch:
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"处理完开奖结果,切换直播间找新福袋",
log_type="OP",
color="RED",
)
analyser.swipe_up_to_next_live() # type: ignore[attr-defined]
else:
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"处理完开奖结果,未启用切换,继续在当前直播间",
log_type="OP",
)
elif result_type == "立即领取奖品":
# 识别到"立即领取奖品",保存全屏截图到单独文件夹,点击返回键,切换下一个直播间
# 记录统计:中奖也算作成功参与一次
try:
analyser._log_kv(
"统计",
"metric",
metric="fudai_attend",
metric_type="success",
run_id=getattr(analyser, "_run_id", ""),
source="lottery_result",
result_type=result_type,
prize_won=True,
)
except Exception:
pass
# 记录中奖日志,用于GUI统计
analyser._log_kv("开奖结果", "检测到中奖结果", log_type="RESULT")
try:
# 确保有最新截图
analyser.operation.get_screenshot(
analyser.device_id, use_service=False
)
# 使用统一的截图路径配置
try:
from douyin.core import path_config
src = path_config.get_screenshot_path()
pic_dir = path_config.get_pic_dir()
except Exception:
# 回退到旧路径(向后兼容)
base_dir = os.path.dirname(__file__)
pic_dir = os.path.join(base_dir, "pic")
src = os.path.join(pic_dir, "screenshot.png")
if os.path.exists(src):
# 创建单独的文件夹保存"立即领取奖品"的截图
prize_dir = os.path.join(pic_dir, "lottery_prize_captures")
os.makedirs(prize_dir, exist_ok=True)
# 保存截图,文件名包含时间戳
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
dst = os.path.join(prize_dir, f"prize_{timestamp}.png")
shutil.copy(src, dst)
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"已保存立即领取奖品截图",
log_type="SCREENSHOT",
path=dst,
)
except Exception as e:
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果", "保存截图失败", log_type="ERR", error=str(e)
)
# 点击返回键
analyser.operation.click_back(analyser.device_id)
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果", "点击返回键关闭开奖结果", log_type="OP"
)
analyser.operation.delay(0.5)
# 切换下一个直播间
try:
needswitch = bool(getattr(analyser, "needswitch", True))
except Exception:
needswitch = True
if needswitch:
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"处理完开奖结果,切换直播间找新福袋",
log_type="OP",
color="RED",
)
analyser.swipe_up_to_next_live() # type: ignore[attr-defined]
else:
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"处理完开奖结果,未启用切换,继续在当前直播间",
log_type="OP",
)
except Exception as e:
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"开奖结果",
"处理开奖结果失败",
error=str(e),
result_type=result_type,
)
# 失败时尝试按返回键并切换
try:
analyser.operation.click_back(analyser.device_id)
analyser.operation.delay(0.5)
analyser.swipe_up_to_next_live() # type: ignore[attr-defined]
except (AttributeError, OSError):
# 忽略点击/滑动中发生的常见错误
pass
finally:
elapsed = time.time() - start_time
analyser._log_kv( # type: ignore[attr-defined, reportPrivateUsage]
"流程",
"_handle_lottery_result_by_ocr完成",
log_type="PERF",
elapsed_seconds=round(elapsed, 2),
result_type=result_type,
)
@staticmethod # type: ignore[misc]
def shot_and_diagnose(
analyser: Any, tag: str, msg: str, device_id: str, diagnose: bool = True
) -> None:
"""截图并执行阶段诊断(兼容旧版调用方式)。
参数:
analyser: 分析器对象
tag: 日志标签
msg: 日志消息
device_id: 设备ID
diagnose: 是否执行阶段诊断(默认True)
"""
try:
# 截图
ok = analyser.operation.get_screenshot(device_id)
if not ok:
analyser._log_kv(tag, f"{msg} - 获取截图失败", ok=0) # type: ignore[attr-defined]
return
# 如果启用诊断,执行阶段诊断
if diagnose:
stage, seen = analyser._diagnose_stage_from_current_screen() # type: ignore[attr-defined]
analyser._last_diag_stage = stage # type: ignore[attr-defined]
analyser._last_diag_seen = seen # type: ignore[attr-defined]
analyser._last_diag_ts = time.time() # type: ignore[attr-defined]
# 使用位置参数调用,避免与关键字参数冲突
analyser._log_kv(tag, msg, **{"stage": stage, "seen": seen}) # type: ignore[attr-defined]
else:
analyser._log_kv(tag, msg) # type: ignore[attr-defined]
except Exception as e:
# 避免异常影响主流程
try:
analyser._log_kv( # type: ignore[attr-defined]
tag, f"{msg} - 异常: {type(e).__name__}"
)
except Exception:
pass