V1.5.2: 识别"源站只发广告/测试资源"的新受限形态（歌曲源全部失效的真因）

用户报"歌曲源全部失效"。逐层实测结论：**不是代码 bug，是源站对该出口 IP 的授权窗口失效**。

实测证据（本机与设备同一出口 IP 188.253.112.231，设备 LAN 192.168.100.177/.83、本机 .203）:
- i.php 仍认证通过: code=200 / end_date=2026-10-05 / ordertype=0 / retry=5；
- do.php 对**每一首歌**（包括不存在的编号 1111111、9999999）都返回**同一个**资源
  https://wb66.cn/f/d/7b7c9/10188555.ts —— 而 wb66 正是代码里早就标注的广告/测试资源域名；
- 换全新随机设备身份(mac/sn)结果相同 → 限制记在**出口 IP** 上，与设备无关；
- 7 个 host × ls=1~3 × (720/1080, h265 0/1) 全组合探测：0 个返回真源；
- mwsLogin 返回 authorized:true，但 license_box_count=0 / license_duration=0（无有效授权额度）。

即状态从"能用"变成了"只发广告"（此前同一身份能拿到 txog.ktvsky.com / download.origjoy.com 的真源）。
我们拒绝广告地址本身是**正确**的（否则就是 1.4.10 修过的"广告被当成歌曲播放"），
所以用户看到的"全部失效"其实是"源站不再给真源 + 我们拒绝广告"的叠加结果。

修复（可操作化，避免用户只看到一句"无法生成下载地址"）:
- SongUrlResolver 统计"全部源只返回不可信地址"这一形态，识别为授权窗口失效：
  · 打 SOURCE-BLOCKED 日志（含示例 url，便于远程取证）；
  · 调用 Eac19WindowGuard.noteRiskBlocked() → 弹「歌曲源临时受限」提示，
    明确告知"额度记在出口 IP 上、换设备无效"，引导重启光猫/路由器更换公网 IP；
  · 进入 3 分钟冷却(BLOCKED_COOLDOWN_MS)：期间快速失败，避免继续冲击源站把限流拖更久；
    拿到真源立即解除冷却。
- AdVideoFilter 的广告特征补上 wb66 / demo（与 JS 的 isDemoUrl 对齐，两条取址路径判定一致）。
- 提示文案补充"或对每首歌只返回广告/测试资源"这一新表现。
- 新增回归测试：用实测 URL https://wb66.cn/f/d/7b7c9/10188555.ts 锁住拦截行为。
- Eac19WindowGuard 文档补充两种受限形态。

现场恢复办法：更换公网出口 IP（重启光猫/路由器重拨）。已下载歌曲不受影响，可正常播放。

版本 1.5.1(33) → 1.5.2(34)；签名证书不变。测试 9 例全通过。

app/src/main/java/com/local/ktv/SongUrlResolver.kt

@@ -38,6 +38,13 @@ object SongUrlResolver {
     private const val VER = "2.0"
     private const val VN = "4.1.3.03281430"
     private const val TIMEOUT_MS = 8_000
+    /**
+     * "源站只发广告/测试资源"后的冷却时长。
+     *
+     * 该限制记在**出口 IP** 上、与设备无关（实测换 mac/sn 无效），源站侧是约 10 分钟的试用窗口；
+     * 这里冷却 3 分钟即可（够避免继续冲击源站，又不会拖太久错过窗口恢复）。
+     */
+    private const val BLOCKED_COOLDOWN_MS = 3 * 60_000L
 
     private val DEFAULT_HOSTS = listOf(
         "http://w.w345.my",
@@ -56,6 +63,9 @@ object SongUrlResolver {
 
     @Volatile private var sn: String = KtvJsBridge.DEVICE_SN
 
+    /** 被判定为"源站只发广告/测试资源"后的冷却截止时间（0 = 未受限）。 */
+    @Volatile private var blockedUntil: Long = 0L
+
     /**
      * 最近一次取址命中的源 host。
      * 供 `SongApiClient.lastSongSourceHost()` 使用 —— 走原生兜底时 JS 的
@@ -102,10 +112,22 @@ object SongUrlResolver {
             MiliLog.warn("NATIVE-SONG 未安装取址通道，跳过原生兜底")
             return null
         }
+        // 已判定"源站对该出口 IP 只发广告/测试资源"时进入冷却：直接失败，
+        // 既让用户立刻看到结论，也避免继续冲击源站把限流拖得更久。
+        val nowMs = System.currentTimeMillis()
+        if (nowMs < blockedUntil) {
+            MiliLog.warn(
+                "SOURCE-BLOCKED 冷却中（剩 ${(blockedUntil - nowMs) / 1000}s）跳过取址 编号=$musicno",
+            )
+            return null
+        }
         val mac = runCatching { DeviceMac.effective() }.getOrDefault(sn)
         val startedAt = System.currentTimeMillis()
         val hosts = synchronized(hostOrder) { hostOrder.toList() }
         var lastDetail = "no-source"
+        var adOnlyCount = 0          // 返回了地址但被判为广告/测试资源的源数
+        var otherFailCount = 0       // token 失败 / 无地址 / 网络异常的源数
+        var adSample = ""
 
         for ((index, host) in hosts.withIndex()) {
             val token = runCatching { fetchToken(channel, host, mac) }.getOrElse {
@@ -114,6 +136,7 @@ object SongUrlResolver {
             }
             if (token.isNullOrEmpty()) {
                 lastDetail = "token-fail"
+                otherFailCount++
                 demote(host)
                 continue
             }
@@ -125,6 +148,7 @@ object SongUrlResolver {
             if (!url.isNullOrEmpty() && isValidSongUrl(url, musicno)) {
                 promote(host)
                 lastHost = host
+                blockedUntil = 0L // 拿到真源 → 立刻解除冷却
                 val elapsed = System.currentTimeMillis() - startedAt
                 val urlHost = runCatching { java.net.URI(url).host }.getOrNull() ?: "?"
                 MiliLog.info(
@@ -137,11 +161,30 @@ object SongUrlResolver {
                 url.isNullOrEmpty() -> "no-url"
                 else -> "demo-or-mismatch"
             }
+            if (url.isNullOrEmpty()) {
+                otherFailCount++
+            } else {
+                adOnlyCount++
+                if (adSample.isEmpty()) adSample = url
+            }
             demote(host)
         }
 
         val elapsed = System.currentTimeMillis() - startedAt
-        MiliLog.error("NATIVE-SONG 全部源失败 编号=$musicno 详情=$lastDetail 用时=${elapsed}ms")
+        // ⚠️ 源站 2026-10 起的新受限形态：不再返回 403，而是**对每一首歌（含不存在的编号）
+        // 都返回同一个广告/测试资源**（实测 https://wb66.cn/f/d/7b7c9/10188555.ts）。
+        // 额度记在**出口 IP** 上，与设备身份无关（换 mac/sn 无效）—— 表现就是"歌曲源全部失效"。
+        // 这里把它识别出来并接入 Eac19WindowGuard 的提示（引导重启光猫/路由器换公网 IP）。
+        if (adOnlyCount > 0 && otherFailCount == 0) {
+            blockedUntil = System.currentTimeMillis() + BLOCKED_COOLDOWN_MS
+            MiliLog.error(
+                "SOURCE-BLOCKED 全部 $adOnlyCount 个源只返回广告/测试资源（该出口 IP 授权窗口失效）" +
+                    " 编号=$musicno 示例=$adSample 用时=${elapsed}ms",
+            )
+            Eac19WindowGuard.noteRiskBlocked()
+        } else {
+            MiliLog.error("NATIVE-SONG 全部源失败 编号=$musicno 详情=$lastDetail 用时=${elapsed}ms")
+        }
         return null
     }