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

2026-07-12 16:45:48 +02:00
parent e66f60f691
commit e01418e7e1
8 changed files with 25 additions and 0 deletions
@@ -218,6 +218,12 @@ NC01 `v0.3` publicExposure 以 `config/hwlab-node-lanes.yaml` 和 PK01 Caddy/FRP

 ## Code Agent 模型通道

+- HWLAB 与 AgentRun 的线上契约、版本和 commit 对齐遵循
+  [DevOps Hygiene](devops-hygiene.md#prohibited-deployment-truth)：
+  - 只允许产生非阻塞 warning 和诊断证据；
+  - 不得因此拒绝 Code Agent admission、dispatch 或实时事件流；
+  - 可安全归一化的旧请求形态必须先归一化再继续业务。
+
 HWLAB 的 DeepSeek/Codex 兼容性属于 HWLAB runtime 规则，长期真相在 HWLAB 仓库 `AGENTS.md` 和目标 lane 对应的 `docs/reference/`。UniDesk 指挥侧只保留监督边界：诊断这类问题时，先在选中 node/lane 的目标 Pod 或临时 passthrough Pod 内闭环证明 Codex stdio、Responses 请求、tool call/tool result 顺序、模型目录和真实 provider 返回，再考虑 GitOps/CI/CD；不要用完整 CI/CD 作为每轮协议试错工具。

 DeepSeek profile 应优先使用成熟 Responses/Anthropic 协议桥接方案，例如 Moon Bridge，来保留 prompt cache、tool-result 顺序和模型目录语义。HWLAB repo-owned compatibility bridge 只能承担薄层职责，例如 Codex zstd request body 解码、非 `function` tool 过滤、`/v1/models` 或 readiness 适配；不要在 UniDesk 或 HWLAB 中手写完整 Responses-to-Chat 转换器替代成熟桥接层。Secret 值、provider token 和完整模型请求正文不得写入 UniDesk 文档、issue 或日志。