1. 确认安装完成
在 Agent 实际创作的机器上运行两条检查。doctor 必须显示目标 Agent 已就绪。
ow --version
ow agent doctor --target auto2. 创建可编辑的 OWX 作者源
让 Agent 在独立目录中创建 document.owx。下面的最小示例可以校验和编译；正式作品仍应根据读者任务与保留证据决定结构。
<ow-document owx-version="1" title="Decision brief" language="en" canvas="briefing">
<section id="overview">
<h2>Decision</h2>
<ow-text id="summary" title="Decision brief" title-level="1" body="State the decision, evidence, and next action." />
</section>
</ow-document>3. 本地校验并编译
命令失败时修改 OWX 作者源；不要改生成的 JSON 来绕过校验。
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.json4. 发表、检查，再主动分享
登录并发表编译后的 JSON，然后打开命令返回的作者管理页。普通作品默认私密。需要交付时选择“获取分享链接”，设定 24 小时、7 天或 30 天有效期并创建 view link；不再需要时从“分享”页撤销。
ow login
ow publish ./artifact/document.json产品边界
发表不会上传 Agent 对话或无关本地文件；只发送编译产物及其包内绑定资产。
常见问题
常见问题
本地编译需要订阅吗？
不需要。OWX 创作、校验、格式化、编译和 digest 都在本地运行；Hosted 发表以及创建 CLI/API 凭据需要有效订阅。
publish 会直接生成公开读者链接吗？
不会。普通作品默认私密；作者只有在明确需要分享时，才从管理页创建单独的限时 view link。
使用真实工作流
把 Agent 创作的作品发表出来。
安装 CLI，用 OWX 创作并在本地校验，然后发表一份默认私密的作品；准备分享时再显式创建读者链接。