下载当前正式包
pull 取回的是作品当前正式修订,不是浏览器页面的抓取结果。把目标文件放在明确目录,并保留原 document ID。
ow pull <document_id> -o document.mdw恢复为草稿工作区
draft open 会重建可编辑结构。先浏览状态和绑定关系,再改内容,不要把解压内部文件当作源。
ow a2ui draft open document.mdw --dir ./workspace发布前重新校验
换机器或升级 CLI 后更要跑完整 check、build 与 digest;旧包能打开,不代表新环境生成的版本一定满足当前契约。
ow a2ui draft check ./workspace
ow a2ui draft build ./workspace
ow a2ui digest ./workspace/document.mdw追加到原作品,而不是另起炉灶
只要读者任务和作品身份没变,就用 --update。需要批准时加 --review,让新候选与当前版保持隔离。
ow publish ./workspace/document.mdw --update <document_id> --review --no-open常见问题
常见问题
pull 会下载 HTML 页面吗?
不会。它下载类型化 .mdw 包,适合恢复和继续创作。
恢复后可以直接用新 URL 发布吗?
可以新建,但如果仍是同一作品,应该用原 document ID 更新,保留 canonical 身份。
使用真实工作流
把 Agent 创作的作品发表出来。
让每份报告、文档或计划拥有面向读者的页面;批注、评审决定和正式版本都从这里回到 Agent。