重新打包用户量过亿的开源截图软件——加入图片自动上传到图床的功能

graph TD
    A[用户触发截图] --> B[ShareX 捕获图片并保存到本地]
    B --> C[捕获任务调用自定义上传器插件]
    C --> D[上传器读取图床配置（API 密钥、端点）]
    D --> E[异步上传图片到图床 API]
    E --> F{上传成功？}
    F -->|是| G[返回图床 URL → 复制到剪贴板 → 通知用户]
    F -->|否| H[记录错误日志 → 提示用户失败原因]

git clone https://github.com/ShareX/ShareX.git
cd ShareX

// ShareX.SmMsUploader/SmMsUploader.cs
using ShareX.UploadersLib;
using System.IO;
using System.Net.Http;
using System.Text.Json;
 
namespace ShareX.SmMsUploader
{
    // 继承 ShareX 的 Uploader 抽象类
    public class SmMsUploader : Uploader
    {
        // 图床配置类（与 ShareX 的设置系统绑定）
        public class SmMsSettings
        {
            public string ApiKey { get; set; } = ""; // SM.MS API 密钥
            public string Endpoint { get; set; } = "https://sm.ms/api/v2/upload"; // 上传端点
        }
 
        // 反序列化 SM.MS 响应的模型
        private class SmMsResponse
        {
            public bool success { get; set; }
            public string message { get; set; }
            public SmMsData data { get; set; } = new();
        }
 
        private class SmMsData
        {
            public string url { get; set; } = ""; // 图片最终 URL
            public string delete { get; set; } = ""; // 删除链接（可选）
        }
 
        // 获取图床配置（ShareX 会自动加载用户设置）
        private SmMsSettings Settings => GetSettings<SmMsSettings>();
 
        public override UploadResult Upload(Stream stream, string fileName)
        {
            try
            {
                // 1. 构建 HTTP 请求（Multipart 表单上传）
                using var client = new HttpClient();
                using var content = new MultipartFormDataContent();
 
                // 添加图片文件流
                var fileContent = new StreamContent(stream);
                fileContent.Headers.ContentType = GetMediaTypeHeaderValue(fileName);
                content.Add(fileContent, "smfile", fileName);
 
                // 添加 API 密钥（若有）
                if (!string.IsNullOrEmpty(Settings.ApiKey))
                {
                    content.Add(new StringContent(Settings.ApiKey), "Authorization");
                }
 
                // 2. 发送上传请求
                var response = client.PostAsync(Settings.Endpoint, content).Result;
                response.EnsureSuccessStatusCode(); // 抛出 HTTP 错误（如 401、403）
 
                // 3. 解析响应结果
                var responseJson = response.Content.ReadAsStringAsync().Result;
                var smMsResponse = JsonSerializer.Deserialize<SmMsResponse>(responseJson);
 
                if (smMsResponse?.success == true)
                {
                    // 返回成功结果（URL 会被 ShareX 自动复制到剪贴板）
                    return new UploadResult
                    {
                        IsSuccess = true,
                        Url = smMsResponse.data.url
                    };
                }
                else
                {
                    return new UploadResult
                    {
                        IsSuccess = false,
                        ErrorMessage = smMsResponse?.message ?? "未知错误"
                    };
                }
            }
            catch (HttpRequestException ex)
            {
                return new UploadResult
                {
                    IsSuccess = false,
                    ErrorMessage = $"网络错误：{ex.Message}"
                };
            }
            catch (JsonException ex)
            {
                return new UploadResult
                {
                    IsSuccess = false,
                    ErrorMessage = $"响应解析失败：{ex.Message}"
                };
            }
        }
 
        // 获取文件 MIME 类型（如 image/png）
        private static System.Net.Http.Headers.MediaTypeHeaderValue GetMediaTypeHeaderValue(string fileName)
        {
            string extension = Path.GetExtension(fileName).ToLowerInvariant();
            return extension switch
            {
                ".png" => new("image/png"),
                ".jpg" or ".jpeg" => new("image/jpeg"),
                ".gif" => new("image/gif"),
                _ => new("application/octet-stream")
            };
        }
    }
}

// ShareX.SmMsUploader/Properties/AssemblyInfo.cs
using ShareX.UploadersLib;
 
[assembly: UploaderPlugin(typeof(ShareX.SmMsUploader.SmMsUploader))]
[assembly: UploaderName("SM.MS 图床")] // 上传器显示名称
[assembly: UploaderDescription("将图片上传到 SM.MS 图床")] // 描述

public class SmMsSettings
{
    [InputBox("API 密钥", "请输入 SM.MS 的 API 密钥（可选，未登录时匿名上传）")]
    public string ApiKey { get; set; } = "";
 
    [InputBox("上传端点", "SM.MS 的 API 端点（默认：https://sm.ms/api/v2/upload）")]
    public string Endpoint { get; set; } = "https://sm.ms/api/v2/upload";
}

{
    "SM.MS 图床": "SM.MS 图床",
    "API 密钥": "API 密钥",
    "请输入 SM.MS 的 API 密钥（可选，未登录时匿名上传）": "请输入 SM.MS 的 API 密钥（可选，未登录时匿名上传）",
    "上传端点": "上传端点"
}

[TestClass]
public class SmMsUploaderTests
{
    [TestMethod]
    public void Upload_ValidImage_ReturnsSuccess()
    {
        // Arrange
        var uploader = new SmMsUploader();
        var settings = new SmMsSettings { ApiKey = "valid-api-key" };
        uploader.SetSettings(settings); // 模拟用户设置
 
        // Mock HTTP 响应（返回成功结果）
        var mockResponse = new SmMsResponse
        {
            success = true,
            data = new SmMsData { url = "https://example.com/test.png" }
        };
        var mockClient = new MockHttpClient();
        mockClient.When(HttpMethod.Post, settings.Endpoint)
                  .RespondJson(mockResponse);
 
        // Replace HttpClient with mock
        uploader.Client = mockClient; // 需调整代码以支持依赖注入
 
        // Act
        var stream = new MemoryStream(Encoding.UTF8.GetBytes("test image"));
        var result = uploader.Upload(stream, "test.png");
 
        // Assert
        Assert.IsTrue(result.IsSuccess);
        Assert.AreEqual("https://example.com/test.png", result.Url);
    }
}

// 加密
string encryptedApiKey = CryptoHelpers.EncryptString(settings.ApiKey);
// 解密
settings.ApiKey = CryptoHelpers.DecryptString(encryptedApiKey);