Bitzsoft.Integrations.CloudDrive.All 1.0.1

Bitzsoft.Integrations.CloudDrive.All

企业网盘服务聚合包 -- 一次安装包含全部供应商实现，一行代码自动注册配置中启用的供应商。

功能特性

• 一键安装：包含全部企业网盘供应商实现，无需逐个引用
• 按需注册：自动扫描 CloudDrive 配置节，仅注册配置中存在的供应商，未配置的不加载
• 多供应商共存：支持同时注册多个供应商（通过命名 HttpClient 隔离各自请求管道）
• 统一抽象：全部供应商实现同一套 ICloudDriveProvider 接口

包含的供应商

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.CloudDrive.All

PackageReference

<PackageReference Include="Bitzsoft.Integrations.CloudDrive.All" Version="1.0.0" />

配置

appsettings.json

每个供应商使用独立的配置节，按需填写。仅配置节存在的供应商会被注册。

{
  "CloudDrive": {
    "Nutstore": {
      "AuthEmail": "your@email.com",
      "AuthPassword": "your_app_password"
    },
    "Microsoft365": {
      "TenantId": "your-tenant-id",
      "ClientId": "your-client-id",
      "ClientSecret": "your-client-secret",
      "DriveId": "your-drive-id"
    },
    "Gokuai": {
      "OrgClientId": "your_org_client_id"
    },
    "AnyShare": {
      "ApiToken": "your_api_token",
      "BaseUrl": "https://your-anyshare-instance.example.com"
    },
    "Baidu": {
      "AccessToken": "your_access_token",
      "RefreshToken": "your_refresh_token",
      "AppKey": "your_app_key",
      "SecretKey": "your_secret_key",
      "AppName": "your_app_name"
    },
    "Aliyun": {
      "RefreshToken": "your_refresh_token",
      "ClientId": "your_client_id",
      "ClientSecret": "your_client_secret",
      "DomainId": "your_domain_id",
      "DriveId": "your_drive_id"
    }
  }
}

各供应商的完整配置项与默认值见「相关包」中对应供应商的 README。

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.CloudDrive.All;

builder.Services.AddBitzsoftCloudDriveAll(builder.Configuration);

默认读取 CloudDrive 配置节。也可指定其他节名：

builder.Services.AddBitzsoftCloudDriveAll(builder.Configuration, "MyCloudDrive");

聚合包仅提供 IConfiguration 绑定这一个重载；如需逐个委托配置，请直接引用对应供应商包。

使用示例

多供应商场景注入 IIntegrationProviderResolver<ICloudDriveProvider>，按稳定 ID （aliyun / anyshare / baidu / gokuai / microsoft365 / nutstore）解析。直接注入 ICloudDriveProvider 只用于单 Provider 兼容场景。

using Bitzsoft.Integrations.CloudDrive.Interfaces;
using Bitzsoft.Integrations.CloudDrive.Models;
using Bitzsoft.Integrations.Core;

public class MyService
{
    private readonly IIntegrationProviderResolver<ICloudDriveProvider> _providers;

    public MyService(IIntegrationProviderResolver<ICloudDriveProvider> providers)
        => _providers = providers;

    public async Task RunAsync()
    {
        var drive = _providers.GetRequired("microsoft365");
        await using var stream = File.OpenRead("report.pdf");
        var result = await drive.UploadAsync(new UploadFileRequest
        {
            FolderId = "root",
            FileName = "report.pdf",
            Content = stream
        });

        var files = await drive.ListFilesAsync("root");
        Console.WriteLine($"共 {files.Items.Count} 个文件");
    }
}

核心类型一览

请求审计

聚合包中的每个供应商内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认 NullRequestLogStore 不持久化。宿主注册 IRequestLogStore 实现后，全部供应商的出站请求会自动落库。

// 宿主注册持久化实现后，所有供应商的出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 只控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("mySecret");
});
services.AddBitzsoftCloudDriveAll(builder.Configuration);

依赖

相关包

• Bitzsoft.Integrations.CloudDrive -- 抽象层
• Bitzsoft.Integrations.CloudDrive.Nutstore -- 坚果云
• Bitzsoft.Integrations.CloudDrive.Microsoft365 -- Microsoft 365 / OneDrive
• Bitzsoft.Integrations.CloudDrive.Gokuai -- 够快云库
• Bitzsoft.Integrations.CloudDrive.AnyShare -- 爱数 AnyShare
• Bitzsoft.Integrations.CloudDrive.Baidu -- 百度网盘
• Bitzsoft.Integrations.CloudDrive.Aliyun -- 阿里云网盘 PDS
• Bitzsoft.Integrations.Compatibility -- 基础工具库