帮助 · 本地校验

在本地校验并编译 OWX

本地闸门会在作品到达 Hosted 发表之前检查语法、类型、绑定、组件、资产和样式合同。

更新于 2026 年 9 月 5 日产品文档OWL Compose CLI 0.1.3 and laterOWL Compose Product

运行完整闸门

自动化中使用 fmt --check。compile 具有事务性:失败时不能替换上一份有效 JSON。

ow a2ui check ./artifact/document.owx
ow a2ui fmt ./artifact/document.owx
ow a2ui fmt ./artifact/document.owx --check
ow a2ui compile ./artifact/document.owx --output ./artifact/document.json
ow a2ui digest ./artifact/document.json

用 preflight 约束必要证据形态

preflight 可以强制作品兑现所承诺的原生组件。要求应来自内容合同,而不是一套通用模板。

ow a2ui preflight ./artifact/document.owx --require ow-chart:line=1 --require ow-table=1 --min-desktop-heights 2

修复命令点名的边界

  1. 语法或未知标签:修改 OWX。
  2. 绑定缺失:修复 Dataset、Query 或 Fact 引用。
  3. 资产缺失:恢复包内文件与来源记录。
  4. quick-style 失败:补齐必要 token,并在真实节点上使用全部必需语义组。

至少检查一次真实渲染

编译成功证明类型合同成立,不证明像素正确。用真实浏览器检查溢出、裁切、空图表、移动端阅读顺序和未解析的可见值。

常见问题

常见问题

可以在编译后改 document.json 吗?

不可以。OWX 与包内输入是作者真源;修改它们并重新编译。

check 通过就代表页面显示正确吗?

不代表。check 校验作者合同;布局和视觉行为仍需真实浏览器验收。

使用真实工作流

把 Agent 创作的作品发表出来。

安装 CLI,用 OWX 创作并在本地校验,然后发表一份默认私密的作品;准备分享时再显式创建读者链接。