OpenWiki 发布失败时，按这五层排查

01｜找不到 CLI 或 Agent Skill

command -v ow 失败就先解决安装和 PATH；ow 能运行但 Agent 不会用，跑 agent doctor，看是不是装到了错误目标或版本已经落后。

command -v ow
ow agent doctor --target auto

重新执行 setup 或 login。不要把 token 粘进脚本、文档或截图；确认凭据保存后，再重试最小发布命令。

ow setup --target auto

先看第一条结构化诊断，回到草稿源修。不要编辑生成后的 JSON 或 ZIP；那会破坏确定性和完整性关系。

ow a2ui draft status ./artifact
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw

raw Markdown、HTML、目录和 stdin 不能直接发布。要么用 typed draft 重写为 .mdw，要么选择能原样托管该文件的载体。

超时只说明没有在窗口内收到决定，不代表拒绝，更不代表批准。报告现状，按授权重新等待或再次发起。

常见问题

为什么本地 check 通过，Hosted 仍可能拒绝？

服务端还会复核包完整性、安全规则、身份和产品边界；本地通过是必要条件，不是绕过服务端校验的凭证。

可以通过改生成文件快速修好吗？

不可以。应修改草稿源或命令输入，再重新 build。

使用真实工作流

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