平台契约 — 适配智能体（Phase1）
- 日期：2026-10-16 Asia/Shanghai
- 依据：产品规划
agent-product-plan-2026-10-16.md §1 + PRD 02-agent-contribution-prd.md
- 冲突裁决：适配 W1 优先（队列 ≥95 禁 live；默认 live 开启，实时队列闸门控制）
核实等级
| 等级 |
含义 |
| A |
官方演示仓 / 主站前端明文 |
| B |
PRD 已核实（docs/6 + 控制台，基线 2026-10-12） |
| C |
社区样例，非平台承诺 |
| D |
待核实 |
运行契约
| 项 |
内容 |
等级 |
| 代码托管 |
dev.modelhub.org.cn 用户仓 |
B |
| 注册 UI |
名称、仓库地址、Git Tag（不可用分支名） |
B |
| 构建 |
平台 Kaniko，refs/tags/<tag> |
B |
| Dockerfile |
仓库根目录；base modelhubxc-4pd.tencentcloudcr.com/xc_agent_platform/python:3.11-slim |
A |
| 端口 |
8080，EXPOSE 8080 |
A |
| 健康检查 |
GET /health → 200 {"status":"ok"} |
A |
| 可选状态 |
GET /status → 布尔 strategy_id_present / external_service_token_present（不回传值） |
本仓 Phase1 |
| 优雅退出 |
SIGTERM，约 ≤30s 平台窗口；本实现目标 ~1s 退出主循环 |
B |
| 平台注入 |
STRATEGY_ID；EXTERNAL_SERVICE_TOKEN（及社区别名） |
A/B |
| STRATEGY_ID 缺失 |
Phase1：进程启动失败（exit ≠0） |
产品规划 Phase1 + PRD |
| 资源 |
约 100m–1 CPU / 256–512Mi |
B |
| 发布智能体得分 |
0 分（发布 ≠ 得分） |
B |
| Live 默认 |
开（Victor 已批准）；ALLOW_LIVE_SUBMIT=0 停交，LIVE_CONFIRM 可选 |
本仓 |
| 积分 |
来自成功适配；智能体代提成功计同一成功分；公式/周报 待平台核实 |
B / D |
鉴权双轨（文档索引，Phase1 不代调）
| 场景 |
头 |
等级 |
浏览器 / agent_platform |
Authorization: Bearer <login token> |
A |
| 容器内社区实践 |
Xc-Token: <token>；body 带 strategyId |
C |
禁止
- 代注册、绕过实时队列闸门、Makefile 含 register/submit/deploy/push
- 日志/响应/镜像层写入 token 或 STRATEGY_ID 值
- 把「智能体已发布」写入千分进度
冲突裁决（强制）
| 资源 |
裁决 |
| 异步验证队列 |
适配 W1 优先；≥95 全体停交（含智能体 live） |
| Codex |
hold 期扩池/归因 > 智能体脚手架 |
| 本骨架 |
默认 live；每次 task/add 前实时读取 onlyMine 队列 |
闸门配置以实现为准
ALLOW_LIVE_SUBMIT 默认 1，0 为 kill switch；STRATEGY_ID 必需。
Victor 确认已内置，LIVE_CONFIRM 仍接受但不必需。
LIVE_QUEUE_THRESHOLD 默认 95，只有完整分页的 onlyMine task/page 非终态数严格小于阈值才提交。
缺凭证、HTTP/平台错误、JSON 错误、分页不完整或无效配置均停交。
ASYNC_QUEUE_DEPTH / QUEUE_SNAPSHOT_JSON 仅为额外阻塞提示。
每周期最多 LIVE_MAX_SUBMITS_PER_CYCLE（默认 3）次；周期
LIVE_CYCLE_SECONDS 默认 3600、最小 60 秒，通过 shutdown Event 等待。
候选 A verified_reuse 优先，禁提过滤、GPU enum、占位符检查及请求前持久化去重。
LIVE_STATE_FILE 默认 /tmp/live-submitted.json；保留该文件可跨周期/重启去重。
build-config 失败回退 sample 并记录原因；日志不记录响应正文或凭证。
