docs: 固化 Aipod imageRef 决策

2026-06-11 02:18:41 +08:00
parent 1b43af55e2
commit 6843e7517b
3 changed files with 6 additions and 1 deletions
@@ -60,6 +60,8 @@ Env identity 的输入至少包含：`imageRef.repoUrl`、`imageRef.commitId`、

 `AipodSpec.spec.imageRef` 是 Aipod 启动时选择 work-ready env image 的 source truth。Queue dispatch、Session turn 和 runner Job 创建不得直接信任 prompt、payload 或 CLI 临时传入的可变 image tag；它们必须先把 `imageRef` 映射到 artifact catalog 中的 env image identity 和 digest-pinned repository digest。

+该规则是 `#146`/`#156` 的长期决策：Aipod 启动应复用 work-ready env image，基础工具、Bun/Node/npm、AgentRun 生产依赖和必要系统包在 env image 或受控预装层准备；普通任务运行时不能默认执行 `apt`、`apk`、`bun install`、`npm install` 来补齐基础环境。
+
 规则：

 - `imageRef.kind` 固定为 `env-image-dockerfile`，最小字段为 `repoUrl`、完整 `commitId` 和仓库内相对 `dockerfilePath`。