跳到主要内容

文档证据边界

发布与兼容性

把 CLI/runtime、source checkout、生成 artifact 和 Showcase material 当作独立的兼容证据。

AUP contract 可以从四个不同层看到,它们变化速度也可能不同:

它能够证明什么
已安装 arc CLI/runtime实际运行过的命令、本地行为、诊断
当前 source checkout正在开发/审阅中的 implementation 语义
生成 JSON/artifact某个兼容 consumer 在当时所期待的形式
Showcase source/README/static page例子和历史,不证明当前注册部署

本 board 带命令的路径在 arc 2.0.0-beta.25 上运行过。来自 implementation 的陈述指向当前审阅 source;已安装 runtime 不同时应重新核验。

不假定“latest”,检查实际 target

bash
arc --version
arc dsl validate .
arc blocklet check .
arc blocklet run .

记录版本、source/artifact 形式、已注册 page/route、target renderer 和观察结果。一个实体 Showcase page 文件本身不证明 route 已注册,也不证明 remote deployment 是当前的。

JSON-first 和 DSL-first 都是受支持 source arrangement。DSL-first 项目可能虚拟暴露 JSON,或为特定 consumer 物化它。新 runtime 上 build 通过,不能用来声称旧 runtime 或未测试 device renderer 也兼容。

发现新行为时,先保留它的目标版本与证据,再把它变成公开 reference claim。