取址改为官方源优先+自建源兜底,只有官方源成功才上报(V1.6.2/45,未发布)

需求一:流程反转 + 上报绑定官方源成功
- 默认 sourceHosts 反转为 ["http://zk.ktv1.top:6677", "https://mdmuse.kasugano.cn"];
  SourceHosts.DEFAULT / SongUrlResolver.DEFAULT_HOSTS(收敛为引用前者)/ ktv_api.js
  CONFIG.HOSTS+HOST 三处一致。
- 取址结果改为 SourcedSongUrl(url, sourceHost)(**显式来源标志**,不靠 URL 猜):
  新增 SongSourceFlow(回落链 firstAvailable / 上报判定 shouldReportToSelfHost /
  全失败信号);JS 侧新增 android.onSongSource(requestId, host) 回传命中的源。
- 汇合点 SongApiClient.getSongDownloadUrl 只在"地址来自官方源"时才 POST /push_download;
  自建源自己给的地址与 DB 回落都不上报。
- 推送默认目标改为"从歌曲源列表里找第一个自建源"(自建源不再排第一,旧写法会直接关掉推送)。
- 1.6.1 落盘的旧默认顺序(自建源优先)在 KtvStore.load() 里一次性迁移;自定义列表不动。
- 业务码 404(自建源没有这首歌)仍只当"该源没地址",不置 sawForbidden、不进冷却、不污染受限统计。

需求二:6 条隐患
1) 设置页改源对 JS 立即生效:KtvJsBridge.applySourceSettingsNow 重新注入 KtvApiConfig.*
   并把已构造实例的 window.api.sourceOrder 重置为新列表;SongApiClient.applySourceSettings 接线。
2) JS 路径识别业务码 403:新增 KtvJsBridge.riskForbidden(status, body)(纯函数,手写判定
   避免 org.json 在单测里是空壳),HTTP 403 与 HTTP 200+{"code":403} 都算风控,与原生 sawForbidden 同口径。
3) isTrustedDownloadUrl 移除广告域名 ac16.vip 白名单,并改为黑名单优先(不再依赖调用顺序)。
4) MainActivity.download(song)(第五条地址消费点)补 AdVideoFilter.isTrustedSongUrl 闸门,
   不可信按"源失效"处理(Eac19WindowGuard.noteAllSourcesFailed),不再静默下载。
5) SongApiClient.fetchFromDb 不再静默吞异常:曲库打不开/查询异常各记一条 MiliLog.localWarn(含编号与异常)。
6) 删除死代码 streamDownloadAndPlay(全仓 grep 无调用点,且内部取址不过最终闸门)。

需求三:死代码/漂移清理(均先全仓搜索确认无引用)
- AdVideoFilter.replacementUrl 无任何写入点(恒为 null)→ 删除,resolve() 只保留"屏蔽"语义。
- ktv_api.js CONFIG.VER/VN 由"从不生效的死值"改为实际使用值 2.0 / 4.1.3.03281430。
- CONFIG.HOST 改为被 getToken 真正读取(不再"注入但从未被读")。
- KTV_BRIDGE_API 14 → 15(JS 两处 + KtvJsBridge 两处校验);AGENTS.md / README.md / README.en.md
  的陈旧标记统一到 15。
- do.php 的 limit 与 i.php 的 retry/ordertype/end_date/heart_time 确认无消费方 → 不新增解析(保持现状)。

需求四:测试与打包
- 新增 SourceOrderConsistencyTest / SongSourceFlowTest / JsBridgeGateTest / DownloadEntryGateTest,
  更新 SourceHostsTest / AdVideoFilterTest;app/build.gradle 打开 unitTests.returnDefaultValues。
- testReleaseUnitTest --rerun-tasks --offline:12 个测试类 / 87 例全过。
- assembleRelease --offline 通过(lintVital NewApi 0 条);版本 1.6.1/44 → 1.6.2/45。

不发布:未推 Gitea/Gitee、未动 Release/tag。
This commit is contained in:
zijunchiang
2026-10-14 03:45:07 +08:00
parent e00a1ace79
commit d01269e917
22 changed files with 1138 additions and 287 deletions
@@ -13,27 +13,30 @@ import java.util.List;
import org.junit.Test;
/**
* 歌曲源列表 / 媒体地址允许清单 / 推送默认目标的纯 JVM 单测。
* 歌曲源列表 / 媒体地址允许清单 / 推送默认目标 / 旧默认值迁移的纯 JVM 单测。
*
* 覆盖需求点名的两组:
* ② 源列表解析(`sourceHosts` 为空时回落默认;含自建源优先);
* ④ 推送默认目标(`pushServerUrl` 为空且首源为自建源时使用它,否则尊重显式配置)。
* 覆盖需求点名的几组:
* ② 源列表解析(`sourceHosts` 为空时回落默认;**官方源优先、自建源兜底**);
* ④ 推送默认目标(`pushServerUrl` 为空时从列表里找自建源,找不到才关闭);
* ③ 1.6.1 旧默认顺序(自建源优先)落盘值的一次性迁移。
*/
public class SourceHostsTest {
// ── ② 源列表解析 ──
/** 空(旧配置没有这个键 / 用户清空)→ 回落默认:**自建源第一、官方源兜底**。 */
/** 空(旧配置没有这个键 / 用户清空)→ 回落默认:**官方源第一、自建源兜底**。 */
@Test
public void emptySourceListFallsBackToDefaultWithSelfHostFirst() {
public void emptySourceListFallsBackToDefaultWithOfficialFirst() {
assertEquals(SourceHosts.DEFAULT, SourceHosts.parse(null));
assertEquals(SourceHosts.DEFAULT, SourceHosts.parse(""));
assertEquals(SourceHosts.DEFAULT, SourceHosts.parse(" \n \n"));
assertEquals(SourceHosts.DEFAULT, SourceHosts.parseList(null));
assertEquals(SourceHosts.DEFAULT, SourceHosts.parseList(Collections.<String>emptyList()));
assertEquals("https://mdmuse.kasugano.cn", SourceHosts.DEFAULT.get(0));
assertEquals("http://zk.ktv1.top:6677", SourceHosts.DEFAULT.get(1));
assertTrue("默认列表里自建源必须排第一", SourceHosts.isSelfHost(SourceHosts.DEFAULT.get(0)));
assertEquals("http://zk.ktv1.top:6677", SourceHosts.DEFAULT.get(0));
assertEquals("https://mdmuse.kasugano.cn", SourceHosts.DEFAULT.get(1));
assertTrue("默认列表第一项必须是官方源", SourceHosts.isOfficialSource(SourceHosts.DEFAULT.get(0)));
assertFalse("默认列表第二项是自建源兜底", SourceHosts.isOfficialSource(SourceHosts.DEFAULT.get(1)));
assertTrue(SourceHosts.isSelfHost(SourceHosts.DEFAULT.get(1)));
}
/** 设置页"一行一个":去空白/尾斜杠、按顺序去重、忽略非 http(s) 的错行。 */
@@ -53,18 +56,47 @@ public class SourceHostsTest {
assertEquals(2, SourceHosts.parse("https://a.example.com;http://b.example.com").size());
}
/** 自建源优先:自建源放第一 + 官方源兜底,两份实现(JS/原生)都读这个顺序。 */
/** 官方源优先:官方源放第一 + 自建源兜底,两份实现(JS/原生)都读这个顺序。 */
@Test
public void selfHostFirstThenOfficialFallback() {
public void officialFirstThenSelfHostFallback() {
List<String> hosts = SourceHosts.parseList(Arrays.asList(
"https://mdmuse.kasugano.cn",
"http://zk.ktv1.top:6677"));
assertTrue(SourceHosts.isSelfHost(hosts.get(0)));
assertFalse(SourceHosts.isSelfHost(hosts.get(1)));
"http://zk.ktv1.top:6677",
"https://mdmuse.kasugano.cn"));
assertTrue(SourceHosts.isOfficialSource(hosts.get(0)));
assertFalse(SourceHosts.isOfficialSource(hosts.get(1)));
assertTrue(SourceHosts.isSelfHost(hosts.get(1)));
// 主机名判定与 scheme/端口无关(内网直连也是自建源)
assertTrue(SourceHosts.isSelfHost("http://mdmuse.kasugano.cn:6677"));
assertTrue(SourceHosts.isSelfHostName("192.168.100.232"));
assertFalse(SourceHosts.isSelfHost(null));
assertFalse(SourceHosts.isSelfHost(""));
// 官方源判定:非自建源的非空主机名;空/畸形一律 false("来源不明"绝不上报)
assertTrue(SourceHosts.isOfficialSource("http://zk.ktv1.top:6677"));
assertTrue(SourceHosts.isOfficialSource("zk.ktv1.top"));
assertFalse(SourceHosts.isOfficialSource(""));
assertFalse(SourceHosts.isOfficialSource(null));
assertFalse(SourceHosts.isOfficialSource("http://192.168.100.232:6677")); // 内网直连 = 自建源
}
// ── ③ 旧默认顺序迁移 ──
/** 落盘值恰好等于 1.6.1 的旧默认(自建源优先)→ 迁移成"官方源优先"的新默认。 */
@Test
public void legacySelfHostFirstOrderIsMigratedToNewDefault() {
List<String> legacy = new ArrayList<String>(SourceHosts.LEGACY_DEFAULT);
assertEquals("旧默认必须与 1.6.1 落盘顺序一致",
Arrays.asList("https://mdmuse.kasugano.cn", "http://zk.ktv1.top:6677"), legacy);
assertEquals(SourceHosts.DEFAULT, SourceHosts.migrateLegacyDefault(legacy));
}
/** 用户自定义的列表**一律不动**(哪怕顺序看起来像旧的)、空 → 默认。 */
@Test
public void customOrderIsNeverRewritten() {
List<String> custom = Arrays.asList("http://192.168.100.232:6677", "http://zk.ktv1.top:6677");
assertEquals(custom, SourceHosts.migrateLegacyDefault(custom));
List<String> selfOnly = Collections.singletonList("https://mdmuse.kasugano.cn");
assertEquals(selfOnly, SourceHosts.migrateLegacyDefault(selfOnly));
assertEquals(SourceHosts.DEFAULT, SourceHosts.migrateLegacyDefault(null));
}
// ── 允许清单解析 ──
@@ -85,9 +117,9 @@ public class SourceHostsTest {
// ── ④ 推送默认目标 ──
/** 留空 + 列表里有自建源 → 用它(**不要求它排第一**,新默认顺序里官方源才是第一)。 */
@Test
public void pushTargetAutoUsesFirstSelfHostSource() {
// 留空 + 首源是自建源 → 用它(自建源接入后的默认行为)
public void pushTargetAutoUsesSelfHostAnywhereInList() {
assertEquals("https://mdmuse.kasugano.cn",
PushDownload.effectiveServerUrl("", SourceHosts.DEFAULT));
assertEquals("http://192.168.100.232:6677",
@@ -95,6 +127,11 @@ public class SourceHostsTest {
// 空配置也照样能拼出端点
assertEquals("https://mdmuse.kasugano.cn/push_download",
PushDownload.endpoint(PushDownload.effectiveServerUrl("", SourceHosts.DEFAULT)));
// 自建源不在第一位(新默认就是这样)也要能找到
List<String> officialFirst = Arrays.asList(
"http://zk.ktv1.top:6677", "https://mdmuse.kasugano.cn");
assertEquals("https://mdmuse.kasugano.cn",
PushDownload.effectiveServerUrl("", officialFirst));
}
@Test
@@ -114,13 +151,12 @@ public class SourceHostsTest {
}
@Test
public void pushTargetStaysOffWhenFirstSourceIsOfficial() {
List<String> officialFirst = new ArrayList<String>();
officialFirst.add("http://zk.ktv1.top:6677");
officialFirst.add("https://mdmuse.kasugano.cn");
assertEquals("首源不是自建源 → 不自动开推送", "",
PushDownload.effectiveServerUrl("", officialFirst));
assertNull(PushDownload.endpoint(PushDownload.effectiveServerUrl("", officialFirst)));
public void pushTargetStaysOffWhenNoSelfHostSource() {
List<String> officialOnly = new ArrayList<String>();
officialOnly.add("http://zk.ktv1.top:6677");
assertEquals("列表里没有自建源 → 不自动开推送", "",
PushDownload.effectiveServerUrl("", officialOnly));
assertNull(PushDownload.endpoint(PushDownload.effectiveServerUrl("", officialOnly)));
assertEquals("没有任何源 → 关闭", "",
PushDownload.effectiveServerUrl("", Collections.<String>emptyList()));
// 配置非法(漏写协议)仍按关闭处理(沿用旧口径)