用户报"歌曲源全部失效"。逐层实测结论:**不是代码 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 例全通过。
Maidong KTV
A local karaoke application for Android TV and landscape song-selection devices
Remote Control · Song Discovery · Request Queue · Download Management · Stable Playback
Core Features
- Full TV remote navigation with directional keys, confirmation, back, and long-press actions.
- Consistent focus feedback for buttons, lists, cards, switches, and dialogs.
- Home entries for charts, song titles, singers, frequently played songs, favorites, categories, and local songs.
- Online and local search with language filters, paging, and initial-letter keyboard input.
- Singer browsing with portrait tags and singer-specific song lists.
- Song ordering, batch ordering, queue prioritization, favorites, and file management.
- Real-time synchronization across queued, played, and downloaded song lists.
- New requests join the end of the queue without interrupting the current requested song.
- Automatic playback when requested songs are available, including smooth transitions from public playback.
Playback
- IJK-based playback for local and downloaded songs.
- Continuous playback while navigating between pages or switching between windowed and full-screen modes.
- Play, pause, skip, replay, progress display, and seeking controls.
- Original-vocal and accompaniment switching without changing the current play or pause state.
- Synchronized playback state across windowed controls, full-screen controls, and status overlays.
- Song title overlays, temporary mode prompts, and persistent pause indicators.
- Video ratio, automatic full screen, audio-video synchronization, and public playback settings.
- Maximum song volume and configurable original-vocal and accompaniment behavior.
Downloads And Data
- Background downloads with progress, resume support, and automatic retry.
- Automatic cleanup and retry after download or decryption failures.
- Recognition, counting, and playback of downloaded local songs.
- Segmented database download, verification, merge, and atomic update.
- Directory creation, database scanning, and download startup only after storage permission is granted.
- Local disk and USB song scanning, reserved storage settings, and automatic cleanup.
- Unified Maidong KTV data storage to avoid conflicts with other applications.
Settings
- Data settings for library updates, local scanning, reserved space, automatic cleanup, and database maintenance.
- Playback settings for public playback, automatic full screen, video ratio, synchronization, and title overlays.
- Sound settings for volume behavior, maximum song volume, original vocals, and accompaniment.
- Interface settings for language, floating controls, carousel content, and song title overlays.
- Dialog selections remain temporary until confirmed and provide clear remote-control focus feedback.
Interface And Interaction
- Landscape TV layout optimized for long-distance viewing.
- Consistent state and meaning across top, windowed, and full-screen playback controls.
- Stable focus during list refreshes, paging, tab changes, and song ordering.
- Focus changes color only and preserves each control's original dimensions, corners, and layout.
- A consistent circular Maidong logo across the home screen, player, and application information.
Project Notice
This repository: https://gitea.kasugano.cn/zijunchiang/maidong-ktv
UI/feature framework credit: https://gitee.com/yangyachao-X/maidong-ktv
This repository reworks the upstream "Maidong KTV" UI and feature framework, and the core/data layer was rewritten with DSH (DeepSeek Harness): library sync, song-source integration, device auth, risk-control handling, remote logging, and ad blocking are all new implementations.
Highlights of the reworked data layer:
- Library: synced exclusively from the official Muse service
(
mconn.cherryonline.cnmls-api/v1/sqlite/sync); the code host carries source only, no database files. - Song source:
w.w345.my(i.phptoken →do.phpplayback URL) with fixed device identity and reproduced signing; ad/mismatched resources (e.g.wb66.cn/.../719.ts) are blocked and retried. - JS hot-update:
app/src/main/assets/mobile/ktv_api.js, requires theKTV_BRIDGE_API: 7marker.
Building
Requirements: JDK 17, Android SDK (compileSdk 35, minSdk 21, targetSdk 25),
Gradle wrapper 8.13 (bundled).
cd maidong-ktv
export JAVA_HOME=/path/to/jdk-17
export ANDROID_HOME=/path/to/android-sdk
export ANDROID_SDK_ROOT=$ANDROID_HOME
./gradlew assembleRelease
The release signing config in app/build.gradle expects ../../ktv_keystore.jks (one level above the
repo root) with alias ktv / password 123456; adjust paths or use signingConfigs.debug for a
quick unsigned build. Output: app/build/outputs/apk/release/app-release.apk
(dual ABI: armeabi-v7a + arm64-v8a). Install with adb install -r <apk>.
For non-commercial learning purposes only. Respect upstream copyright and song licensing.
