Pass、Stage 与执行关系
行为与约束
Pass 的 id/enabled 标识声明,enabledWhen 控制条件。stage 使用精确 template/version/target/phase;传统 host 入口的可接受组合在兼容结构中单列,不把 host 与 stage 随意同时使用。主线 command_list 按 commands 的作者顺序执行,跨 Pass 顺序由 ordering.after/before/requires 和访问关系解析。
inputs/outputs 是资源访问合同,programs 是本 Pass 可调用 Program 集合;它们不替代命令绑定和附件。ordering 的 ID 必须可解析,requires 不是弱排序提示。反向 phase、循环、未满足依赖与读写 hazard 应在候选图拒绝。phase 名称以生成 Catalog/token 表为准,不宣称永远固定数量。
Services 使用 id/version,可声明 required/optional,条件与 unavailable=disablePass 影响活动闭包。所需 Service 的依赖要由固定 Catalog 和真实工厂共同满足;元数据登记不等于可执行 provider。optional 不是允许一个活动 command 无视缺失的必需功能。
通过 graph dump 查看声明与活动节点、command occurrence、访问和依赖。Program-less 的 clear/copy/historyCommit 仍参与相应资源或生命周期关系,不应被只遍历 Program 的分析遗漏。
自动生成的 v5 结构
必需性只针对所展示的对象/分支。Schema 没写 default 不表示运行时没有默认值。完整定义保留条件规则;Loader 另行解析 ID、所有权、预算及设备约束。
pass · v5
| 字段 / 分支 | 本对象必需性 | 结构约束 |
|---|---|---|
commands | optional here | type="array"; items=#/$defs/command |
enabled | required | type="boolean" |
enabledWhen | optional here | type="array"; items=#/$defs/condition |
host | optional here | $ref="#/$defs/host" |
id | required | $ref="#/$defs/identifier" |
inputs | optional here | type="array" |
outputs | optional here | type="array" |
programs | optional here | type="array"; uniqueItems=true; items=#/$defs/identifier |
services | optional here | type="array"; items=#/$defs/service |
stage | optional here | $ref="#/$defs/stage" |
完整结构规则: #/$defs/pass
{
"additionalProperties": false,
"allOf": [
{
"not": {
"required": [
"stage",
"host"
]
}
}
],
"properties": {
"commands": {
"items": {
"$ref": "#/$defs/command"
},
"type": "array"
},
"enabled": {
"type": "boolean"
},
"enabledWhen": {
"items": {
"$ref": "#/$defs/condition"
},
"type": "array"
},
"host": {
"$ref": "#/$defs/host"
},
"id": {
"$ref": "#/$defs/identifier"
},
"inputs": {
"items": {
"oneOf": [
{
"$ref": "#/$defs/identifier"
},
{
"$ref": "#/$defs/resourceView"
}
]
},
"type": "array"
},
"outputs": {
"items": {
"oneOf": [
{
"$ref": "#/$defs/identifier"
},
{
"$ref": "#/$defs/resourceView"
}
]
},
"type": "array"
},
"programs": {
"items": {
"$ref": "#/$defs/identifier"
},
"type": "array",
"uniqueItems": true
},
"services": {
"items": {
"$ref": "#/$defs/service"
},
"type": "array"
},
"stage": {
"$ref": "#/$defs/stage"
}
},
"required": [
"id",
"enabled"
],
"type": "object"
}stage · v5
| 字段 / 分支 | 本对象必需性 | 结构约束 |
|---|---|---|
ordering | optional here | $ref="#/$defs/ordering" |
phase | required | enum=["modelShadow","framePrepare","shadow","opaque","sky","transparent","cloudReflection","shaftPrepare","shaftSun","cloud","particles","afterDraw","afterFinal","screenOutput"] |
target | required | enum=["world","afterDraw"] |
template | required | $ref="#/$defs/identifier" |
version | required | $ref="#/$defs/positiveVersion" |
完整结构规则: #/$defs/stage
{
"additionalProperties": false,
"properties": {
"ordering": {
"$ref": "#/$defs/ordering"
},
"phase": {
"enum": [
"modelShadow",
"framePrepare",
"shadow",
"opaque",
"sky",
"transparent",
"cloudReflection",
"shaftPrepare",
"shaftSun",
"cloud",
"particles",
"afterDraw",
"afterFinal",
"screenOutput"
]
},
"target": {
"enum": [
"world",
"afterDraw"
]
},
"template": {
"$ref": "#/$defs/identifier"
},
"version": {
"$ref": "#/$defs/positiveVersion"
}
},
"required": [
"template",
"version",
"target",
"phase"
],
"type": "object"
}host · v5
| 字段 / 分支 | 本对象必需性 | 结构约束 |
|---|---|---|
ordering | optional here | $ref="#/$defs/ordering" |
phase | required | enum=["modelShadow","framePrepare","shadow","opaque","sky","transparent","cloudReflection","shaftPrepare","shaftSun","cloud","particles","afterDraw","afterFinal","screenOutput"] |
target | required | enum=["world","afterDraw"] |
完整结构规则: #/$defs/host
{
"additionalProperties": false,
"properties": {
"ordering": {
"$ref": "#/$defs/ordering"
},
"phase": {
"enum": [
"modelShadow",
"framePrepare",
"shadow",
"opaque",
"sky",
"transparent",
"cloudReflection",
"shaftPrepare",
"shaftSun",
"cloud",
"particles",
"afterDraw",
"afterFinal",
"screenOutput"
]
},
"target": {
"enum": [
"world",
"afterDraw"
]
}
},
"required": [
"target",
"phase"
],
"type": "object"
}ordering · v5
| 字段 / 分支 | 本对象必需性 | 结构约束 |
|---|---|---|
after | optional here | type="array"; uniqueItems=true; items=#/$defs/identifier |
before | optional here | type="array"; uniqueItems=true; items=#/$defs/identifier |
requires | optional here | type="array"; uniqueItems=true; items=#/$defs/identifier |
完整结构规则: #/$defs/ordering
{
"additionalProperties": false,
"properties": {
"after": {
"items": {
"$ref": "#/$defs/identifier"
},
"type": "array",
"uniqueItems": true
},
"before": {
"items": {
"$ref": "#/$defs/identifier"
},
"type": "array",
"uniqueItems": true
},
"requires": {
"items": {
"$ref": "#/$defs/identifier"
},
"type": "array",
"uniqueItems": true
}
},
"type": "object"
}service · v5
| 字段 / 分支 | 本对象必需性 | 结构约束 |
|---|---|---|
enabledWhen | optional here | type="array"; items=#/$defs/condition |
id | required | $ref="#/$defs/identifier" |
mode | optional here | enum=["required","optional"] |
unavailable | optional here | enum=["disablePass"] |
version | required | $ref="#/$defs/positiveVersion" |
完整结构规则: #/$defs/service
{
"additionalProperties": false,
"properties": {
"enabledWhen": {
"items": {
"$ref": "#/$defs/condition"
},
"type": "array"
},
"id": {
"$ref": "#/$defs/identifier"
},
"mode": {
"enum": [
"required",
"optional"
]
},
"unavailable": {
"enum": [
"disablePass"
]
},
"version": {
"$ref": "#/$defs/positiveVersion"
}
},
"required": [
"id",
"version"
],
"type": "object"
}完整示例
来源与机器记录
字段归属清单 · Schema v5 · Catalog v2 · Completion v2
schema-v3 · schema-v4 · schema-v5 · completion-v1 · completion-v2 · temporal · settings-guide ·