Merge authoritative main into the task branch

Why: include the current integration baseline before verification.

Evidence: fetched origin/main=f1866dc3bb4537ac6446fdd26e696cb636b543ef.

Impact: integrate upstream changes without rewriting task history.

Refs: task-sync
This commit is contained in:
2026-10-20 07:47:29 +00:00
9 changed files with 649 additions and 1 deletions
+254
View File
@@ -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。
@@ -0,0 +1,166 @@
# feature/fast-slow-o2-i1-agent-native 任务卡
任务主记录:PR #647 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/647;Dev 草稿 PR [#647](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/647);状态:已完成(合入前闭合);owner:weichen
## 基线与授权
- 权威仓:ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git;目标分支:main;R0(initial_base_sha)= ac594c90e536cfb670e94680f045a6c8247a2513
- 工作区:/home/weichen/projects/Agent-System-Dev-wt-feature-fast-slow-o2-i1-agent-native(worktree);分支:feature/fast-slow-o2-i1-agent-native
- 分支类型:standalone;root_target:main;immediate_target:main;accepting_requirements:false
- 需求分流:verdict=NEW;selected_initiative=无;requirement_sha256=24717af8dcc91e7b1fbe4ceb92919ea31e43da66f46e51371e9ea2102d8b8cc5;triage_receipt=/tmp/o2i1-20261020/triage.json;receipt_sha256=7854667c4867dabc655b1ce4d1b8f026da6de0e2929fb26b4374353089474fa7
- 授权与交付终点:用户 2026-10-20 阶段 4/5 人审“通过”([方案](docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md) §6.1 选 C2 同时接受 `http2_stream` 与 `known_length`+`match`;§6.2 配置仅系统层、默认关闭),并要求启动 I1。终点:Agent-Native I1 草稿 PR 经独立 Review 与 CI 通过 + 阶段 6 评审包,待用户阶段 6 人审后再合入。未授权:I2/I3 启动前另行确认、P1 付费探针(另提资源方案)、部署、真实模型/付费请求。
- 交付模式:goal-first(目标、范围和交付终点一次确认;范围内连续推进)
- 实施执行:agent-per-unit(配置:AGENT-EXECUTION.md)
- 合入执行:agent(已授权交付范围内,Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入)
- 人工决策点:仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
- 当前阶段:实施与自检;当前增量:I1(Agent-Native 分支 feature/fast-slow-o2-i1-route-contract,base origin/main 9c24e22)
- 流程依据:仓库根目录 policy/delivery.md(归档后仍按仓库根目录定位)
## 目标与非目标
- 目标:对一条精确绑定的 OpenAI 兼容路由(模型 + 规范化基址 + 摘要),在流缺字面 `[DONE]` 但 C1–C9 全部成立时放行工具调用,终态标 `CompletionBasis=route_contract_eof`;合同为零值时行为逐字节等同现状。
- 受影响:Agent-Native `runtime/llm`(`Client.RouteContract`、解析器延后判定、`Event`/`TerminalObservation` 新增 `completionBasis`/`contractCheck`)、新包 `runtime/argschema`、`runtime/tools/registry.go` 委托校验。
- 非目标:不改 `StreamComplete` 语义;不泛化到其他路由/协议;Backend 配置与透传(I2)、Dev 改钉(I3)、付费探针(P1)不在本卡。
## Agent 实施收据
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md;每次尝试一行,原始日志留在源码外收据路径。
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|---|---|---|---|---|---|---|---|---|---|---|
| o2-i1-agent-native-route-contract | runtime/llm、runtime/argschema、registry.go(+test) | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 1 | cursor / auto | scope-expansion(单元包 `allowed_paths` 误用 `**` 通配,执行器按前缀匹配,7 个范围内文件被判越界;fail-stop) | 未集成 | never | /tmp/o2i1-20261020/o2-i1-receipt.attempt1-scope-expansion.json |
| o2-i1-agent-native-route-contract | 同上(改为前缀写法 `runtime/llm/`、`runtime/argschema/`,范围不变) | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 2(用户 2026-10-20 授权全新重跑) | cursor / auto | success | `899fd70`(ref refs/agent-exec/e38bcf1c…/445c377b,parent 9c24e22),`agent-exec apply` 快进集成 | never | /tmp/o2i1-20261020/o2-i1-receipt.json |
## 关联方向与规划
- 适用状态:待核对(无适用规划时说明原因)
- 主记录路径/版本:待核对(路径按仓库根目录定位,归档后不变;只引用唯一正文)
- 对应里程碑:待核对
## 需求分析
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|---|---|---|---|---|---|---|
| R1 | I1:Agent-Native `route_contract_eof` 限路由等价终态 | 符合:用户 2026-10-19 选定 O2,2026-10-20 阶段 4/5 通过 | P1 | 计划 §2 测试矩阵全部用例通过;拒绝时终态事件除 `contractCheck` 外与合同关闭 deep-equal;零值合同行为不变;现有断言不删减 | 无 | 实施中 |
## 方案与计划
- 方案引用:docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md(Dev main,PR #639 合入)
- 实施计划引用:docs/superpowers/plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md §2(I1)
- 测试计划引用:同上 §2 测试表与验证命令
## 阶段记录
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|---|---|---|---|---|---|
| 需求拆解 | 待定 | 待执行 | — | — | — |
| 需求评估 | 待定 | 待执行 | — | — | — |
| 需求表确认 | 待定 | 待执行 | — | — | — |
| 方案设计 | Dev 5a7a0da | 通过(C2 接受 known_length+match) | 用户 | 2026-10-20 | 阶段 4 人审 |
| 实施计划 | Dev 5a7a0da | 通过 | 用户 | 2026-10-20 | 阶段 5 人审 |
| 实施与自检 | Agent-Native 899fd70 | 完成(SELF) | cursor worker 实施;host 范围审阅与验证 | 2026-10-20 | 收据 o2-i1-receipt.json |
| 正式测试与验收 | Agent-Native 899fd70 | 阶段 6 通过(接受 C2 编号) | 用户 | 2026-10-20 | PR #48 CI GATE success;评审包 2026-10-20-fast-slow-o2-i1-review.md |
| 代码 Review | Agent-Native 899fd70 | PASS | 全新会话 code-reviewer | 2026-10-20 | 见合入与清理节 |
| 合入 | Agent-Native 2fc66be | 已合入 Agent-Native main | host | 2026-10-20 | 用户阶段 6 授权 |
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
## 探索试验与迭代
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|---|---|---|---|---|---|---|---|
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
## 同步记录
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|---|---|---|---|
| 启动 | ac594c90e536cfb670e94680f045a6c8247a2513 | ac594c90e536cfb670e94680f045a6c8247a2513 | 2026-10-20T03:22:13Z |
## 证据(Evidence)
<!-- CMD="<命令>" make evidence 写入;手抄/转写输出视为无效证据(AGENTS.md 证据与验证门禁)。 -->
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|---|---|---|---|---|---|
## 交付调度
- 调度状态:未入队;调度记录:无
- entry_id:无;attempt_id:无;窗口执行者:无
- 固定候选:无(base/head、组件与相关配置引用实际尝试)
- 调度依据:policy/delivery.md#合入调度
- 固定后证据:源码外 RECEIPT;实际结果后按授权原样导入和闭合
## 结果与验证
- 结果:I1 在 Agent-Native 分支 `feature/fast-slow-o2-i1-route-contract`(`899fd70`,草稿 PR #48)交付;阶段 6 评审包 docs/superpowers/specs/2026-10-20-fast-slow-o2-i1-review.md。
- 验证:host(SELF)@899fd70 vet、定向测试(含 -race)、`go test ./...` PASS;CI(GATE)PR #48 三项 success;独立 Review PASS。
- 影响与剩余项:仅 Agent-Native `runtime/llm`、`runtime/argschema`、registry 委托;合同默认关闭。剩余:用户阶段 6;I2、I3、P1;评审包第 3 节非阻塞项。
## 规划进展与下一步
- 本次推进/剩余:待核对(依据实际成果更新适用方案/规划)
- 首选下一任务:待核对(无适用规划、已完成或受阻时如实说明,不虚构任务)
- 推荐依据:待填写
- 前置条件/待确认:待核对
- 预期产物/验收条件:待定义
- 重复任务核对:待核对(已有/在途任务、PR 与规划记录)
- 启动授权:未授权(建议不自动启动新任务,仍须明确授权)
## 合入与清理
- Review 记录:Cursor Task 子代理 code-reviewer(fresh_session=true,session=531ce711-73e7-44d8-8b9e-ed90d93856f7;只接收需求、方案/计划、base 9c24e22/head 899fd70 与 diff,未转交实施会话);结论 PASS,0 阻塞,3 条非阻塞记入评审包第 3 节;评审者自跑 vet 与 -race 定向测试通过(SELF)。
- CI 记录(Agent-Native):PR #48 head `899fd70d27dd25bb88088a677546a71e54a86d9e` commit status success:`ci / vet-and-test`(runs/4350/jobs/7018)、`ci / docker-checkout-hostgateway`(runs/4350/jobs/7019)、`governance / governance`(runs/4351/jobs/7020)(GATE)。
- 冲突记录:NOT_RUN(最新目标同步、冲突处置、组合兼容核验及复审/补测)
- CI 记录:NOT_RUN(当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果)
- 合入记录(Agent-Native):用户 2026-10-20 阶段 6 通过;PR #48 核验 head `899fd70`、commit status success(3 项,GATE)后合入 Agent-Native main,合入提交 `2fc66be65201232ea38ba64d457efad5565d869d`;合入后 tree `720ec93` 与合入前 `git merge-tree` 预期一致。Dev 改钉在 I3 组合验证。
- 合入记录(本 PR):NOT_RUN(交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验)
- 清理记录:Agent-Native worktree `Agent-Native-wt-feature-fast-slow-o2-i1` 核验无写者、干净后移除,本地分支已删;Dev worktree 待本 PR 合入后回收。
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
```json
{
"summary_schema": 1,
"source": "SELF",
"timestamp": "2026-10-20T03:21:23.593016+00:00",
"command": "make precheck",
"exit_code": 0,
"cwd": "/home/weichen/projects/Agent-System-Dev",
"before_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
"after_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
"branch": "main",
"target_branch": "main",
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
"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=ac594c90e5",
"[remote] origin/main=ac594c90e5 ahead=0 behind=0",
"[tree] clean submodules_drift=0 uninit=0",
"[worktrees] linked=7",
"[cards] 已合入未闭合任务卡:feature-iam-role-permission-linked-capabilities.md——make task-close 回填归档(主检出运行)",
"[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] ac594c90e5(完整:ac594c90e536cfb670e94680f045a6c8247a2513)",
"[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": "8354ba7addbd3c5505eb65459b25cc49dc9c6513d9a4e8f6b38dc9f448b3f478",
"receipt_sha256": "a0e06fafe3a01436440290d8fe41abd0581c817dde2ad3481497f95cae50a473",
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/a0e06fafe3a01436440290d8fe41abd0581c817dde2ad3481497f95cae50a473.json"
}
```
## 闭合记录(合入前折叠)
- 本卡在 PR #647(https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/647)合入前闭合并归档,随该 PR 一同合入。
- 该 PR 的合并提交即本任务的落地记录。
- 合入后无需回填,也无需单独的闭合 PR。
| 同步(记录前对象) | d2035c76dc1cb15e01d2c184af5155d9d773cd9f | 014655339962c1057970ddc9ce9e2025fe31f902 | 2026-10-20T05:56:34Z |
| 同步(记录前对象) | f97917032d143188bc7faf665aff612d9814af4e | a577c9e11bae5655fc63a9ca313c84e70ad24aed | 2026-10-20T06:55:48Z |
+4
View File
@@ -51,6 +51,10 @@ profiles:
adapter: cursor adapter: cursor
executable: cursor-agent-stable executable: cursor-agent-stable
model: auto 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 enabled: true
antigravity: antigravity:
+9 -1
View File
@@ -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) 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) 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: version:
@echo "agent-system $(VERSION)" @echo "agent-system $(VERSION)"
@@ -99,6 +99,8 @@ help:
@echo "make dev 开发模式说明(前后端分离热更新)" @echo "make dev 开发模式说明(前后端分离热更新)"
@echo "make pin 推进 submodule 指针到各仓远端 main(提交前须 make test 通过)" @echo "make pin 推进 submodule 指针到各仓远端 main(提交前须 make test 通过)"
@echo "make status submodule 状态" @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-validate 校验 AGENT-EXECUTION.md(scripts/agent-exec validate,经 dm-server agent-exec)"
@echo "make agent-exec-apply RECEIPT=<path> 快进当前分支到成功收据的 transport" @echo "make agent-exec-apply RECEIPT=<path> 快进当前分支到成功收据的 transport"
@echo "make agent-exec-admit 校验暂存路径具备 transport 来源或属于 host 豁免" @echo "make agent-exec-admit 校验暂存路径具备 transport 来源或属于 host 豁免"
@@ -118,6 +120,12 @@ agent-exec-apply:
agent-exec-admit: agent-exec-admit:
scripts/agent-exec admit --repo . 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: sync:
git submodule update --init --recursive --jobs 8 git submodule update --init --recursive --jobs 8
+50
View File
@@ -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"]
+57
View File
@@ -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。
- 不要将生产凭据、私钥或其他敏感文件带进容器。
+23
View File
@@ -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
+50
View File
@@ -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"
@@ -0,0 +1,36 @@
# 快慢通道 O2 I1(Agent-Native `route_contract_eof`):阶段 6 评审包
- 状态:**用户阶段 6 通过(2026-10-20)**,接受第 3 节第 1 条的 C2 编号,并要求启动 I2。Agent-Native #48 已合入 main(`2fc66be`)。I3(Dev 改钉)待 I2 后启动,P1 付费探针另提资源方案。
- 日期:2026-10-20;作者:host;Dev 任务:`feature/fast-slow-o2-i1-agent-native`。
- 依据:[阶段 4 方案](2026-10-19-fast-slow-o2-route-contract-eof-design.md)与[阶段 5 计划 §2](../plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md)(用户 2026-10-20 通过;C2 同时接受 `http2_stream` 与 `known_length`+`match`)。
- 交付对象:Agent-Native 草稿 PR [#48](https://git-home.u1680832.nyat.app:30319/weichen/Agent-Native/pulls/48),base `9c24e22`(origin/main),head `899fd70`。
## 1. 交付内容
| 方案条目 | 实现 | 位置 |
|---|---|---|
| 路由合同与身份绑定(§4.1) | `RouteContractEOF{Model, BaseURL, IdentitySHA256}`、`RouteContractIdentity`、`NormalizeRouteBaseURL`(仅 https,含 userinfo/query/fragment 一律不匹配);`Client.RouteContract` 为 nil/零值即关闭;重定向逐项比较 scheme、host、port、path | `runtime/llm/route_contract.go`、`client.go` |
| 解析器延后判定(计划 §2.2) | 公开 `ParseSSE` 签名与零值行为不变;内部 `parseSSE(…, sseHooks)` 只在“有工具且缺 `[DONE]`”时把成功候选与今天的失败事件一起交给传输层;新增 `finishChunks`、`multiChoice`、`fragmentAfterFinish` 统计 | `runtime/llm/sse.go` |
| 放行条件 C1–C9(§4.2) | 按顺序判定,记录第一个不满足的编号;放行时 `StreamComplete=false`、`CompletionBasis=route_contract_eof` | `route_contract.go` `check` |
| 参数 schema 子集(§4.3) | 新包 `runtime/argschema.Validate`,由 `validateArgs`/`matchesType` 逐字迁移;registry 改为委托 | `runtime/argschema/`、`runtime/tools/registry.go` |
| 可观测性(§4.4) | `Event.CompletionBasis`;`TerminalObservation.completionBasis`/`contractCheck`(仅枚举值);`[DONE]` 成功路径记 `done_marker` | `types.go`、`client.go` |
## 2. 验证
- 实施:Cursor worker(`agent-exec`,attempt 2 success;attempt 1 因单元包 `allowed_paths` 误用 `**` 被判 scope-expansion,修正写法后经用户授权全新重跑),`agent-exec apply` 快进集成。
- host 验证(SELF)@`899fd70`:改动文件 `gofmt` 合格;`git diff --check`;`go vet ./runtime/...`;`go test ./runtime/llm/... ./runtime/argschema/... ./runtime/tools/... -count=1`(另跑 `-race`)与 `go test ./... -count=1` 全部通过。
- CI(GATE):PR #48 head `899fd70` 三项检查 success(`ci / vet-and-test`、`ci / docker-checkout-hostgateway`、`governance / governance`)。
- 独立 Review(全新会话 code-reviewer,只接收需求、base/head 与 diff;评审者自跑为 SELF):**PASS,无阻塞项**。确认零值合同行为不变;拒绝事件与合同关闭事件除 `contractCheck` 外 `reflect.DeepEqual`;`argschema` 与旧实现逐行一致;无数据竞争;计划 §2 测试矩阵每一行都有带断言的用例,并同时断言 Usage 保留与放行次数。
## 3. 需人审确认与非阻塞项
1. **C3 行的编号差异**:计划写的是 HTTP/2 `RST_STREAM`/中途断连期望 C3,实现返回 **C2**。原因是 C2(传输边界)先于 C3 判定,断流时没有见到 EOF,先在 C2 失败。结论同样是拒绝,`contractCheck` 记录的是“第一个不满足的条件”,不一定是根因。请确认接受。
2. **无工具的错误终态也会带 `contractCheck`**(非阻塞):合同开启时,纯文本流遇到供应商错误这类终态也会补一次判定(如记为 `C2`),这类流本来就不可能放行。不影响验收条件 3,也不泄漏内容;可在后续把补判限定为含工具调用的终态。
3. **重复 `finish_reason` 会被 C4 拒绝**(非阻塞,失败关闭):若供应商在 usage 块里重复 `finish_reason`,一律拒绝。MiniMax 真实流是否这样,列为 P1 付费探针的观察点。
4. **测试可加强**(非阻塞):`release/http2` 与 `close-delimited` 用例可直接断言 `BodyBoundary.FramingClass`;补一个“合同开启时纯文本流不变”的回归用例(评审者已用临时探针确认行为不变)。
## 4. 下一步(通过后)
1. 合入 Agent-Native #48(组件仓,无需 #518 窗口)。
2. 启动 I2(Backend:系统层配置键、`openLLMClient` 按身份挂合同、透传 `completionBasis`;启动前核对 Backend 是否有读 `StreamComplete` 的工具门控)。
3. I3 Dev 改钉组合验证;P1 另提资源方案。