hf-space-recovery

用途：诊断并恢复 OpenEnv 环境在 Hugging Face Hub 上失败或卡住的 Space 部署，尽量缩小影响范围。主要能力包括：确认统一发布版本（命名空间 openenv、版本 vX.Y.Z、Space 后缀 -vX-Y-Z，无后缀视为旧版）；用 hf spaces ls 快照所有版本化 Space 的运行状态，将 RUNNING 与 SLEEPING 视为健康，其余进入分诊；按 RUNTIME_ERROR、BUILD_ERROR、APP_STARTING 超过 10 分钟三类提取信号，分别读取 .runtime.raw.errorMessage、构建错误信息，或先看事件流与指标再改代码；参考 references/troubleshooting.md 的症状到修复映射。使用方式：用单次发布元组统一所有命令；用 hf spaces info、events、metrics 端点收集信息；优先执行定向重部署 scripts/prepare_hf_deployment.sh --hf-namespace openenv --env <env_name> --skip-collection，保留后缀与版本固定行为；openenv CLI 仅作补充（如 uv run openenv validate）；代码本身无问题时，用 huggingface_hub 的 api.restart_space(factory_reboot=True) 解卡，仍卡住再删除并重建 Space；最后核对 runtime stage 与 /health 端点，并检查全量版本化 Space 状态，再用 scripts/manage_hf_collection.py 按同一版本更新合集成员，每个重部署的 Space 追加一个 --space-id。限制：资料未说明该技能的权限范围、依赖版本、失败重试上限与回滚策略，也未提供价格或平台支持细节，缺失信息暂未提供。