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

Bitzsoft.Integrations.CloudDrive.Nutstore

坚果云企业网盘服务实现，基于 WebDAV 协议与坚果云服务端交互。

功能特性

• 基于 WebDAV 协议实现文件上传、下载、移动、复制、删除等基础操作
• 文件夹管理：支持文件夹创建、列举、删除
• NSDAV XML API：支持搜索、创建分享链接、文件夹 ACL 权限管理
• 认证方式：邮箱 + 应用专用密码（HTTP Basic Auth）
• 统一异常处理：WebDAV 错误自动映射为 CloudDriveException

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.CloudDrive.Nutstore

PackageReference

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

配置

appsettings.json

{
  "CloudDrive": {
    "Nutstore": {
      "AuthEmail": "your-email@example.com",
      "AuthPassword": "your-app-password",
      "BaseUrl": "https://dav.jianguoyun.com/dav/",
      "RestApiUrl": "https://api.jianguoyun.com/v2/",
      "HttpClientName": "NutstoreCloudDrive"
    }
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.CloudDrive.Nutstore;

builder.Services.AddBitzsoftNutstoreCloudDrive(
    builder.Configuration.GetSection("CloudDrive:Nutstore"));

委托配置

builder.Services.AddBitzsoftNutstoreCloudDrive(options =>
{
    options.AuthEmail = "your-email@example.com";
    options.AuthPassword = "your-app-password";
});

使用示例

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 = "/documents",
            FileName = "report.pdf",
            Content = stream,
            ContentType = "application/pdf"
        });

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

        // 下载文件
        var download = await _drive.DownloadAsync("/documents/report.pdf");

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

        // 创建分享链接
        var link = await _drive.CreateShareLinkAsync(new CreateShareLinkRequest
        {
            FileId = "/documents/report.pdf",
            AccessLevel = ShareLinkAccessLevel.View
        });

        // 文件夹 ACL 权限管理
        var perms = await _drive.GetPermissionsAsync("/documents");
    }
}

核心类型一览

实现状态

请求审计

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

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

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

注意事项

• WebDAV 协议不支持服务端搜索和分页，ListFilesAsync 采用客户端分页
• SearchAsync 使用 NSDAV 搜索接口，分页和类型/扩展名筛选在客户端完成
• 分享链接创建接口不支持访问密码、过期时间或最大访问次数
• 权限管理接口会提交完整 ACL 列表，封装会先读取再替换/移除目标权限
• fileId 和 folderId 均为 WebDAV 相对路径（如 /documents/report.pdf）
• 应用密码需在坚果云 Web 端「安全选项」中生成第三方应用专用密码
• 文件夹 ID 以路径形式表示，根目录使用 /

依赖

相关包

• Bitzsoft.Integrations.CloudDrive -- 抽象层
• Bitzsoft.Integrations.CloudDrive.All -- 聚合包（一键注册全部供应商）
• 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 -- 基础工具库