docs: 禁止线上版本契约阻塞业务

2026-07-12 16:45:48 +02:00
parent e66f60f691
commit e01418e7e1
8 changed files with 25 additions and 0 deletions
@@ -237,6 +237,10 @@ AgentRun Queue 任务如果需要调用 UniDesk 维护桥，例如 `trans` / `un

 ## AgentRun / HWLAB 协同职责边界

+- AgentRun 接收 HWLAB 请求时，微服务契约版本、source commit、resource commit、镜像 provenance 和部署对齐只属于诊断信息；完整规则见
+  [DevOps Hygiene](devops-hygiene.md#prohibited-deployment-truth)。
+- 仅由版本或契约形态差异触发的校验必须归一化并输出非阻塞 warning，不得阻止 run、command、runner 或 session admission。
+
 HWLAB 接入 AgentRun 时，必须先按公共契约和运行证据判断问题归属，再进入对应仓库修改。谁拥有缺失能力、错误语义或未修复行为，就改谁；不得为了让当前联调继续推进而在另一侧迁就、伪造语义、补观测替代实现，或把缺失能力包装成已完成。

 AgentRun 负责共享 Agent 执行基础设施本身，包括 run/command/runner-job 生命周期、bundle 物化、cancel、trace/result 元语、backend adapter 事件语义、runner 环境传递、CLI 结果查询和 OA 规格中已经承诺的能力。若这些能力缺失或行为错误，必须回到 UniDesk OA 规格确认需求，再在 `pikasTech/agentrun` 的源码、自测、CI/CD 和 `agentrun-v02` 运行面中补齐；HWLAB 不应在渲染层、adapter 层或 prompt 中推断、补造 AgentRun 没有发出的事实。