帮助 · 发布

第一次发布 OpenWiki 文档:从草稿到可分享链接

先说最容易踩的坑:OpenWiki 发布的不是一份随手写下的 Markdown,也不是一个 HTML 文件,而是经过本地校验、内容与呈现绑定明确的 .mdw 包。这样多一步,换来的是稳定版本、可复查来源和可预测渲染。

更新于 2026 年 8 月 3 日产品文档
OpenWiki 的真实报告页面与稳定文档身份
真实发布结果:本地校验后的类型化文档,会成为适合读者浏览的稳定页面。

01|先确认 CLI 与 Agent Skill 真的可用

不要把“装过”当成“能用”。先检查 ow 是否在 PATH 中,再跑 doctor。doctor 通过,才说明当前 Agent 环境拿到了与 CLI 匹配的工作流说明。

command -v ow
ow agent doctor --target auto

02|把内容做成类型化草稿

先定读者、标题和文档语言,再逐步加入段落、事实、表格、图表或评审信息。生成包是构建产物,不要解压后直接改。

ow a2ui draft init ./artifact --title "Launch plan" --description "Decision-ready launch plan" --language en
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw

03|校验完成后再发布

check 看结构和绑定,build 产出确定性包,digest 给出身份摘要。三步都成功,再发布;Hosted 还会在服务端复核一次。

ow publish ./artifact/document.mdw --no-open
产品边界

Hosted 不直接接收 Markdown、HTML、目录、stdin、Bundle JSON 或 JSON-LD。

04|把返回的链接分清楚

  1. 给普通读者发只读链接。
  2. 保留 document ID,后续修订和恢复都要用。
  3. 评审或管理链接带权限,只交给对应的人。
  4. 交付前在真实浏览器里打开一次,确认布局、图片和访问状态。

常见问题

常见问题

可以直接发布一份 Markdown 吗?

不可以。Hosted 只接收由 ow a2ui draft 构建并通过校验的 .mdw 包。

本地构建也需要登录吗?

不需要。草稿、校验、构建和 digest 都在本机完成;只有发布到 Hosted 时才需要账户凭据。

使用真实工作流

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

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