SuperAPI AI 工具集

vss-deploy

部署与运维

查看项目

更新于 10-16 02:39

技能介绍

用途:该技能仅面向 sample-applications/video-search-and-summarization,用于部署、切换、检查与拆除 VSS,所有回答须以仓库文件(尤其 setup.sh 与 docker/compose.*.yaml)为依据,不得臆造参数、服务、端口或变量。

环境准备:先运行捆绑的 bootstrap 脚本,它会优先复用已有 VSS 检出,找不到时才从 main 做浅层稀疏检出,并在 stdout 打印应用根目录: SKILL_DIR=".github/skills/vss-deploy" APP_ROOT="$(bash "$SKILL_DIR/scripts/vss-bootstrap.sh")" cd "$APP_ROOT" 后续命令均在该 APP_ROOT 下执行。

模式路由:summary 对应 --summary;search 对应 --search;both/dual 对应 --summary --search;unified/all 对应 --summary-and-search。用户表述含糊时应先询问,不要默认。

配置与凭据:非机密配置在 vss.config.env,凭据由 scripts/gen-secrets.sh 生成到被 gitignore 的 vss.secrets.env。先执行 gen-secrets.sh,再 source 两个文件。常用变量包括 MINIO_ROOT_USER、MINIO_ROOT_PASSWORD、POSTGRES_USER、POSTGRES_PASSWORD、RABBITMQ_USER、RABBITMQ_PASSWORD,以及各模式模型变量。

部署:setup.sh 必须被 source。可先加 config 做 dry-run 检查解析后的 Compose。部署用 docker compose up -d,建议在后台或长超时下运行;启动前若缺少模型产物,会先拉起临时 vss-model-download 容器(回环端口 8640,单任务默认超时 5400 秒)。部署后可用 scripts/wait-health.sh 等待健康并打印 URL。

后端选择:默认 OVMS;可用 VLM_TARGET_DEVICE=GPU、ENABLE_VLLM=true、ENABLE_VLLM_GPU=true、ENABLE_EMBEDDING_GPU=true 等切换。

生命周期:source setup.sh --stop(--down 为别名)、--clean-data 会删除应用数据卷但不删除 ov_models 模型缓存。

默认端口:UI 为 http://<HOST_IP>:<APP_HOST_PORT>/,APP_HOST_PORT 默认 12345;dual 模式为 …/summary/ 与 …/search/。

限制:更深入的模型服务崩溃、OVMS 缓存/GPU 错误、搜索无结果等问题应转交 vss-troubleshoot 技能与官方排障文档。