cmvr_edge_ai/client/detect

Detect Client

这里放置不依赖 pipeline 的 Detect HTTP SDK 使用示例。SDK 只负责：

• list_models() 查询 active_push 与 passive_invoke 能力；
• infer(category, image, media_type, parameters, image_roles) 调用 POST /v1/inference；
• 严格校验版本化响应，并把连接、HTTP 状态和协议错误分成不同异常。

客户端不得传入 model_id、权重路径或 pipeline 配置。模型选择和权重生命周期属于 server/detect；客户端只使用服务端公开的稳定业务 category。

安装 HTTP extra 后运行 example.py：

uv sync --extra http
CMVR_DETECT_BASE_URL=http://127.0.0.1:8081 \
  uv run --no-sync python client/detect/example.py ./sample.jpg detect.ppe

远程服务配置了 server.http.bearer_token 时，通过环境变量传入同一 token；TLS 部署应把 base URL 改为 https://：

CMVR_DETECT_BASE_URL=https://edge.example.com:8081 \
CMVR_DETECT_BEARER_TOKEN='deployment-secret' \
  uv run --no-sync python client/detect/example.py ./sample.jpg detect.ppe

SDK 的生产代码位于 cmvr_edge_ai.client.detect。base URL、认证 header 和 timeout 属于调用应用配置；本目录不复制服务端 category/model/weights 配置。