排查 OWL Compose 安装与发表问题

找不到 ow 命令

使用 Active LTS 或 Maintenance LTS Node.js，并确认 npm 全局可执行目录在 PATH 中。权限问题优先用 Node 版本管理器修复，不要把 sudo 当成捷径。

node --version
npm --version
npm prefix --global

Agent 没有发现 OWL Compose

安装期间已经打开的 Agent 需要重启。若存在多个 target，按 ow agent --help 显示的精确目标重新运行 setup。

ow agent doctor --target auto

check 或 compile 失败

修复第一条源文件、绑定、资产或样式错误。不要改生成的 JSON，也不要删除上一份有效产物。

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

登录、发表或分享失败

1. 账号切换后运行 ow setup --relogin --target auto。
2. 发表或创建凭据前确认 Hosted 订阅有效。
3. 只有浏览器拉起失败时才用 --no-open 重试同一发表命令。
4. 读者打不开时，在“分享”页检查过期和撤销状态，再用未登录浏览器复测。