合并自建歌曲源支线（selfhost-source）+ 版本号按约定修正为 1.6.0

版本号： - 1.5.11 越界（规则 3 规定 patch ≤ 10）→ 修正为 1.6.0（进位到 minor、patch 归 0） - versionCode 43 不变：43 从未对外发布，本次修正只是把命名拉回约定合并支线（原在工作区根目录、App 仓库之外，DESIGN.md 自称"支线"）： - selfhost-source/server/ 自建歌曲源服务器（纯 Python 标准库、零 pip 依赖） - selfhost-source/deploy/、DESIGN.md、LIBRARY.md、build_inventory.py - selfhost-source/inventory/ 小清单（playlists.csv、song-stats.md 等） - ⚠️ inventory 生成物（songs-*.csv / singers-top.csv，共 84MB）不入库，已写入 .gitignore；需要时用 build_inventory.py 依据 muse.db 重新生成同时入库的 App 侧支线改动（此前为工作树未提交状态）： - Whoami.kt（whoami 设备心跳）、DeviceIdentity.kt（设备身份伪装） - PushDownload.kt / PushDownloadClient.kt（点歌推送） - AdVideoFilter 带 query/fragment 的地址闸门；KTV_BRIDGE_API 11 → 13 - 修 ktv_api.js 的 global.KtvBridgeApiVersion（12 → 13，与注释及 Kotlin 两处校验一致） - 对应单测：WhoamiTest / DeviceIdentityTest / PushDownloadTest / AdVideoFilterTest（共 39 例）文档： - DESIGN.md 的"在 App 仓库之外"约定改为"已并入仓库统一版本化" - AGENTS.md 版本号行更新为 1.6.0/43，并新增支线并入说明验证：assembleRelease + testReleaseUnitTest 全过（39 例）
2026-10-14 02:06:28 +08:00
parent e060ae5ebe
commit 87aa979abd
68 changed files with 21305 additions and 105 deletions
@@ -0,0 +1,277 @@
+歌单,歌曲数,热度
+粤剧,993,100
+民歌传唱,896,100
+儿歌,836,100
+经典老歌,824,100
+甜蜜幸福,811,100
+心碎伤感,773,100
+寂寞空灵,753,100
+歌颂祖国,745,100
+流行歌曲,741,100
+高清歌曲,740,100
+潮剧,713,100
+影视金曲,711,100
+情歌对唱,708,100
+戏曲片段,696,100
+草原歌曲,684,100
+友谊万岁,673,100
+异国风情,655,100
+经典翻唱,620,100
+音乐教唱,616,100
+21世纪头十年经典流行老歌,602,39074816
+只要能遇见你，就不怕姗姗来迟,590,133955544
+京剧,558,100
+华语经典老歌，永恒不朽（百首精选）,553,32044612
+军旅歌曲,551,100
+网络歌曲,544,100
+「华语」哭泣使人乞讨，思念使人奔跑,504,76430448
+【岁月如歌】重温那些年的经典旋律,435,25217662
+欢乐庆典,409,100
+【华语】把回忆藏在曾经的歌里,382,16945052
+歌词唱透了心声，回忆模糊了眼眸,376,60673300
+disco,376,100
+90后的回忆杀 - 『持续更新』,363,94378480
+你需要一首BGM，来撑起你的内心戏！,360,49580660
+那些好听到发疯的粤语歌,334,200972224
+越剧,333,100
+想开一家奶茶店这些歌列表循环就叫它&经历,313,25819758
+听一首粤语老歌，来怀念过去,310,36688940
+女人靓歌坊,302,100
+2018抖音热门BGM，持续更新（抖音2018）,301,58560668
+KTV女生必点歌曲【惊艳】,284,29985414
+【经典】聼一首老歌，想念一段时光,279,21643864
+KTV必点歌曲，学会你就是麦霸,273,1256432
+『网易云热歌』热评10w+（持续更新）,266,219262704
+情歌还是老的好,263,61754832
+抖音短视频【BGM全收录】,260,76740552
+有没有一句歌词直戳内心,260,29518206
+岁月如潮水，将我向老歌推,235,35259452
+点起一支烟，听一首粤语歌,231,21488826
+【华语】那些年，我们曾抄写過的歌词,224,25698424
+痛彻心扉地哭，然后刻骨铭心地记住,223,65652120
+热歌榜,219,19100000
+耳 朵 喜 欢 你,216,20741844
+人这一辈子，最怕突然听懂了一首歌。,215,88305968
+男人KTV,210,100
+粤语丨 岁月流情，回味旧日的浪漫故事,205,16267297
+吟游歌者，句句成诗,199,16302019
+说不出名字的那些经典英文歌,194,59731052
+一个天蝎座的听歌列表,194,78245912
+将回忆酿成烈酒入喉 从此不再挽留不再回头,191,126480024
+校园民谣,189,100
+其他戏曲,185,100
+最陈奕迅·精选,184,40859036
+林俊杰最全歌曲合辑,180,27574428
+『粤语』好听到爆的粤语歌单.,177,203949920
+「粤语」人世间所有的相遇 都是久别重逢,173,32167214
+黄梅戏,173,100
+【旋律控】超级好听的英文歌,172,495963200
+400首好听英文歌,171,186228896
+支撑美术画画Or肝作业的力量 耐听 杂食,168,73241696
+你的青春里有没有属于你的一首歌？,165,146709104
+华语百首 | 回忆伤人无声，唱不尽世间遗憾,164,223239712
+KTV男生必点歌曲，学会你就是麦霸,158,7145392
+听说你也在找好听的华语歌,156,200185024
+有哪些好听的歌会让你感同身受,155,36718892
+内地榜,150,1409345
+云音乐热歌榜,148,12946769920
+KTV【惊艳全场】必点歌曲（女声）,146,1540725
+一路向北（适合开车的时候听）,146,28797034
+首首好聽到爆的英文歌,142,27804416
+耳朵喜欢你 好听到可以单曲循环,139,240023280
+一个旋律两首歌 | 是无意穿堂风 偏偏引山洪,138,11232113
+【♔私藏】一听就会中毒的英文歌,138,63874560
+那些喜欢到循环播放的歌,138,117558320
+评论过万的中文歌与潜力股,137,30243442
+KTV必点：有没有一首歌，唱着唱着就泪奔,134,85365104
+【欧美男团】秒杀耳朵系列,133,140557504
+很好听的华语伤感歌曲,132,24267484
+好 听 到 可 以 单 曲 循 环 (中),129,150165392
+豫剧,126,100
+KTV麦霸必点歌曲,123,61461172
+失恋必听歌单 | 因为你突然听懂了很多歌,120,152410768
+余生太长 你好难忘,120,18866748
+抖音大合集_Mm（抖腿吧骚年）周日更新,117,13213081
+你是北来的狂风 瞬间席卷我整个领空,117,10560531
+细数那些值得单曲循环的英文歌,116,39812128
+华语民谣 I 孤独的心诠释诗意和远方,115,24140130
+时间治愈的是 愿意自渡之人,114,56218112
+初识不知曲中意，再听已是曲中人,114,60350688
+沪剧,114,100
+欧美经典 | 总有一首歌直击你心,113,35879548
+华语女声‖那些入耳入心的代表曲,108,23539098
+爱情宣言,107,100
+KTV华语必点,106,1069788
+精选经典好听古风歌曲合集,105,18233012
+再深的感情也抵挡不住缘分的交错,104,9783831
+台湾地区榜,104,283688
+万次评论只为这个旋律,103,47847960
+国产HipHop从地下到地上,102,39701088
+新歌榜,100,1600000
+粤语♪容易抱住谁十年最难是放,100,12240618
+陈粒 / 张悬 / 花粥 / 谢春花 / 房东的猫,99,40172108
+【节奏控】超带感的英文歌（经典篇）,99,173546576
+香港地区榜,98,916685
+KTV成为麦霸的练习曲（男声篇）,95,1121833
+民谣200首【精选】,95,91756288
+怀旧辑 | 昨日红花今又开，似是故人来,95,11419997
+【健身运动】必备单曲,95,85414152
+【欧美】简直好听到飞起来,94,23705624
+温柔暴击 | 沉溺于男友音的甜蜜乡,93,43284212
+粤语男声：我爱你依旧如初，不曾改变。,93,27124312
+有故事的男生，唱着有故事的歌,93,19802516
+『欧美』抖腿族`节奏控福利.,93,13413579
+台湾偶像剧黄金年代|记忆是阵阵花香,93,26925956
+女生KTV必点歌曲,91,6643973
+这些歌名连起来，是我暗恋你多年的秘密,91,22446996
+百首良曲|刷（抄）作业必备燃曲,91,145921504
+熬夜和想你，我都该戒掉了,90,48574272
+叱咤樂壇 的流行-粵耳旋律,90,41869776
+年少不懂粤语歌，而立再听句句情,90,14012528
+软妹子 萝莉 中文 萌音,89,43419216
+【民谣】民谣是毒也是药,88,32760102
+纯音乐,87,100
+KTV装逼系列之 经典粤语,86,1586773
+『粤语』 听一首把自己感动的歌,86,48572008
+国语古风中国风神曲，细腻地抚摸你的耳膜,85,54830448
+那些eason最好听的歌 ❤️,85,17690426
+"""多少人以朋友的名义爱着一个人? """,84,9664045
+『治愈女声』 温暖沉静，治愈心灵,84,15602435
+测试耳机的解析度【耳机福利】,84,85447296
+这些充满『强烈画面感』的音乐,84,73268688
+你最想对暗恋的人 说的一句话是什么,84,17018624
+革命歌曲,80,100
+我爱你  第一句是假的  第二句也是假的,79,24416922
+听歌最怕应景，触景最怕生情,79,18458268
+『一百首』经典华语怀旧老歌,78,53617452
+致回不去的校园，致那美好的曾经,77,33127414
+百首老歌：再续当年情,77,48829920
+【环球唱片精选】必听百首华语经典,76,15801973
+评论过万的英文歌与潜力股,75,149134048
+给你一张2008年的CD。,75,10695745
+『回忆童年经典动画片主题曲』,75,64405000
+最是粤语最为情深 也唯独你最难忘怀,74,31313740
+华语百首 | 歌词里那些欲言又止的少女心事,73,13121594
+抖音排行榜,73,4539160
+淮剧,73,100
+粤语女声 I 故事太多 没人会听你诉说,72,27929232
+在KTV唱什么粤语歌可以秒杀全场。,71,44972744
+流行指数榜,71,7953220
+永远听不腻的英文歌,70,54454648
+确认过眼神，余生都是你,70,13031843
+『致前任』我曾经很喜欢你 但也只能到这里,68,21179900
+100个悲伤的瞬间，有没有你的心酸？,68,43176556
+『华语』KTV最佳对唱“CP”称号就靠它了,68,10569881
+你总要一个人，经历些难捱的日子。,67,45230216
+『一听就上瘾的外语歌』,66,18800020
+『华语』百首精选，听歌如见你,66,61617944
+单循辑｜我想和你共享耳机,65,26620854
+这世界上情歌那么多，却没有一首属于我,65,19778744
+100首华语民谣，因为懂得才有共鸣,65,55331340
+「古风」最值得单曲循环的古风歌合集,64,41925268
+『90后』小时候【所谓非主流】的经典神曲,64,29664244
+这些歌比《说散就散》《体面》更扎心！,63,36707820
+每首都能单曲循环的国语,63,11202720
+2017年度最热新歌TOP100,63,52499584
+飙升榜,63,18633712
+「欧美经典」 岁月催人变老，老歌如酒弥香,61,13102667
+予你情诗百首，余生你是我的所有,61,62038004
+爱情不卑微不施舍，别以为你是谁,61,17230560
+2016年度最热新歌TOP100,59,21751304
+祝福歌曲,59,100
+【网易云热评歌曲】起风了,58,30354378
+全球最高下载量单曲Top 100,57,92039624
+攒了一大堆好听的歌想和你一起听,57,119721480
+【KTV小众出彩】女生中音好唱又特别,57,1310795
+全球史诗级万评电音!百种风格【主打】,56,23881556
+2018年度最热新歌TOP100,56,177636416
+神级Remix电音背后的优质原作☆总集完结篇,55,18411296
+「手机铃声」清新自然无前奏响起,55,139808576
+『华语女声』糟糕！是心动的感觉,55,17294504
+数尽荒芜过后 必定会有新生,54,22957940
+那些触动人心的女声民谣,54,48874732
+劲歌热舞,54,19900000
+论正确背诗的方式【文言已补充,53,12071600
+100首经典英文老歌.,53,80141264
+作业专属【刷题BGM】,51,56108500
+2016年度分享量最高单曲TOP100,51,39715140
+2017年度热议单曲TOP100,50,42962244
+YouTube上最受欢迎的音乐MV Top100,50,54926820
+如果你也喜欢陈奕迅,49,16542336
+值得收藏的广告歌曲,48,19426976
+有品的英语学霸炼成记1,45,22245450
+甜到骨子里，听进心坎里,45,25507984
+NBA最成功的背景音乐,45,20925048
+【古风戏腔】戏子入画，一生天涯,44,34203340
+【 2017 YouTube收听量最高的欧美歌曲 】,44,20005152
+风月无憾 | 你是我有关青春 最美的句读,44,16596123
+【一人一首民谣】--爱上民谣因为习惯了孤独,44,15271488
+【 把故事藏在歌名里 〗,44,11728312
+【环球精选】华语乐坛一人一首绝对精选,44,9512863
+秦腔,43,100
+年轻时不懂，为何现在却红了眼,42,11008444
+民谣 / 成长中的情绪共谋者,42,13568484
+古风伤恋｜待到红颜消 杳杳无归期,41,20156636
+香港电影中的50首经典歌曲 [追忆录],41,39237508
+『曲作精选』细数古风圈原创作曲人❶,40,29728992
+【烟嗓/爵士/灵魂/蓝调/华丽】韵味/酷炫,39,26264554
+我最大的遗憾，是你的遗憾与我有关,39,14920621
+【看球听歌】NBA篮球宣传单曲大全,38,23725072
+一人一首华语好声音【男生篇】,38,17794448
+21世纪以来全球最畅销的单曲前100名,38,28553940
+评剧,38,100
+《情书》——献给总是美丽的你,37,11520450
+放弃一个喜欢了很久的人是什么感觉,36,10026779
+『欧美前奏控』论歌曲前奏的重要性,36,14389441
+『开口脆』迷幻嗓音极致瞬间❤️,36,50420700
+抖音短视频【最火200首歌曲排行榜】,36,20282876
+[华语]开嗓就能hold住全场的KTV神曲,36,8529601
+Sleepy pillow-嗜睡軟枕,36,20682306
+2018上半年最热新歌TOP50,35,36380288
+小清新民谣|一听就会爱上的歌,34,24559114
+打碟,34,100
+妈妈，他的糖里有毒,33,17148520
+先生 我把暗恋放歌单里 可……,33,20208778
+一名90后看过的经典动漫,33,12338554
+耳朵怀孕 | 世界级大师69支MV,32,45309432
+多热烈的白羊，热烈的抽象。,32,22586518
+过年回家如何在KTV里笑傲全场,31,4900936
+民谣精选 你的名字美如诗,31,15922849
+2017上半年最热新歌TOP50,30,9850027
+「婚礼策划」迎宾暖场,30,21900980
+终于听懂每首情歌，却再也没有可以联系的人,30,46345240
+当优质原曲邂逅神级Remix,30,25077296
+花鼓戏,30,100
+2017年度最受欢迎个性推荐歌曲,29,51586764
+还记得你的梦想吗？别让你的梦只有想,28,19405810
+Hold住全场的KTV炫技良曲/华语篇,28,7585659
+一个比较走心的民谣歌单,28,39694876
+『翻唱』百首经典翻唱 每首都能单曲循环,26,11747071
+女声控|那些一曲惊人的古风歌,26,22358572
+『1979-至今』全年代日本动漫OP大盘点-持更,26,31309808
+『无前奏铃声』超适合做手机铃声的歌曲！,26,26377520
+适合努力学习英语时听的歌曲,25,25432568
+100首古风歌曲推荐❶【古风控必备】,24,44344688
+一曲戏腔极尽风流，一抹笑靥极尽欢颜。,23,27972912
+『古风女声』扶柔倾国色，风华绝世人,22,11834110
+华语K歌精选 | 循环太多遍之麦霸KTV必点曲,22,1083307
+入耳即醉｜超级好听的欧美女声,21,15823761
+2018全年抖腿指南，老铁你怕了吗？,21,23302986
+Billboard官网：120周年纪，120首时代金曲,21,14348045
+入耳便爱上的英文歌,19,83380624
+「前奏控」被前奏秒杀的古风歌,16,16473778
+锡剧,16,100
+【中国有嘻哈】华语独立说唱 | 热门海藏,15,17358392
+新年就是要听喜庆的歌,15,4983737
+Trap丨令人沉迷的随性说唱,14,35637472
+串烧,14,100
+芗剧,14,100
+电音,13,100
+闽剧,11,100
+打碟现场,10,1000
+慢摇,9,100
+晋剧,7,100
+琼剧,6,100
+河北梆子,3,100
+周杰伦最全演唱正序集,0,39390452
+庐剧,0,100
@@ -0,0 +1,134 @@
+# 麦动KTV 本地曲库 — 歌曲统计与清单
+
+- 数据源：`muse.db`（md5 已核对；版本文件 `db_version.txt`）
+- 生成时间：2026-10-10 00:19:25
+- **歌曲总数：696,393 首**（其中已删除 deleted_at 非空：0）
+
+## 一、按语言（归一化到 7 个规范语种）
+
+| 语言 | 歌曲数 | 占比 |
+|---|---:|---:|
+| 国语 | 629,947 | 90.46% |
+| 粤语 | 24,646 | 3.54% |
+| 闽南语 | 15,967 | 2.29% |
+| 英语 | 14,701 | 2.11% |
+| 日语 | 2,115 | 0.30% |
+| 韩语 | 3,548 | 0.51% |
+| 其它 | 5,407 | 0.78% |
+| (未标注) | 62 | 0.01% |
+
+（另有 **26** 首的 `lang` 字段不是规范语种——填的是歌名/节目名等脏数据，已归入『其它』）
+
+## 二、曲风/标签 Top 30（tags_str 为 JSON 数组，取每首首个标签统计）
+
+| 标签 | 歌曲数 |
+|---|---:|
+| 流行歌曲 | 554,606 |
+| 寂寞空灵 | 484,235 |
+| disco | 47,302 |
+| 甜蜜幸福 | 27,323 |
+| 经典老歌 | 26,728 |
+| 网络歌曲 | 23,025 |
+| 心碎伤感 | 19,094 |
+| 男女对唱 | 17,545 |
+| 高清歌曲 | 16,744 |
+| 欢乐庆典 | 12,922 |
+| 民歌传唱 | 9,997 |
+| 儿童歌曲 | 9,082 |
+| 异国风情 | 8,986 |
+| 经典翻唱 | 6,666 |
+| 民族歌曲 | 5,932 |
+| 戏曲片段 | 4,674 |
+| 影视金曲 | 3,315 |
+| 情歌对唱 | 3,283 |
+| 歌颂祖国 | 1,960 |
+| 外国歌曲 | 1,889 |
+| 草原歌曲 | 1,452 |
+| 潮剧 | 1,382 |
+| 粤剧 | 1,263 |
+| 友谊万岁 | 1,070 |
+| 军旅歌曲 | 851 |
+| 纯音乐 | 589 |
+| 京剧 | 573 |
+| 越剧 | 362 |
+| 其他戏曲 | 340 |
+| 女人靓歌坊 | 306 |
+
+（不同标签合计 138 个）
+
+## 三、歌手
+
+- 歌手表总数：**137,462**（其中有名字的 137,460）
+- 歌曲-歌手关联：**771,261** 条，覆盖 **692,579** 首歌（占 99.5%）
+
+| 歌手 | 歌曲数 |
+|---|---:|
+| 烟嗓船长 | 3,597 |
+| 洛天依 | 3,029 |
+| 艺凌 | 2,517 |
+| 魏佳艺 | 1,932 |
+| 苍狼 | 1,917 |
+| 肖雨蒙 | 1,624 |
+| 安儿陈 | 1,587 |
+| 王一佳 | 1,582 |
+| 沧桑小杰 | 1,581 |
+| 李英 | 1,564 |
+| 王超然 | 1,542 |
+| 红蔷薇 | 1,539 |
+| 李亚鑫 | 1,475 |
+| 音乐走廊 | 1,396 |
+| 小琢 | 1,395 |
+| 常超凡 | 1,366 |
+| 卢润泽 | 1,242 |
+| 朱跃明 | 1,242 |
+| 王娜 | 1,236 |
+| 王爱华 | 1,228 |
+| 烟圈蔓延 | 1,190 |
+| 赵洋 | 1,170 |
+| 任夏 | 1,138 |
+| 田园 | 1,116 |
+| 黑豆ado | 1,092 |
+| 洋澜一 | 1,083 |
+| 黄静美 | 1,077 |
+| 大头针 | 1,038 |
+| 向思思 | 1,006 |
+| 燕宝儿 | 960 |
+
+## 四、其它维度
+
+| 维度 | 统计 |
+|---|---|
+| 有 cloud_url 的歌曲 | （本版库无该列）|
+| filename 形如 `<编号>.ts` | 686,855 |
+| 可伴奏(accomp=1) | 19,688 |
+| 有原唱(original=1) | 0 |
+| available=1 | 0 |
+| 歌单数 | 276 |
+| 歌单关联歌曲 | 43,054 |
+
+### mv_type 分布
+
+| mv_type | 歌曲数 |
+|---|---:|
+| 2 | 550,925 |
+| 0 | 124,906 |
+| 1 | 16,138 |
+| 4 | 2,980 |
+| 5 | 1,209 |
+| 3 | 235 |
+
+## 五、导出清单（CSV）
+
+- `songs-all.csv`：**696,393** 行（43.5 MB）
+- `songs-国语.csv`：629,947 行
+- `songs-粤语.csv`：24,646 行
+- `songs-闽南语.csv`：15,967 行
+- `songs-英语.csv`：14,701 行
+- `songs-其它.csv`：5,407 行
+- `songs-韩语.csv`：3,548 行
+- `songs-日语.csv`：2,115 行
+- `songs-未标注.csv`：62 行
+- `singers-top.csv`：1175 KB
+- `playlists.csv`：13 KB
+
+（耗时 16.8s）