diff --git a/Mirai.Net/Data/Messages/MessageChain.cs b/Mirai.Net/Data/Messages/MessageChain.cs index 8431674..7b8d8f2 100644 --- a/Mirai.Net/Data/Messages/MessageChain.cs +++ b/Mirai.Net/Data/Messages/MessageChain.cs @@ -2,9 +2,6 @@ namespace Mirai.Net.Data.Messages; -/// -/// -/// //just a definition in Data namespace public partial class MessageChain : List { diff --git a/Mirai.Net/Utils/Scaffolds/MessageChain.cs b/Mirai.Net/Utils/Scaffolds/MessageChain.cs index b9d2524..17bbef7 100644 --- a/Mirai.Net/Utils/Scaffolds/MessageChain.cs +++ b/Mirai.Net/Utils/Scaffolds/MessageChain.cs @@ -10,12 +10,22 @@ // ReSharper disable once CheckNamespace namespace Mirai.Net.Data.Messages; +/// +/// 消息链 +/// public partial class MessageChain : List { + /// + /// AddRange + /// + /// public MessageChain(IEnumerable collection) : base(collection) { } + /// + /// + /// public MessageChain() : base() { } diff --git a/Mirai.Net/Utils/Scaffolds/MessageChainBuilder.cs b/Mirai.Net/Utils/Scaffolds/MessageChainBuilder.cs index 1f30cf5..c334709 100644 --- a/Mirai.Net/Utils/Scaffolds/MessageChainBuilder.cs +++ b/Mirai.Net/Utils/Scaffolds/MessageChainBuilder.cs @@ -4,6 +4,9 @@ namespace Mirai.Net.Utils.Scaffolds; +/// +/// 消息链建造者 +/// public class MessageChainBuilder { private readonly MessageChain _chain = new(); @@ -311,6 +314,10 @@ public MessageChainBuilder VoiceFromUrl(string url) return this; } + /// + /// 建造消息链 + /// + /// public MessageChain Build() { return _chain; diff --git a/Mirai.Net/Utils/Scaffolds/MessageScaffold.cs b/Mirai.Net/Utils/Scaffolds/MessageScaffold.cs index b0bfd0d..85c6a77 100644 --- a/Mirai.Net/Utils/Scaffolds/MessageScaffold.cs +++ b/Mirai.Net/Utils/Scaffolds/MessageScaffold.cs @@ -14,6 +14,12 @@ public static class MessageScaffold { #region Legacy + /// + /// + /// + /// + /// + /// public static MessageChain Append(this string origin, params MessageBase[] append) { var re = new MessageChain { new PlainMessage(origin) }; @@ -22,6 +28,12 @@ public static MessageChain Append(this string origin, params MessageBase[] appen return re; } + /// + /// + /// + /// + /// + /// public static MessageChain Append(this string origin, IEnumerable append) { var re = new MessageChain { new PlainMessage(origin) }; @@ -30,6 +42,12 @@ public static MessageChain Append(this string origin, IEnumerable a return re; } + /// + /// + /// + /// + /// + /// public static MessageChain Append(this string origin, string append) { var re = new MessageChain { new PlainMessage(origin), new PlainMessage(append) }; @@ -37,6 +55,12 @@ public static MessageChain Append(this string origin, string append) return re; } + /// + /// + /// + /// + /// + /// public static MessageChain Append(this MessageBase messageBase, params MessageBase[] append) { var re = new MessageChain { messageBase }; @@ -45,6 +69,12 @@ public static MessageChain Append(this MessageBase messageBase, params MessageBa return re; } + /// + /// + /// + /// + /// + /// public static MessageChain Append(this MessageBase messageBase, IEnumerable append) { var re = new MessageChain { messageBase }; @@ -53,6 +83,12 @@ public static MessageChain Append(this MessageBase messageBase, IEnumerable + /// + /// + /// + /// + /// public static MessageChain Append(this MessageBase messageBase, string append) { var re = new MessageChain { messageBase, new PlainMessage(append) }; @@ -60,6 +96,12 @@ public static MessageChain Append(this MessageBase messageBase, string append) return re; } + /// + /// + /// + /// + /// + /// public static MessageChain Append(this IEnumerable bases, params MessageBase[] append) { var re = bases.ToList(); @@ -68,6 +110,12 @@ public static MessageChain Append(this IEnumerable bases, params Me return re.ToMessageChain(); } + /// + /// + /// + /// + /// + /// public static MessageChain Append(this IEnumerable bases, string append) { var re = bases.ToList(); @@ -76,6 +124,12 @@ public static MessageChain Append(this IEnumerable bases, string ap return re.ToMessageChain(); } + /// + /// + /// + /// + /// + /// public static MessageChain Append(this IEnumerable bases, IEnumerable append) { var re = bases.ToList(); diff --git a/Mirai.Net/Utils/Scaffolds/MiraiScaffold.cs b/Mirai.Net/Utils/Scaffolds/MiraiScaffold.cs index 1307247..7dab4fb 100644 --- a/Mirai.Net/Utils/Scaffolds/MiraiScaffold.cs +++ b/Mirai.Net/Utils/Scaffolds/MiraiScaffold.cs @@ -15,6 +15,9 @@ namespace Mirai.Net.Utils.Scaffolds; +/// +/// mirai相关拓展方法 +/// public static class MiraiScaffold { #region MiraiBot extensions @@ -176,6 +179,12 @@ await MessageManager .RecallAsync(id); } + /// + /// 回复消息 + /// + /// + /// + /// public static async Task QuoteMessageAsync(this FriendMessageReceiver receiver, MessageChain chain) { @@ -185,6 +194,12 @@ public static async Task QuoteMessageAsync(this FriendMessageReceiver re .QuoteFriendMessageAsync(receiver.Sender.Id, id, chain); } + /// + /// 回复消息 + /// + /// + /// + /// public static async Task QuoteMessageAsync(this GroupMessageReceiver receiver, MessageChain chain) { @@ -194,6 +209,12 @@ public static async Task QuoteMessageAsync(this GroupMessageReceiver rec .QuoteGroupMessageAsync(receiver.Sender.Group.Id, id, chain); } + /// + /// 回复消息 + /// + /// + /// + /// public static async Task QuoteMessageAsync(this TempMessageReceiver receiver, MessageChain chain) { @@ -203,6 +224,12 @@ public static async Task QuoteMessageAsync(this TempMessageReceiver rece .QuoteTempMessageAsync(receiver.Sender.Id, receiver.Sender.Group.Id, id, chain); } + /// + /// 回复消息 + /// + /// + /// + /// public static async Task QuoteMessageAsync(this FriendMessageReceiver receiver, string message) { var id = receiver.MessageChain.OfType().First().MessageId; @@ -211,6 +238,12 @@ public static async Task QuoteMessageAsync(this FriendMessageReceiver re .QuoteFriendMessageAsync(receiver.Sender.Id, id, message); } + /// + /// 回复消息 + /// + /// + /// + /// public static async Task QuoteMessageAsync(this GroupMessageReceiver receiver, string message) { var id = receiver.MessageChain.ToList().OfType().First().MessageId; @@ -219,6 +252,12 @@ public static async Task QuoteMessageAsync(this GroupMessageReceiver rec .QuoteGroupMessageAsync(receiver.Sender.Group.Id, id, message); } + /// + /// 回复消息 + /// + /// + /// + /// public static async Task QuoteMessageAsync(this TempMessageReceiver receiver, string message) { var id = receiver.MessageChain.OfType().First().MessageId; diff --git a/Mirai.Net/Utils/Scaffolds/ModuleScaffold.cs b/Mirai.Net/Utils/Scaffolds/ModuleScaffold.cs index c4a9506..c55aaef 100644 --- a/Mirai.Net/Utils/Scaffolds/ModuleScaffold.cs +++ b/Mirai.Net/Utils/Scaffolds/ModuleScaffold.cs @@ -7,6 +7,9 @@ namespace Mirai.Net.Utils.Scaffolds; +/// +/// 模块化拓展方法 +/// public static class ModuleScaffold { /// @@ -32,7 +35,7 @@ public static IEnumerable GetModules(this T module) where T : IModul /// /// /// - public static void SubscribeModule(this IEnumerable modules, MessageReceiverBase @base) + public static void Raise(this IEnumerable modules, MessageReceiverBase @base) { foreach (var module in modules) {