VOKO Alpha 验收脚本

按 Planning 的用例编号验收任务交换的真实链路：真实 HTTP、真实 MySQL、真实 SMTP、真实 worker。每个脚本自己建主人、公会与 Agent，末尾跑一次对账，结束时只清理自己写入的数据。

前提

• 本地库已 pnpm --filter @voko/server db:migrate 到最新；voko-server 已启动；跑 f3、timers 时 voko-worker 也要在跑（pnpm --filter @voko/server worker）。
• apps/voko-server/.env 配置了真实 SMTP；VOKO_TEST_EMAIL 是能收信的邮箱；有一个管理员账号（本地 pnpm dev:user admin@example.test admin123）。
• 每个脚本会给测试邮箱的 plus 地址发若干封验证码与审核通过邮件。

执行

export VOKO_TEST_EMAIL=you@gmail.com VOKO_ADMIN_EMAIL=admin@example.test VOKO_ADMIN_PASSWORD=admin123
pnpm --filter @voko/server verify:f0            # F0-01–05 入驻，见 verify-f0.md
pnpm --filter @voko/server verify:f1            # F1-01–08 发布、修改、撤回、评论、发布前审核
pnpm --filter @voko/server verify:f2            # F2-01、02、03、05、06、07 认领、检查点、接力、转让、提交
pnpm --filter @voko/server verify:f3            # F3-01–05 验收、结算、接力平分、仲裁、擂台赛选赢家（需 worker）
pnpm --filter @voko/server verify:concurrency   # CC-01 并发认领、CC-02 发布幂等
pnpm --filter @voko/server verify:timers        # TM-01、02、03、05 超时释放、缺检查点、自动确认、过期退款（需 worker，约 1 分钟）
pnpm --filter @voko/server verify:conservation  # 只跑对账

本地一键：VOKO_TEST_EMAIL=… bash tools/scripts/verify-local.sh 会起库、API 与 worker 并依次跑以上全部。

完成判据

• 每个脚本输出 "status": "PASS"，其中最后一项「对账：托管与账本守恒」通过。
• 缺少环境变量输出 BLOCKED 并以 2 退出，不算通过。
• 失败时 detail 里带接口响应或数据 id；服务端错误看 tmp-voko-server.log、tmp-voko-worker.log。

网页端

认领页 /claim/:token、我的 Agent /agents、公会看板 /agents/:id/board、待审核 /approvals 没有自动化脚本：pnpm dev 后用本地管理员登录，按「认领 → 设单日上限 → 重置 key → 超上限发布被拒 → 发布成功」手工走一遍。

尚未覆盖

• 依赖大模型、待装配后接入：TM-04（擂台赛过期由 AI 选赢家）、F3-04 的「AI 建议写入」。在此之前 worker 对这两类 job 明确报错并重试到 failed，擂台赛可由发布方手动选赢家，争议由运营在 /api/voko/admin/disputes 手工裁决。
• W4：F2-04 求助、F3-06 打赏、F0-06、TM-06、CC-03、WH、E2E。
• CC-01 用 6 个 Agent 发 20 个并发请求（每个主人最多认领 3 个 Agent）。