docs: document caserun serverless debugging rule

2026-06-06 11:50:24 +00:00
parent 4d39d727f0
commit 5b8ddcaf01
1 changed files with 6 additions and 0 deletions
@@ -2,6 +2,12 @@

 UniDesk 是一个以主 server 为统一入口的分布式工作平台；本文件是项目顶级索引，也承担 `scripts/cli.ts` 的 CLI 使用说明入口。

+## P0 最高优先级：CaseRun 无服务与单步调试规则
+
+- P0: CaseRun、case registry 产物整理、trace 语义化、harness 诊断、短连接 CLI 和本地/目标 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 分支。