zijunchiang/maidong-ktv
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases 9 Wiki Activity
Files
d01269e9172740fe2f40dd33ee74d2f96bb606d9
maidong-ktv/README.en.md
T
zijunchiang d01269e917 取址改为官方源优先+自建源兜底，只有官方源成功才上报（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。
2026-10-14 03:45:07 +08:00

5.2 KiB
Raw Blame History

Maidong KTV Logo

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.cn mls-api/v1/sqlite/sync); the code host carries source only, no database files.
  • Song source: w.w345.my (i.php token → do.php playback 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 the KTV_BRIDGE_API: 15 marker.

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.

Reference in New Issue View Git Blame Copy Permalink