📝 (ui): 引入 HomeActivityVm 统一管理更新逻辑与状态

引入 HomeActivityVm 负责应用与规则的更新检查、状态卡数据更新及自动备份任务。
通过 LiveData 通知 UI 展示更新弹窗，解耦 Activity 与业务逻辑，提升可维护性。
状态卡组件现通过 VM 获取数据并触发检查，避免直接调用工具类。

Author: AnkioTomas

app/src/main/java/net/ankio/auto/ui/activity/HomeActivity.kt

@@ -17,53 +17,68 @@ package net.ankio.auto.ui.activity
 
 import android.os.Bundle
 import android.view.MenuItem
+import androidx.activity.viewModels
+import androidx.core.net.toUri
+import androidx.lifecycle.lifecycleScope
 import androidx.navigation.fragment.NavHostFragment
 import androidx.navigation.ui.NavigationUI
 import androidx.navigation.ui.setupWithNavController
+import kotlinx.coroutines.launch
 import net.ankio.auto.App
 import net.ankio.auto.R
 import net.ankio.auto.databinding.ActivityMainBinding
 import net.ankio.auto.storage.backup.BackupManager
 import net.ankio.auto.ui.api.BaseActivity
-import net.ankio.auto.update.AppUpdateHelper
-import net.ankio.auto.update.RuleUpdateHelper
+import net.ankio.auto.ui.api.BaseSheetDialog
+import net.ankio.auto.ui.dialog.UpdateDialog
 import net.ankio.auto.ui.utils.slideDown
 import net.ankio.auto.ui.utils.slideUp
-import net.ankio.auto.utils.PrefManager
-import net.ankio.auto.utils.Throttle
+import net.ankio.auto.ui.vm.HomeActivityVm
+import net.ankio.auto.update.AppUpdateHelper
+import net.ankio.auto.update.RuleUpdateHelper
+import net.ankio.auto.utils.CustomTabsHelper
 
 class HomeActivity : BaseActivity() {
+    private val vm: HomeActivityVm by viewModels()
 
-    /** Pref 全量同步节流：5 分钟，持久化以支持进程重启后节流 */
-    private val prefSyncThrottle = Throttle.asFunction(
-        intervalMs = 5 * 60 * 1000L,
-        persistKey = "pref_sync"
-    ) { App.launch { PrefManager.syncAllToBackend() } }
+    private val binding: ActivityMainBinding by lazy {
+        ActivityMainBinding.inflate(layoutInflater)
+    }
 
-    /** 自动检查更新节流：30 分钟，持久化以支持进程重启后节流 */
-    private val updateCheckThrottle = Throttle.asFunction(
-        intervalMs = 30 * 60 * 1000L,
-        persistKey = "auto_update_check"
-    ) {
-        App.launch {
-            runCatching {
-                if (RuleUpdateHelper.isAutoCheckEnabled()) {
-                    RuleUpdateHelper.checkAndShow(this@HomeActivity, false)
-                }
-                if (AppUpdateHelper.isAutoCheckEnabled()) {
-                    AppUpdateHelper.checkAndShow(this@HomeActivity, false)
+    /** 注册 VM 的 LiveData 观察，用于展示规则/应用更新弹窗 */
+    private fun setupUpdateListeners() {
+        vm.appUpdateModel.observe(this) { model ->
+            if (model == null) return@observe
+            vm.consumeAppUpdate()
+            BaseSheetDialog.create<UpdateDialog>(this)
+                .setUpdateModel(model)
+                .setRuleTitle(getString(R.string.app))
+                .setOnClickUpdate {
+                    CustomTabsHelper.launchUrl(AppUpdateHelper.buildApkUrl(model.version).toUri())
                 }
-            }
+                .show()
         }
-    }
 
-    private val binding: ActivityMainBinding by lazy {
-        ActivityMainBinding.inflate(layoutInflater)
+        vm.ruleUpdateModel.observe(this) { model ->
+            if (model == null) return@observe
+            vm.consumeRuleUpdate()
+            BaseSheetDialog.create<UpdateDialog>(this)
+                .setUpdateModel(model)
+                .setRuleTitle(getString(R.string.rule))
+                .setOnClickUpdate {
+                    lifecycleScope.launch {
+                        RuleUpdateHelper.updateRule(this@HomeActivity, model)
+                        vm.refreshStatus(this@HomeActivity)
+                    }
+                }
+                .show()
+        }
     }
 
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(binding.root)
+        setupUpdateListeners()
         val navHostFragment = supportFragmentManager
             .findFragmentById(R.id.nav_host_fragment) as NavHostFragment?
             ?: throw IllegalStateException("NavHostFragment not found")
@@ -97,16 +112,12 @@ class HomeActivity : BaseActivity() {
 
     override fun onResume() {
         super.onResume()
-        prefSyncThrottle()
-        updateCheckThrottle()
+        vm.startSyncUpdateTask()
     }
 
     override fun onStop() {
         super.onStop()
-        // 使用全局协程作用域执行备份，避免阻塞UI线程
-        App.launch {
-            BackupManager.autoBackup()
-        }
+        vm.startAutoBackup()
     }
 
     override fun onDestroy() {

app/src/main/java/net/ankio/auto/ui/fragment/HomeFragment.kt

@@ -18,6 +18,7 @@ package net.ankio.auto.ui.fragment
 import android.content.Intent
 import android.os.Bundle
 import android.view.View
+import androidx.fragment.app.activityViewModels
 import androidx.navigation.fragment.findNavController
 import com.google.gson.Gson
 import net.ankio.auto.BuildConfig
@@ -36,15 +37,18 @@ import net.ankio.auto.ui.dialog.BottomSheetDialogBuilder
 import net.ankio.auto.ui.fragment.components.BookCardComponent
 import net.ankio.auto.ui.fragment.components.MonthlyCardComponent
 import net.ankio.auto.ui.fragment.components.StatusCardComponent
+import net.ankio.auto.ui.vm.HomeActivityVm
 import net.ankio.auto.utils.PrefManager
 import org.ezbook.server.intent.BillInfoIntent
 
 class HomeFragment : BaseFragment<FragmentPluginHomeBinding>() {
     private val gson = Gson()
+    private val vm: HomeActivityVm by activityViewModels()
 
     override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
         super.onViewCreated(view, savedInstanceState)
         val statusCard: StatusCardComponent = binding.activeCard.bindAs()
+        statusCard.setVm(vm)
 
 
         val monthlyCard: MonthlyCardComponent = binding.monthlyCard.bindAs()

app/src/main/java/net/ankio/auto/ui/fragment/components/StatusCardComponent.kt

@@ -17,100 +17,82 @@ package net.ankio.auto.ui.fragment.components
 
 import androidx.annotation.ColorInt
 import androidx.annotation.DrawableRes
-import net.ankio.auto.BuildConfig
+import androidx.lifecycle.findViewTreeLifecycleOwner
 import net.ankio.auto.R
-import net.ankio.auto.constant.WorkMode
 import net.ankio.auto.databinding.CardStatusBinding
-import net.ankio.auto.service.CoreService
-import net.ankio.auto.service.OcrService
 import net.ankio.auto.ui.api.BaseComponent
 import net.ankio.auto.ui.theme.DynamicColors
-import net.ankio.auto.update.AppUpdateHelper
-import net.ankio.auto.update.RuleUpdateHelper
 import net.ankio.auto.ui.utils.toDrawable
+import net.ankio.auto.ui.vm.HomeActivityVm
+import net.ankio.auto.ui.vm.StatusData
 import net.ankio.auto.utils.PrefManager
-import net.ankio.auto.xposed.XposedModule
 import java.util.Locale
 
+/**
+ * 状态卡组件，展示工作状态、规则/应用版本，点击检查更新。
+ * 需通过 [setVm] 注入 [HomeActivityVm]，UI 数据与点击逻辑均走 VM。
+ */
 class StatusCardComponent(binding: CardStatusBinding) :
     BaseComponent<CardStatusBinding>(binding) {
 
+    private var vm: HomeActivityVm? = null
+
+    /** 注入 ViewModel，必须在 [onComponentCreate] 之后由宿主调用 */
+    fun setVm(vm: HomeActivityVm) {
+        this.vm = vm
+        setupVm()
+    }
+
     override fun onComponentCreate() {
         super.onComponentCreate()
+        binding.cardContentRule.setBackgroundColor(DynamicColors.SurfaceColor3)
+        binding.cardContentApp.setBackgroundColor(DynamicColors.SurfaceColor3)
 
-        // 整卡点击：检查规则更新
+        // 点击：检查更新（走 VM）
         binding.cardContentRule.setOnClickListener {
-            launch {
-                RuleUpdateHelper.checkAndShow(context, true) { updateRuleTexts() }
-            }
+            vm?.checkRuleUpdate(fromUser = true)
         }
-
         binding.cardContentApp.setOnClickListener {
-            launch {
-                AppUpdateHelper.checkAndShow(context, true)
-            }
+            vm?.checkAppUpdate(fromUser = true)
         }
 
-        // 长按：强制规则更新
+        // 长按：强制规则更新后检查
         binding.cardContentRule.setOnLongClickListener {
             PrefManager.ruleVersion = ""
-            launch {
-                RuleUpdateHelper.checkAndShow(context, true) { updateRuleTexts() }
-            }
+            vm?.checkRuleUpdate(fromUser = true)
             true
         }
         binding.cardContentApp.setOnLongClickListener {
-            launch {
-                AppUpdateHelper.checkAndShow(context, true)
-            }
+            vm?.checkAppUpdate(fromUser = true)
             true
         }
-
-        binding.cardContentRule.setBackgroundColor(DynamicColors.SurfaceColor3)
-        binding.cardContentApp.setBackgroundColor(DynamicColors.SurfaceColor3)
-        // 初始化状态显示
-        updateActiveStatus()
-        updateRuleTexts()
     }
 
     override fun onComponentResume() {
         super.onComponentResume()
-        updateActiveStatus()
-        updateRuleTexts()
+        vm?.refreshStatus(context)
     }
 
-    /**
-     * 当前模式是否处于"工作中"
-     */
-    private fun isCurrentModeActive(): Boolean {
-        return when (PrefManager.workMode) {
-            WorkMode.Ocr -> OcrService.serverStarted
-            WorkMode.LSPatch -> CoreService.isRunning(context)
-            WorkMode.Xposed -> XposedModule.active()
+    /** 绑定 VM 后调用：注册观察、首次刷新 */
+    private fun setupVm() {
+        val v = vm ?: return
+        val owner = binding.root.findViewTreeLifecycleOwner() ?: return
+        v.refreshStatus(context)
+        v.statusData.observe(owner) { data ->
+            applyStatusData(data)
         }
     }
 
-    /**
-     * 统一更新激活状态显示（第一行：工作状态 + 模式标签）
-     */
-    private fun updateActiveStatus() {
-        val isActive = isCurrentModeActive()
-        val versionName = BuildConfig.VERSION_NAME
-
-        // 工作状态文本
-        val statusText = if (isActive) {
-            context.getString(R.string.status_working)
-        } else {
-            context.getString(R.string.status_inactive)
-        }
-        binding.titleText.text = statusText
-
-        binding.modeText.text = PrefManager.workMode.name.uppercase()
-        // 调试模式时显示小标签，与 mode 标签风格统一
+    /** 根据 [StatusData] 更新 UI */
+    private fun applyStatusData(data: StatusData) {
+        binding.titleText.text =
+            if (data.isActive) context.getString(R.string.status_working)
+            else context.getString(R.string.status_inactive)
+        binding.modeText.text = data.workMode.name.uppercase(Locale.getDefault())
         binding.debugTag.visibility =
-            if (PrefManager.debugMode) android.view.View.VISIBLE else android.view.View.GONE
+            if (data.debugMode) android.view.View.VISIBLE else android.view.View.GONE
 
-        if (isActive) {
+        if (data.isActive) {
             setActive(
                 backgroundColor = DynamicColors.SecondaryContainer,
                 textColor = DynamicColors.OnPrimaryContainer,
@@ -123,21 +105,15 @@ class StatusCardComponent(binding: CardStatusBinding) :
                 drawable = R.drawable.home_active_error
             )
         }
-        binding.subtitleText.text = "v$versionName"
-        val channelValue = PrefManager.appChannel.lowercase(Locale.getDefault())
+        binding.subtitleText.text = "v${data.versionName}"
+        binding.ruleVersionText.text = data.ruleVersion
+        binding.ruleUpdateText.text = data.ruleUpdate
+
         val values = context.resources.getStringArray(R.array.update_channel_values)
         val texts = context.resources.getStringArray(R.array.update_channel_texts)
-        val channelIndex = values.indexOf(channelValue).coerceAtLeast(0)
+        val channelIndex = values.indexOf(data.channelValue).coerceAtLeast(0)
         binding.channelText.text =
-            texts.getOrElse(channelIndex) { texts.firstOrNull() ?: channelValue }
-    }
-
-    /**
-     * 更新第三、四行：规则版本与规则更新时间
-     */
-    private fun updateRuleTexts() {
-        binding.ruleVersionText.text = PrefManager.ruleVersion
-        binding.ruleUpdateText.text = PrefManager.ruleUpdate
+            texts.getOrElse(channelIndex) { texts.firstOrNull() ?: data.channelValue }
     }
 
     private fun setActive(