错误归属（Error Ownership）
按 Nimi 各层把错误契约、规则前缀和权威源对应起来的参考表。
各层归属
| 层 | 归属契约 | 规则前缀 | 它持有什么 |
|---|---|---|---|
| 平台协议 | .nimi/spec/platform/core-protocol.authority.yaml | P-PROTO-* | 跨世界协议错误码、动作提示、审计事件分类 |
| Runtime | .nimi/spec/runtime/rpc-foundations.authority.yaml | K-ERR-* | reason code、错误分类、retry 与契约失败的区分 |
| Runtime 流式 | .nimi/spec/runtime/rpc-foundations.authority.yaml | K-STREAM-* | 终态帧、流级失败语义 |
| SDK | .nimi/spec/sdks/client-core.authority.yaml | S-ERROR-* | 面向 App 的错误呈现、强类型错误形态 |
| 桌面端 | .nimi/spec/desktop/shell-ui.authority.yaml | rule.nimi.desktop.shell-ui.* | UI 错误边界、retry 策略、用户侧错误渲染 |
翻译表
平台到 Runtime 的映射，是协议级错误与 Runtime reason code 之间的规范翻译点：config/platform-error-code-mapping.yaml。
各层各自的枚举表：
| 表 | 层 |
|---|---|
platform/kernel/tables/protocol-error-codes.yaml | 平台 |
runtime/kernel/tables/reason-codes.yaml | Runtime |
runtime/kernel/tables/error-mapping-matrix.yaml | Runtime 跨层 |
config/sdks-error-codes.yaml | SDK |
canonical/desktop/shell-runtime.authority.yaml | 桌面端 |
区分"传输恢复"和"契约失败"
| 失败类型 | 谁能恢复 | 权威来源 |
|---|---|---|
| 传输错误（网络、超时、瞬时 5xx） | retry、auth refresh | 传输 / SDK 传输契约 |
| 需要刷新认证 | auth refresh、token 轮换 | Runtime auth + SDK 传输 |
| 契约失败（强类型形态、MIME、schema、字段缺失） | retry 不能救；fail-closed | 归属契约 |
| 流式终态失败 | 流中段救不回来；发出终态失败帧 | Runtime 流式 |
retry 和 auth refresh 是传输机制，不能用来悄悄恢复 decode、content-type、schema、契约这类失败。
一次失败穿越多层
一次失败通常会跨多层。举例：上游 provider 在流式生成中途失败，会按下表展开：
| 层 | 动作 |
|---|---|
| Provider | 返回瞬时错误帧 |
| Runtime provider-health | 归到 K-ERR-* 族 |
| Runtime 流式 | 决定恢复或终结；终结则发出强类型终态失败帧 |
| Runtime 审计 | 记录失败和 trace 血缘 |
| SDK 错误呈现 | 按 S-ERROR-* 投出强类型 App 侧错误 |
| 桌面端 UI | 在 D-* 错误边界下呈现 |
| 用户 | 看到的是受治理的失败，而不是被伪造出来的成功 |
来源依据
.nimi/spec/platform/core-protocol.authority.yamlconfig/platform-protocol-error-codes.yamlconfig/platform-error-code-mapping.yaml.nimi/spec/runtime/rpc-foundations.authority.yaml.nimi/spec/sdks/client-core.authority.yamlconfig/sdks-error-codes.yaml.nimi/spec/desktop/shell-ui.authority.yaml.nimi/spec/desktop/shell-runtime.authority.yaml