docs: 固化 Aipod imageRef 决策

2026-06-11 02:18:41 +08:00
parent 1b43af55e2
commit 6843e7517b
3 changed files with 6 additions and 1 deletions
@@ -131,6 +131,7 @@ HWLAB Workbench 的 project/workspace 不属于 RuntimeAssembly 四要素，也
 ### BackendImageRef

 - `BackendImageRef.source` 是 env image Dockerfile source，来自 AipodSpec `spec.imageRef` 或受控 runtime default；`kind` 固定为 `env-image-dockerfile`，最小字段为 `repoUrl`、完整 `commitId` 和仓库内相对 `dockerfilePath`。
+- `#146` 的 Aipod 装配决策要求 `source` 先写入 AipodSpec，再进入 Queue dispatch / Session turn / runner Job 解析；不得由 prompt、payload、临时 CLI 参数、可变 image tag 或 dispatcher 当前 rollout commit 隐式决定 runner 镜像。
 - `BackendImageRef.image` 是 source 解析后的 digest-pinned image，必须来自 CI/CD artifact catalog、GitOps manifest 或 manager allowlist；客户端不能在 run payload 中传任意可变镜像。
 - runner Job 创建前必须先用 `source` 解析 env image identity，并优先从 artifact catalog / registry 复用已有 digest；未命中只能返回明确 build-required 或进入受控 CI/CD，不能在普通任务容器内现装依赖。
 - v0.1 可以继续使用现有 agentrun runner 镜像，不要求立即拆独立 backend image。