Support dynamic referenced values

backend/codegen/src/main/kotlin/net/mamoe/mirai/console/codegen/SettingValueUseSiteCodegen.kt

@@ -21,11 +21,13 @@ fun main() {
     }.writeText(buildString {
         appendln(COPYRIGHT)
         appendln()
+        appendln(FILE_SUPPRESS)
+        appendln()
         appendln(PACKAGE)
         appendln()
-        // appendln(IMPORTS)
-        // appendln()
-        // appendln()
+        appendln(IMPORTS)
+        appendln()
+        appendln()
         appendln(DO_NOT_MODIFY)
         appendln()
         appendln()
@@ -44,8 +46,12 @@ private val PACKAGE = """
 package net.mamoe.mirai.console.setting
 """.trimIndent()
 
+private val FILE_SUPPRESS = """
+@file:Suppress("INVISIBLE_REFERENCE", "INVISIBLE_MEMBER", "unused")
+""".trimIndent()
 private val IMPORTS = """
-import kotlinx.serialization.builtins.*
+import net.mamoe.mirai.console.setting.internal.valueImpl
+import kotlin.internal.LowPriorityInOverloadResolution
 """.trimIndent()
 
 fun genAllValueUseSite(): String = buildString {
@@ -111,6 +117,26 @@ fun genAllValueUseSite(): String = buildString {
 
             @JvmName("valueMutable")
             inline fun <reified T : Setting> Setting.value(default: MutableSet<T>): MutableSettingSetValue<T> = valueImpl(default)
+            
+            /**
+             * 创建一个只引用对象而不跟踪其属性的值.
+             *
+             * @param T 类型. 必须拥有 [kotlinx.serialization.Serializable] 注解 (因此编译器会自动生成序列化器)
+             */
+            @DangerousReferenceOnlyValue
+            @JvmName("valueDynamic")
+            @LowPriorityInOverloadResolution
+            inline fun <reified T : Any> Setting.value(default: T): Value<T> = valueImpl(default)
+            
+            @RequiresOptIn(
+                ""${'"'}
+                这种只保存引用的 Value 可能会导致意料之外的结果, 在使用时须保持谨慎.
+                对值的改变不会触发自动保存, 也不会同步到 UI 中. 在 UI 中只能编辑序列化之后的值.
+            ""${'"'}, level = RequiresOptIn.Level.WARNING
+            )
+            @Retention(AnnotationRetention.BINARY)
+            @Target(AnnotationTarget.FUNCTION)
+            annotation class DangerousReferenceOnlyValue
         """
     )
 }

backend/mirai-console/src/main/kotlin/net/mamoe/mirai/console/setting/_Setting.kt

@@ -7,10 +7,13 @@
  * https://github.com/mamoe/mirai/blob/master/LICENSE
  */
 
+@file:Suppress("INVISIBLE_REFERENCE", "INVISIBLE_MEMBER", "unused")
 
 package net.mamoe.mirai.console.setting
 
 import net.mamoe.mirai.console.setting.internal.valueImpl
+import kotlin.internal.LowPriorityInOverloadResolution
+
 
 /**
  * !!! This file is auto-generated by backend/codegen/src/kotlin/net.mamoe.mirai.console.codegen.SettingValueUseSiteCodegen.kt
@@ -138,3 +141,23 @@ inline fun <reified T : Setting> Setting.value(default: Set<T>): SettingSetValue
 @JvmName("valueMutable")
 inline fun <reified T : Setting> Setting.value(default: MutableSet<T>): MutableSettingSetValue<T> = valueImpl(default)
 
+/**
+ * 创建一个只引用对象而不跟踪其属性的值.
+ *
+ * @param T 类型. 必须拥有 [kotlinx.serialization.Serializable] 注解 (因此编译器会自动生成序列化器)
+ */
+@DangerousReferenceOnlyValue
+@JvmName("valueDynamic")
+@LowPriorityInOverloadResolution
+inline fun <reified T : Any> Setting.value(default: T): Value<T> = valueImpl(default)
+
+@RequiresOptIn(
+    """
+    这种只保存引用的 Value 可能会导致意料之外的结果, 在使用时须保持谨慎.
+    对值的改变不会触发自动保存, 也不会同步到 UI 中. 在 UI 中只能编辑序列化之后的值.
+""", level = RequiresOptIn.Level.WARNING
+)
+@Retention(AnnotationRetention.BINARY)
+@Target(AnnotationTarget.FUNCTION)
+annotation class DangerousReferenceOnlyValue
+

backend/mirai-console/src/main/kotlin/net/mamoe/mirai/console/setting/internal/internalValueImpl.kt

@@ -6,6 +6,7 @@
  *
  * https://github.com/mamoe/mirai/blob/master/LICENSE
  */
+@file:Suppress("INVISIBLE_REFERENCE", "INVISIBLE_MEMBER")
 
 package net.mamoe.mirai.console.setting.internal
 
@@ -14,6 +15,7 @@ import kotlinx.serialization.builtins.ListSerializer
 import kotlinx.serialization.builtins.SetSerializer
 import net.mamoe.mirai.console.setting.*
 import net.mamoe.yamlkt.YamlDynamicSerializer
+import kotlin.internal.LowPriorityInOverloadResolution
 import kotlin.reflect.KClass
 import kotlin.reflect.full.createInstance
 
@@ -290,6 +292,7 @@ internal fun <T : Any> Setting.valueImpl(
  * For primitives and serializable only
  */
 @PublishedApi
+@LowPriorityInOverloadResolution
 internal inline fun <reified T : Any> Setting.valueImpl(default: T): Value<T> =
     valueImpl(default, T::class)