Agent-System-Dev/.task/archive/feature-docker-test-image.md

feature/docker-test-image 任务卡

任务主记录：PR #645 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/645；状态：已完成（合入前闭合）；owner：weichen

基线与授权

• 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 162c5a0160

• 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image（worktree）；分支：feature/docker-test-image

• 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false

• 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=614aefe70dd97a672de9522beee5fece3da4719ee310d1c7cfc4d13fea081ac2；triage_receipt=/tmp/docker-image-triage.json；receipt_sha256=bc1c9cab074d853273d064a98599c6ef2519aa4022f2272bcc0830d3d97d01c0

• 授权与交付终点：用户直接请求（2026-10-20）：为本系统准备 Docker 测试镜像（含系统环境、SSH、无头浏览器），后续测试用该镜像启动容器做隔离测试。终点=镜像定义与构建/验证入口合入 main：docker/ 定义文件 + Makefile image-build/image-verify + docker/README.md，镜像本机构建通过、容器内环境自检通过。未授权事项：不改动 modules/**、CI/治理脚本、部署形态（本仓交付仍非容器化）；不发布镜像到外部 registry；不把本镜像用于生产部署。

• 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）

• 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）

• 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）

• 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收

• 当前阶段：需求拆解；当前增量：I1（待定义）

• 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）

目标与非目标

目标：一份可重复构建的测试环境镜像定义（docker/），镜像内提供与本机开发一致的工具链（Go 1.27.1、Node 26.10.0、Python 3.14、git、make）、SSH 服务（仅公钥、专用 dev 用户）与无头浏览器（Playwright 1.64.0 chromium，系统级缓存 /opt/ms-playwright），供后续以 docker run 启动一次性容器、挂载仓库做隔离测试。

入口/影响：新增 docker/（Dockerfile、entrypoint.sh、verify-env.sh、README.md）；根 Makefile 新增 image-build / image-verify 两个目标。不嵌入仓库代码与任何密钥；不改变 make test/CI 行为；不引入部署容器化。

非目标：镜像注册表发布、CI 内构建镜像、多架构构建、给镜像装业务代码/子模块、Windows/macOS 镜像。

Agent 实施收据

路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。

单元 ID	预期范围	配置摘要	角色	候选顺序	attempt	CLI/模型	终态	transport	fallback	源码外收据路径
docker-test-image	docker/**、Makefile	AGENT-EXECUTION.md（agent-execution/v1）	implementation	cursor→antigravity→pi（紧急 codex）	cursor#a1（运行 1）	cursor-agent-stable/auto	failed-unknown（cursor 后端连接反复中断，exit 1）	未发生	无	/tmp/docker-image-unit1-receipt.json；隔离工作区保留于 /tmp/agent-exec-1000/ebd031a7b7be000aca6f401395d70cd1/wt-bb3cf3ec9e85
docker-test-image	同上（重派发）	同上	implementation	同上	cursor#a1（运行 2，重发前已对账+探活）	cursor-agent-stable/auto	failed-unknown（Cursor 月度额度耗尽 ActionRequiredError，非瞬时）	未发生	无	/tmp/docker-image-unit2-receipt.json；隔离工作区保留于 /tmp/agent-exec-1000/90bc3c29e3ea2d9fbebc9e376461846f/wt-c0358fa94a6b
docker-test-image	同上（误派发）	同上	implementation	同上	—	—	invalid-config（运行前检出脏：host 对 AGENT-EXECUTION.md 的直接改动被 admit 拒绝后残留，已回滚，未启动任何候选）	未发生	无	/tmp/docker-image-unit3-receipt.json
docker-test-image	同上（重派发）	AGENT-EXECUTION.md（cursor 停用后，16776aa）	implementation	antigravity→pi（紧急 codex）	agy#a1（运行 4）	antigravity/auto	failed-unknown（实现与验证全部完成、终态记录已输出，但会话尾部一次后端 API EOF 污染 result 信封，控制器 fail-closed 未建 transport；镜像已建成且 verify-env PASS 经 host 独立复核）	未发生	无	/tmp/docker-image-unit4-receipt.json；隔离区 /tmp/agent-exec-1000/78f91904001532b603bf0ceeb292b893/wt-3ec6b80250c3（含已验证实现）
docker-test-image	同上（重验证派发）	同上	implementation	同上	agy#a2（运行 5，对账后；连续第二次因传输机制的 failed-unknown 重派发，若再失败则回到用户决策，不无限循环）	待运行	NOT_RUN	NOT_RUN	NOT_RUN	/tmp/docker-image-unit5-receipt.json

• 配置摘要来源：AGENT-EXECUTION.md agent-execution 块（schema v1；implementation 候选 cursor/agy/pi，每候选至多 3 次，紧急 codex 一次，fallback_to_host=never）；运行收据由 scripts/agent-exec run 写出后原样保留在源码外路径。
• 运行 1 对账（2026-10-20）：镜像未构建（docker images 无 agent-system-test-*）、无新增容器、规范检出干净；改动仅存在于保留的隔离工作区（Makefile M + docker/ 4 文件）；cursor 探活已恢复（探针 exit 0）。据此授权同一单元重新派发（新 run，非同 run 盲重试）。
• 运行 2 对账（2026-10-20）：终态原因实为 Cursor Ultra 月度用量额度耗尽（ActionRequiredError，重置日 2026-11-10），属确定性不可用；host 依配置 enabled 机制停用 cursor 时被 pre-commit admit 拒绝（非豁免路径须 transport 来源），路由改动本身又需一次成功运行——死锁，经用户选项 1 解除（见下方决策点）。
• 运行 4 对账（2026-10-20）：worker 完成实现且四条验证自报通过，host 独立重跑 docker run --rm --shm-size=1g agent-system-test-env:dev /usr/local/bin/verify-env.sh → verify-env: PASS；失败纯属会话尾部 API EOF 污染 result 信封（raw log 尾部 streamGenerateContent: EOF），非内容缺陷。镜像 agent-system-test-env:dev 已在 daemon 中（层缓存可复用）。授权重派发运行 5 作纯重验证；若再因传输机制失败，停止并回用户决策。

关联方向与规划

• 适用状态：待核对（无适用规划时说明原因）
• 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
• 对应里程碑：待核对

需求分析

ID	描述	项目符合度及依据	优先级	验收条件	依赖	结论
R1	测试环境镜像定义：docker/ 内 Dockerfile 固定 ubuntu:24.04（amd64）+ Go 1.27.1 + Node 26.10.0 + Python 3.14（deadsnakes）+ git/make/openssh-server/sudo + Playwright 1.64.0 chromium（/opt/ms-playwright）	与本机开发工具链版本一致（实测：go1.27.1 / v26.10.0 / 3.14.8 / playwright 1.64.0），避免测试行为漂移	高	docker build -t agent-system-test-env:dev docker/ 退出 0	无	已确认
R2	SSH 就绪：容器以 root 入口前台跑 sshd；PermitRootLogin no、PasswordAuthentication no；dev 用户（UID 1000、NOPASSWD sudo）；host key 首启生成；authorized_keys 运行时只读挂载注入	隔离测试需要经 SSH 进入容器；公钥注入避免镜像携带凭据	高	容器内 sshd -t 通过；dev 存在且 sudo NOPASSWD；镜像内无任何私钥/secret	R1	已确认
R3	无头浏览器可用：镜像内预装 playwright 1.64.0 chromium 及系统依赖，ENV PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright	frontend e2e（@playwright/test ^1.50.1，解析 1.64.0）容器内可直接跑；版本对齐避免浏览器 revision 漂移	高	verify-env.sh 中 chromium --headless --dump-dom about:blank 输出 HTML	R1	已确认
R4	构建/验证入口与文档：Makefile image-build / image-verify；docker/README.md 覆盖构建、启动（端口映射、--shm-size、公钥挂载、仓库挂载 /workspace）、容器内跑 e2e 示例与安全边界	用户后续直接用这两个入口启动隔离测试容器	中	make image-build、make image-verify 可用；README 含最小可复现命令	R1–R3	已确认

方案与计划

• 方案引用：本卡「目标与非目标」+ 单元包 /tmp/unit-docker-test-image.json（digest 由运行收据记录）；固定版本事实：go1.27.1、node v26.10.0、python 3.14.8、playwright 1.64.0（本机实测于 2026-10-20）
• 实施计划引用：单单元 docker-test-image（docker/** + Makefile 内聚小任务，合为一个包）
• 测试计划引用：R1–R4 验收条件 = worker 窄检查（docker build + 容器内 verify-env.sh）；host 权威验证在 apply 后本仓重跑同两命令

阶段记录

阶段	对象版本	状态	决策/执行者	时间	依据
需求拆解	R0=162c5a0160	已完成	host 主模型	2026-10-20	AGENTS.md 路由 + policy/delivery.md
需求评估	R0=162c5a0160	已完成	host 主模型	2026-10-20	本卡需求表 R1–R4
需求表确认	R0=162c5a0160	已完成	用户直接请求即授权	2026-10-20	授权与交付终点节
方案设计	R0=162c5a0160	已完成	host 主模型	2026-10-20	见方案与计划
实施计划	R0=162c5a0160	已完成	host 主模型	2026-10-20	单元 docker-test-image（单元包 /tmp/unit-docker-test-image.json）
实施与自检	de3d3aff（transport de3d3aff285e0dcfd185c9904a3a9b01af34e2fa）	已完成	agy worker（运行 4 实现、运行 5 重验证）→ host apply	2026-10-20	/tmp/docker-image-unit5-receipt.json；运行 1–5 详见收据表
正式测试与验收	de3d3aff	已完成（SELF；GATE 待 CI）	host 主模型	2026-10-20	make image-build / image-verify 证据入卡；CI 待验
代码 Review	de3d3aff	进行中	host 主模型（policy 允许，独立于实施会话）	2026-10-20	见合入与清理节 Review 记录
合入	de3d3aff	待执行	host（授权范围内）	—	按 policy/delivery.md 合入流程
合入核验与收口	—	待执行	host	—	—

决策点（2026-10-20，已闭合）

implementation/repair 角色首候选 cursor 因月度额度耗尽必然失败，且路由配置无法由 host/worker 合规变更。选项及结果：

1. 已采纳（用户 2026-10-20 选定选项 1）：用户以自身授权在任务 worktree 编辑 AGENT-EXECUTION.md 将 cursor profile enabled: false（附注释，额度重置后恢复），并亲自 git commit --no-verify 提交为 16776aa（配置 diff 已在决策菜单中预告并经用户选择，validate 通过）。host 据此重派发，路由落到探活正常的 antigravity。额度重置后应恢复 enabled: true。
2. 用户在 Cursor 提高 Spend Limit（未采用）。
3. 等待 2026-11-10 重置（未采用）。
4. host 以 role=test 派发（未采用，角色标签与工作性质不符）。

探索试验与迭代

增量/试验	假设	范围	判断和停止条件	授权/决策依据	结果	变更影响	需重审补测
I1	docker/ 镜像定义可构建、容器内自检通过	单一交付	build+verify 通过即停，不做镜像优化迭代	授权与交付终点节	NOT_RUN	待评估	待评估

同步记录

节点	sync_base_sha	tested_head_sha	checked_at
启动	162c5a0160	162c5a0160	2026-10-20T02:39:22Z

证据（Evidence）

时间(UTC)	命令	被测HEAD	exit	来源	sha256(16)

交付调度

• 调度状态：未入队；调度记录：无
• entry_id：无；attempt_id：无；窗口执行者：无
• 固定候选：无（base/head、组件与相关配置引用实际尝试）
• 调度依据：policy/delivery.md#合入调度
• 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合

结果与验证

• 结果：docker/ 测试环境镜像定义（Dockerfile + entrypoint.sh + verify-env.sh + README.md）与根 Makefile image-build/image-verify 目标已由 worker 交付、host apply 入分支（de3d3aff）。镜像 ubuntu:24.04 + Go 1.27.1 + Node 26.10.0 + Python 3.14（deadsnakes）+ Playwright 1.64.0 chromium（/opt/ms-playwright）+ sshd（仅公钥、dev 用户 NOPASSWD sudo、root 登录关闭）。
• 验证：make image-build exit=0（SELF，证据块）；make image-verify exit=0 且 verify-env: PASS（SELF）；worker 四条自检通过；R1–R4 验收条件全部满足。已知非阻塞项：Dockerfile FROM --platform=linux/amd64 触发 buildkit 一条 lint 警告（有意钉住 amd64，不改）。CI GATE 与 Review 见合入与清理节。
• 影响与剩余项：仅新增 docker/ 与 Makefile 两个目标，不触碰 modules/CI/治理脚本；镜像不发布外部 registry。剩余：PR CI、独立 Review、合入与回收。

规划进展与下一步

• 本次推进/剩余：待核对（依据实际成果更新适用方案/规划）
• 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务）
• 推荐依据：待填写
• 前置条件/待确认：待核对
• 预期产物/验收条件：待定义
• 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
• 启动授权：未授权（建议不自动启动新任务，仍须明确授权）

合入与清理

• Review 记录：PASS（host 主模型独立 Review，非实施会话；对象 base=origin/main/d2035c76 head=b9c0fc3）。范围核对：7 文件全部在授权内（docker/ 4 文件 + Makefile 增量 + 任务卡 + AGENT-EXECUTION.md 路由调整 16776aa）；Go/CI/脚本/modules 零触碰；secret 扫描无命中（仅 task-start 等词的 sk- 误报）；Makefile 除 .PHONY 一行外纯增量。非阻塞观察：① FROM --platform=linux/amd64 触发 buildkit lint 警告（有意钉 amd64，接受）；② sshd_config 追加式覆盖依赖 stock ubuntu 默认（测试镜像可接受，verify-env 已断言 sshd -t）。
• 冲突记录：main 前进至 d2035c7（含 #644）后合并 origin/main（merge commit b9c0fc3），无冲突；新 gitlink 物化后 make test-worktree 递归核对通过；modules/frontend 仍解析 @playwright/test ^1.50.1（镜像内浏览器 1.64.0 对齐不变）。
• CI 记录：CI_SUCCESS @ b9c0fc3fa1817812295394e069b457cc098e1f24（ci / test、test-pg、svc-realcombo 全绿，runs 4360）。过程备注：首候选 HEAD 8e062ca 的 test-pg 首跑 TestArtifactFacadeCard 失败（伴随 database is closed 收尾噪音），重跑同 job 即 success，判偶发；b9c0fc3 的 test 首跑为 npm EIDLETIMEOUT 网络抖动，重跑 success。两次均非本 PR 内容缺陷（本 PR 未触碰 Go/npm 依赖）。
• 合入记录：待执行（合入后回填）
• 清理记录：待执行（合入后回填）

{
  "summary_schema": 1,
  "source": "SELF",
  "timestamp": "2026-10-20T02:38:25.695061+00:00",
  "command": "make precheck",
  "exit_code": 0,
  "cwd": "/home/weichen/projects/Agent-System-Dev",
  "before_head": "162c5a0160955989608f325b4be30458e3717d16",
  "after_head": "162c5a0160955989608f325b4be30458e3717d16",
  "branch": "main",
  "target_branch": "main",
  "target_head": "162c5a0160955989608f325b4be30458e3717d16",
  "root_target": "main",
  "immediate_target": "main",
  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "output_tail": [
    "make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
    "[repo]   branch=main head=162c5a0160",
    "[remote] origin/main=162c5a0160 ahead=0 behind=0",
    "[tree]   clean submodules_drift=0 uninit=0",
    "[worktrees] linked=6",
    "[initiatives] local cards (not authoritative): none",
    "[hooks]   core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
    "[facts]   policy/facts.md 6 条事实均在有效期内",
    "[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
    "[R0] 162c5a0160（完整：162c5a0160955989608f325b4be30458e3717d16）",
    "[worktree] before-sync: recursive component checks passed",
    "[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
    "make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
  ],
  "output_sha256": "9e1904b7470a27857bd0243bc42faff0a9eb9cafc6916ad823fb1ccfea32f3b3",
  "receipt_sha256": "838d0ce05fc8661b279c5ccd7696cbe4712cd582b3bf39411ede4265e314a7f1",
  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/838d0ce05fc8661b279c5ccd7696cbe4712cd582b3bf39411ede4265e314a7f1.json"
}

{
  "summary_schema": 1,
  "source": "SELF",
  "timestamp": "2026-10-20T04:24:06.218569+00:00",
  "command": "make image-build",
  "exit_code": 0,
  "cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image",
  "before_head": "de3d3aff285e0dcfd185c9904a3a9b01af34e2fa",
  "after_head": "de3d3aff285e0dcfd185c9904a3a9b01af34e2fa",
  "branch": "feature/docker-test-image",
  "target_branch": "main",
  "target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
  "root_target": "main",
  "immediate_target": "main",
  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "output_tail": [
    "#10 CACHED",
    "",
    "#11 exporting to image",
    "#11 exporting layers done",
    "#11 exporting manifest sha256:1b70b78c47f81555bca6525d04f8fefa836eb817d37bd018fcd71632c9cce13b done",
    "#11 exporting config sha256:af4c14981be06d79e082e1685dd6f5aac947bc2f08022de3efdb8a158d656ffb done",
    "#11 exporting attestation manifest sha256:bebc178b5c4328c737af45858184422a642deb66ac627d6cc80d6ec3c003f246 done",
    "#11 exporting manifest list sha256:b9244ca7c49a4192b6beee8cb66ea148f2b07d6c26e613f3661aba4e569b6fa4 done",
    "#11 naming to docker.io/library/agent-system-test-env:dev done",
    "#11 unpacking to docker.io/library/agent-system-test-env:dev done",
    "#11 DONE 0.0s",
    "",
    " \u001b[33m1 warning found (use docker --debug to expand):",
    "\u001b[0m - FromPlatformFlagConstDisallowed: FROM --platform flag should not use constant value \"linux/amd64\" (line 1)",
    "make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image'"
  ],
  "output_sha256": "9d5d28f761a75ec302f735b181d53f3a31893b29a7db1417da0b580d39a6ede9",
  "receipt_sha256": "10c826d7803683685c0fe49e99b8a86a04e0d675b14aad637f50220a48b13d58",
  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/10c826d7803683685c0fe49e99b8a86a04e0d675b14aad637f50220a48b13d58.json"
}

{
  "summary_schema": 1,
  "source": "SELF",
  "timestamp": "2026-10-20T04:24:15.223285+00:00",
  "command": "make image-verify",
  "exit_code": 0,
  "cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image",
  "before_head": "de3d3aff285e0dcfd185c9904a3a9b01af34e2fa",
  "after_head": "de3d3aff285e0dcfd185c9904a3a9b01af34e2fa",
  "branch": "feature/docker-test-image",
  "target_branch": "main",
  "target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
  "root_target": "main",
  "immediate_target": "main",
  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "output_tail": [
    "make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image'",
    "docker run --rm --shm-size=1g agent-system-test-env:dev /usr/local/bin/verify-env.sh",
    "verify-env: PASS",
    "make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image'"
  ],
  "output_sha256": "4e670ae97df841f706396291f73ef43e7702f9fd60cfe163b37699ca5968804a",
  "receipt_sha256": "3c69f4644d10998f86733da4486b1967e49c310aad4a932aa13a7bddaf387265",
  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/3c69f4644d10998f86733da4486b1967e49c310aad4a932aa13a7bddaf387265.json"
}

闭合记录（合入前折叠）

• 本卡在 PR #645（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/645）合入前闭合并归档，随该 PR 一同合入。
• 该 PR 的合并提交即本任务的落地记录。
• 合入后无需回填，也无需单独的闭合 PR。