tako 文档 GitHub

T2 人工验收用例(2026-09-27)

用途:T2「HTTP + SSE 最小 UI」的 Task 5 Step 2 人工判定清单。被测对象是当前工作区 = 315e7b0 + 未提交的 internal/webui/static/index.html 改动(约 900 行)——先别 git checkout 掉,测的就是它。 机器关口(Task 5 Step 1)已于 2026-09-27 由 AI 预跑:gofmt -l 空、go build/vet 过、 go test ./... -race -count=1 9 包全绿;冒烟:服务起得来、GET / 200、非法参数 400。 全部跑完后把「结果记录表」贴回来,我负责写进 doc/11 §6 台账并做 Task 6 文档同步。

0. 预备(2 分钟)

cd yk-tako-eino
cat .env                     # 确认模型 key 在
mkdir -p /tmp/yktako-ui-test && touch /tmp/yktako-ui-test/keep.txt   # B 组的审批靶子
git rev-parse --short HEAD && git status --short                      # 记录被测版本
go run ./cmd/yktako -web 127.0.0.1:8765

浏览器(建议 Chrome)开 http://127.0.0.1:8765,DevTools 留 Console + Network 两个面板 (出错时截图用)。服务端终端全程留着,看有没有 panic。端口被占就换一个地址。

失败记录格式:编号 + 现象 + 与预期的差异,能带 Console/Network 截图最好。


A 组:基础与流式(不依赖审批)

A1 页面加载与静态挂点

  1. 浏览器打开首页。
  2. 看:输入框、右上角「新会话」「看板」按钮,状态显示「就绪」。

A2 SSE 逐事件(核心:不是跑完才一次性显示)

  1. 发:先查现在时间,再算 1234*5678,最后用一句话总结
  2. 盯着看事件出现的节奏。

A3 看板面板

  1. 发:把「整理桌面」拆成 3 步记到任务看板,然后只做第一步
  2. 看右侧看板栏;点右上角看板按钮折叠/展开;把窗口拉窄到 <900px 再看。

A4 长任务 + 停止

  1. 发:用 bash 执行 for i in 1 2 3 4 5; do sleep 3; done,然后汇报完成
  2. 运行中(状态「正在工作…」)点「停止」。

A5 新会话不继承上下文

  1. 先跑 A2 或 A3,再点右上角「新会话」(运行中会弹确认框——确认会中止当前轮)。
  2. 先问:我刚才让你做了什么?

B 组:审批回路(T2 核心,两条路径都要走)

B1 拒绝路径

  1. 发:用 bash 执行 rm -rf /tmp/yktako-ui-test
  2. 等审批卡片弹出,看卡片内容,点「拒绝」。
  1. 终端验证:ls /tmp/yktako-ui-test → 目录还在(命令真没执行)。

B2 批准路径

  1. 同 B1 的请求再来一次;这次点「批准执行」。
  2. 终端验证:ls /tmp/yktako-ui-test → 报 No such file or directory。
  3. 重建靶子:mkdir -p /tmp/yktako-ui-test && touch /tmp/yktako-ui-test/keep.txt。

B3 审批挂起时刷新页面(边界)

  1. 触发一张审批卡,先别点,直接 F5 刷新。
  2. 刷新后直接发一条普通消息(如 你好)。

B4 审批挂起时点「停止」(边界)

  1. 触发一张审批卡,点右上/底部「停止」。

C 组:并发、隔离与接口边界

C1 同会话并发 → 409(curl,不经浏览器)

SID=$(uuidgen)
curl -sN -X POST http://127.0.0.1:8765/api/chat -H 'Content-Type: application/json' \
  -d "{\"sessionId\":\"$SID\",\"message\":\"用 bash 执行 sleep 20 然后汇报\"}" >/dev/null &
sleep 3
curl -s -i -X POST http://127.0.0.1:8765/api/chat -H 'Content-Type: application/json' \
  -d "{\"sessionId\":\"$SID\",\"message\":\"第二句\"}" | head -5
kill %1

C2 会话隔离(看板不串账)

  1. 普通窗口跑一个记看板的任务(A3 的请求即可)。
  2. 开无痕窗口(新 sessionId)跑一个不同的看板任务。

C3 运行中刷新(断线语义)

  1. 跑 A4 的长任务,中途 F5。

C4 接口参数校验(curl)

curl -s -o /dev/null -w 'chat 缺字段: %{http_code}\n' -X POST http://127.0.0.1:8765/api/chat \
  -H 'Content-Type: application/json' -d '{"sessionId":"x"}'
curl -s -o /dev/null -w 'approval 非法 decision: %{http_code}\n' -X POST http://127.0.0.1:8765/api/approval \
  -H 'Content-Type: application/json' -d '{"sessionId":"x","requestId":"y","decision":"nope"}'
curl -s -o /dev/null -w 'approval 不存在 requestId: %{http_code}\n' -X POST http://127.0.0.1:8765/api/approval \
  -H 'Content-Type: application/json' -d '{"sessionId":"x","requestId":"y","decision":"approve"}'

C5 暗色适配(外观)

  1. 系统外观切到深色(macOS:系统设置 → 外观),页面自动跟随(跟随系统,没有页内开关)。

D 组:REPL 回归(另一入口不能被 T2 带坏)

D1 REPL 多步任务 + 审批

go run ./cmd/yktako     # 不带 -web
  1. 发 先查现在时间,再算 1234*5678,最后用一句话总结。
  2. 发 用 bash 执行 rm -rf /tmp/yktako-ui-test,先答 n(验证不执行),再来一次答 y(验证执行)。

明确不用测 / 不要报的(《10》§5 范围冻结)

结果记录表

用例 结果(通过/失败/跳过) 现象或截图 备注
A1 页面加载
A2 SSE 逐事件
A3 看板面板
A4 长任务+停止
A5 新会话
B1 拒绝路径
B2 批准路径
B3 挂起时刷新
B4 挂起时停止
C1 并发 409
C2 会话隔离
C3 运行中刷新
C4 参数校验
C5 暗色适配
D1 REPL 回归