feat: support mihomo/clash.meta/flclashx install-config intent

whalechoi · whalechoi · commit 3f1b7b05f4f3 · 2026-05-28T16:24:34.000+08:00
diff --git a/app/build.gradle.kts b/app/build.gradle.kts
@@ -116,7 +116,7 @@ dependencies {
     implementation(libs.miuix.navigation3.ui)
     implementation(libs.miuix.preference)
     implementation(libs.reorderable)
-    implementation(libs.snakeyaml)
+    implementation(libs.snakeyaml.engine)
     implementation(libs.zxing.android.embedded)
     ksp(libs.androidx.room.compiler)
 }
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
@@ -42,6 +42,26 @@
                     android:host="install-config"
                     android:scheme="v2rayng" />
             </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+
+                <data
+                    android:host="install-config"
+                    android:scheme="clashmeta" />
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+
+                <data
+                    android:host="install-config"
+                    android:scheme="flclashx" />
+            </intent-filter>
         </activity>
 
         <activity-alias
diff --git a/app/src/main/assets/aboutlibraries.json b/app/src/main/assets/aboutlibraries.json
@@ -248,13 +248,13 @@
             ]
         },
         {
-            "uniqueId": "org.yaml:snakeyaml",
-            "artifactVersion": "2.6",
-            "name": "SnakeYAML",
-            "description": "YAML 1.1 parser and emitter for Java",
-            "website": "https://bitbucket.org/snakeyaml/snakeyaml",
+            "uniqueId": "org.snakeyaml:snakeyaml-engine",
+            "artifactVersion": "3.0.1",
+            "name": "SnakeYAML Engine",
+            "description": "Core YAML 1.2 parser and emitter for Java",
+            "website": "https://bitbucket.org/snakeyaml/snakeyaml-engine",
             "scm": {
-                "url": "https://bitbucket.org/snakeyaml/snakeyaml/src"
+                "url": "https://bitbucket.org/snakeyaml/snakeyaml-engine/src"
             },
             "licenses": [
                 "Apache-2.0"
diff --git a/app/src/main/kotlin/app/MainActivity.kt b/app/src/main/kotlin/app/MainActivity.kt
@@ -20,8 +20,8 @@ import features.proxy.server.qr.AndroidQrCodeScanRequester
 import features.resources.runtime.AndroidResourceFilePicker
 import features.subscription.SubscriptionFetchUseCase
 import features.subscription.SubscriptionInstallConfigUseCase
-import features.subscription.isV2rayNgInstallConfigUri
-import features.subscription.toV2rayNgInstallConfigOrNull
+import features.subscription.isSubscriptionInstallConfigUri
+import features.subscription.toSubscriptionInstallConfigOrNull
 import features.subscription.usecase.subscriptionUpdateMessage
 import kotlinx.coroutines.launch
 import ui.feedback.AndroidToastTipNotifier
@@ -163,8 +163,8 @@ class MainActivity : ComponentActivity() {
 
     private fun handleExternalIntent(intent: Intent?) {
         val data = intent?.data ?: return
-        if (!data.isV2rayNgInstallConfigUri()) return
-        val config = intent.toV2rayNgInstallConfigOrNull()
+        if (!data.isSubscriptionInstallConfigUri()) return
+        val config = intent.toSubscriptionInstallConfigOrNull()
         if (config == null) {
             (application as AsteriskApplication).appScope.launch {
                 tipNotifier.show(getString(R.string.subscription_install_config_invalid))
diff --git a/app/src/main/kotlin/features/proxy/server/list/ProxyServerListTopBar.kt b/app/src/main/kotlin/features/proxy/server/list/ProxyServerListTopBar.kt
@@ -29,9 +29,11 @@ import features.proxy.server.usecase.withImportedProxyServers
 import features.proxy.server.usecase.withUpdatedSubscriptionServers
 import features.subscription.DefaultSubscriptionGroupId
 import features.subscription.SubscriptionFetchUseCase
+import features.subscription.SubscriptionInstallConfigUseCase
 import features.subscription.usecase.subscriptionUpdateMessage
 import features.subscription.usecase.toSubscriptionFetchOptions
 import features.subscription.usecase.updateSubscriptions
+import features.subscription.toSubscriptionInstallConfigOrNull
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.launch
 import top.yukonga.miuix.kmp.basic.ScrollBehavior
@@ -77,10 +79,12 @@ internal fun ProxyServerListTopBar(
                     action = action,
                     groupState = groupState,
                     proxyListState = proxyListState,
+                    stateStore = stateStore,
                     updateAppState = updateAppState,
                     navigator = navigator,
                     qrScanner = qrScanner,
                     proxyServerImportFileUseCase = proxyServerImportFileUseCase,
+                    subscriptionFetchUseCase = subscriptionFetchUseCase,
                     clipboard = clipboard,
                     tipNotifier = tipNotifier,
                     scope = scope,
@@ -134,10 +138,12 @@ private fun handleProxyServerListAddAction(
     action: ProxyServerListAddAction,
     groupState: ProxyServerListGroups,
     proxyListState: ProxyServerListState,
+    stateStore: AndroidAppStateStore,
     updateAppState: ((AppState) -> AppState) -> Unit,
     navigator: Navigator,
     qrScanner: ProxyServerQrScanUseCase,
     proxyServerImportFileUseCase: ProxyServerImportFileUseCase,
+    subscriptionFetchUseCase: SubscriptionFetchUseCase,
     clipboard: Clipboard,
     tipNotifier: AndroidToastTipNotifier,
     scope: CoroutineScope,
@@ -150,6 +156,17 @@ private fun handleProxyServerListAddAction(
                 runCatching { qrScanner.scan() }
                     .onSuccess { scanText ->
                         if (scanText.isNullOrBlank()) return@onSuccess
+                        if (
+                            installSubscriptionFromQrCode(
+                                text = scanText,
+                                stateStore = stateStore,
+                                subscriptionFetchUseCase = subscriptionFetchUseCase,
+                                tipNotifier = tipNotifier,
+                                messages = messages,
+                            )
+                        ) {
+                            return@onSuccess
+                        }
                         importProxyServers(
                             text = scanText,
                             source = ProxyServerImportSource.QrCode,
@@ -213,6 +230,33 @@ private fun handleProxyServerListAddAction(
     }
 }
 
+private suspend fun installSubscriptionFromQrCode(
+    text: String,
+    stateStore: AndroidAppStateStore,
+    subscriptionFetchUseCase: SubscriptionFetchUseCase,
+    tipNotifier: AndroidToastTipNotifier,
+    messages: ProxyServerListMessages,
+): Boolean {
+    val config = text.toSubscriptionInstallConfigOrNull() ?: return false
+    runCatching {
+        SubscriptionInstallConfigUseCase(
+            stateStore = stateStore,
+            subscriptionFetchUseCase = subscriptionFetchUseCase,
+        ).install(config)
+    }.onSuccess { result ->
+        tipNotifier.show(
+            subscriptionUpdateMessage(
+                result = result,
+                successTemplate = messages.subscriptionUpdateResultTemplate,
+                failedTemplate = messages.subscriptionUpdateResultWithFailedTemplate,
+            ),
+        )
+    }.onFailure { error ->
+        tipNotifier.showError(error)
+    }
+    return true
+}
+
 private suspend fun importProxyServers(
     text: String,
     source: ProxyServerImportSource,
diff --git a/app/src/main/kotlin/features/proxy/server/usecase/importer/ProxyServerMihomoV2RayCommon.kt b/app/src/main/kotlin/features/proxy/server/usecase/importer/ProxyServerMihomoV2RayCommon.kt
@@ -78,10 +78,6 @@ private fun MihomoYamlMap.ensureNoUnsupportedV2RayTlsOptions() {
             unsupported("ECH query-server-name is not supported")
         }
     }
-    val realityOpts = map("reality-opts")
-    if (realityOpts?.boolean("support-x25519mlkem768") == true) {
-        unsupported("Reality X25519-MLKEM768 is not supported")
-    }
 }
 
 private fun MihomoYamlMap.ensureNoUnsupportedWsHeaders() {
diff --git a/app/src/main/kotlin/features/proxy/server/usecase/importer/ProxyServerMihomoVlessImport.kt b/app/src/main/kotlin/features/proxy/server/usecase/importer/ProxyServerMihomoVlessImport.kt
@@ -202,9 +202,6 @@ private fun JsonObjectBuilder.putXrayRealitySettings(
     fallback: MihomoYamlMap,
 ) {
     val realityOpts = primary.map("reality-opts") ?: fallback.map("reality-opts") ?: emptyMap()
-    if (realityOpts.boolean("support-x25519mlkem768") == true) {
-        unsupported("Reality X25519-MLKEM768 is not supported")
-    }
     putStringIfNotBlank("serverName", primary.string("servername", "sni") ?: fallback.string("servername", "sni"))
     putStringIfNotBlank(
         "fingerprint",
diff --git a/app/src/main/kotlin/features/proxy/server/usecase/importer/ProxyServerMihomoYamlImport.kt b/app/src/main/kotlin/features/proxy/server/usecase/importer/ProxyServerMihomoYamlImport.kt
@@ -5,9 +5,8 @@ import features.proxy.server.model.ProxyServer
 import features.proxy.server.usecase.EmptyProxyServerImportResult
 import features.proxy.server.usecase.ProxyServerImportResult
 import features.proxy.server.usecase.ProxyServerImportSource
-import org.yaml.snakeyaml.LoaderOptions
-import org.yaml.snakeyaml.Yaml
-import org.yaml.snakeyaml.constructor.SafeConstructor
+import org.snakeyaml.engine.v2.api.Load
+import org.snakeyaml.engine.v2.api.LoadSettings
 
 private const val LogTag = "ProxyServerMihomoYamlImport"
 
@@ -16,7 +15,13 @@ internal fun parseProxyServersFromMihomoYamlConfig(
     source: ProxyServerImportSource,
 ): ProxyServerImportResult {
     val root = runCatching {
-        newMihomoYamlParser().load<Any?>(text.trimStart(ImportByteOrderMark))
+        newMihomoYamlParser().loadFromString(text.trimStart(ImportByteOrderMark))
+    }.onFailure { error ->
+        AndroidAppLogger.warn(
+            LogTag,
+            "Failed to parse ${source.logName} as mihomo YAML",
+            error,
+        )
     }.getOrNull() ?: return EmptyProxyServerImportResult
     val configs = root.mihomoProxyConfigs()
     if (configs.isEmpty()) {
@@ -129,8 +134,8 @@ private fun skippedMessage(
         "type=${type.ifBlank { "<blank>" }} name=${name.ifBlank { "<blank>" }} reason=$reason"
 }
 
-private fun newMihomoYamlParser(): Yaml {
-    return Yaml(SafeConstructor(LoaderOptions()))
+private fun newMihomoYamlParser(): Load {
+    return Load(LoadSettings.builder().build())
 }
 
 private val SupportedMihomoProxyTypes = setOf(
diff --git a/app/src/main/kotlin/features/subscription/SubscriptionDefaults.kt b/app/src/main/kotlin/features/subscription/SubscriptionDefaults.kt
@@ -2,5 +2,7 @@ package features.subscription
 
 const val DefaultSubscriptionGroupId = 1
 const val DefaultSubscriptionUserAgent = "v2rayNG/2.2.0"
+const val ClashMetaSubscriptionUserAgent = "clash.meta"
+const val FlClashXSubscriptionUserAgent = "FlClash X/v0.4.0-pre.12 Platform/android"
 const val AutoSubscriptionCheckIntervalMillis = 60L * 1000L
 const val AutoSubscriptionRetryDelayMillis = 15L * 60L * 1000L
diff --git a/app/src/main/kotlin/features/subscription/SubscriptionInstallConfigUseCase.kt b/app/src/main/kotlin/features/subscription/SubscriptionInstallConfigUseCase.kt
@@ -11,16 +11,17 @@ import features.proxy.server.usecase.withUpdatedSubscriptionServers
 import features.subscription.usecase.toSubscriptionFetchOptions
 import features.subscription.usecase.updateSubscriptions
 
-internal data class V2rayNgInstallConfig(
+internal data class SubscriptionInstallConfig(
     val name: String,
     val url: String,
+    val userAgent: String,
 )
 
 internal class SubscriptionInstallConfigUseCase(
     private val stateStore: AndroidAppStateStore,
     private val subscriptionFetchUseCase: SubscriptionFetchUseCase,
 ) {
-    suspend fun install(config: V2rayNgInstallConfig): ProxyServerListSubscriptionUpdateResult {
+    suspend fun install(config: SubscriptionInstallConfig): ProxyServerListSubscriptionUpdateResult {
         val group = stateStore.addSubscriptionGroup(config)
         val result = updateSubscriptions(
             groups = listOf(group),
@@ -39,29 +40,37 @@ internal class SubscriptionInstallConfigUseCase(
     }
 }
 
-internal fun Intent.toV2rayNgInstallConfigOrNull(): V2rayNgInstallConfig? {
+internal fun Intent.toSubscriptionInstallConfigOrNull(): SubscriptionInstallConfig? {
     if (action != Intent.ACTION_VIEW) return null
-    return data?.toV2rayNgInstallConfigOrNull()
+    return data?.toSubscriptionInstallConfigOrNull()
 }
 
-internal fun Uri.isV2rayNgInstallConfigUri(): Boolean {
-    return scheme.equals(V2rayNgScheme, ignoreCase = true) &&
+internal fun String.toSubscriptionInstallConfigOrNull(): SubscriptionInstallConfig? {
+    val uri = runCatching { trim().toUri() }.getOrNull() ?: return null
+    return uri.toSubscriptionInstallConfigOrNull()
+}
+
+internal fun Uri.isSubscriptionInstallConfigUri(): Boolean {
+    return installConfigSource() != null &&
         isHierarchical &&
-        host.equals(V2rayNgInstallConfigHost, ignoreCase = true)
+        host.equals(InstallConfigHost, ignoreCase = true)
 }
 
-private fun Uri.toV2rayNgInstallConfigOrNull(): V2rayNgInstallConfig? {
-    if (!isV2rayNgInstallConfigUri()) return null
+internal fun Uri.toSubscriptionInstallConfigOrNull(): SubscriptionInstallConfig? {
+    val source = installConfigSource() ?: return null
+    if (!isHierarchical || !host.equals(InstallConfigHost, ignoreCase = true)) return null
     val name = getQueryParameter("name")?.trim().orEmpty()
+        .ifBlank { source.defaultName.orEmpty() }
     val url = getQueryParameter("url")?.trim().orEmpty()
     if (name.isBlank() || !url.isValidSubscriptionUrl()) return null
-    return V2rayNgInstallConfig(
+    return SubscriptionInstallConfig(
         name = name,
         url = url,
+        userAgent = source.userAgent,
     )
 }
 
-private fun AndroidAppStateStore.addSubscriptionGroup(config: V2rayNgInstallConfig): SubscriptionGroupState {
+private fun AndroidAppStateStore.addSubscriptionGroup(config: SubscriptionInstallConfig): SubscriptionGroupState {
     var savedGroup: SubscriptionGroupState? = null
     update { state ->
         val group = state.newSubscriptionGroup(config)
@@ -74,12 +83,12 @@ private fun AndroidAppStateStore.addSubscriptionGroup(config: V2rayNgInstallConf
     return checkNotNull(savedGroup)
 }
 
-private fun AppState.newSubscriptionGroup(config: V2rayNgInstallConfig): SubscriptionGroupState {
+private fun AppState.newSubscriptionGroup(config: SubscriptionInstallConfig): SubscriptionGroupState {
     return SubscriptionGroupState(
         id = nextSubscriptionGroupId,
         name = config.name,
         url = config.url,
-        userAgent = DefaultSubscriptionUserAgent,
+        userAgent = config.userAgent,
         updateInterval = "",
         updateViaProxy = false,
         enabled = true,
@@ -94,6 +103,26 @@ private fun String.isValidSubscriptionUrl(): Boolean {
         uri.host?.isNotBlank() == true
 }
 
-private const val V2rayNgScheme = "v2rayng"
-private const val V2rayNgInstallConfigHost = "install-config"
+private enum class InstallConfigSource(
+    val scheme: String,
+    val userAgent: String,
+    val defaultName: String? = null,
+) {
+    V2rayNg(scheme = "v2rayng", userAgent = DefaultSubscriptionUserAgent),
+    ClashMeta(scheme = "clashmeta", userAgent = ClashMetaSubscriptionUserAgent),
+    FlClashX(
+        scheme = "flclashx",
+        userAgent = FlClashXSubscriptionUserAgent,
+        defaultName = "clashsub",
+    ),
+}
+
+private fun Uri.installConfigSource(): InstallConfigSource? {
+    val uriScheme = scheme ?: return null
+    return InstallConfigSource.entries.firstOrNull { source ->
+        source.scheme.equals(uriScheme, ignoreCase = true)
+    }
+}
+
+private const val InstallConfigHost = "install-config"
 private val SubscriptionUrlSchemes = setOf("http", "https")
diff --git a/app/src/main/kotlin/features/subscription/usecase/SubscriptionUpdateUseCase.kt b/app/src/main/kotlin/features/subscription/usecase/SubscriptionUpdateUseCase.kt
diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml

Original file line number	Diff line number	Diff line change
`@@ -116,7 +116,7 @@ dependencies {`
`116`	`116`	`implementation(libs.miuix.navigation3.ui)`
`117`	`117`	`implementation(libs.miuix.preference)`
`118`	`118`	`implementation(libs.reorderable)`
`119`		`- implementation(libs.snakeyaml)`
	`119`	`+ implementation(libs.snakeyaml.engine)`
`120`	`120`	`implementation(libs.zxing.android.embedded)`
`121`	`121`	`ksp(libs.androidx.room.compiler)`
`122`	`122`	`}`
Original file line number	Diff line number	Diff line change
`@@ -78,10 +78,6 @@ private fun MihomoYamlMap.ensureNoUnsupportedV2RayTlsOptions() {`
`78`	`78`	`unsupported("ECH query-server-name is not supported")`
`79`	`79`	`}`
`80`	`80`	`}`
`81`		`- val realityOpts = map("reality-opts")`
`82`		`- if (realityOpts?.boolean("support-x25519mlkem768") == true) {`
`83`		`- unsupported("Reality X25519-MLKEM768 is not supported")`
`84`		`- }`
`85`	`81`	`}`
`86`	`82`
`87`	`83`	`private fun MihomoYamlMap.ensureNoUnsupportedWsHeaders() {`