Merge authoritative main into the task branch

Why: include the current integration baseline before verification. Evidence: fetched origin/main=f97917032d143188bc7faf665aff612d9814af4e. Impact: integrate upstream changes without rewriting task history. Refs: task-sync
2026-10-20 06:55:04 +00:00
parent ff5213fd16 f97917032d
commit a577c9e11b
7 changed files with 447 additions and 1 deletions
@@ -0,0 +1,254 @@
+# 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）= 162c5a0160955989608f325b4be30458e3717d16
+- 工作区：/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 |
+|---|---|---|---|
+| 启动 | 162c5a0160955989608f325b4be30458e3717d16 | 162c5a0160955989608f325b4be30458e3717d16 | 2026-10-20T02:39:22Z |
+
+## 证据（Evidence）
+
+<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
+| 时间(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 依赖）。
+- 合入记录：待执行（合入后回填）
+- 清理记录：待执行（合入后回填）
+
+<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
+```json
+{
+  "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"
+}
+```
+
+<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
+```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"
+}
+```
+
+<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
+```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。
@@ -50,6 +50,10 @@ profiles:
    adapter: cursor
    executable: cursor-agent-stable
    model: auto
+    # Re-enabled 2026-10-20: the earlier disable was based on a misreading
+    # of ActionRequiredError — the real cause was the DM executor not
+    # passing --model auto (cursor fell back to a quota-limited model).
+    # Fixed by PR #644 (deps/development-manager pin); quota itself is fine.
    enabled: true

  antigravity:
@@ -13,7 +13,7 @@ PLUGINS    := plugins
 COMBO      := core=$(shell git -C $(CORE) rev-parse --short HEAD 2>/dev/null)+backend=$(shell git -C $(BACKEND) rev-parse --short HEAD 2>/dev/null)+frontend=$(shell git -C $(FRONTEND) rev-parse --short HEAD 2>/dev/null)+ui=$(shell git -C $(UI) rev-parse --short HEAD 2>/dev/null)+agentcmd=$(shell git -C deps/agent-command rev-parse --short HEAD 2>/dev/null)+documents=$(shell git -C modules/documents rev-parse --short HEAD 2>/dev/null)+native=$(shell git -C deps/agent-native rev-parse --short HEAD 2>/dev/null)+squad=$(shell git -C deps/agent-squad rev-parse --short HEAD 2>/dev/null)+intent=$(shell git -C deps/agent-intent rev-parse --short HEAD 2>/dev/null)
 VERSION    := $(shell git describe --tags --always --dirty 2>/dev/null)+$(COMBO)

-.PHONY: help sync status build frontend svc svc-list svc-info svc-commits svc-history svc-update svc-recover svc-watchdog test-backend test-backend-pg test-multi-instance test-lifecycle test-regulations-kb test-frontend test-ui test-core test-agentcmd test-pins test-libs dev pin clean setup precheck task-triage task-triage-decide task-start task-resume task-sync task-close task-finish task-pr-check ci-wait facts-verify evidence version agent-exec-validate agent-exec-apply agent-exec-admit
+.PHONY: help sync status build frontend svc svc-list svc-info svc-commits svc-history svc-update svc-recover svc-watchdog test-backend test-backend-pg test-multi-instance test-lifecycle test-regulations-kb test-frontend test-ui test-core test-agentcmd test-pins test-libs dev pin clean setup precheck task-triage task-triage-decide task-start task-resume task-sync task-close task-finish task-pr-check ci-wait facts-verify evidence version agent-exec-validate agent-exec-apply agent-exec-admit image-build image-verify

 version:
 	@echo "agent-system $(VERSION)"
@@ -99,6 +99,8 @@ help:
 	@echo "make dev         开发模式说明（前后端分离热更新）"
 	@echo "make pin         推进 submodule 指针到各仓远端 main（提交前须 make test 通过）"
 	@echo "make status      submodule 状态"
+	@echo "make image-build 构建 Docker 测试环境镜像 agent-system-test-env:dev"
+	@echo "make image-verify 运行镜像内环境自检 verify-env.sh"
 	@echo "make agent-exec-validate  校验 AGENT-EXECUTION.md（scripts/agent-exec validate，经 dm-server agent-exec）"
 	@echo "make agent-exec-apply RECEIPT=<path>  快进当前分支到成功收据的 transport"
 	@echo "make agent-exec-admit  校验暂存路径具备 transport 来源或属于 host 豁免"
@@ -118,6 +120,12 @@ agent-exec-apply:
 agent-exec-admit:
 	scripts/agent-exec admit --repo .

+image-build:
+	docker build -t agent-system-test-env:dev docker/
+
+image-verify:
+	docker run --rm --shm-size=1g agent-system-test-env:dev /usr/local/bin/verify-env.sh
+
 sync:
 	git submodule update --init --recursive --jobs 8

@@ -0,0 +1,50 @@
+FROM --platform=linux/amd64 ubuntu:24.04
+
+ENV DEBIAN_FRONTEND=noninteractive
+ENV PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright
+ENV PATH=/usr/local/go/bin:/usr/local/lib/nodejs/node-v26.10.0-linux-x64/bin:${PATH}
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        ca-certificates \
+        curl \
+        git \
+        libatomic1 \
+        make \
+        openssh-server \
+        sudo \
+        xz-utils \
+        software-properties-common \
+    && add-apt-repository -y ppa:deadsnakes/ppa \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends \
+        python3.14 \
+        python3.14-venv \
+    && python3.14 -m ensurepip --upgrade \
+    && ln -sf /usr/bin/python3.14 /usr/local/bin/python3 \
+    && ln -sf /usr/bin/python3.14 /usr/local/bin/python \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN curl -fsSL https://go.dev/dl/go1.27.1.linux-amd64.tar.gz -o /tmp/go1.27.1.linux-amd64.tar.gz \
+    && rm -rf /usr/local/go \
+    && tar -C /usr/local -xzf /tmp/go1.27.1.linux-amd64.tar.gz \
+    && curl -fsSL https://nodejs.org/dist/v26.10.0/node-v26.10.0-linux-x64.tar.xz -o /tmp/node-v26.10.0-linux-x64.tar.xz \
+    && mkdir -p /usr/local/lib/nodejs \
+    && tar -C /usr/local/lib/nodejs -xJf /tmp/node-v26.10.0-linux-x64.tar.xz \
+    && npx -y playwright@1.64.0 install --with-deps chromium \
+    && rm -f /tmp/go1.27.1.linux-amd64.tar.gz /tmp/node-v26.10.0-linux-x64.tar.xz \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN userdel -r ubuntu 2>/dev/null || true \
+    && groupdel ubuntu 2>/dev/null || true \
+    && groupadd --gid 1000 dev \
+    && useradd --uid 1000 --gid 1000 --create-home --shell /bin/bash dev \
+    && echo "dev ALL=(ALL) NOPASSWD:ALL" > /etc/sudoers.d/dev \
+    && chmod 0440 /etc/sudoers.d/dev \
+    && printf '\nPermitRootLogin no\nPasswordAuthentication no\nPubkeyAuthentication yes\n' >> /etc/ssh/sshd_config
+
+COPY --chmod=755 entrypoint.sh /usr/local/bin/entrypoint.sh
+COPY --chmod=755 verify-env.sh /usr/local/bin/verify-env.sh
+
+EXPOSE 22
+ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
@@ -0,0 +1,57 @@
+# Docker 测试环境镜像说明
+
+## 用途与边界
+
+本目录用于定义一个可重复构建的隔离测试环境镜像，供后续用该镜像启动一次性容器、挂载当前仓库做隔离测试。
+
+- 该镜像只提供测试运行环境，不包含仓库代码。
+- 该镜像不包含任何密钥、私钥或凭据。
+- 本仓正式交付流程仍以非容器化路径为准，此镜像仅用于辅助隔离测试。
+
+## 构建与自检
+
+在仓库根目录执行：
+
+```bash
+make image-build
+make image-verify
+```
+
+- `make image-build`：构建镜像 `agent-system-test-env:dev`。
+- `make image-verify`：运行镜像内环境自检脚本 `/usr/local/bin/verify-env.sh`。
+
+## 启动测试容器示例
+
+```bash
+docker run -d --name asdev-test --shm-size=1g -p 127.0.0.1:2222:22 -v ~/.ssh/id_ed25519.pub:/home/dev/.ssh/authorized_keys:ro -v $PWD:/workspace agent-system-test-env:dev
+```
+
+说明：
+
+- `authorized_keys` 挂载源可以替换为任意可用的 `.pub` 公钥文件。
+- 容器内 SSH 登录用户为 `dev`。
+- `dev` 用户已配置 sudo 免密。
+
+进入容器：
+
+```bash
+ssh -p 2222 dev@127.0.0.1
+```
+
+## 容器内最小测试流程
+
+```bash
+cd /workspace
+make sync
+cd modules/frontend
+npm ci
+npx playwright test
+```
+
+说明：镜像已内置 `PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright` 下的 Chromium，通常无需在容器内再次执行 `playwright install`。
+
+## 安全说明
+
+- 容器内无密码登录，仅允许公钥认证。
+- 每个容器实例在启动时独立生成 SSH host key。
+- 不要将生产凭据、私钥或其他敏感文件带进容器。
@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+mkdir -p /run/sshd
+ssh-keygen -A
+
+install -d -m 0700 -o dev -g dev /home/dev/.ssh
+
+if [ -f /home/dev/.ssh/authorized_keys ]; then
+    tmp_authorized_keys="$(mktemp)"
+    cp /home/dev/.ssh/authorized_keys "${tmp_authorized_keys}"
+    install -m 0600 -o dev -g dev "${tmp_authorized_keys}" /home/dev/.ssh/authorized_keys 2>/dev/null || {
+        chown dev:dev /home/dev/.ssh/authorized_keys 2>/dev/null || true
+        chmod 0600 /home/dev/.ssh/authorized_keys 2>/dev/null || true
+    }
+    rm -f "${tmp_authorized_keys}"
+fi
+
+if [ "$#" -gt 0 ]; then
+    exec "$@"
+fi
+
+exec /usr/sbin/sshd -D -e
@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+fail_expect() {
+    local expected="$1"
+    local actual="$2"
+    echo "校验失败: 期望: ${expected}"
+    echo "校验失败: 实际: ${actual}"
+    exit 1
+}
+
+command -v git >/dev/null 2>&1 || fail_expect "git 可执行文件存在" "git 不存在"
+command -v make >/dev/null 2>&1 || fail_expect "make 可执行文件存在" "make 不存在"
+
+go_version="$(go version 2>&1 || true)"
+[[ "${go_version}" == *"go1.27.1"* ]] || fail_expect "go version 输出包含 go1.27.1" "${go_version}"
+
+node_version="$(node --version 2>&1 || true)"
+[[ "${node_version}" == "v26.10.0" ]] || fail_expect "v26.10.0" "${node_version}"
+
+npm_version="$(npm --version 2>&1 || true)"
+[[ -n "${npm_version}" ]] || fail_expect "npm --version 有输出" "空输出"
+
+python_version="$(python3 --version 2>&1 || true)"
+[[ "${python_version}" =~ ^Python\ 3\.14\.[0-9]+$ ]] || fail_expect "Python 3.14.x" "${python_version}"
+
+if ! sshd_output="$(sshd -t 2>&1)"; then
+    fail_expect "sshd -t 检查通过" "${sshd_output}"
+fi
+
+id dev >/dev/null 2>&1 || fail_expect "用户 dev 存在" "用户 dev 不存在"
+
+sudo_list="$(sudo -l -U dev 2>&1 || true)"
+echo "${sudo_list}" | grep -q "NOPASSWD" || fail_expect "sudo -l -U dev 含 NOPASSWD" "${sudo_list}"
+
+if [ "${PLAYWRIGHT_BROWSERS_PATH:-}" != "/opt/ms-playwright" ]; then
+    fail_expect "PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright" "${PLAYWRIGHT_BROWSERS_PATH:-<未设置>}"
+fi
+
+chromium_path="$(
+    find /opt/ms-playwright -type f \( -name headless_shell -o -name chrome \) 2>/dev/null | head -n 1
+)"
+
+[ -n "${chromium_path}" ] || fail_expect "在 /opt/ms-playwright 下存在 headless_shell 或 chrome" "未找到可执行文件"
+[ -x "${chromium_path}" ] || fail_expect "chromium 可执行文件具有执行权限" "${chromium_path} 不可执行"
+
+chromium_dom="$("${chromium_path}" --headless --no-sandbox --disable-gpu --dump-dom about:blank 2>&1 || true)"
+echo "${chromium_dom}" | grep -q "<html" || fail_expect "chromium --dump-dom 输出包含 <html" "${chromium_dom}"
+
+echo "verify-env: PASS"