帮助 · 修订

更新 OpenWiki 文档,同时保留原来的 URL

一份持续维护的报告不该每次都换地址。OpenWiki 把“作品身份”和“某一版内容”分开:canonical URL 始终指向当前正式版,每个已发布版本则有自己的固定链接。

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

先提交候选修订

像首次发布一样完成 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

哪些东西不会变

  1. canonical URL 仍代表同一份作品。
  2. 旧版固定链接继续指向原内容。
  3. 旧版 PDF 与 .mdw 仍属于当时的正式版本。
  4. 候选通过发布决定前,读者看到的当前版不变。

换电脑也能接着做

先 pull 当前包,再用 draft open 恢复工作区。这样继续的是结构化源材料,不是从网页复制一份失去绑定关系的文本。

ow pull <document_id> -o document.mdw
ow a2ui draft open document.mdw --dir ./workspace

什么时候应该新建文档

如果主题、所有者、读者任务或证据边界已经换了,就该给新作品一个新身份。不要只为了继承旧链接的流量,硬把两件不同的事塞在一起。

常见问题

常见问题

更新后,之前发出去的链接会失效吗?

不会。canonical URL 保持稳定;每个正式版本也会留下不可变的固定链接。

待评审的新版本会立刻覆盖当前版吗?

不会。候选在通过发布决定前,与当前正式版分开保存。

使用真实工作流

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

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