跳到主要内容

文档证据边界

版本兼容性

每一条命令和行为声明都应以实际产生证据的 ARC 版本来阅读。

Web Device 兼容性不只会变动一项:已安装的 ARC CLI/runtime、可能更靠前的 source checkout、站点的 source convention 和生成的 compatibility material 都可能不同。版本名字相似,不代表这些东西可以互换。

本 board 第一版使用的证据

声明类型当前证据边界
Serve-time 内容访问门、第一屏试读、access-gatearc#4065 之后的 arc 2.0.0-beta.35;2026-08-15 在 http://arcblock.localhost:4922/ 的本地采集
本地命令路径与最小站点验收隔离本地环境中的 arc 2.0.0-beta.25
Markdown Slides包含 Web Device slides widget 的本地 ARC source build;本 board 尚未记录已发布版本边界
runtime implementation 语义编写本 board 时审阅的当前 ARC source
历史 Cookbook/article/issue仅作上下文和设计历史,不作默认当前合同

本页写某条命令“已运行”时,除非页面另有目标,指的是它在 beta.25 中被实际执行过。Markdown Slides 是较新的 source-level contract:使用前先核验目标 build 包含 slides widget。写 runtime “当前读取”某目录或选择某 layout 时,依据是被审阅的 implementation;已安装版本不同时应重新核验。

复制一种 pattern 前先检查

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

兼容性决定应以已安装版本和真实本地输出为准。历史站点或文章采用了不同 pattern 时,目标版本没有实际跑过前应保留它;不要只因新文档用了新的 source-first 形式就批量转换。

让 compatibility artifact 留在自己的边界

JSON layout/configuration 与分散 .web 文件可以继续是受支持的 compatibility form。新站点应优先使用当前文档化的 AUP 与 site.yaml 形式,但生成或历史文件只能在具体 consumer 通过后再删除。一个 runtime 上 build 成功,不代表旧 deployment/runtime 也接受相同 source。

每一份 UI acceptance evidence 应记录 CLI/runtime 版本、route、locale、browser/device target 与观察结果。这比声称没有限定条件的“latest 支持”更有用。