帮助 · 版本更新

为已有 OWL Compose 作品发表新版本

新的正式版本会推进作品的当前版本,但不会重写任何旧的不可变版本。

更新于 2026 年 9 月 5 日产品文档OWL Compose CLI 0.1.3 and laterOWL Compose Product

修改作者真源

从保留的 OWX 与冻结输入开始。尤其是事实或来源纠错,应记录内容为什么变化。

重新构建产物

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

显式指定已有作品

首次成功后,CLI 也可能保留产物目录绑定。document ID 应留在包元数据与 CI 秘密边界,不要在作品尚未正式策展时写进公共正文。

ow publish ./artifact/document.json --update <document_id>

同时验证当前版本与固定版本

  1. 在作者页确认预期版本号。
  2. 检查当前读者预览。
  3. 打开新固定版本预览。
  4. 确认旧固定版本没有变化。
  5. 核对现有 view link 是否仍对应预期受众,不合适的立即撤销。

常见问题

常见问题

新版本会覆盖旧版本吗?

不会。每个已发表版本保持不可变,只是作品的 current 指针推进到新版本。

什么时候该用 --new-document?

读者任务、所有者、主题或证据边界发生实质变化时,应创建新身份。

使用真实工作流

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

安装 CLI,用 OWX 创作并在本地校验,然后发表一份默认私密的作品;准备分享时再显式创建读者链接。