#47830 [docs update] Update usage of `hf` cli for cache list and removal

原始 PR 作者 ariG23498 合并时间 2026-07-07 15:09 文件变更 1 提交数 1 评论 1 代码增减 +7 / -33

执行摘要

Hugging Face CLI 已更新其缓存管理命令，旧命令 scan-cache 和 delete-cache 已被废弃。该 PR 由 ariG23498 提交，更新文档以反映新用法。

该 PR 简单直接，无深入学习必要。但值得注意文档随外部库 API 变化及时更新的良好实践。

讨论亮点

仅有一条来自 mergify[bot] 的评论，提供了文档预览链接。无实质讨论。

修改文件：docs/models/supported_models.md。
替换命令：将
- hf scan-cache → hf cache list -q（简洁模式）
- hf scan-cache -v → hf cache list（详细模式）
- hf scan-cache --dir ... → hf cache list --dir ...
删除过时示例：移除 hf delete-cache 的交互式 TUI 使用示例，替换为一行命令 hf cache rm $(hf cache list -q) 以删除所有缓存。
调整链接：更新链接到 Hugging Face 文档的正确位置。

文件	模块	状态	重要度
`docs/models/supported_models.md`	文档	modified	3.01

分析完成后，这里会展示 LLM 生成的相对完整源码片段和详细注释。

当前评论区没有形成足够清晰的争议点或结论，后续有更多讨论时会体现在这里。

低风险。仅修改文档文本，不涉及代码逻辑。但需确保新命令语法在新版 huggingface_hub 中确实可用。

影响范围小，仅影响阅读文档的用户。改善用户使用 HF CLI 管理缓存的体验。

当前没有检测到明确关联的 Issue 链接，后续同步到相关引用后会出现在这里。