Bitzsoft.Integrations.CloudDrive.Gokuai 1.0.0-alpha.10

Bitzsoft.Integrations.CloudDrive.Gokuai

够快云库企业网盘服务实现，基于够快云库开放平台 API。

功能特性

• 基于够快云库开放平台 API，支持文件上传、下载、列表查询、搜索、移动、复制、删除
• 免认证接入：无需身份认证，通过 org_client_id 参数标识企业组织
• 文件夹管理：文件夹创建与删除
• 关键词搜索：按关键词搜索文件
• 共享链接管理：创建与删除共享链接
• 统一异常：错误自动映射为 CloudDriveException

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.CloudDrive.Gokuai

PackageReference

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

配置

appsettings.json

{
  "CloudDrive": {
    "Gokuai": {
      "OrgClientId": "你的企业组织客户端标识",
      "BaseUrl": "https://openapi.gokuai.com/1/",
      "HttpClientName": "GokuaiCloudDrive"
    }
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.CloudDrive.Gokuai;

builder.Services.AddBitzsoftGokuaiCloudDrive(
    builder.Configuration.GetSection("CloudDrive:Gokuai"));

委托配置

builder.Services.AddBitzsoftGokuaiCloudDrive(options =>
{
    options.OrgClientId = "your_org_client_id";
    options.BaseUrl = "https://openapi.gokuai.com/1/";
});

使用示例

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

public class MyService
{
    private readonly ICloudDriveProvider _drive;

    public MyService(ICloudDriveProvider drive) => _drive = drive;

    public async Task UploadAndListAsync()
    {
        // 上传文件
        await using var stream = File.OpenRead("report.pdf");
        var upload = await _drive.UploadAsync(new UploadFileRequest
        {
            FolderId = "parent_folder_id",
            FileName = "report.pdf",
            Content = stream,
            ContentType = "application/pdf"
        });

        // 列出文件夹内容
        var files = await _drive.ListFilesAsync("parent_folder_id");
        foreach (var file in files.Items)
        {
            Console.WriteLine($"{file.Name} ({file.Size} bytes)");
        }

        // 下载文件
        var download = await _drive.DownloadAsync(upload.FileInfo.Id);

        // 搜索文件
        var results = await _drive.SearchAsync(new SearchFilesRequest
        {
            Keyword = "report"
        });

        // 创建共享链接
        var link = await _drive.CreateShareLinkAsync(new CreateShareLinkRequest
        {
            FileId = upload.FileInfo.Id,
            AccessLevel = ShareLinkAccessLevel.View
        });
        Console.WriteLine($"共享链接: {link.Url}");
    }
}

核心类型一览

实现状态

请求审计

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认 NullRequestLogStore 不持久化。

// ① 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftGokuaiCloudDrive(options => { /* ... */ });

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("mySecret"); // 额外脱敏字段
});
services.AddBitzsoftGokuaiCloudDrive(options => { /* ... */ });

依赖

相关包

• Bitzsoft.Integrations.CloudDrive -- 抽象层
• Bitzsoft.Integrations.CloudDrive.All -- 聚合包（一键注册全部供应商）
• Bitzsoft.Integrations.CloudDrive.Nutstore -- 坚果云
• Bitzsoft.Integrations.CloudDrive.Microsoft365 -- Microsoft 365 / OneDrive
• Bitzsoft.Integrations.CloudDrive.AnyShare -- 爱数 AnyShare
• Bitzsoft.Integrations.CloudDrive.Baidu -- 百度网盘
• Bitzsoft.Integrations.CloudDrive.Aliyun -- 阿里云网盘 PDS
• Bitzsoft.Integrations.Compatibility -- 基础工具库