feat: 获取文件 URL (#6)

Co-authored-by: Kexun Liu <32810212+stevesensei@users.noreply.github.com>

Author: clansty

NapPlana.Net.Core/Bot/BotInstance/INapBot.cs

@@ -50,6 +50,20 @@ Task<PrivateMessageSendResponseData> SendPrivateMessageAsync(PrivateMessageSend
     /// 发送私聊合并转发消息
     /// </summary>
     Task<ForwardMessageSendResponseData> SendPrivateForwardMessageAsync(PrivateForwardMessageSend message, int timeoutSeconds = 15);
+    /// <summary>
+    /// 获取文件信息
+    /// </summary>
+    Task<GetFileResponseData> GetFileAsync(GetFileRequest request, int timeoutSeconds = 15);
+    
+    /// <summary>
+    /// 获取群文件下载链接
+    /// </summary>
+    Task<GetFileUrlResponseData> GetGroupFileUrlAsync(GetGroupFileUrlRequest request, int timeoutSeconds = 15);
+    
+    /// <summary>
+    /// 获取私聊文件下载链接
+    /// </summary>
+    Task<GetFileUrlResponseData> GetPrivateFileUrlAsync(GetPrivateFileUrlRequest request, int timeoutSeconds = 15);
 
     /// <summary>
     /// 处理好友添加请求

NapPlana.Net.Core/Bot/BotInstance/NapBot.cs

@@ -173,6 +173,45 @@ public async Task<ForwardMessageSendResponseData> SendPrivateForwardMessageAsync
         return res ?? throw new Exception("Failed to send private forward message.");
     }
 
+    /// <summary>
+    /// 获取文件信息
+    /// </summary>
+    /// <param name="request">请求参数</param>
+    /// <param name="timeoutSeconds">超时时间</param>
+    /// <returns>文件信息</returns>
+    public async Task<GetFileResponseData> GetFileAsync(GetFileRequest request, int timeoutSeconds = 15)
+    {
+        if (request is null) throw new ArgumentNullException(nameof(request));
+        var res = await SendMessageAsync<GetFileResponseData>(request, ApiActionType.GetFile, timeoutSeconds);
+        return res ?? throw new Exception("Failed to get file info.");
+    }
+
+    /// <summary>
+    /// 获取群文件下载链接
+    /// </summary>
+    /// <param name="request">请求参数</param>
+    /// <param name="timeoutSeconds">超时时间</param>
+    /// <returns>文件下载链接</returns>
+    public async Task<GetFileUrlResponseData> GetGroupFileUrlAsync(GetGroupFileUrlRequest request, int timeoutSeconds = 15)
+    {
+        if (request is null) throw new ArgumentNullException(nameof(request));
+        var res = await SendMessageAsync<GetFileUrlResponseData>(request, ApiActionType.GetGroupFileUrl, timeoutSeconds);
+        return res ?? throw new Exception("Failed to get group file url.");
+    }
+
+    /// <summary>
+    /// 获取私聊文件下载链接
+    /// </summary>
+    /// <param name="request">请求参数</param>
+    /// <param name="timeoutSeconds">超时时间</param>
+    /// <returns>文件下载链接</returns>
+    public async Task<GetFileUrlResponseData> GetPrivateFileUrlAsync(GetPrivateFileUrlRequest request, int timeoutSeconds = 15)
+    {
+        if (request is null) throw new ArgumentNullException(nameof(request));
+        var res = await SendMessageAsync<GetFileUrlResponseData>(request, ApiActionType.GetPrivateFileUrl, timeoutSeconds);
+        return res ?? throw new Exception("Failed to get private file url.");
+    }
+    
     /// <summary>
     /// 处理好友添加请求
     /// </summary>

NapPlana.Net.Core/Data/API/FileAPI.cs

@@ -0,0 +1,99 @@
+using System.Text.Json.Serialization;
+
+namespace NapPlana.Core.Data.API;
+
+/// <summary>
+/// 获取文件信息-请求
+/// </summary>
+public class GetFileRequest
+{
+    /// <summary>
+    /// 文件ID
+    /// </summary>
+    [JsonPropertyName("file_id")]
+    public string? FileId { get; set; }
+
+    /// <summary>
+    /// 文件路径、URL或Base64
+    /// </summary>
+    [JsonPropertyName("file")]
+    public string? File { get; set; }
+}
+
+/// <summary>
+/// 获取文件信息-响应
+/// </summary>
+public class GetFileResponseData : ResponseDataBase
+{
+    /// <summary>
+    /// 本地路径
+    /// </summary>
+    [JsonPropertyName("file")]
+    public string? File { get; set; }
+
+    /// <summary>
+    /// 下载URL
+    /// </summary>
+    [JsonPropertyName("url")]
+    public string? Url { get; set; }
+
+    /// <summary>
+    /// 文件大小
+    /// </summary>
+    [JsonPropertyName("file_size")]
+    public string? FileSize { get; set; }
+
+    /// <summary>
+    /// 文件名
+    /// </summary>
+    [JsonPropertyName("file_name")]
+    public string? FileName { get; set; }
+
+    /// <summary>
+    /// Base64编码
+    /// </summary>
+    [JsonPropertyName("base64")]
+    public string? Base64 { get; set; }
+}
+
+/// <summary>
+/// 获取群文件下载链接-请求
+/// </summary>
+public class GetGroupFileUrlRequest
+{
+    /// <summary>
+    /// 群号
+    /// </summary>
+    [JsonPropertyName("group_id")]
+    public string GroupId { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 文件ID
+    /// </summary>
+    [JsonPropertyName("file_id")]
+    public string FileId { get; set; } = string.Empty;
+}
+
+/// <summary>
+/// 获取私聊文件下载链接-请求
+/// </summary>
+public class GetPrivateFileUrlRequest
+{
+    /// <summary>
+    /// 文件ID
+    /// </summary>
+    [JsonPropertyName("file_id")]
+    public string FileId { get; set; } = string.Empty;
+}
+
+/// <summary>
+/// 获取文件下载链接-响应（群聊/私聊通用）
+/// </summary>
+public class GetFileUrlResponseData : ResponseDataBase
+{
+    /// <summary>
+    /// 文件下载链接
+    /// </summary>
+    [JsonPropertyName("url")]
+    public string? Url { get; set; }
+}

NapPlana.Net.Core/Data/Enumeration.cs

@@ -783,7 +783,25 @@ public enum ApiActionType
     /// 发送合并转发消息。
     /// </summary>
     [JsonPropertyName("send_forward_msg")]
-    SendForwardMsg = 38
+    SendForwardMsg = 38,
+    
+    /// <summary>
+    /// 获取文件信息。
+    /// </summary>
+    [JsonPropertyName("get_file")]
+    GetFile = 39,
+    
+    /// <summary>
+    /// 获取群文件下载链接。
+    /// </summary>
+    [JsonPropertyName("get_group_file_url")]
+    GetGroupFileUrl = 40,
+    
+    /// <summary>
+    /// 获取私聊文件下载链接。
+    /// </summary>
+    [JsonPropertyName("get_private_file_url")]
+    GetPrivateFileUrl = 41
 }
 
 /// <summary>