xc_validation_strategy/README.md

# xc_validation_strategy

批量向 ModelHub XC 平台提交模型验证任务的策略服务，之后保持 HTTP 服务存活供平台探活。

当前批次仅向 `zhoushasha` 账号提交 `main.py` 中列出的 12 个模型，每个模型只提交 `ppu_zw_810e` 一张卡，共 12 个任务。

## 功能

- 使用 `AUTH_TOKEN` 环境变量（未提供时使用 `main.py` 中的预设 Bearer Token）向 `zhoushasha` 账号提交任务
- 从 `main.py` 的 `PPU_MODELS` 读取本批次模型，批量提交验证任务
- 账号额度暂满时，每 30 分钟重试尚未提交的模型
- 提交结果写入 `submitted_validation_tasks.txt`
- 暴露 `/health` 和 `/status` 接口满足平台运行时契约

## 项目结构

```
.
├── main.py            # 主入口：HTTP 服务 + 提交逻辑
├── model_ids/         # 历史批次模型 ID 清单，本轮未使用
├── Dockerfile         # 平台镜像构建配置
├── requirements.txt   # Python 依赖
└── submitted_validation_tasks.txt   # 运行后自动生成，记录提交结果
```

## 平台契约说明

本项目满足平台对策略镜像的全部必要约束：

- Dockerfile 位于仓库根目录，基于官方轻量基础镜像
- 暴露 8080 端口并实现 `GET /health`
- 通过环境变量 `STRATEGY_ID` 获取策略 ID
- 正确处理 `SIGTERM` 信号，支持优雅停机

运行前应确认 `AUTH_TOKEN` 有效；若未设置环境变量，则使用 `main.py` 中的预设 Bearer Token。