2026-10-16 15:47:10 +08:00
|
|
|
|
# 平台契约 — 适配智能体（Phase1）
|
|
|
|
|
|
|
|
|
|
|
|
- 日期：2026-10-16 Asia/Shanghai
|
|
|
|
|
|
- 依据：产品规划 `agent-product-plan-2026-10-16.md` §1 + PRD `02-agent-contribution-prd.md`
|
2026-10-16 22:24:54 +08:00
|
|
|
|
- **冲突裁决：适配 W1 优先**（队列 ≥95 禁 live；默认 live 开启，实时队列闸门控制）
|
2026-10-16 15:47:10 +08:00
|
|
|
|
|
|
|
|
|
|
## 核实等级
|
|
|
|
|
|
|
|
|
|
|
|
| 等级 | 含义 |
|
|
|
|
|
|
|------|------|
|
|
|
|
|
|
| **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 |
|
2026-10-16 22:24:54 +08:00
|
|
|
|
| Live 默认 | **开**（Victor 已批准）；`ALLOW_LIVE_SUBMIT=0` 停交，`LIVE_CONFIRM` 可选 | 本仓 |
|
2026-10-16 15:47:10 +08:00
|
|
|
|
| 积分 | 来自**成功适配**；智能体代提成功计同一成功分；公式/周报 **待平台核实** | B / D |
|
|
|
|
|
|
|
|
|
|
|
|
## 鉴权双轨（文档索引，Phase1 不代调）
|
|
|
|
|
|
|
|
|
|
|
|
| 场景 | 头 | 等级 |
|
|
|
|
|
|
|------|----|------|
|
|
|
|
|
|
| 浏览器 / `agent_platform` | `Authorization: Bearer <login token>` | A |
|
|
|
|
|
|
| 容器内社区实践 | `Xc-Token: <token>`；body 带 `strategyId` | C |
|
|
|
|
|
|
|
|
|
|
|
|
## 禁止
|
|
|
|
|
|
|
2026-10-16 22:24:54 +08:00
|
|
|
|
- 代注册、绕过实时队列闸门、Makefile 含 register/submit/deploy/push
|
2026-10-16 15:47:10 +08:00
|
|
|
|
- 日志/响应/镜像层写入 token 或 STRATEGY_ID **值**
|
|
|
|
|
|
- 把「智能体已发布」写入千分进度
|
|
|
|
|
|
|
|
|
|
|
|
## 冲突裁决（强制）
|
|
|
|
|
|
|
|
|
|
|
|
| 资源 | 裁决 |
|
|
|
|
|
|
|------|------|
|
|
|
|
|
|
| 异步验证队列 | 适配 W1 优先；≥95 全体停交（含智能体 live） |
|
|
|
|
|
|
| Codex | hold 期扩池/归因 > 智能体脚手架 |
|
2026-10-16 22:24:54 +08:00
|
|
|
|
| 本骨架 | 默认 live；每次 task/add 前实时读取 onlyMine 队列 |
|
2026-10-16 15:47:10 +08:00
|
|
|
|
|
|
|
|
|
|
## 闸门配置以实现为准
|
|
|
|
|
|
|
2026-10-16 22:24:54 +08:00
|
|
|
|
`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` 默认 600、最小 60 秒，通过 shutdown Event 等待。
|
|
|
|
|
|
候选 A verified_reuse 优先，禁提过滤、GPU enum、占位符检查及请求前持久化去重。
|
|
|
|
|
|
`LIVE_STATE_FILE` 默认 /tmp/live-submitted.json；保留该文件可跨周期/重启去重。
|
|
|
|
|
|
build-config 失败回退 sample 并记录原因；日志不记录响应正文或凭证。
|
