feat(drivers): add huggingface cloud storage driver

[WUHINS]

Summary / 摘要

实现了 HuggingFace 仓库作为 OpenList 存储驱动的完整功能。

用户可感知的变化

• 新增 HuggingFace 驱动类型，支持模型(model) / 数据集(dataset) / 空间(space) 三种仓库
• 支持配置项：repo_id（必填）、api_token、ref（分支/标签/commit SHA，默认 main）、repo_type（默认 model）、hf_proxy（代理地址）
• 文件上传：<5MB 走 base64 NDJSON 内联提交，≥5MB 自动切换到 HuggingFace LFS（S3 presigned URL 直传）
• 支持目录创建（.gitkeep 方式）、文件/目录删除、文件列表、下载直链生成

重要实现变化

• 新增 5 个文件：drivers/huggingface/driver.go（核心逻辑）、meta.go（驱动元数据）、types.go（API 类型）、util.go（工具函数），以及在 drivers/all.go 注册

• LFS 上传流程：saveStream 写临时文件 + SHA256 → preupload 检测 → LFS batch API 获取 S3 presigned URL → PUT 直传 S3（支持 fallback 到 POST）→ verify（可选）→ NDJSON commit 提交 lfsFile 引用

• 小型文件流式提交：io.Pipe + base64 编码 + NDJSON 内嵌，避免写临时文件

• 自定义 HTTP 客户端：s3Client() 单例共享连接池（5 分钟 ResponseHeaderTimeout），hfClient() 独立客户端（DisableKeepAlives）用于 HF API

• context.WithoutCancel 保护 S3 上传 body 不被任务取消中断

• 过滤未签名的 x-amz-* 头部，避免 S3 403（X-Amz-SignedHeaders=host）

• saveStream 增加 fi.Size() != stream.GetSize() 校验，提前捕获数据不完整

• This PR has breaking changes.
  / 此 PR 包含破坏性变更。

• This PR changes public API, config, storage format, or migration behavior.
  / 此 PR 修改了公开 API、配置、存储格式或迁移行为。

• This PR requires corresponding changes in related repositories.
  / 此 PR 需要关联仓库同步修改。

Related repository PRs / 关联仓库 PR:

• OpenList-Frontend:
• OpenList-Docs:

Related Issues / 关联 Issue

无

Testing / 测试

• go build -o OpenList.exe . — 编译通过，生成 ~124MB 可执行文件
• Manual test / 手动测试:
  • 目标驱动上下传（上传小文件、大文件 LFS 自动切换）
  • 文件复制、目录创建、删除操作
  • 代理配置（hf_proxy）验证
  • 使用 Go 1.23+ 构建，全量编译无报错

Checklist / 检查清单

• I have read CONTRIBUTING.
  / 我已阅读 CONTRIBUTING。
• I confirm this contribution follows the repository license, contribution policy, and code of conduct.
  / 我确认此贡献符合仓库许可证、贡献规范和行为准则。
• I have formatted the changed code with gofmt, go fmt, or prettier where applicable.
  / 我已按适用情况使用 gofmt、go fmt 或 prettier 格式化变更代码。
• I have requested review from relevant maintainers or code owners where applicable.
  / 我已在适用情况下请求相关维护者或代码所有者审查。

AI Disclosure / AI 使用声明

• This PR includes AI-assisted content.
  / 此 PR 包含 AI 辅助内容。

Tools used / 使用工具:

• ChatGPT
• Codex
• GitHub Copilot
• Claude
• Gemini
• Other (please specify) / 其他（请注明）: opencode (deepseek-v4-flash-free)

Usage scope / 使用范围:

• Code generation / 代码生成

• Refactoring / 重构

• Documentation / 文档

• Tests / 测试

• Translation / 翻译

• Review assistance / 审查辅助

• I have reviewed and validated all AI-assisted content included in this PR.
  / 我已审核并验证此 PR 中的所有 AI 辅助内容。

• I have ensured that all AI-assisted commits include Co-Authored-By attribution.
  / 我已确保所有 AI 辅助提交都包含 Co-Authored-By 归属信息。

• I can reproduce all AI-assisted content included in this PR without any AI tools.
  / 我可以在没有任何 AI 工具的情况下重现此 PR 中包含的所有 AI 辅助内容。

---

代码实现思路和驱动编写方向由开发者指导，针对 HF 官方 API，初次尝试编写 OpenList 驱动。如有缺陷请指出。

---

如果需要我调整措辞或增减内容，直接说。

[jyxjjj]

临时文件不要提交

[WUHINS]

临时文件不要提交

已改正，感谢提醒

[zjhcx]

HF仓库已经支持S3访问了，数据集还不支持

[WUHINS]

HF仓库已经支持S3访问了，数据集还不支持

所以主要是支持模型和数据集，只是对接API的话顺手做全可能更好，毕竟小白不一定知道HF支持S3，S3配置也有点难度。

[WUHINS]

HF仓库已经支持S3访问了，数据集还不支持

我看官方说法是桶支持，但标准的模型、数据集几乎不支持
且官方似乎没有明确说明桶是否免费。

[zjhcx]

HF仓库已经支持S3访问了，数据集还不支持

我看官方说法是桶支持，但标准的模型、数据集几乎不支持 且官方似乎没有明确说明桶是否免费。

确实，不过我试了一下，桶目前是和数据集和模型共享存储空间的