docs: document caserun serverless debugging rule

2026-06-06 19:54:55 +08:00
parent 2a7fc17afb
commit 844d4a3683
1 changed files with 6 additions and 0 deletions
@@ -2,6 +2,12 @@

 HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥官和 runner 进入本仓库时的顶级索引，只放入口、一句话规则和长期参考链接；细则统一维护在 `docs/reference/`。

+## P0 CaseRun 无服务与单步调试规则
+
+- P0: v0.2 HWPOD CaseRun、case registry 产物整理、trace 语义化、harness 诊断、短连接 CLI 和 D601/G14 目标 host 上可直接运行的 runner 调试，默认是无服务工作流；只要不需要变更 cloud-api、web、gateway、GitOps、k3s runtime 或其他常驻服务，就必须直接无服务运行和验证，禁止为了运行 CaseRun 触发 CI/CD、rollout 或服务发布。
+- P0: CaseRun 卡在 hwpod-node、workspace prepare、编译、下载、串口、artifact 收集或其他基础设施步骤时，必须先把卡点拆成同一目标运行面的单步命令验证；禁止用反复全量 CaseRun 大回环替代单步定位。
+- P0: 只有单步卡点已经验证通过，且需要验证完整编排、trace 和 registry 产物时，才启动一次完整 CaseRun；完整 CaseRun 仍必须按 cli-spec 异步启动、短轮询状态、收集 trace，不得加入 evidence 自动评价、门禁或自动判断。
+
 ## P0 文档/CLI 直接主 worktree 规则

 - P0: 单纯文档、AGENTS.md、docs/reference、SPEC、短连接 CLI、trans/tran/helper 这类轻量变更，禁止为了“隔离开发”新建 git worktree；必须在当前工作线固定主 worktree 直接修改、提交并 push 到对应 remote 分支，v0.2 默认 `/root/hwlab-v02` -> `origin/v0.2`。