删除 WX_resized.jpg(本地与仓库, 无引用)

- DatabaseBootstrapper: 新增 SYNC_TTL_DAYS=30 与 db_sync_at.txt 时间戳
  (lastSyncAt/isSyncDue/syncRemainingMs/syncStatusText/markSynced)
- initializeDatabase: 本地曲库可用且未到期时跳过服务器同步(无网络请求);
  到期或本地不可用才查版本并在有更新时下载
- 设置页: 曲库行显示「30 天同步: N 天后/已到期」; 更新按钮改为手动强制检查
- download(): 成功后记录同步时间(去掉一次多余的远端版本请求)

AGENTS.md

@@ -2,33 +2,62 @@
 
 > 本文件供后续开发（含 AI 助手会话）遵循，优先级高于默认习惯。
 
-## 一、代码同步策略（重要，2026-09-11 起生效）
+## 一、代码同步策略（2026-09-11 更新）
 
-**自动推送 Gitee：已禁用。**
+**代码主仓库已迁移至 Gitea：https://gitea.kasugano.cn/zijunchiang/maidong-ktv**
 
-- ✅ 允许：本地 `git add` / `git commit`（保留本地提交历史，便于回滚与对比）
+| 远端 | 地址 | 状态 |
-- ❌ 禁止：**自动执行 `git push`**（包括"完成改动后顺手推送"这类默认动作）
+|---|---|---|
-- ⏸ 仅在用户**明确指示**（例如"推送到 Gitee"/"同步代码"）时，才执行推送
+| `origin` | `https://gitea.kasugano.cn/zijunchiang/maidong-ktv.git` | ✅ 主仓库，**同步目标** |
+| `gitee` | `https://gitee.com/zijunchiang/maidong-ktv.git` | ⛔ 已停用（推送被钩子拦截） |
 
-### 手动启用/推送方式
+- ✅ 预期动作：完成改动 → 本地 `git commit` → `git push origin master`（同步到 Gitea）
+- ⛔ 禁止：推送到 Gitee（`pre-push` 钩子会拦截，避免误推送）
+- 凭据：Gitea 访问令牌 `dsh-sync`（可在 Gitea「设置 → 应用 → 访问令牌」随时吊销），
+  存放于 `~/.git-credentials-gitea`（权限 600），由本仓库级 `credential.helper` 引用；
+  账号密码不写入仓库配置。
 
-已安装 `pre-push` 钩子做拦截（防止误推送）。启用推送二选一：
+### 推送方式
 
 ```bash
-# 方式 1：创建启用标记（推荐，推送后建议删除标记恢复拦截）
+cd /home/zijun/dsh/maidongktv/maidong-ktv
-touch .git/ALLOW_GITEE_PUSH
+git push origin master              # origin = Gitea（主仓库）
-git push origin master
+git push --no-verify gitee master   # 仅在确需回推 Gitee 时使用
-rm -f .git/ALLOW_GITEE_PUSH
-
-# 方式 2：临时绕过钩子
-git push --no-verify origin master
 ```
 
-### 远端信息
+### 运行时端点（已全部迁移到 Gitea）
 
-- 仓库：https://gitee.com/zijunchiang/maidong-ktv （公开）
+App 内部两处端点已指向 Gitea（随本版 APK 生效）：
-- 分支：`master`
+
-- 发布：Gitee Release（tag 形如 `v1.2.5`，需附 `.apk` 附件，供 App 内检查更新）
+- `AppUpdateManager.kt`：`gitea.kasugano.cn/api/v1/repos/zijunchiang/maidong-ktv/releases/latest`（App 内检查更新）
+- `KtvJsBridge.kt`：`gitea.kasugano.cn/zijunchiang/maidong-ktv/raw/branch/master/app/src/main/assets/mobile/ktv_api.js`（JS 热更新）
+
+> 注意：Gitea 的 raw 规范路径是 `/raw/branch/<分支>/<文件>`；`/raw/<分支>/<文件>` 会 303 跳转。
+> Gitea 的 raw 与 release 下载对**无 User-Agent** 的请求同样放行（App 裸 socket 可直连）。
+
+### 发布新版本（Gitea Release）
+
+```bash
+TOKEN=$(sed -E 's|https://zijunchiang:([^@]+)@.*|\1|' ~/.git-credentials-gitea)
+
+# 1) 创建 Release（tag 需高于当前 versionName 才会提示更新）
+curl -X POST -u "zijunchiang:$TOKEN" -H "Content-Type: application/json" \
+  -d '{"tag_name":"v1.2.6","name":"麦动KTV V1.2.6","body":"更新说明","target_commitish":"master"}' \
+  https://gitea.kasugano.cn/api/v1/repos/zijunchiang/maidong-ktv/releases
+
+# 2) 上传 APK 附件（用返回的 release id；附件名必须 ASCII）
+curl -X POST -u "zijunchiang:$TOKEN" \
+  -F "attachment=@麦动KTV-V1.2.6-release.apk" \
+  "https://gitea.kasugano.cn/api/v1/repos/zijunchiang/maidong-ktv/releases/<id>/assets?name=maidong-ktv-V1.2.6-release.apk"
+```
+
+> ⚠️ **附件文件名必须为 ASCII**：Gitea 1.27 的规范下载路径
+> `/releases/download/<tag>/<文件名>` 对非 ASCII 文件名返回 404（`/attachments/<uuid>` 直链虽可用，
+> 但 `releases/latest` API 返回的是规范路径）。因此 Gitea 上的附件用
+> `maidong-ktv-V1.2.x-release.apk` 这类 ASCII 名；本地留存的发布包仍可命名
+> `麦动KTV-V1.2.x-release.apk`。
+>
+> 上传 22MB APK 约需 70s，注意命令超时设置。
 
 ## 二、构建与产物
 
@@ -66,6 +95,7 @@ $BT/apksigner verify 目标名.apk
 
 - **歌曲源**：`app/src/main/assets/mobile/ktv_api.js` 的 `CONFIG.HOSTS`（多源自动排序，失败源沉底）
 - **JS 热更新**：改动 `ktv_api.js` 必须同步提升 `KTV_BRIDGE_API: N` 标记（JS 与 `KtvJsBridge.kt` 两处校验），否则设备仍用缓存旧脚本
-- **曲库**：只走官方 Muse 同步（`MuseDbSync`），不再依赖 Gitee 数据库文件
+- **曲库**：只走官方 Muse 同步（`MuseDbSync`），不再依赖代码仓库数据库文件
+- **曲库同步时效**：默认 **30 天**（`DatabaseBootstrapper.SYNC_TTL_DAYS`）。未到期启动**不联网**、直接用本地曲库；到期后才查询服务器版本，有更新才下载。时效起点记录在 `db_sync_at.txt`，由 `DatabaseBootstrapper.markSynced()` 写入（下载成功或校验为最新时）。设置页「曲库 → 更新」为手动强制检查（绕过时效，仅在服务器版本更新时下载）
 - **麦克风**：`MicActivator` 常驻占用输入通道（TV/投影需占用后才有演唱声音输出），外接设备热插拔会自动重建
-- **发布**：Gitee 仓库必须保持 **public**，否则 App 内检查更新/下载会 403
+- **仓库可见性**：Gitea 仓库保持 **public**（若后续把 App 更新/热更新端点迁到 Gitea，非 public 会导致 403）

README.en.md

@@ -59,6 +59,8 @@
 
 ## Project Notice
 
+> **This repository**: [https://gitea.kasugano.cn/zijunchiang/maidong-ktv](https://gitea.kasugano.cn/zijunchiang/maidong-ktv)
+>
 > **UI/feature framework credit**: [https://gitee.com/yangyachao-X/maidong-ktv](https://gitee.com/yangyachao-X/maidong-ktv)
 >
 > This repository reworks the upstream "Maidong KTV" UI and feature framework, and the core/data layer was
@@ -68,7 +70,7 @@
 Highlights of the reworked data layer:
 
 - **Library**: synced exclusively from the official Muse service
-  (`mconn.cherryonline.cn` `mls-api/v1/sqlite/sync`); Gitee hosts code only, no database files.
+  (`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: 7` marker.

README.md

@@ -10,6 +10,8 @@
 
 ## 📌 项目说明
 
+> **本仓库**：[https://gitea.kasugano.cn/zijunchiang/maidong-ktv](https://gitea.kasugano.cn/zijunchiang/maidong-ktv)
+>
 > **内容框架来源**：[https://gitee.com/yangyachao-X/maidong-ktv](https://gitee.com/yangyachao-X/maidong-ktv)
 >
 > 本仓库基于上游「麦动 KTV」的界面与功能框架进行改造，并使用 **DSH（DeepSeek Harness）** 重写内核与数据源：重新实现曲库同步、歌曲源接入、设备认证、风控应对、远程日志与广告屏蔽等底层逻辑。上游框架的版权归原作者所有，本项目仅作学习与技术交流。
@@ -46,11 +48,11 @@
 
 ## 内核与数据源（DSH 重写部分）
 
-- **曲库**：统一走**官方 Muse 同步**（`mconn.cherryonline.cn` `mls-api/v1/sqlite/sync`，RSA 登录 + 增量文件校验），不再依赖 Gitee 承载数据库；Gitee 仓库仅存代码。
+- **曲库**：统一走**官方 Muse 同步**（`mconn.cherryonline.cn` `mls-api/v1/sqlite/sync`，RSA 登录 + 增量文件校验），不再依赖代码托管仓库承载数据库。
 - **歌曲源**：接入 `w.w345.my`（`i.php` 取 token → `do.php` 解析播放地址），固定设备标识并复刻签名算法；广告/错号资源（如返回 `wb66.cn/.../719.ts` 或文件名与 musicno 不一致）会被拦截并重试。
 - **风控应对**：源对陌生出口 IP 存在试用窗口（约 10 分钟，403"检测到异常行为"），App 检测到 403 后弹窗提示更换公网 IP；同 token 退避重试，不放大请求量。
 - **JS 热更新**：歌曲接口逻辑在 `app/src/main/assets/mobile/ktv_api.js`，安装后从本仓库自动拉取兼容版本（须保留 `KTV_BRIDGE_API: 7` 标记）。
-- **应用更新**：以 Gitee Release 标签作为版本号（如 `1.2.5`），Release 需附带一个 `.apk` 附件；仅当标签高于当前 `BuildConfig.VERSION_NAME` 时提示下载。
+- **应用更新**：以 Gitea Release 标签作为版本号（如 `1.2.5`），Release 需附带一个 `.apk` 附件；仅当标签高于当前 `BuildConfig.VERSION_NAME` 时提示下载。
 
 ## 🔧 编译教程
 

app/src/main/assets/mobile/ktv_api.js

@@ -1,7 +1,7 @@
 /**
  * KTV Song API - JS Hot Update Module
  * ====================================
- * 从 Gitee 热更新, App 无需发版即可修复 API 变更
+ * 从 Gitea 热更新, App 无需发版即可修复 API 变更
  *
  * 用法:
  *   const api = new KtvApi({proxy: 'http://127.0.0.1:7897'})

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

@@ -11,10 +11,10 @@ import java.io.FileOutputStream
 import java.net.HttpURLConnection
 import java.net.URL
 
-/** Gitee Release based in-app updater. */
+/** Gitea Release based in-app updater. */
 object AppUpdateManager {
     private const val LATEST_RELEASE_API =
-        "https://gitee.com/api/v5/repos/zijunchiang/maidong-ktv/releases/latest"
+        "https://gitea.kasugano.cn/api/v1/repos/zijunchiang/maidong-ktv/releases/latest"
 
     data class Release(
         val version: String,
@@ -54,7 +54,7 @@ object AppUpdateManager {
                     apkName = apkName,
                 )
             })
-        }, "gitee-update-check").start()
+        }, "gitea-update-check").start()
     }
 
     fun download(
@@ -105,7 +105,7 @@ object AppUpdateManager {
                 require(partial.renameTo(target)) { "无法保存安装包" }
                 target
             })
-        }, "gitee-update-download").start()
+        }, "gitea-update-download").start()
     }
 
     /**

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

@@ -7,14 +7,57 @@ import java.util.Locale
 /**
  * 曲库下载引导（仅官方 Muse 同步源）。
  *
- * 说明：已移除 Gitee 数据库分片/镜像下载路径（database_publish 不再发布到 Gitee，
+ * 说明：已移除分片/镜像数据库下载路径（database_publish 不再发布到代码仓库，
- * Gitee 仓库此后只存代码）。曲库统一从官方 Muse 服务（mconn.cherryonline.cn mls-api）
+ * 代码仓库此后只存代码）。曲库统一从官方 Muse 服务（mconn.cherryonline.cn mls-api）
- * 同步，由 [MuseDbSync] 负责登录、同步、校验与安装；本类只做版本文件与可读错误包装。
+ * 同步，由 [MuseDbSync] 负责登录、同步、校验与安装；本类负责同步时效、版本文件
+ * 与可读错误包装。
+ *
+ * 同步时效：默认 **30 天**（[SYNC_TTL_DAYS]）。未到期时启动不联网同步，直接用
+ * 本地曲库；到期后才向服务器查询版本并在有更新时下载。
  */
 object DatabaseBootstrapper {
     private const val TAG = "DatabaseBootstrapper"
 
+    /** 曲库同步时效(天)：达到时效后才触发服务器同步。 */
+    const val SYNC_TTL_DAYS = 30
+    private const val SYNC_TTL_MS = SYNC_TTL_DAYS * 24L * 60 * 60 * 1000
+    private const val DAY_MS = 24L * 60 * 60 * 1000
+
     private val versionFile: File get() = File(MuseDatabase.defaultDbFile().parentFile, "db_version.txt")
+    private val syncStampFile: File get() = File(MuseDatabase.defaultDbFile().parentFile, "db_sync_at.txt")
+
+    /** 上次成功同步(或成功校验为最新)的时间戳(毫秒)；无记录返回 0。 */
+    fun lastSyncAt(): Long = runCatching {
+        syncStampFile.takeIf { it.exists() }?.readText()?.trim()?.toLongOrNull()
+    }.getOrNull() ?: 0L
+
+    /** 记录一次成功同步/校验，作为 30 天时效的起点。 */
+    fun markSynced(at: Long = System.currentTimeMillis()) {
+        runCatching { syncStampFile.writeText(at.toString()) }
+    }
+
+    /** 同步是否已到期；无记录(从未同步)视为到期。 */
+    fun isSyncDue(now: Long = System.currentTimeMillis()): Boolean {
+        val last = lastSyncAt()
+        return last <= 0L || now - last >= SYNC_TTL_MS
+    }
+
+    /** 距离下次同步的剩余毫秒；已到期或无记录返回 0。 */
+    fun syncRemainingMs(now: Long = System.currentTimeMillis()): Long {
+        val last = lastSyncAt()
+        if (last <= 0L) return 0L
+        return (last + SYNC_TTL_MS - now).coerceAtLeast(0L)
+    }
+
+    /** 同步状态文案(用于设置界面展示)。 */
+    fun syncStatusText(now: Long = System.currentTimeMillis()): String {
+        val last = lastSyncAt()
+        if (last <= 0L) return "未同步"
+        val remaining = syncRemainingMs(now)
+        if (remaining <= 0L) return "已到期"
+        val days = (remaining + DAY_MS - 1) / DAY_MS
+        return "$days 天后同步"
+    }
 
     /** 远端曲库版本（官方 Muse）；失败返回 null。 */
     fun fetchRemoteVersion(): String? = MuseDbSync.fetchVersion()
@@ -23,16 +66,12 @@ object DatabaseBootstrapper {
         versionFile.takeIf { it.exists() }?.readText()?.trim()?.takeIf { it.isNotEmpty() }
     }.getOrNull()
 
-    private fun saveLocalDbVersion(version: String) {
+    /** 下载曲库：仅官方 Muse 同步源；成功后记录同步时间(重置 30 天时效)。 */
-        runCatching { versionFile.writeText(version.trim()) }
-    }
-
-    /** 下载曲库：仅官方 Muse 同步源。 */
     fun download(onProgress: (Int) -> Unit): Result<File> {
         return runCatching {
             val file = MuseDbSync.download(onProgress)
-            // MuseDbSync 内部已保存版本；此处幂等兜底。
+            // MuseDbSync 内部已保存版本文件；这里记录同步时间作为时效起点。
-            MuseDbSync.fetchVersion()?.let(::saveLocalDbVersion)
+            markSynced()
             file
         }.mapError(::readableError)
     }

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

@@ -30,15 +30,16 @@ import javax.crypto.Cipher
  * 在隐藏 WebView 中运行可热更新的歌曲接口脚本。
  *
  * JS 决定接口地址、参数、签名和响应解析；Android 只提供 HTTP 与 RSA 这两个
- * WebView 中不可靠的底层能力。这样接口变化时只需更新 Gitee 上的 ktv_api.js。
+ * WebView 中不可靠的底层能力。这样接口变化时只需更新 Gitea 上的 ktv_api.js。
  */
 class KtvJsBridge(context: Context) {
     companion object {
         private const val TAG = "KtvJsBridge"
         private const val JS_FILE = "mobile/ktv_api.js"
         private const val CACHE_FILE = "ktv_api_cache.js"
+        // 热更新脚本地址(Gitea 主仓库; raw 规范路径为 /raw/branch/<分支>/<文件>)
         private const val REMOTE_JS_URL =
-            "https://gitee.com/zijunchiang/maidong-ktv/raw/master/app/src/main/assets/mobile/ktv_api.js"
+            "https://gitea.kasugano.cn/zijunchiang/maidong-ktv/raw/branch/master/app/src/main/assets/mobile/ktv_api.js"
         private const val MAX_RESPONSE_BYTES = 2 * 1024 * 1024
         private const val JS_REQUEST_TIMEOUT_MS = 180_000
         // 当前歌曲源 w.w345.my 使用的设备标识(mac + sn)。与用户抓包示例一致,
@@ -250,7 +251,7 @@ class KtvJsBridge(context: Context) {
                         cacheFile.writeText(script, Charsets.UTF_8)
                         tempFile.delete()
                     }
-                    Log.i(TAG, "JS cache updated from Gitee (${script.length} chars)")
+                    Log.i(TAG, "JS cache updated from Gitea (${script.length} chars)")
                     // 启动后刚拉到的新版本直接生效；若已有请求在执行，则留到下次启动。
                     mainHandler.post {
                         if (ready && callbacks.isEmpty() && !destroyed) {

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

@@ -586,23 +586,37 @@ class MainActivity : AppCompatActivity() {
         databaseBootstrapRunning = true
         showDatabaseLoading(true, "正在初始化曲库...", null)
         io.execute {
-            val remoteVersion = DatabaseBootstrapper.fetchRemoteVersion()
-            val localVersion = DatabaseBootstrapper.getLocalDbVersion()
-            val updateRequired = remoteVersion != null && remoteVersion != localVersion
             var bootstrapError: Throwable? = null
             var usedOldDatabase = false
 
-            var ok = if (updateRequired) false else library.muse.open()
+            // 先尝试打开本地曲库；仅当本地不可用或已过 30 天时效时才联网同步。
-            if (!ok) {
+            var ok = library.muse.open()
-                library.muse.close()
+            val syncDue = DatabaseBootstrapper.isSyncDue()
-                val result = DatabaseBootstrapper.download(::showDatabaseDownloadProgress)
+            if (!ok || syncDue) {
-                bootstrapError = result.exceptionOrNull()
+                val reason = if (!ok) "本地曲库不可用" else "已到 ${DatabaseBootstrapper.SYNC_TTL_DAYS} 天同步时效"
-                ok = result.isSuccess && library.muse.open()
+                Log.i(TAG, "触发曲库服务器同步：$reason")
-                if (!ok) {
+                val remoteVersion = DatabaseBootstrapper.fetchRemoteVersion()
-                    // A failed online update must not make an existing local catalog unusable.
+                if (remoteVersion != null) {
-                    usedOldDatabase = library.muse.open()
+                    val localVersion = DatabaseBootstrapper.getLocalDbVersion()
-                    ok = usedOldDatabase
+                    if (!ok || remoteVersion != localVersion) {
+                        library.muse.close()
+                        val result = DatabaseBootstrapper.download(::showDatabaseDownloadProgress)
+                        bootstrapError = result.exceptionOrNull()
+                        ok = result.isSuccess && library.muse.open()
+                        if (!ok) {
+                            // A failed online update must not make an existing local catalog unusable.
+                            usedOldDatabase = library.muse.open()
+                            ok = usedOldDatabase
+                        }
+                    } else {
+                        // 版本一致：本次已完成有效校验，重置时效起点。
+                        DatabaseBootstrapper.markSynced()
+                    }
+                } else {
+                    Log.w(TAG, "曲库同步到期，但获取远端版本失败，本次继续使用本地曲库")
                 }
+            } else {
+                Log.i(TAG, "曲库未到期(${DatabaseBootstrapper.syncStatusText()})，跳过服务器同步")
             }
 
             val count = if (ok) library.muse.songCount() else 0
@@ -8232,7 +8246,7 @@ class MainActivity : AppCompatActivity() {
             SettingsEntry(
                 R.drawable.ott_ic_data_upgrade,
                 "应用更新",
-                "当前版本 ${BuildConfig.VERSION_NAME}，更新来源：Gitee Release",
+                "当前版本 ${BuildConfig.VERSION_NAME}，更新来源：Gitea Release",
                 "检查更新",
             ) { checkAppUpdate(true) },
             SettingsEntry(R.drawable.ott_ic_about_us, "关于", actionText = "查看") { showAboutDialog() },
@@ -8274,7 +8288,8 @@ class MainActivity : AppCompatActivity() {
                     "统计中…",
                     "更新",
                 ) {
-                    io.execute { library.muse.close(); library.muse.open(); main.post { showSettingsSection(1, false) } }
+                    // 手动强制检查更新(绕过 30 天时效; 仅当服务器版本更新时才下载)
+                    forceDatabaseSync()
                 },
                 SettingsEntry(R.drawable.ott_ic_data_setting, "U盘加歌", "扫描U盘内按规定命名的歌曲文件，并添加到曲库中", "立即加歌") { toast("未检测到U盘") },
                 SettingsEntry(R.drawable.ott_ic_setting_storage_space, "预留存储空间", "当前 ${String.format(Locale.ROOT, "%.1f", reserveStorageGb)} GB") { showReserveStorageDialog() },
@@ -8315,9 +8330,55 @@ class MainActivity : AppCompatActivity() {
         io.execute {
             val count = runCatching { library.muse.songCount() }.getOrDefault(0)
             val downloaded = runCatching { countDownloadedFiles() }.getOrDefault(0)
+            // 同步时效(30 天): 未到期不联网, 到期后才触发服务器同步。
+            val syncText = DatabaseBootstrapper.syncStatusText()
             main.post {
                 if (activeSettingsAdapter === adapter) {
-                    adapter.updateSubtitle("曲库", "数据库 $count 首  本地已下载 $downloaded 首")
+                    adapter.updateSubtitle(
+                        "曲库",
+                        "数据库 $count 首  本地已下载 $downloaded 首  ·  ${DatabaseBootstrapper.SYNC_TTL_DAYS} 天同步: $syncText",
+                    )
+                }
+            }
+        }
+    }
+
+    /**
+     * 手动强制检查曲库更新(绕过 30 天时效)。
+     * 仅在服务器版本更新(或本地库不可用)时才下载, 避免无谓的大文件传输。
+     */
+    private fun forceDatabaseSync() {
+        showDatabaseLoading(true, "正在检查曲库更新...", null)
+        io.execute {
+            val remoteVersion = DatabaseBootstrapper.fetchRemoteVersion()
+            if (remoteVersion == null) {
+                main.post {
+                    showDatabaseLoading(false, "", null)
+                    toast("检查失败：无法连接曲库服务器")
+                    showSettingsSection(1, false)
+                }
+                return@execute
+            }
+            val localVersion = DatabaseBootstrapper.getLocalDbVersion()
+            if (library.muse.isAvailable() && remoteVersion == localVersion) {
+                DatabaseBootstrapper.markSynced()
+                main.post {
+                    showDatabaseLoading(false, "", null)
+                    toast("曲库已是最新版本")
+                    showSettingsSection(1, false)
+                }
+                return@execute
+            }
+            library.muse.close()
+            val result = DatabaseBootstrapper.download(::showDatabaseDownloadProgress)
+            val ok = result.isSuccess && library.muse.open()
+            main.post {
+                if (ok) {
+                    showDatabaseLoading(false, "", null)
+                    toast("曲库同步完成")
+                    showSettingsSection(1, false)
+                } else {
+                    showDatabaseLoadingFailure("曲库同步失败：${result.exceptionOrNull()?.message.orEmpty()}")
                 }
             }
         }

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

@@ -20,7 +20,7 @@ import javax.crypto.Cipher
 /**
  * 官方曲库同步：login → cookie → sqlite/sync → 下载 gz → 解压安装。
  *
- * 这是原版「时光KTV / 麦动」的曲库分发方式，取代此前临时使用的 Gitee 分片方案。
+ * 这是原版「时光KTV / 麦动」的曲库分发方式，取代此前临时使用的分片分发方案。
  * 授权门控发生在服务端(未授权设备 sync 返回空 files)，本地只负责完整复刻请求协议。
  */
 object MuseDbSync {

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

@@ -10,8 +10,8 @@ import java.util.concurrent.atomic.AtomicReference
 /**
  * 歌曲 API 客户端 —— JS 热更新桥接
  * =================================
- * - 通过 KtvJsBridge 调用 Gitee 上的 JS 脚本
+ * - 通过 KtvJsBridge 调用 Gitea 上的 JS 脚本
- * - API 变更时只需更新 Gitee JS 文件，App 无需发版
+ * - API 变更时只需更新 Gitea JS 文件，App 无需发版
  * - 首次播放时实时获取 URL，不存在过期问题
  */
 object SongApiClient {