local

type Addition struct {
	driver.RootPath
	// Thumbnail 是否启用缩略图功能
	// 启用后，图片和视频文件将生成缩略图
	Thumbnail bool `json:"thumbnail" required:"true" help:"启用缩略图功能，支持图片和视频文件"`

	// ThumbCacheFolder 缩略图缓存文件夹路径
	// 如果为空，则不会缓存缩略图到磁盘，每次请求都会重新生成
	// 建议配置缓存目录以提高性能
	ThumbCacheFolder string `json:"thumb_cache_folder" help:"缩略图缓存文件夹路径，留空则不缓存缩略图，建议配置以提高性能"`

	// ThumbConcurrency 生成缩略图的并发数
	// 控制可以同时生成多少个缩略图，避免系统资源过度消耗
	// 设置为0表示无限制，但可能导致系统负载过高
	ThumbConcurrency string `` /* 150-byte string literal not displayed */

	// VideoThumbPos 视频缩略图位置
	// 如果是数字（整数或浮点数），表示视频的秒数
	// 如果以'%'结尾，表示视频时长的百分比
	// 例如：10表示第10秒，20%表示视频时长的20%位置
	VideoThumbPos string `` /* 157-byte string literal not displayed */

	// ShowHidden 是否显示隐藏文件和文件夹
	// 在Unix/Linux系统中，以点(.)开头的文件被视为隐藏文件
	// 在Windows系统中，通过文件属性的FILE_ATTRIBUTE_HIDDEN标志判断
	ShowHidden bool `json:"show_hidden" default:"false" required:"false" help:"是否显示隐藏的文件和文件夹，默认不显示"`

	// MkdirPerm 创建文件夹的权限，八进制表示
	// 仅在Unix/Linux系统中有效
	// 默认为777，表示所有用户都有读写执行权限
	MkdirPerm string `` /* 129-byte string literal not displayed */

	// RecycleBinPath 回收站路径
	// 如果为空或保持'delete permanently'，则永久删除文件
	// 否则将删除的文件移动到指定的回收站目录
	RecycleBinPath string `` /* 164-byte string literal not displayed */
}

type Local struct {
	model.Storage
	Addition
	// contains filtered or unexported fields
}

type NopTokenBucket struct {
	// contains filtered or unexported fields
}

type StaticTokenBucket struct {
	// contains filtered or unexported fields
}

type TokenBucket interface {
	// Take 获取一个令牌，返回一个通道，当有令牌可用时会收到信号
	Take() <-chan struct{}
	// Put 归还一个令牌到桶中
	Put()
	// Do 使用令牌执行函数，自动获取和归还令牌
	Do(context.Context, func() error) error
}