Skip to content

fix(hfs): 固定 Hugging Face 客户端并对齐可选 Secret - #14

Merged
BlueSkyXN merged 4 commits into
mainfrom
codex/full-clean-hfs-20260729-223153
Jul 29, 2026
Merged

fix(hfs): 固定 Hugging Face 客户端并对齐可选 Secret#14
BlueSkyXN merged 4 commits into
mainfrom
codex/full-clean-hfs-20260729-223153

Conversation

@BlueSkyXN

@BlueSkyXN BlueSkyXN commented Jul 29, 2026

Copy link
Copy Markdown
Owner

结果与边界

Space deploy workflow 与 Bucket storage sampler 固定到 huggingface_hub==1.5.0 / click==8.3.3 的真实接口,并将默认禁用的 admin 凭据改为 optional Secret。

本 PR 尚未部署:未执行 HF Settings/Space/Bucket 写入、restart、authenticated S3 smoke、persistence、backup 或 restore;仅做过 allowlisted Bucket 只读采样。

变更

  • HFS module CLI 的 Click pin 固定为 8.3.3,关闭 CVE-2026-7246 / GHSA-47fr-3ffg-hgmwhuggingface_hub==1.5.0 合同保持不变。
  • disabled-by-default admin token 从 required 调整为 optional Secret。
  • workflow 使用 HfApi.space_info() / get_space_variables() 与 module CLI upload/download,保留 tree/provenance/checksum/逐字节 readback。
  • sampler 使用 HfApi.bucket_info() 读取 accounting,module CLI recursive JSON listing 可见树,并拒绝版本漂移。
  • contract/docs 禁止 bare hf、不存在的 Bucket info JSON 参数与非结构化 parsing 回归。

兼容性

  • source pin、wrapper allowlist、S3 API 与数据格式不变。
  • admin 默认关闭时无需 admin token;启用时仍必须配置并鉴权。

验证

  • exact HEAD:b4a1c0671a8b9fdfddf613179dc018ccd559cdd5
  • scripts/validate-contract.sh(含 Nginx syntax)、Bash syntax、git diff --check:PASS
  • allowlisted Bucket read-only sampler:127 files / 111207388 bytes / drift 0
  • Docker source build、Space workflow/live S3/persistence:pending

风险与 Review focus

  • 重点检查 HfApi 与 module CLI 职责、sampler 只读边界、bare CLI 禁止和 optional admin Secret 合同。
  • 只读 accounting/tree 不证明对象内容、mount、S3 write 或 restart persistence。

@BlueSkyXN
BlueSkyXN merged commit 7e31af6 into main Jul 29, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant