用途：面向需要调用 Hugging Face 平台能力的场景，可检索模型、数据集和 Spaces，查看仓库文件，并使用无服务器推理执行文本生成、文生图、嵌入与文本分类等任务。
主要能力：验证账号（whoami-v2）；按关键词、pipeline_tag、sort、direction、limit、author、filter 等参数搜索模型、数据集和 Spaces；获取模型与数据集详情；列出仓库文件；调用推理接口完成文本生成、文生图、嵌入与文本分类；查询支持无服务器推理的模型与推理提供方；创建、删除仓库（删除需写权限 token）。
使用方式：所有示例均假定已设置 HUGGING_FACE_TOKEN，认证采用 Authorization: Bearer $HUGGING_FACE_TOKEN 请求头。基础地址为 Hub API https://huggingface.co/api 与 Inference API https://router.huggingface.co。文本生成使用 OpenAI 兼容端点 https://router.huggingface.co/hf-inference/v1/chat/completions；文生图、嵌入、分类使用 /hf-inference/models/{model_id} 路径。复杂 JSON 负载可先写入临时文件，再用 -d @/tmp/hugging_face_request.json 发送，以避免 shell 引号问题。请求失败时可运行 zero doctor check-connector --env-name HUGGING_FACE_TOKEN 或 zero doctor check-connector --url https://huggingface.co/api/whoami-v2 --method GET 排查。
适用场景：原型验证和快速任务优先使用无服务器推理；生产环境可部署 Inference Endpoints。用 inference_provider 过滤查找可用模型，确认模型是否支持无服务器推理。模型 ID 使用 org/name 格式，如 meta-llama/Llama-3.1-8B-Instruct。
限制：并非所有模型都支持无服务器推理；需注意速率限制，认证请求限额更高，重度使用可考虑 Pro 账户。删除仓库需要写权限 token。关于计费、价格及更细的平台规则，资料暂未提供。