# 根式与工作区式更新差异

两套管理协议不能只换路径。分别确认字段、枚举、空值、成功码和返回包装后再调用。

| 项目 | 根式 | 工作区式 |
| --- | --- | --- |
| 后端类型 | 字符串；非法/省略创建按 OPENAI | 数值0～6；非法拒绝，省略0。 |
| 创建提供商密钥 | OPENAI/QIANWEN/DOUBAO 检查非空 | 所选创建 owner 未把密钥非空作为统一条件；保存不证明可调用。 |
| 更新 name/key/timeout | 只应用非空/正数，空值保留 | 同类非空/正数规则，key 名为 api_key_encrypted。 |
| 更新 models | 省略/null/[] 保留，非空数组替换 | 省略/null 保留，[] 清空，非空数组替换。 |
| 重设推理 NONE | 非空协议字符串 | optional数值0；省略/null保留。 |
| 来源字段 | 未采用 | 仅 LLM；origin_ref/version 空串可清除，provider_origin 空串拒绝。 |
| 端点状态 | ONLINE/OFFLINE；非法/省略按 ONLINE | 0/1；非法拒绝，省略/null按0。 |
| Router strategy | 非法/省略按 ROUND_ROBIN | 非法拒绝，省略0。 |
| Router interval | 非正按30 | 非正按30。 |
| Router LLM retries | 非正按0 | 零/省略为0，负数按2。 |
| Router Embedding retries | 非正按2 | 非正按2。 |
| Router affinity | 省略/null按false覆盖 | 省略/null按false覆盖。 |

Root update 的空数组不会清空。工作区式虽有清空 HTTP 合同，但当前专用 Go/Python 及其 CLI 的重复字段序列化会丢失空数组。参数类型存在不等于客户端能表达所有有效 HTTP 输入，见 [模型与供给后端](../../../../../developer/cli/tasks/model-provider-backend.md)。

工作区式对象的 type=0、status=0、reasoning=0、strategy=0 和 false/空数组可从 HTTP 响应省略；顶层成功 code=0 保留。CLI JSON 还会按自身序列化省略零值。检查对象 ID、默认值与字段存在性，不能把所有缺键等同于未知或失败。
