feat: 特质支持显示描述文本

Author: textGamex

Moder.Core/Models/Modifiers/LeafModifier.cs

@@ -16,6 +16,7 @@ public sealed class LeafModifier : IModifier, IEquatable<LeafModifier>
     public ModifierType Type => ModifierType.Leaf;
 
     public const string CustomEffectTooltipKey = "custom_effect_tooltip";
+    public const string CustomModifierTooltipKey = "custom_modifier_tooltip";
 
     /// <summary>
     /// 从 <see cref="Leaf"/> 构建一个叶子修饰符, <see cref="LocalizationKey"/> 属性被设置为 <c>leaf.Key</c>

Moder.Core/Models/Vo/TraitVo.cs

@@ -1,22 +1,34 @@
+using System.Text;
 using CommunityToolkit.Mvvm.ComponentModel;
 using CommunityToolkit.Mvvm.Messaging;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.UI.Xaml.Controls;
 using Microsoft.UI.Xaml.Documents;
 using Moder.Core.Messages;
 using Moder.Core.Models.Character;
+using Moder.Core.Parser;
 using Moder.Core.Services;
+using Moder.Core.Services.GameResources;
 using Moder.Language.Strings;
 
 namespace Moder.Core.Models.Vo;
 
-public sealed partial class TraitVo(Trait trait, string localisationName) : ObservableObject, IEquatable<TraitVo>
+public sealed partial class TraitVo(Trait trait, string localisationName)
+    : ObservableObject,
+        IEquatable<TraitVo>
 {
     public string Name => trait.Name;
     public Trait Trait => trait;
     public string LocalisationName => localisationName;
     public TextBlock Description => GetDescription();
 
+    private static readonly ModifierService ModifierService =
+        App.Current.Services.GetRequiredService<ModifierService>();
+    private static readonly LocalisationService LocalisationService =
+        App.Current.Services.GetRequiredService<LocalisationService>();
+
+    private static readonly string Separator = new('-', 25);
+
     /// <summary>
     /// 是否已选择, 当值改变时, 发送 <see cref="SelectedTraitChangedMessage"/> 通知
     /// </summary>
@@ -31,11 +43,7 @@ partial void OnIsSelectedChanged(bool value)
     private TextBlock GetDescription()
     {
         var textBox = new TextBlock();
-        foreach (
-            var inline in App
-                .Current.Services.GetRequiredService<ModifierService>()
-                .GetModifierInlines(trait.AllModifiers)
-        )
+        foreach (var inline in ModifierService.GetModifierInlines(trait.AllModifiers))
         {
             textBox.Inlines.Add(inline);
         }
@@ -45,9 +53,47 @@ var inline in App
             textBox.Inlines.Add(new Run { Text = Resource.ModifierDisplay_Empty });
         }
 
+        textBox.Inlines.Add(new LineBreak());
+        textBox.Inlines.Add(new Run { Text = Separator });
+        textBox.Inlines.Add(new LineBreak());
+
+        var traitDesc = LocalisationService.GetValue($"{trait.Name}_desc");
+
+        foreach (var chars in GetCleanText(traitDesc).Chunk(15))
+        {
+            textBox.Inlines.Add(new Run { Text = new string(chars) });
+            textBox.Inlines.Add(new LineBreak());
+        }
+
+        if (textBox.Inlines[^1] is LineBreak)
+        {
+            textBox.Inlines.RemoveAt(textBox.Inlines.Count - 1);
+        }
         return textBox;
     }
 
+    private static string GetCleanText(string rawText)
+    {
+        string text;
+        if (LocalizationFormatParser.TryParse(rawText, out var formats))
+        {
+            var sb = new StringBuilder();
+            foreach (var format in formats)
+            {
+                sb.Append(
+                    format.Type == LocalizationFormatType.TextWithColor ? format.Text[1..] : format.Text
+                );
+            }
+            text = sb.ToString();
+        }
+        else
+        {
+            text = rawText;
+        }
+
+        return text;
+    }
+
     public bool Equals(TraitVo? other)
     {
         if (other is null)
@@ -72,4 +118,4 @@ public override int GetHashCode()
     {
         return Name.GetHashCode();
     }
-}
+}

Moder.Core/Services/ModifierService.cs

@@ -157,6 +157,11 @@ public IReadOnlyCollection<Inline> GetModifierInlines(IEnumerable<IModifier> mod
                         leafModifier.Key,
                         LeafModifier.CustomEffectTooltipKey
                     )
+                    ||
+                    StringComparer.OrdinalIgnoreCase.Equals(
+                        leafModifier.Key,
+                        LeafModifier.CustomModifierTooltipKey
+                    )
                 )
                 {
                     addedInlines = _localisationFormatService.GetTextWithColor(