SuperAPI AI 工具集

hf-space-recovery

部署与运维

查看项目

更新于 10-16 00:29

技能介绍

用途:该技能面向 OpenEnv 环境在 Hugging Face Hub 上的部署恢复,帮助快速定位并修复失败或卡住的 Space,尽量缩小影响范围。

主要能力:确认发布版本组合(命名空间 openenv、版本 vX.Y.Z、Space 后缀 -vX-Y-Z,无后缀视为旧版);用 hf spaces ls 快照各版本 Space 运行状态,将 RUNNING 与 SLEEPING 视为健康,其余进入排查;区分 RUNTIME_ERROR(读取 .runtime.raw.errorMessage 中的 traceback)与 BUILD_ERROR(读取构建错误后修补 Dockerfile 或依赖);对超过 10 分钟仍处于 APP_STARTING 的 Space,先查看事件流与指标再改代码。

使用方式:通过 hf spaces info、events、metrics 接口获取信号,参考 references/troubleshooting.md 的症状到修复映射;优先定向重新部署而非全量推送,使用 scripts/prepare_hf_deployment.sh 并带 --hf-namespace openenv、--env <env_name>、--skip-collection;openenv CLI 作为补充,可用 uv run openenv validate 校验环境布局。若代码无误但卡在 APP_STARTING,可用 huggingface_hub 的 HfApi().restart_space(..., factory_reboot=True) 重启,仍无效再删除并重建 Space。最后校验运行时阶段与 /health 端点,并做全量检查,再用 scripts/manage_hf_collection.py 按同一版本更新集合成员。

适用场景:OpenEnv 环境从 envs/ 部署到 Hub 后的发布排障与恢复。

限制:资料未提供该技能的安装方式、收费、支持平台与效果保证;具体命令参数与脚本行为以仓库实际内容为准。