跳转到正文

诊断代码参考 ​

行为与约束 ​

先看退出码,再看稳定 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 验证只覆盖结构,不能替代这些语义诊断。

自动生成的诊断目录 ​

CodeFamilyEvidenceSeverityTitleCauseShortest fixJSON example
DLABI1001sceneAbi.catalogresolvederrorCatalog Duplicate RegistrationAn ID, version, dependency, metadata field, or expected Catalog hash is invalid.Refresh Catalog v2 and author only published ID/version pairs.shape
DLABI1002sceneAbi.catalogresolvederrorCatalog Unknown IdentifierAn ID, version, dependency, metadata field, or expected Catalog hash is invalid.Refresh Catalog v2 and author only published ID/version pairs.shape
DLABI1003sceneAbi.catalogresolvederrorCatalog Unsupported VersionAn ID, version, dependency, metadata field, or expected Catalog hash is invalid.Refresh Catalog v2 and author only published ID/version pairs.shape
DLABI1004sceneAbi.catalogresolvederrorCatalog Invalid MetadataAn ID, version, dependency, metadata field, or expected Catalog hash is invalid.Refresh Catalog v2 and author only published ID/version pairs.shape
DLABI1005sceneAbi.catalogresolvederrorCatalog Missing DependencyAn ID, version, dependency, metadata field, or expected Catalog hash is invalid.Refresh Catalog v2 and author only published ID/version pairs.shape
DLABI1006sceneAbi.catalogresolvederrorCatalog Expected Hash MismatchAn ID, version, dependency, metadata field, or expected Catalog hash is invalid.Refresh Catalog v2 and author only published ID/version pairs.shape
DLABI2001sceneAbi.routeOwnershipresolvederrorRoute MissingA 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
DLABI2002sceneAbi.routeOwnershipresolvederrorRoute DuplicateA 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
DLABI2003sceneAbi.routeOwnershipresolvederrorRoute Ownership ConflictA 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
DLABI2004sceneAbi.routeOwnershipresolvederrorRoute Mode UnsupportedA 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
DLABI2005sceneAbi.routeOwnershipresolvederrorRoute Category DisabledA 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
DLABI3001sceneAbi.targetStateresolvederrorTarget Color Attachment Count InvalidThe 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
DLABI3002sceneAbi.targetStateresolvederrorTarget Output Location InvalidThe 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
DLABI3003sceneAbi.targetStateresolvederrorTarget Attachment Operation InvalidThe 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
DLABI3004sceneAbi.targetStateresolvederrorTarget Depth Attachment MissingThe 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
DLABI3005sceneAbi.targetStateresolvederrorState Preset UnsupportedThe 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
DLABI3006sceneAbi.targetStateresolvederrorTarget Viewport Policy InvalidThe 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
DLABI3007sceneAbi.targetStateresolvederrorTarget Resource View UnsupportedThe 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
DLABI4001sceneAbi.bindingInterfaceresolvederrorBinding UnknownA 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
DLABI4002sceneAbi.bindingInterfaceresolvederrorBinding Required MissingA 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
DLABI4003sceneAbi.bindingInterfaceresolvederrorBinding Type MismatchA 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
DLABI4004sceneAbi.bindingInterfaceresolvederrorBinding Frequency MismatchA 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
DLABI4005sceneAbi.bindingInterfaceresolvederrorBinding Slot ConflictA 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
DLABI4006sceneAbi.bindingInterfaceresolvederrorShader Interface MismatchA 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
DLABI4007sceneAbi.bindingInterfaceresolvederrorProvider Service Closure InvalidA 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
DLABI4008sceneAbi.bindingInterfaceresolvederrorProvider Program InvalidA 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
DLABI5001sceneAbi.deviceFramebufferresolvederrorDevice Limit ExceededA 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
DLABI5002sceneAbi.deviceFramebufferresolvederrorDevice Render Target Format UnsupportedA 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
DLABI5003sceneAbi.deviceFramebufferresolvederrorFramebuffer Attachment Extent MismatchA 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
DLABI5004sceneAbi.deviceFramebufferresolvederrorFramebuffer IncompleteA 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
DLABI6001sceneAbi.fallbackSourceresolvederrorFallback Program MissingA 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
DLABI6002sceneAbi.fallbackSourceresolvederrorFallback Source Owner MixedA 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
DLABI6003sceneAbi.fallbackSourceresolvederrorFallback Source UnavailableA 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
DLAST1001customDataresolvederrorRaw expression budget exceededVariable count or raw AST nodes, including inactive branches, exceed ABI v1 limits.Reduce variables and raw expression size.shape
DLAST1002customDataresolvederrorVariable identifier is invalidA variable ID is invalid or duplicated.Use unique case-sensitive ABI identifiers.shape
DLAST1003customDataresolvederrorExpression signature is invalidTypes, literal/default lanes, function name or arity do not match the closed ABI.Use exact typed operands and explicit casts or constructors.shape
DLAST1004customDataresolvederrorDependency depth exceededA raw AST or cross-variable reference chain exceeds depth 64.Flatten the expression and shorten reference chains.shape
DLAST1005customDataresolvederrorVariable dependency cycleVariable references form a cycle, including inactive branches.Remove cyclic references; recursive evaluation is unsupported.shape
DLAST1006customDataresolvederrorExpression reference is absentA variable, named material constant or consumer variable cannot be resolved.Declare the referenced ID and use the matching resolved material plan.shape
DLAST1007customDataresolvederrorExpression frequency is incompatibleThe declared frequency is lower than an executable dependency or input availability.Use frame/view frequency appropriate to the input contract.shape
DLAST1008customDataresolvederrorWeighted operation budget exceededThe compiled generation/frame/view instructions exceed fixed type-weighted ABI limits.Reduce expensive operations and reuse shared expressions.shape
DLAST1009customDataresolvederrorTyped input contract is unavailableThe 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
DLAST1010customDataresolvederrorOption expression is invalidAn 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
DLAST1011customDataresolvederrorMandatory constant expression failedA 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
DLAST1012customDataresolvederrorInput consumer lacks capabilityA consumer lacks required world/frame/view, phase/category or service capabilities.Provide the exact input capabilities at every consumer.shape
DLAST1013customDataresolvederrorUnit or coordinate space is incompatibleKnown units or spaces conflict, or matrix source/target spaces cannot compose.Preserve metadata and compose compatible transforms; casts cannot erase conflicts.shape
DLAST2001customDataresolvedwarningDeclared frequency is unnecessarily highThe output variable is declared at a higher frequency than its executable dependencies.Lower its declared frequency when consumers permit it.shape
DLCONTENT1001-DLCONTENT1004contentIdentityimportedSnapshoterrorContent snapshot rejectedThe 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
DLDATA1001dataAbiauthorederrorData execution is unsupportedA 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-DLDATA2002dataToolsresolvedOfflineerrorData explanation rejectedThe request contract or production data plan is invalid.Use data requestVersion 1 and fix the reported source file/pointer.shape
DLDATA3001dataDriverpublishedDataInterfaceerrorData driver evidence rejectedThe version, hash, published identity or linked layout/location is invalid.Export a fresh v5 data-driver report from the exact world/generation.shape
DLGRAPH0001-DLGRAPH0004graphresolvederrorGraph request rejectedThe 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-DLGRAPH0102graphresolvedwarningGraph evidence is partialAn 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-DLGRAPH1002graphresolvedinformation/errorResource hazard directionTwo command accesses require an explicit or inferred ordering.Add a valid dependency/order edge when the diagnostic is an error.shape
DLGRAPH1101-DLGRAPH1102graphresolvedinformation/errorMixed legacy hazard directionA command access overlaps a legacy Stage access.Add an order compatible with both the command and legacy Stage.shape
DLGRAPH1201graphresolvedinformationRead-modify-write accessOne command reads and writes the same resource.No action is needed unless the command did not intentionally request read-modify-write.shape
DLMAN0001-DLMAN0099manifestauthorederrorManifest validation failureThe production Loader rejected one or more authored values.Fix the first reported file and JSON pointer, then validate again.shape
DLMAN0101manifestauthoredwarningOptional Catalog reference unavailableAn optional service reference is not registered by this host.Remove the optional reference or install a host that publishes it.shape
DLMAT1001materialAbiauthorederrorMaterial table declaration is invalidThe pack has multiple tables or lacks Manifest v5/materials ABI v1.Declare one persistent buffer with materialTable version 1.shape
DLMAT1002materialAbiresolvederrorMaterial table has an invalid consumer or writerA writer, host storage alias, or non-storage binding targets the immutable table.Use explicit readOnly storageBuffer command bindings and allocator-owned storage.shape
DLMAT1003materialAbiresolvederrorMaterial Program binding conflictsProgram invocations disagree on table binding, symbol, or SSBO slots.Give every invocation the same table binding; use Program variants for different contracts.shape
DLMAT1004materialAbidriverObservederrorMaterial table device limit or upload failureThe 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
DLMAT1005materialAbistaticSourceerrorMaterial block source violates ABI v1The 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
DLMAT1006materialAbidriverObservederrorLinked material block violates ABI v1The 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
DLPROGRAM0001programresolvederrorProgram is absentThe requested Program is not in the resolved graph.Use a Program ID from graph v2 or enable the Stage that owns it.shape
DLPUBLISH1101-DLPUBLISH1104p11ReleaseacceptanceerrorP11 publication rejectedThe 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-DLREPORT0020driverReportdriverObservederrorDriver report is invalidThe 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-DLREPORT0104driverReportdriverObservedwarning/errorDriver evidence is partialA prepared command, Program, or FBO row has incomplete evidence.Re-export after the generation finishes preparing; do not promote partial evidence.shape
DLREPORT1001-DLREPORT1010driverReportdriverObservederrorDriver report is stalePack, Manifest, Catalog, source, generation inputs, epoch, or owner identity changed.Export a new report from the exact currently published generation.shape
DLSCENE0001-DLSCENE0005sceneresolvederrorScene explanation rejectedThe Scene explain version, Catalog, route count, or route projection is invalid.Refresh Catalog v2 and fix the authored route identified by provenance.shape
DLSCENE0100sceneresolvedinformationLegacy Manifest has no Scene routesManifest 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-DLSCHEMA1003schemaauthorederrorSchema operation rejectedThe 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-DLSCHEMA2002schemaauthorederrorSchema bundle differsA 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-DLSHADER0302shaderstaticReflectionerrorShader preprocessing failureA source/include path or preprocessor conditional is invalid.Fix the reported source line and keep includes inside the selected owner root.shape
DLTOOL1001-DLTOOL1002toolauthorederrorUnsafe documentation outputA documentation path is implicit, unsafe, reparse-backed, or non-empty.Use an explicit empty temporary directory outside the read-only publish tree.shape
DLTOOL2001-DLTOOL2004toolauthorederrorDocumentation contract mismatchA 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-DLVIS3008visualEvidencedriverObservederrorDriver/RenderDoc cross evidence rejectedThe 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 ·

ShaderPackManifestLoader.cs

作者文档 · Manifest v5 / Scene ABI v2