诊断代码参考
行为与约束
先看退出码,再看稳定 code、severity、family、evidence 与作者 provenance。修正首个有来源的错误后重新验证,避免把后续连锁错误逐一当成根因。warning 也需解释,例如 DLABI2005 的 disabled Terrain 可能隐藏世界内容;退出码 0 不等于无警告或完整画面。
原始诊断标题、原因与 shortest fix 从锁定工具输出保留,代码不翻译。下表是生成目录,不是本次触发了每一条诊断的声明。驱动、content snapshot 缺失时的 deferred/notProvided 不能自动改写成成功或错误。
结构化诊断形状
JSON 结果保留 code/message/severity 与适用的 file、JSON pointer、Program、resource、identifier/version 等上下文。provenance 指向组合前作者文件,enginePath 可指向组合后的逻辑位置;两者不能混作同一个路径。旧 CLI/RPC 的具体 envelope 以其选择的合同版本为准。
DLMAN 是 Loader 配置域,DLABI 为 Scene/接口域,DLDATA 为材质/typed data 域,P9UI 为设置 UI 域,DLTOOL 为工具/文档合同域。schema 验证只覆盖结构,不能替代这些语义诊断。
自动生成的诊断目录
| Code | Family | Evidence | Severity | Title | Cause | Shortest fix | JSON example |
|---|---|---|---|---|---|---|---|
DLABI1001 | sceneAbi.catalog | resolved | error | Catalog Duplicate Registration | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1002 | sceneAbi.catalog | resolved | error | Catalog Unknown Identifier | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1003 | sceneAbi.catalog | resolved | error | Catalog Unsupported Version | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1004 | sceneAbi.catalog | resolved | error | Catalog Invalid Metadata | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1005 | sceneAbi.catalog | resolved | error | Catalog Missing Dependency | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1006 | sceneAbi.catalog | resolved | error | Catalog Expected Hash Mismatch | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI2001 | sceneAbi.routeOwnership | resolved | error | Route Missing | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI2002 | sceneAbi.routeOwnership | resolved | error | Route Duplicate | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI2003 | sceneAbi.routeOwnership | resolved | error | Route Ownership Conflict | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI2004 | sceneAbi.routeOwnership | resolved | error | Route Mode Unsupported | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI2005 | sceneAbi.routeOwnership | resolved | error | Route Category Disabled | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI3001 | sceneAbi.targetState | resolved | error | Target Color Attachment Count Invalid | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3002 | sceneAbi.targetState | resolved | error | Target Output Location Invalid | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3003 | sceneAbi.targetState | resolved | error | Target Attachment Operation Invalid | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3004 | sceneAbi.targetState | resolved | error | Target Depth Attachment Missing | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3005 | sceneAbi.targetState | resolved | error | State Preset Unsupported | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3006 | sceneAbi.targetState | resolved | error | Target Viewport Policy Invalid | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3007 | sceneAbi.targetState | resolved | error | Target Resource View Unsupported | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI4001 | sceneAbi.bindingInterface | resolved | error | Binding Unknown | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4002 | sceneAbi.bindingInterface | resolved | error | Binding Required Missing | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4003 | sceneAbi.bindingInterface | resolved | error | Binding Type Mismatch | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4004 | sceneAbi.bindingInterface | resolved | error | Binding Frequency Mismatch | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4005 | sceneAbi.bindingInterface | resolved | error | Binding Slot Conflict | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4006 | sceneAbi.bindingInterface | resolved | error | Shader Interface Mismatch | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4007 | sceneAbi.bindingInterface | resolved | error | Provider Service Closure Invalid | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4008 | sceneAbi.bindingInterface | resolved | error | Provider Program Invalid | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI5001 | sceneAbi.deviceFramebuffer | resolved | error | Device Limit Exceeded | A real device limit, format, attachment extent, or framebuffer completeness check failed. | Reduce targets or choose supported formats/extents, then verify on the target driver. | shape |
DLABI5002 | sceneAbi.deviceFramebuffer | resolved | error | Device Render Target Format Unsupported | A real device limit, format, attachment extent, or framebuffer completeness check failed. | Reduce targets or choose supported formats/extents, then verify on the target driver. | shape |
DLABI5003 | sceneAbi.deviceFramebuffer | resolved | error | Framebuffer Attachment Extent Mismatch | A real device limit, format, attachment extent, or framebuffer completeness check failed. | Reduce targets or choose supported formats/extents, then verify on the target driver. | shape |
DLABI5004 | sceneAbi.deviceFramebuffer | resolved | error | Framebuffer Incomplete | A real device limit, format, attachment extent, or framebuffer completeness check failed. | Reduce targets or choose supported formats/extents, then verify on the target driver. | shape |
DLABI6001 | sceneAbi.fallbackSource | resolved | error | Fallback Program Missing | A BuiltIn fallback Program or its owner-isolated source closure is missing or mixed. | Use the published BuiltIn recipe unchanged and never include across Pack/BuiltIn owner roots. | shape |
DLABI6002 | sceneAbi.fallbackSource | resolved | error | Fallback Source Owner Mixed | A BuiltIn fallback Program or its owner-isolated source closure is missing or mixed. | Use the published BuiltIn recipe unchanged and never include across Pack/BuiltIn owner roots. | shape |
DLABI6003 | sceneAbi.fallbackSource | resolved | error | Fallback Source Unavailable | A BuiltIn fallback Program or its owner-isolated source closure is missing or mixed. | Use the published BuiltIn recipe unchanged and never include across Pack/BuiltIn owner roots. | shape |
DLAST1001 | customData | resolved | error | Raw expression budget exceeded | Variable count or raw AST nodes, including inactive branches, exceed ABI v1 limits. | Reduce variables and raw expression size. | shape |
DLAST1002 | customData | resolved | error | Variable identifier is invalid | A variable ID is invalid or duplicated. | Use unique case-sensitive ABI identifiers. | shape |
DLAST1003 | customData | resolved | error | Expression signature is invalid | Types, literal/default lanes, function name or arity do not match the closed ABI. | Use exact typed operands and explicit casts or constructors. | shape |
DLAST1004 | customData | resolved | error | Dependency depth exceeded | A raw AST or cross-variable reference chain exceeds depth 64. | Flatten the expression and shorten reference chains. | shape |
DLAST1005 | customData | resolved | error | Variable dependency cycle | Variable references form a cycle, including inactive branches. | Remove cyclic references; recursive evaluation is unsupported. | shape |
DLAST1006 | customData | resolved | error | Expression reference is absent | A variable, named material constant or consumer variable cannot be resolved. | Declare the referenced ID and use the matching resolved material plan. | shape |
DLAST1007 | customData | resolved | error | Expression frequency is incompatible | The declared frequency is lower than an executable dependency or input availability. | Use frame/view frequency appropriate to the input contract. | shape |
DLAST1008 | customData | resolved | error | Weighted operation budget exceeded | The compiled generation/frame/view instructions exceed fixed type-weighted ABI limits. | Reduce expensive operations and reuse shared expressions. | shape |
DLAST1009 | customData | resolved | error | Typed input contract is unavailable | The exact input ID/version is unknown or a host input is used at generation frequency. | Use a published typed input with an exact version and legal frequency. | shape |
DLAST1010 | customData | resolved | error | Option expression is invalid | An option type, float32 range or finite string enum map is incompatible. | Match the option type; map every allowed string value to a finite scalar. | shape |
DLAST1011 | customData | resolved | error | Mandatory constant expression failed | A guaranteed constant operation divides by zero, overflows, casts illegally or produces a non-finite value. | Fix the reported node; useDefault does not hide mandatory compile-time faults. | shape |
DLAST1012 | customData | resolved | error | Input consumer lacks capability | A consumer lacks required world/frame/view, phase/category or service capabilities. | Provide the exact input capabilities at every consumer. | shape |
DLAST1013 | customData | resolved | error | Unit or coordinate space is incompatible | Known units or spaces conflict, or matrix source/target spaces cannot compose. | Preserve metadata and compose compatible transforms; casts cannot erase conflicts. | shape |
DLAST2001 | customData | resolved | warning | Declared frequency is unnecessarily high | The output variable is declared at a higher frequency than its executable dependencies. | Lower its declared frequency when consumers permit it. | shape |
DLCONTENT1001-DLCONTENT1004 | contentIdentity | importedSnapshot | error | Content snapshot rejected | The snapshot exceeds budgets, has invalid identities/hash or belongs to a stale world. | Export a fresh WorldFinal snapshot and resolve against its exact identity. | shape |
DLDATA1001 | dataAbi | authored | error | Data execution is unsupported | A host predating the P11 data ABI cannot execute the declared module. | Use a P11-capable host and Manifest v5 or omit the unsupported module. | shape |
DLDATA2001-DLDATA2002 | dataTools | resolvedOffline | error | Data explanation rejected | The request contract or production data plan is invalid. | Use data requestVersion 1 and fix the reported source file/pointer. | shape |
DLDATA3001 | dataDriver | publishedDataInterface | error | Data driver evidence rejected | The version, hash, published identity or linked layout/location is invalid. | Export a fresh v5 data-driver report from the exact world/generation. | shape |
DLGRAPH0001-DLGRAPH0004 | graph | resolved | error | Graph request rejected | The graph contract, Catalog identity, manifest identity, or Program selection is incompatible. | Refresh Catalog v2 and repeat the request with a supported graph contract. | shape |
DLGRAPH0101-DLGRAPH0102 | graph | resolved | warning | Graph evidence is partial | An optional service or offline BuiltIn source could not be projected. | Inspect the message; ship the required host service or treat BuiltIn source as descriptor-only. | shape |
DLGRAPH1001-DLGRAPH1002 | graph | resolved | information/error | Resource hazard direction | Two command accesses require an explicit or inferred ordering. | Add a valid dependency/order edge when the diagnostic is an error. | shape |
DLGRAPH1101-DLGRAPH1102 | graph | resolved | information/error | Mixed legacy hazard direction | A command access overlaps a legacy Stage access. | Add an order compatible with both the command and legacy Stage. | shape |
DLGRAPH1201 | graph | resolved | information | Read-modify-write access | One command reads and writes the same resource. | No action is needed unless the command did not intentionally request read-modify-write. | shape |
DLMAN0001-DLMAN0099 | manifest | authored | error | Manifest validation failure | The production Loader rejected one or more authored values. | Fix the first reported file and JSON pointer, then validate again. | shape |
DLMAN0101 | manifest | authored | warning | Optional Catalog reference unavailable | An optional service reference is not registered by this host. | Remove the optional reference or install a host that publishes it. | shape |
DLMAT1001 | materialAbi | authored | error | Material table declaration is invalid | The pack has multiple tables or lacks Manifest v5/materials ABI v1. | Declare one persistent buffer with materialTable version 1. | shape |
DLMAT1002 | materialAbi | resolved | error | Material table has an invalid consumer or writer | A writer, host storage alias, or non-storage binding targets the immutable table. | Use explicit readOnly storageBuffer command bindings and allocator-owned storage. | shape |
DLMAT1003 | materialAbi | resolved | error | Material Program binding conflicts | Program invocations disagree on table binding, symbol, or SSBO slots. | Give every invocation the same table binding; use Program variants for different contracts. | shape |
DLMAT1004 | materialAbi | driverObserved | error | Material table device limit or upload failure | The payload, SSBO slot, or stage/combined block count exceeds the actual device limit, or upload fails. | Reduce the table or choose available SSBO bindings; inspect the GL error. | shape |
DLMAT1005 | materialAbi | staticSource | error | Material block source violates ABI v1 | The readonly std430 block, highp uvec4 layout, or precision does not match its invocation. | Include /dawnlight/materials-v1.glsl or author the exact documented raw block. | shape |
DLMAT1006 | materialAbi | driverObserved | error | Linked material block violates ABI v1 | The driver reports a missing block, wrong binding/type/offset/stride, or reflection error. | Keep the block active and inspect the linked driver layout before publication. | shape |
DLPROGRAM0001 | program | resolved | error | Program is absent | The requested Program is not in the resolved graph. | Use a Program ID from graph v2 or enable the Stage that owns it. | shape |
DLPUBLISH1101-DLPUBLISH1104 | p11Release | acceptance | error | P11 publication rejected | The independent acceptance matrix is pending, stale, incomplete or has mismatched evidence files. | Complete every P11 dimension including performance, preserve full input identities and evidence hashes. | shape |
DLREPORT0000-DLREPORT0020 | driverReport | driverObserved | error | Driver report is invalid | The report format, hash, ordering, path safety, generation inputs, or native identity is invalid. | Export a fresh report from the published generation and do not edit it. | shape |
DLREPORT0101-DLREPORT0104 | driverReport | driverObserved | warning/error | Driver evidence is partial | A prepared command, Program, or FBO row has incomplete evidence. | Re-export after the generation finishes preparing; do not promote partial evidence. | shape |
DLREPORT1001-DLREPORT1010 | driverReport | driverObserved | error | Driver report is stale | Pack, Manifest, Catalog, source, generation inputs, epoch, or owner identity changed. | Export a new report from the exact currently published generation. | shape |
DLSCENE0001-DLSCENE0005 | scene | resolved | error | Scene explanation rejected | The Scene explain version, Catalog, route count, or route projection is invalid. | Refresh Catalog v2 and fix the authored route identified by provenance. | shape |
DLSCENE0100 | scene | resolved | information | Legacy Manifest has no Scene routes | Manifest v3 uses the legacy pipeline and cannot expose Manifest v4 route records. | Migrate to Manifest v4 only when Scene category control is required. | shape |
DLSCHEMA1001-DLSCHEMA1003 | schema | authored | error | Schema operation rejected | The version, output path, or managed output tree is invalid. | Use version 3, 4 or 5 and an explicit empty or schema-managed directory; keep the v5 bundle separate. | shape |
DLSCHEMA2001-DLSCHEMA2002 | schema | authored | error | Schema bundle differs | A generated artifact is missing or does not match the code-owned bytes. | Regenerate into staging, review the diff, then run schema approve explicitly. | shape |
DLSHADER0301-DLSHADER0302 | shader | staticReflection | error | Shader preprocessing failure | A source/include path or preprocessor conditional is invalid. | Fix the reported source line and keep includes inside the selected owner root. | shape |
DLTOOL1001-DLTOOL1002 | tool | authored | error | Unsafe documentation output | A documentation path is implicit, unsafe, reparse-backed, or non-empty. | Use an explicit empty temporary directory outside the read-only publish tree. | shape |
DLTOOL2001-DLTOOL2004 | tool | authored | error | Documentation contract mismatch | A guide fence, file tree, path, or generated diagnostic table drifted. | Restore file= markers and regenerate the checked table from the code-owned Catalog. | shape |
DLVIS3001-DLVIS3008 | visualEvidence | driverObserved | error | Driver/RenderDoc cross evidence rejected | The observation, matched report, Program interface, event topology, or resource chain is invalid. | Re-export the exact generation report and recollect the selected RDC events before visual review. | shape |
完整示例
来源与机器记录
字段归属清单 · Schema v5 · Catalog v2 · Completion v2
schema-v3 · schema-v4 · schema-v5 · completion-v1 · completion-v2 · temporal · settings-guide ·