先提交候选修订
像首次发布一样完成 check、build 和 digest,然后明确指定已有文档。开启 review 后,新内容先成为候选,不会悄悄替换当前正式版。
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw
ow publish ./artifact/document.mdw --update <document_id> --review --no-open哪些东西不会变
- canonical URL 仍代表同一份作品。
- 旧版固定链接继续指向原内容。
- 旧版 PDF 与 .mdw 仍属于当时的正式版本。
- 候选通过发布决定前,读者看到的当前版不变。
换电脑也能接着做
先 pull 当前包,再用 draft open 恢复工作区。这样继续的是结构化源材料,不是从网页复制一份失去绑定关系的文本。
ow pull <document_id> -o document.mdw
ow a2ui draft open document.mdw --dir ./workspace什么时候应该新建文档
如果主题、所有者、读者任务或证据边界已经换了,就该给新作品一个新身份。不要只为了继承旧链接的流量,硬把两件不同的事塞在一起。
常见问题
常见问题
更新后,之前发出去的链接会失效吗?
不会。canonical URL 保持稳定;每个正式版本也会留下不可变的固定链接。
待评审的新版本会立刻覆盖当前版吗?
不会。候选在通过发布决定前,与当前正式版分开保存。
使用真实工作流
把 Agent 创作的作品发表出来。
让每份报告、文档或计划拥有面向读者的页面;批注、评审决定和正式版本都从这里回到 Agent。