docs: 固化 Aipod imageRef 决策

2026-06-11 02:18:41 +08:00
parent 1b43af55e2
commit 6843e7517b
3 changed files with 6 additions and 1 deletions
@@ -62,6 +62,8 @@ spec:

 `imageRef` 是 Aipod work-ready 环境的声明式 source，不是最终 Kubernetes image 字符串。它回答“这个 Aipod 的基础执行镜像由哪个 Git commit 中的哪个 Dockerfile/Containerfile 构建”。

+本决策来自 `#146` 主线和 `#156` work-ready runner 收口：Aipod 装配完成后必须已经具备基础执行环境，`apt`、`apk`、`bun install`、`npm install` 或等价基础依赖安装不能成为普通任务运行时的默认前置。`imageRef` 必须先固化到 AipodSpec YAML，再由 dispatch/runner 解析为 env identity 和 digest-pinned image；不得用 prompt、payload、临时 CLI 参数或 dispatcher 当前 rollout commit 替代。
+
 最小结构：

 ```yaml
@@ -86,7 +88,7 @@ imageRef:
 仓库内置 `config/aipods/artificer.yaml`，名称为 `Artificer`。它的长期目标是承接 UniDesk 分布式开发任务：

 - 使用 `backendProfile=sub2api`，模型声明为 `gpt-5.5`，reasoning effort 为 `xhigh`。
- 通过 `imageRef` 引用 AgentRun `v0.1` env image Dockerfile source；启动时必须复用已物化的 digest-pinned env image，不能把依赖安装留给任务运行时。
+- 通过 `imageRef` 引用 AgentRun `v0.1` env image Dockerfile source；当前默认值是 `repoUrl=git@github.com:pikasTech/agentrun.git`、`commitId=6601b4afb4870ecec62f14459e14202e5ccca7ec`、`dockerfilePath=deploy/container/Containerfile`。启动时必须复用已物化的 digest-pinned env image，不能把依赖安装留给任务运行时。
 - 通过 provider SecretRef `agentrun-v01-provider-sub2api` 获取 `auth.json` 与 `config.toml`。
 - 通过 `toolCredentials` 获取 GitHub Issue/PR 写入 token：`agentrun-v01-tool-github-pr` -> env `GH_TOKEN`。
 - 通过 `toolCredentials` 获取 UniDesk SSH 透传 token：`agentrun-v01-tool-unidesk-ssh` -> env `UNIDESK_SSH_CLIENT_TOKEN`。