feat(主页): 新语法 - 随机文本块

Author: MovTery

ZalithLauncher/src/main/assets/home_page/doc_page_en.md

@@ -15,6 +15,27 @@ In addition to standard Markdown, you can also use the following extension compo
 
 ---
 
+### Random Text Block
+Place multiple text segments within a block. When the homepage loads, one of the segments will be randomly displayed.
+
+**Syntax**  
+...random-start
+This is a piece of text, weight defaults to 1.0
+weight(2.0): This is the second piece of text, weight is set to 2.0
+This is the third piece of text
+...random-end
+
+**Parameter description:**
+- Unlike other components, this component uses inline parameters, embedded directly at the beginning of the actual value line.
+- `weight`:
+    - Specifies the weight value for this piece of text. Supports integers and decimals. Optional.
+    - The homepage will randomly select a piece of text according to the weights.
+
+> This component is only supported within standard Markdown.
+> This component will NOT take effect inside standard Markdown containers or other extension components.
+
+---
+
 ### Card Component
 Used to wrap content inside a container with a background and rounded corners.
 

ZalithLauncher/src/main/assets/home_page/doc_page_zh.md

@@ -15,6 +15,27 @@
 
 ---
 
+### 随机文本块
+在一个区块内填入多段文本，主页在加载时，将随机显示其中的一段文本
+
+**语法**  
+...random-start
+这是一段文本，权重默认为 1.0
+weight(2.0): 这是第二段文本，权重被配置为 2.0
+这是第三段文本
+...random-end
+
+**参数说明：**
+- 与其他组件不同，该组件的参数为内嵌参数，直接嵌入到实际值行首
+- `weight`: 
+  - 可填写该段文本的具体的权重值，支持整数、小数，可选
+  - 主页将按权重随机抽取文本
+
+> 该组件仅支持在基础的 Markdown 内使用
+> 该组件不会生效于标准 Markdown 容器或其他扩展组件内
+
+---
+
 ### 卡片组件
 用于将内容包裹在一个有背景和圆角的容器中
 

ZalithLauncher/src/main/java/com/movtery/zalithlauncher/ui/screens/main/custom_home/CustomHome.kt

@@ -40,6 +40,7 @@ import com.halilibo.richtext.ui.RichTextStyle
 import com.movtery.zalithlauncher.ui.components.MarkdownView
 import com.movtery.zalithlauncher.ui.components.defaultRichTextStyle
 import com.movtery.zalithlauncher.ui.theme.itemColor
+import kotlin.random.Random
 
 fun LazyListScope.customHomePage(
     blocks: List<MarkdownBlock>,
@@ -399,17 +400,19 @@ private fun parseMarkdownBlocksInternal(
         if (match == null) {
             //没有更多匹配，添加剩余内容
             val remaining = cleared.substring(lastIndex).trim('\n')
-            if (remaining.isNotEmpty()) {
-                blocks.add(MarkdownBlock.Normal(astNode = parseMarkdown(remaining)))
+            val processedRemaining = processRandomBlocksInText(remaining)
+            if (processedRemaining.isNotEmpty()) {
+                blocks.add(MarkdownBlock.Normal(astNode = parseMarkdown(processedRemaining)))
             }
             break
         }
 
         //处理匹配项之前的普通文本
         if (match.range.first > lastIndex) {
             val text = cleared.substring(lastIndex, match.range.first).trim('\n')
-            if (text.isNotEmpty()) {
-                blocks.add(MarkdownBlock.Normal(astNode = parseMarkdown(text)))
+            val processedText = processRandomBlocksInText(text)
+            if (processedText.isNotEmpty()) {
+                blocks.add(MarkdownBlock.Normal(astNode = parseMarkdown(processedText)))
             }
         }
 
@@ -793,4 +796,101 @@ private fun parseWeight(params: String): Pair<Float, Boolean>? {
     val weight = match.groupValues[1].toFloatOrNull() ?: return null
     val fill = match.groupValues[2] != "noFill"
     return Pair(weight, fill)
+}
+
+private const val randomStartTag = "...random-start"
+private const val randomEndTag = "...random-end"
+private val randomOptionRegex = Regex("""^weight\((\d+(?:\.\d+)?)\)\s*:\s*(.*)$""")
+
+private data class RandomOption(
+    val text: String,
+    val weight: Double
+)
+
+/**
+ * 处理文本中的随机文本块，自动将其替换为随机选中的文本
+ * 语法：
+ * ```
+ * ...random-start
+ * weight(N): 文本内容
+ * 默认权重的文本内容
+ * ...random-end
+ * ```
+ * - 以 `weight(N): ` 开头可指定权重，否则权重默认为 1
+ * - 随机抽取后的结果中不包含换行符
+ */
+private fun processRandomBlocksInText(text: String): String {
+    if (!text.contains(randomStartTag)) return text
+
+    val lines = text.lines()
+    val result = mutableListOf<String>()
+    var inRandomBlock = false
+    var randomStartLine: String? = null
+    val randomLines = mutableListOf<String>()
+
+    for (line in lines) {
+        val trimmed = line.trimStart()
+
+        if (inRandomBlock) {
+            if (trimmed.startsWith(randomEndTag)) {
+                val selected = pickRandomText(randomLines)
+                result.add(selected)
+                randomLines.clear()
+                inRandomBlock = false
+                randomStartLine = null
+            } else {
+                randomLines.add(line)
+            }
+        } else {
+            if (trimmed.startsWith(randomStartTag)) {
+                inRandomBlock = true
+                randomStartLine = line
+            } else {
+                result.add(line)
+            }
+        }
+    }
+
+    //如果文本结束但随机块未闭合，则忽略此随机文本块
+    if (inRandomBlock) {
+        randomStartLine?.let { result.add(it) }
+        result.addAll(randomLines)
+    }
+
+    return result.joinToString("\n")
+}
+
+/**
+ * 从随机文本候选项中根据权重抽取一个文本
+ */
+private fun pickRandomText(lines: List<String>): String {
+    val options = lines.mapNotNull { line ->
+        val trimmed = line.trim()
+        if (trimmed.isEmpty()) return@mapNotNull null
+
+        //读取权重值
+        val match = randomOptionRegex.find(trimmed)
+        if (match != null) {
+            val weight = match.groupValues[1].toDoubleOrNull() ?: 1.0
+            val text = match.groupValues[2]
+            RandomOption(text, weight)
+        } else {
+            //未配置权重时，默认为 1
+            RandomOption(trimmed, 1.0)
+        }
+    }
+
+    if (options.isEmpty()) return ""
+
+    val totalWeight = options.sumOf { it.weight }
+    var randomValue = Random.nextDouble() * totalWeight
+
+    for (option in options) {
+        randomValue -= option.weight
+        if (randomValue <= 0) {
+            return option.text
+        }
+    }
+
+    return options.last().text
 }