# PR #47830 完整报告

- 仓库：`vllm-project/vllm`
- 标题：[docs update] Update usage of `hf` cli for cache list and removal
- 合并时间：2026-07-07 15:09
- 原文链接：http://prhub.com.cn/vllm-project/vllm/pull/47830

---

## 执行摘要

此 PR 更新了文档中 Hugging Face CLI 缓存管理命令的用法，将已废弃的 `hf scan-cache` 和 `hf delete-cache` 替换为 `hf cache list` 和 `hf cache rm`，并移除了过时的交互式 TUI 示例。

## 功能与动机

Hugging Face CLI 更新后，旧命令 `scan-cache` 和 `delete-cache` 已被废弃。该 PR 同步更新文档，避免用户使用过时命令。

## 实现拆解

1. **文件修改**：`docs/models/supported_models.md` 中的缓存管理章节。
2. **命令替换**：
 - `hf scan-cache` → `hf cache list -q`
 - `hf scan-cache -v` → `hf cache list`
 - `hf scan-cache --dir` → `hf cache list --dir`
3. **删除过时示例**：移除 `hf delete-cache` 的 TUI 交互示例及 `<details>` 标签，替换为一行命令 `hf cache rm $(hf cache list -q)`，简化操作指南。

### 无关键源码变更，仅文档文本修改。

## 评论区精华

无实质讨论。

## 风险与影响

- **风险**：低。仅文档变更，无代码风险。但需确保命令在常见 `huggingface_hub` 版本中可用。
- **影响**：影响查阅文档的用户，提升命令准确性。

## 关联脉络

无关联 PR 或 Issue。