跳转到正文

CLI、协议与证据合同 ​

行为与约束 ​

固定工具是 docs-tools-f8aaa5c4-w1.1。显式 CLI 把选定 JSON/text 写 stdout,诊断写 stderr;退出码 0 为命令成功,1 为合同/业务失败,2 为用法错误。没有显式子命令时是 Content-Length framed JSON-RPC 2.0 stdio,不是逐行 JSON。

操作合同与证据
catalog list --contract 2 --format jsonCatalog v2,不能把 host 标签当 release 身份
pack validate PACK --format json生产 Loader 语义,仍不编译驱动
scene explain PACK --include-inactive --format jsonScene explain v1,区分声明、活动路由与 source owner
graph dump PACK --contract 2 --include-inactivegraph v2;v5 IR v7,节点保留活动性与 provenance
program interface PACK --program ID --contract 2v5 data interface 合同;静态接口而非实际驱动
program interface PACK --program ID --driver-report FILE默认 Scene 合同 1,适用于 W4 Scene 驱动报告
driver-report inspect FILE --pack-root PACK核对报告身份与包,不能只看 report 文件存在
materials explain/layout PACK无 WorldFinal 时 mapping deferred
data explain/graph/interface PACKoffline runtimeEvaluated=false;按支持合同处理 data driver report
schema export/verify --manifest-version 5 --output DIRv5 bundle/request/index/completion v2

RPC initialize 不提供版本列表时保留 protocol 1 默认;v3 才公布新增 data methods、Program interface [1,2] 和 Schema bundle [1,2]。协商 unsupported-only 时 selectedVersion=null、compatible=false,不把最高版本偷偷当作共同支持。Manifest、Analyzer protocol、Catalog、Scene ABI、graph IR 与报告 contract 都有各自版本号。

跨检查需绑定 manifest/source/include、options/capabilities、Catalog、内容快照、generation/device 和 report hash。W4 Scene 报告不能交给 --contract 2 的 data 报告读取器。release publish 使用独立 acceptance ledger,要求完整证据与性能门;本参考或静态样例不构成正式 v5 发布授权。原始 v5 指南 DLTOOL2001 与独立网站变体的通过仍分别保留。

完整示例 ​

来源与机器记录 ​

字段归属清单 · 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