Hugging Face API 工具构建器

要解决什么问题

在 Hugging Face 上查模型、跟论文、批量读卡片元数据时，很多人要么在浏览器里点来点去，要么每次手写 curl 和 jq，鉴权方式也不统一。私有或 gated 资源一旦没带好 token，就会撞上速率限制或 401，而且多步查询（趋势榜 → 元数据 → 卡片 frontmatter）很难复用成一条可维护的流水线。

技能如何工作

本技能把职责收敛为：交付可组合的命令行工具，而不是一次性脚本。设计上强调几条硬规则：

• 每个脚本必须支持 --help，明确 stdin/stdout 语义，方便接入 Shell 管道。
• 鉴权统一走环境变量 HF_TOKEN，请求头形如 Authorization: Bearer ${HF_TOKEN}，与官方 API 及更高配额策略一致。
• 在定方案前先小样本探查 API 返回结构；复杂 OpenAPI 全貌不要整文件拉取，用 jq 按需截取接口片段。
• 优先 Shell；逻辑过重时再选 Python 或 TSX，并附带基线示例（原始 JSON 输出）与 stdin → NDJSON 的 enrich 类工具，便于 jq 排序、筛选、截断。

参考实现覆盖典型链路：趋势模型串联解析、按 arXiv 前缀搜索模型（含过窄结果时的重试）、用 hf CLI 拉模型卡片并抽取 YAML frontmatter（license、pipeline tag、gated 标志等）。非破坏性脚本在交付前应自测，并在有歧义时先向用户确认偏好。

适用边界与注意点

• 技能面向 HF REST API 与 hf CLI 的脚本化封装，不替代你在 Hub 上的账号权限或模型许可条款。
• 管道示例依赖本机已安装 jq、curl 等常见工具；OpenAPI 文档体积极大，务必按 SKILL 要求用查询式方式阅读，避免一次性加载。
• huggingface-cli 已废弃，新脚本应使用 hf 子命令 访问仓库与卡片内容。