fix: suppress cached no-valid-output lag

Author: Astro-Han

quantclass_sync_internal/data_query.py

@@ -211,8 +211,16 @@ def get_products_overview(
                     and freshness_anchor is not None
                     and (today - freshness_anchor).days <= _STALE_GRACE_DAYS
                 )
+            if (
+                cache_fresh
+                and last_status == "skipped"
+                and last_reason == REASON_NO_VALID_OUTPUT
+                and last_date == cached_api_date
+                and _parse_date(local_date) is not None
+            ):
+                ref_date = _parse_date(local_date)
             # 无有效缓存时，A 股产品用交易日历找最近交易日，避免周末误报
-            if _is_a_stock_product(product) and trading_calendar:
+            elif _is_a_stock_product(product) and trading_calendar:
                 trading_ref = _last_trading_day(trading_calendar, today)
                 ref_date = cached_api_date if cache_fresh else (trading_ref or today)
             else:

tests/test_data_query.py

@@ -408,6 +408,35 @@ def test_overview_same_api_date_after_check_updates_keeps_no_valid_output_suppre
         self.assertEqual(overview[0]["days_behind"], 0)
         self.assertEqual(overview[0]["status_color"], "green")
 
+    def test_overview_cached_api_date_after_no_valid_output_is_not_pending(self):
+        """更新后仅依赖缓存 API 日期时，same-date no_valid_output 仍不应显示落后。"""
+        self._write_timestamp("coin-cap", "2026-03-10")
+        update_api_latest_dates(self.log_dir, {"coin-cap": "2026-03-11"})
+        report = _new_report("test", mode="network")
+        _append_result(
+            report,
+            product="coin-cap",
+            status="skipped",
+            reason_code="no_valid_output",
+            error="同步未产生可用输出，已跳过状态推进。",
+            date_time="2026-03-11",
+        )
+        _update_product_last_status(self.log_dir, report)
+
+        import unittest.mock
+        with unittest.mock.patch(
+            "quantclass_sync_internal.data_query.report_dir_path",
+            return_value=self.log_dir,
+        ):
+            overview = get_products_overview(
+                self.data_root,
+                ["coin-cap"],
+                today=date(2026, 3, 13),
+            )
+
+        self.assertEqual(overview[0]["days_behind"], 0)
+        self.assertEqual(overview[0]["status_color"], "green")
+
     def test_overview_preserves_green_after_sync_when_api_cache_exists(self):
         """同步结果为 up_to_date 时，若保留 API 缓存字段，总览仍应显示绿色。"""
         self._write_timestamp("coin-cap", "2026-03-11")