Method analyze

agent/custom/reco/auto_promotion.py:253–396

(
        self,
        context: Context,
        argv: CustomRecognition.AnalyzeArg,
    )

        cls._seen_non_map = False

    def analyze(
        self,
        context: Context,
        argv: CustomRecognition.AnalyzeArg,
    ) -> CustomRecognition.AnalyzeResult | RectType | None:

        try:
            params = parse_params(argv.custom_recognition_param)
        except ValueError as e:
            logger.error(f"[AutoPromotion] 导航参数解析失败（{e}），使用默认值")
            params = {}
        query = params.get("query", "nav")
        self.apply_param_overrides(params)

        target = self.CARD_NAME.strip()

        if query == "nav":
            if not target or target == "当前页面":
                return None
            APCardFinder.reset_nav_state()
            logger.info(f"[AutoPromotion] 开始导航至「{target}」")
            return CustomRecognition.AnalyzeResult(box=[0, 0, 0, 0], detail={})

        if query == "arrived":
            # 必须先离开过地图页再回到地图页才算到达：启动时若已在某张
            # 地图页（可能是别的活动的），直接判到达会在错误的地图上推图
            if not is_stage_map(context, argv.image):
                APCardFinder._seen_non_map = True
                return None
            # 活动入口界面（有「步入剧情」按钮）被 APExploreAnchorOCR 误判为地图页时的防御：
            # 入口界面不是关卡地图，需先点「步入剧情」才进入地图
            if is_hit(context.run_recognition("AP_NavStoryEnter", argv.image)):
                APCardFinder._seen_non_map = True
                return None
            # 卡片详情页（有「活动正篇/主线正篇」按钮）被 APStageNumberOCR 误判为地图页时的防御：
            # 详情页标题含活动编号（如「77号往事」），OCR 把「77」误读为关卡号；
            # 需先点「活动正篇」才进入关卡地图
            if is_hit(context.run_recognition("AP_NavMainEntry", argv.image)):
                APCardFinder._seen_non_map = True
                return None
            if not APCardFinder._seen_non_map:
                return None
            logger.info("[AutoPromotion] 已到达关卡地图页，导航完成")
            APCardFinder.reset_nav_state()
            return CustomRecognition.AnalyzeResult(box=[0, 0, 0, 0], detail={})

        if query == "pv":
            if APCardFinder._pv_taps >= self.PV_TAP_LIMIT:
                return None
            detail = context.run_recognition("APNavFullOCR", argv.image)
            tokens = [r for r in ocr_results(detail) if len(r.text.strip()) >= 2]
            if len(tokens) > self.PV_MAX_TOKENS:
                return None
            APCardFinder._pv_taps += 1
            logger.info(
                f"[AutoPromotion] 疑似 PV 播放中（第 {APCardFinder._pv_taps} 次），"
                "点击唤出跳过按钮"
            )