Add plugin-specific Chinese console banners

Author: 54895y

src/main/kotlin/com/y54895/matrixlib/MatrixLib.kt

@@ -11,16 +11,16 @@ object MatrixLib : Plugin() {
     val branding = MatrixBranding(
         displayName = "MatrixLib",
         rootCommand = "/matrixlib",
-        runtimeName = "Matrix shared service bus"
+        runtimeName = "MatrixLib 共享运行时"
     )
 
     override fun onLoad() {
         MatrixConsoleVisuals.renderBoot(
             branding = branding,
-            headline = "Loading shared Matrix runtime",
+            headline = "正在装载共享接口与运行时桥接",
             details = listOf(
-                MatrixConsoleFact("Exports", "action / menu / compat / text / yaml / console"),
-                MatrixConsoleFact("Usage", "Required by MatrixShop, MatrixAuth, MatrixCook")
+                MatrixConsoleFact("导出接口", "action / menu / compat / text / yaml / console"),
+                MatrixConsoleFact("服务对象", "MatrixShop / MatrixAuth / MatrixCook")
             )
         )
     }
@@ -30,8 +30,8 @@ object MatrixLib : Plugin() {
             branding = branding,
             version = pluginVersion,
             details = listOf(
-                MatrixConsoleFact("API", "Action, menu, compat, text, yaml"),
-                MatrixConsoleFact("Runtime", "Console visuals and resource bridge")
+                MatrixConsoleFact("共享接口", "action / menu / compat / text / yaml / console"),
+                MatrixConsoleFact("运行状态", "控制台品牌 / 资源桥接 / 通用适配")
             )
         )
     }
@@ -40,7 +40,7 @@ object MatrixLib : Plugin() {
         MatrixConsoleVisuals.renderShutdown(
             branding = branding,
             details = listOf(
-                MatrixConsoleFact("State", "Shared runtime offline")
+                MatrixConsoleFact("运行状态", "共享运行时已离线")
             )
         )
     }

src/main/kotlin/com/y54895/matrixlib/api/brand/MatrixBranding.kt

@@ -6,5 +6,6 @@ data class MatrixBranding(
     val adminCommand: String? = null,
     val runtimeName: String = displayName,
     val accentColor: String = "&b",
-    val neutralColor: String = "&7"
+    val neutralColor: String = "&7",
+    val bannerTitle: String = displayName
 )

src/main/kotlin/com/y54895/matrixlib/api/console/MatrixConsoleVisuals.kt

@@ -12,15 +12,8 @@ data class MatrixConsoleFact(
 
 object MatrixConsoleVisuals {
 
-    private const val BORDER = "&8&m+------------------------------------------------------------------+"
-
-    private val logo = listOf(
-        "&3 __  __       _        _        __  __       _        _      ",
-        "&b|  \\/  | __ _| |_ _ __(_)_  __ |  \\/  | __ _| |_ _ __(_)_  __",
-        "&b| |\\/| |/ _` | __| '__| \\ \\/ / | |\\/| |/ _` | __| '__| \\ \\/ /",
-        "&9| |  | | (_| | |_| |  | |>  <  | |  | | (_| | |_| |  | |>  < ",
-        "&9|_|  |_|\\__,_|\\__|_|  |_/_/\\_\\ |_|  |_|\\__,_|\\__|_|  |_/_/\\_\\"
-    )
+    private const val MIN_BORDER_WIDTH = 66
+    private val colorCodePattern = Regex("&[0-9a-fk-orA-FK-OR]")
 
     fun renderBoot(
         branding: MatrixBranding,
@@ -59,8 +52,8 @@ object MatrixConsoleVisuals {
         renderBlock(
             branding = branding,
             stage = "READY",
-            headline = "${branding.runtimeName} online",
-            details = listOf(MatrixConsoleFact("Version", version)) + defaultDetails(branding) + details,
+            headline = "${branding.runtimeName} 已就绪",
+            details = listOf(MatrixConsoleFact("版本", version)) + defaultDetails(branding) + details,
             trailingBlank = true
         )
     }
@@ -72,8 +65,8 @@ object MatrixConsoleVisuals {
         renderBlock(
             branding = branding,
             stage = "FAIL",
-            headline = "${branding.runtimeName} startup aborted",
-            details = listOf(MatrixConsoleFact("Reason", reason))
+            headline = "${branding.runtimeName} 启动失败",
+            details = listOf(MatrixConsoleFact("原因", reason))
         )
     }
 
@@ -84,7 +77,7 @@ object MatrixConsoleVisuals {
         renderBlock(
             branding = branding,
             stage = "STOP",
-            headline = "${branding.runtimeName} shutting down",
+            headline = "${branding.runtimeName} 正在卸载",
             details = details,
             leadingBlank = true
         )
@@ -99,28 +92,31 @@ object MatrixConsoleVisuals {
         leadingBlank: Boolean = false,
         trailingBlank: Boolean = false
     ) {
+        val contentLines = mutableListOf<String>()
+        if (includeLogo) {
+            contentLines += MatrixAsciiBanner.render(branding.bannerTitle)
+            contentLines += stageLine(branding, "INFO", branding.runtimeName)
+        }
+        contentLines += stageLine(branding, stage, headline)
+        details.forEach { contentLines += detailLine(branding, it) }
+
+        val border = border(contentLines)
         val lines = mutableListOf<String>()
         if (leadingBlank) {
             lines += ""
         }
-        lines += BORDER
-        if (includeLogo) {
-            lines += logo
-            lines += stageLine(branding, "INFO", branding.runtimeName)
-            lines += BORDER
-        }
-        lines += stageLine(branding, stage, headline)
-        details.forEach { lines += detailLine(branding, it) }
-        lines += BORDER
+        lines += border
+        contentLines.forEach { lines += it }
+        lines += border
         if (trailingBlank) {
             lines += ""
         }
         send(lines)
     }
 
     private fun defaultDetails(branding: MatrixBranding): List<MatrixConsoleFact> {
-        val details = mutableListOf(MatrixConsoleFact("Command", branding.rootCommand))
-        branding.adminCommand?.let { details += MatrixConsoleFact("Admin", it) }
+        val details = mutableListOf(MatrixConsoleFact("主命令", branding.rootCommand))
+        branding.adminCommand?.let { details += MatrixConsoleFact("管理命令", it) }
         return details
     }
 
@@ -131,7 +127,7 @@ object MatrixConsoleVisuals {
             "FAIL", "STOP" -> "&c"
             else -> branding.accentColor
         }
-        return "${prefix(branding)}$color[$stage] &f$headline"
+        return "${prefix(branding)}$color[${stageLabel(stage)}] &f$headline"
     }
 
     private fun detailLine(branding: MatrixBranding, fact: MatrixConsoleFact): String {
@@ -142,6 +138,27 @@ object MatrixConsoleVisuals {
         return "&8[${branding.accentColor}${branding.displayName}&8] "
     }
 
+    private fun stageLabel(stage: String): String {
+        return when (stage.uppercase()) {
+            "INFO" -> "信息"
+            "LOAD" -> "加载"
+            "INIT" -> "初始化"
+            "READY" -> "就绪"
+            "FAIL" -> "失败"
+            "STOP" -> "卸载"
+            else -> stage
+        }
+    }
+
+    private fun border(lines: List<String>): String {
+        val width = maxOf(MIN_BORDER_WIDTH, lines.maxOfOrNull(::visibleLength) ?: MIN_BORDER_WIDTH)
+        return "&8&m+${"-".repeat(width)}+"
+    }
+
+    private fun visibleLength(line: String): Int {
+        return colorCodePattern.replace(line, "").length
+    }
+
     private fun send(lines: List<String>) {
         lines.forEach { line ->
             val rendered = MatrixText.color(line)
@@ -153,3 +170,46 @@ object MatrixConsoleVisuals {
         }
     }
 }
+
+private object MatrixAsciiBanner {
+
+    private val rowColors = listOf("&3", "&b", "&b", "&9", "&9")
+
+    private val glyphs = mapOf(
+        ' ' to listOf("     ", "     ", "     ", "     ", "     "),
+        '?' to listOf("?????", "   ? ", "  ?  ", "     ", "  ?  "),
+        'A' to listOf("  A  ", " A A ", "AAAAA", "A   A", "A   A"),
+        'B' to listOf("BBBB ", "B   B", "BBBB ", "B   B", "BBBB "),
+        'C' to listOf(" CCC ", "C   C", "C    ", "C   C", " CCC "),
+        'H' to listOf("H   H", "H   H", "HHHHH", "H   H", "H   H"),
+        'I' to listOf("IIIII", "  I  ", "  I  ", "  I  ", "IIIII"),
+        'K' to listOf("K   K", "K  K ", "KKK  ", "K  K ", "K   K"),
+        'L' to listOf("L    ", "L    ", "L    ", "L    ", "LLLLL"),
+        'M' to listOf("M   M", "MM MM", "M M M", "M   M", "M   M"),
+        'N' to listOf("N   N", "NN  N", "N N N", "N  NN", "N   N"),
+        'O' to listOf(" OOO ", "O   O", "O   O", "O   O", " OOO "),
+        'P' to listOf("PPPP ", "P   P", "PPPP ", "P    ", "P    "),
+        'R' to listOf("RRRR ", "R   R", "RRRR ", "R  R ", "R   R"),
+        'S' to listOf(" SSS ", "S    ", " SSS ", "    S", " SSS "),
+        'T' to listOf("TTTTT", "  T  ", "  T  ", "  T  ", "  T  "),
+        'U' to listOf("U   U", "U   U", "U   U", "U   U", " UUU "),
+        'X' to listOf("X   X", " X X ", "  X  ", " X X ", "X   X")
+    )
+
+    fun render(text: String): List<String> {
+        val normalized = text.uppercase().ifBlank { "MATRIX" }
+        val rows = List(rowColors.size) { StringBuilder() }
+        normalized.forEachIndexed { index, char ->
+            val glyph = glyphs[char] ?: glyphs.getValue('?')
+            glyph.forEachIndexed { rowIndex, row ->
+                rows[rowIndex].append(row)
+                if (index < normalized.lastIndex) {
+                    rows[rowIndex].append(' ')
+                }
+            }
+        }
+        return rows.mapIndexed { index, builder ->
+            rowColors[index] + builder.toString().trimEnd()
+        }
+    }
+}