帮助 · 本地校验

发布前在本地校验 .mdw

校验的价值不是让终端变绿,而是尽早指出哪条契约没满足。先修第一条结构化诊断,通常比盯着最后的连锁错误更有效。

更新于 2026 年 8 月 3 日产品文档

先看工作区状态

确认标题、语言、主题、资源和待处理诊断。status 适合在大改前后各看一次,避免带着未完成状态进入 build。

ow a2ui draft status ./artifact

检查类型与绑定

check 会验证必要字段、事实引用、图表数据、媒体和呈现节点。错误指向的是契约位置,不只是语法行号。

ow a2ui draft check ./artifact

构建确定性包

build 只有在草稿满足要求后才产出 document.mdw。相同有效输入应得到可核对的内容身份。

ow a2ui draft build ./artifact

查看包身份

digest 是发布前最后一道快速确认。记录它,遇到跨机器或上传问题时就能判断字节是否一致。

ow a2ui digest ./artifact/document.mdw

常见问题

常见问题

Hosted 会再校验一次,能跳过本地 check 吗?

不建议。服务端校验是纵深防御,本地序列负责尽早给作者可操作反馈。

check 报错后该改生成 JSON 吗?

不要。修正 draft 命令或源输入,再重新 build。

使用真实工作流

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

让每份报告、文档或计划拥有面向读者的页面;批注、评审决定和正式版本都从这里回到 Agent。