feat: 添加了文件相关的 API

Author: SlimeNull

README.md

@@ -276,68 +276,4 @@ Action 在 go-cqhttp 中的 JSON 格式与消息类似, 它为参数抽出了一
 
 如果你有什么好的想法, 也可以直接提交一个 PR, 我们一起来完善这个项目吧!
 
-> 球球了, 有问题请直接提出来, 不要犹豫, 咱真的很需要用户意见, 尤其是如何提升这个库的 "优雅程度".
-
-### 📚 编写规范
-
-下面是编写时可能提供帮助的一些规范:
-
-> 虽然库的有些内部代码真的很丑(例如命名), 但这是为了外部访问的便捷而做出的妥协, 实属无奈之举.
-
-#### 🗂️ 各个文件夹的内容
-
-- `/Action` : 用户要使用到的各种 CqAction
-- `/Action/Sender` : 用来发送 CqAction 的各个协议实现
-- `/Action/Model/Params` : CqAction 进行调用时所需要的具体参数 (用户不可见)
-- `/Action/Result` : 用户要使用到的各种 CqActionResult
-- `/Action/Result/Model/Data` : CqActionResult 返回时要读取的具体数据 (用户不可见)
-- `/DataStructure` : CqAction 参数或返回数据中所使用到的各种结构
-- `/DataStructure/Model` : CqAction 参数或返回数据中所使用到的各种结构的实际传输声明 (用户不可见)
-- `/Enumeration` : 各种枚举类型
-- `/Extension` : 各种拓展方法
-- `/JsonConverter` : 程序集所需要使用的 JSON 转换器 (用户不可见)
-- `/Message` : 用户会用到的各种消息类型
-- `/Message/CqCodeDef` : CQ 码操作类
-- `/Message/DataModel` : 消息的实际传输数据模型 (用户不可见)
-- `/Message/JsonConverter` : 某些特殊消息需要使用到的 JSON 转换器 (用户不可见)
-- `/Post` : 消息上报的各种类型
-- `/Utils` : 各种工具类
-- `/` : 被用户直接访问, 不需要进行归类的内容
-
-#### 🛠️ 编写步骤
-
-编写一个 Action 的参考步骤:
-
-1. 添加 `CqActionType` 成员
-2. 添加 `Consts.ActionType` 成员
-3. 在 `CqEnum` 中实现 `CqActionType` 转字符串
-4. 编写它的 `CqAction` 类
-5. 编写它的 `CqActionParamsModel` 类 (internal, 有一个全参构造函数, 成员名称为原始名称)
-6. 编写它的 `CqActionResult` 类 (不能有公开构造函数, 因为用户不能创建它的实例)
-7. 编写它的 `CqActionResultDataModel` 类 (internal, 只有 JSON 构造函数, 成员名称为原始名称)
-8. 实现 `CqActionResult.FromRaw`
-9. 实现 `CqActionResultDataModel.FromRaw`
-10. 在 `CqActionSessionExtensions` 中添加对应拓展方法
-
-编写一个 CqMsg 的参考步骤:
-
-1. 添加 `CqMsgType` 成员
-2. 编写它的 `CqMsg` 类
-3. 编写它的 `CqMsgDataModel` 类 (internal, 一个无参构造函数, 一个全参构造函数)
-4. 实现它在 `CqMsgModelConverter` 中的转换
-5. 实现它在 `CqCode.ModelChainFromCqCodeString` 中的转换
-
-#### 📃 命名规范
-
-- 尽量将缩写改为全称, 尽量将奇怪的名称改为正常的名称 \
-  例如: SetGroupBan -> BanGroupMember (禁言群成员)
-- 尽量将错误的名称改为正确的名称 \
-  例如: CheckUrlSafely -> CheckUrlSafety (检查链接安全性)
-
-#### 📎 类型声明提示
-
-- 在原文档中以 `number` 标识的类型, 统一使用 `long`, 否则可能会溢出
-- 在原文档中, 消息 ID 有的地方声明为 `int32`, 有的地方声明为 `int64`, 在本库中, 将统一使用 `int64`
-
-
-
+> 球球了, 有问题请直接提出来, 不要犹豫, 咱真的很需要用户意见, 尤其是如何提升这个库的 "优雅程度".

src/EleCho.GoCqHttpSdk/Action/CqBanGroupAllMembers.cs

@@ -33,8 +33,8 @@ public CqBanGroupAllMembersAction(long groupId, bool enable)
         /// 是否启用禁言
         /// </summary>
         public bool Enable { get; set; }
-        
-        
+
+
         internal override CqActionParamsModel GetParamsModel()
         {
             return new CqBanGroupAllMembersActionParamsModel(GroupId, Enable);

src/EleCho.GoCqHttpSdk/Action/CqCreateGroupFolderAction.cs

@@ -0,0 +1,47 @@
+using EleCho.GoCqHttpSdk.Action.Model.Params;
+
+
+namespace EleCho.GoCqHttpSdk.Action
+{
+    /// <summary>
+    /// 创建群文件文件夹操作
+    /// </summary>
+    public class CqCreateGroupFolderAction : CqAction
+    {
+        /// <summary>
+        /// 实例化
+        /// </summary>
+        /// <param name="groupId"></param>
+        /// <param name="name"></param>
+        public CqCreateGroupFolderAction(long groupId, string name)
+        {
+            GroupId = groupId;
+            Name = name;
+        }
+
+        /// <summary>
+        /// 操作类型: 创建群文件夹
+        /// </summary>
+        public override CqActionType ActionType => CqActionType.CreateGroupFolder;
+
+        /// <summary>
+        /// 群号
+        /// </summary>
+        public long GroupId { get; set; }
+
+        /// <summary>
+        /// 文件夹名称
+        /// </summary>
+        public string Name { get; set; }
+
+        /// <summary>
+        /// 文件夹父 ID (仅能为 / )
+        /// </summary>
+        public string Parent { get; set; } = "/";
+
+        internal override CqActionParamsModel GetParamsModel()
+        {
+            return new CqCreateGroupFolderParamsModel(GroupId, Name, Parent);
+        }
+    }
+}

src/EleCho.GoCqHttpSdk/Action/CqDeleteGroupFileAction.cs

@@ -0,0 +1,49 @@
+using EleCho.GoCqHttpSdk.Action.Model.Params;
+
+
+namespace EleCho.GoCqHttpSdk.Action
+{
+    /// <summary>
+    /// 删除群文件操作
+    /// </summary>
+    public class CqDeleteGroupFileAction : CqAction
+    {
+        /// <summary>
+        /// 实例化
+        /// </summary>
+        /// <param name="groupId"></param>
+        /// <param name="fileId"></param>
+        /// <param name="busid"></param>
+        public CqDeleteGroupFileAction(long groupId, string fileId, int busid)
+        {
+            GroupId = groupId;
+            FileId = fileId;
+            Busid = busid;
+        }
+
+        /// <summary>
+        /// 操作类型: 删除群文件
+        /// </summary>
+        public override CqActionType ActionType => CqActionType.DeleteGroupFile;
+
+        /// <summary>
+        /// 群号
+        /// </summary>
+        public long GroupId { get; set; }
+
+        /// <summary>
+        /// 文件 ID, 参考 <see cref="CqGroupUploadedFile"/>
+        /// </summary>
+        public string FileId { get; set; }
+
+        /// <summary>
+        /// 文件类型, 参考 <see cref="CqGroupUploadedFile"/>
+        /// </summary>
+        public int Busid { get; set; }
+
+        internal override CqActionParamsModel GetParamsModel()
+        {
+            return new CqDeleteGroupFileActionParamsModel(GroupId, FileId, Busid);
+        }
+    }
+}

src/EleCho.GoCqHttpSdk/Action/CqDeleteGroupFolderAction.cs

@@ -0,0 +1,43 @@
+using EleCho.GoCqHttpSdk.Action.Model.Params;
+
+
+namespace EleCho.GoCqHttpSdk.Action
+{
+    /// <summary>
+    /// 删除群文件夹操作
+    /// </summary>
+    public class CqDeleteGroupFolderAction : CqAction
+    {
+        /// <summary>
+        /// 实例化
+        /// </summary>
+        /// <param name="groupId"></param>
+        /// <param name="folderId"></param>
+        public CqDeleteGroupFolderAction(long groupId, string folderId)
+        {
+            GroupId = groupId;
+            FolderId = folderId;
+        }
+
+        /// <summary>
+        /// 操作类型: 删除群文件夹
+        /// </summary>
+        public override CqActionType ActionType => CqActionType.DeleteGroupFolder;
+
+        /// <summary>
+        /// 群号
+        /// </summary>
+        public long GroupId { get; set; }
+
+        /// <summary>
+        /// 文件夹 ID
+        /// </summary>
+        public string FolderId { get; set; }
+
+
+        internal override CqActionParamsModel GetParamsModel()
+        {
+            return new CqDeleteGroupFolderActionParamsModel(GroupId, FolderId);
+        }
+    }
+}

src/EleCho.GoCqHttpSdk/Action/CqGetGroupFileSystemInformationAction.cs

@@ -0,0 +1,35 @@
+using EleCho.GoCqHttpSdk.Action.Model.Params;
+
+
+namespace EleCho.GoCqHttpSdk.Action
+{
+    /// <summary>
+    /// 获取群文件系统信息操作
+    /// </summary>
+    public class CqGetGroupFileSystemInformationAction : CqAction
+    {
+        /// <summary>
+        /// 实例化
+        /// </summary>
+        /// <param name="groupId"></param>
+        public CqGetGroupFileSystemInformationAction(long groupId)
+        {
+            GroupId = groupId;
+        }
+
+        /// <summary>
+        /// 操作类型: 获取群文件系统信息
+        /// </summary>
+        public override CqActionType ActionType => CqActionType.GetGroupFileSystemInformation;
+
+        /// <summary>
+        /// 群号
+        /// </summary>
+        public long GroupId { get; set; }
+
+        internal override CqActionParamsModel GetParamsModel()
+        {
+            return new CqGetGroupFileSystemInformationActionParamsModel(GroupId);
+        }
+    }
+}

src/EleCho.GoCqHttpSdk/Action/CqGetGroupFileUrlAction.cs

@@ -0,0 +1,26 @@
+using EleCho.GoCqHttpSdk.Action.Model.Params;
+
+
+namespace EleCho.GoCqHttpSdk.Action
+{
+    public class CqGetGroupFileUrlAction : CqAction
+    {
+        public CqGetGroupFileUrlAction(long groupId, string fileId, int busid)
+        {
+            GroupId = groupId;
+            FileId = fileId;
+            Busid = busid;
+        }
+
+        public override CqActionType ActionType => CqActionType.GetGroupFileUrl;
+
+        public long GroupId { get; set; }
+        public string FileId { get; set; }
+        public int Busid { get; set; }
+
+        internal override CqActionParamsModel GetParamsModel()
+        {
+            return new CqGetGroupFileUrlActionParamsModel(GroupId, FileId, Busid);
+        }
+    }
+}

src/EleCho.GoCqHttpSdk/Action/CqGetGroupFilesByFolderAction.cs

@@ -0,0 +1,42 @@
+using EleCho.GoCqHttpSdk.Action.Model.Params;
+
+
+namespace EleCho.GoCqHttpSdk.Action
+{
+    /// <summary>
+    /// 获取群子目录文件列表操作
+    /// </summary>
+    public class CqGetGroupFilesByFolderAction : CqAction
+    {
+        /// <summary>
+        /// 实例化
+        /// </summary>
+        /// <param name="groupId"></param>
+        /// <param name="folderId"></param>
+        public CqGetGroupFilesByFolderAction(long groupId, string folderId)
+        {
+            GroupId = groupId;
+            FolderId = folderId;
+        }
+
+        /// <summary>
+        /// 操作类型: 获取群子目录文件列表
+        /// </summary>
+        public override CqActionType ActionType => CqActionType.GetGroupFilesByFolder;
+
+        /// <summary>
+        /// 群号
+        /// </summary>
+        public long GroupId { get; set; }
+
+        /// <summary>
+        /// 目录 ID
+        /// </summary>
+        public string FolderId { get; set; }
+
+        internal override CqActionParamsModel GetParamsModel()
+        {
+            return new CqGetGroupFilesByFolderActionParamsModel(GroupId, FolderId);
+        }
+    }
+}

src/EleCho.GoCqHttpSdk/Action/CqGetGroupRootFilesAction.cs

@@ -0,0 +1,36 @@
+using EleCho.GoCqHttpSdk.Action.Model.Params;
+
+
+namespace EleCho.GoCqHttpSdk.Action
+{
+    /// <summary>
+    /// 获取群根目录文件列表操作
+    /// </summary>
+    public class CqGetGroupRootFilesAction : CqAction
+    {
+        /// <summary>
+        /// 实例化
+        /// </summary>
+        /// <param name="groupId"></param>
+        public CqGetGroupRootFilesAction(long groupId)
+        {
+            GroupId = groupId;
+        }
+
+
+        /// <summary>
+        /// 操作类型: 获取群根目录文件列表
+        /// </summary>
+        public override CqActionType ActionType => CqActionType.GetGroupRootFiles;
+
+        /// <summary>
+        /// 群号
+        /// </summary>
+        public long GroupId { get; set; }
+
+        internal override CqActionParamsModel GetParamsModel()
+        {
+            return new CqGetGroupRootFilesActionParamsModel(GroupId);
+        }
+    }
+}