forked from luopingyi/xc_agent_platform_demo
26 lines
2.0 KiB
Markdown
26 lines
2.0 KiB
Markdown
# configParams 配置来源与容器验证
|
||
|
||
日期：2026-10-16 Asia/Shanghai。
|
||
|
||
结论：**API**。配置来自服务端，前端将响应 `data` 写入 `configParams`。
|
||
依据：[autoconfig-capture-2026-10-16.md](/workspace/modelhub-adapt/logs/autoconfig-capture-2026-10-16.md)。原「公开面无 build-config」缺口关闭：**未公开文档但已抓包证实**。
|
||
|
||
## 已证实契约
|
||
|
||
- `POST /api/adapt/task/build-config`
|
||
- Query：`gpuType=Sunrise_pt-200-x1&framework=vllm&taskType=text-generation`
|
||
- 空 body，无 JSON；模型地址不进入 query/body，也无需传 strategyId。
|
||
- HTTP 2xx，JSON `code == 0`，非空字符串 `data` 为 YAML。
|
||
- 当前 UI 无「自动配置」标签。新建适配弹层选择模型、GPU、文本生成后，选择框架触发 effect 并填入配置。
|
||
- 抓包观察到 `Authorization` 头，值未记录。容器默认按社区实践发送 `Xc-Token`；`BUILD_CONFIG_USE_AUTHORIZATION=1` 改用同一 resolve_token 值作为 Authorization，不自动加 Bearer。
|
||
|
||
## 客户端与验证
|
||
|
||
`src/build_config_client.py` 的 `build_config()` 成功返回 YAML，失败抛出 `BuildConfigError`，包含安全归因、HTTP 状态和平台数字码；不返回服务端消息或传输异常细节。缺失/无效凭证不联网，40100、40101、其他平台码、传输失败和无效 data 均可区分。导入无 I/O。
|
||
|
||
默认 dry-run 使用 `templates/config_params.sample.yaml`，无网络。`CONFIG_PARAMS_SOURCE=build-config` 强制 API；或 `ALLOW_BUILD_CONFIG=1` 且可解析 token 时使用 API。调用失败直接报错，不回退 sample。调用方须传真实 GPU enum。`make build-config-dry` 仅生成配置，缺 token 非零退出，不输出 YAML 或凭证。
|
||
|
||
## 剩余 GAP 与边界
|
||
|
||
尚无容器 token 鉴权实证；需运行时 token + API 调用并与只读探针对照，不能宣称鉴权就绪。sample 本身不是 production-ready。队列 ≥95 禁 live。本轮仅 mock 测试，不进行真实 API 调用，不调用 task/add，不保存秘密，不提交任务或推送 tag。
|