wzrrd publish 用于将静态文件和目录发布到 https://<slug>.wzrrd.sh/。其公开 CLI 与技能分发仓库为 wzrrd-sh/wzrrd-cli。
一、用途 该技能适合在用户要求提供 wzrrd 链接、分享链接或评审链接，或希望分享计划、命令输出、智能体回复等内容供他人查看时使用。发布对象是静态文件或目录，可以是单个 HTML 文件，也可以是根目录含 index.html 的目录。
二、安装 若系统中缺少 wzrrd，可执行： curl -fsSL https://wzrrd.sh/install.sh | bash 若 ~/.local/bin 不在 PATH 中，需将其加入 PATH，或直接调用 ~/.local/bin/wzrrd。
三、立即发布 命令示例： wzrrd publish --file ./site --slug demo --file 可以是单个 HTML 文件或含根级 index.html 的目录。匿名发布无需登录即可使用。匿名发布是临时的，24 小时后过期。匿名发布响应会包含 claimUrl，如果用户希望该 URL 变为永久链接，可分享或打开该 claimUrl。
四、发布计划或助手回复的评审链接 当用户说“give me a wzrrd link”“publish this plan”“make a share link”，或希望另一台机器评审工作时：只发布具体的计划或作品产物，不要发布原始聊天记录；发布前需移除密钥、私密对话片段、客户数据和仅限机器使用的凭据；优先使用包含 index.html 评审页的小型临时目录；选择易读的 slug，例如 pi-plan-review、support-flow-review 或 <project>-<topic>-review；返回可访问的实时 URL，如果是匿名发布，还需包含 claimUrl 和过期说明。 快速静态评审页模式示例（创建临时目录并写入 index.html 后发布）： site="$(mktemp -d -t wzrrd-review.XXXXXX)" cat > "$site/index.html" <<'EOF' <!doctype html> <html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Agent Review</title> <style> body { font: 16px/1.5 system-ui, sans-serif; max-width: 860px; margin: 3rem auto; padding: 0 1rem; } pre { white-space: pre-wrap; background: #f6f6f6; padding: 1rem; border-radius: 8px; } textarea { width: 100%; min-height: 12rem; font: inherit; padding: 0.75rem; } </style> </head> <body> <h1>Agent Review</h1> <p>Review this plan/work, type feedback below, then paste it back into the agent session.</p> <pre> PASTE_ESCAPED_PLAN_OR_WORK_HERE </pre> <h2>Feedback</h2> <textarea id="feedback" placeholder="Type feedback here..."></textarea> <p><button type="button" onclick="navigator.clipboard.writeText(document.getElementById('feedback').value)">Copy feedback</button></p> </body> </html> EOF wzrrd publish --file "$site" --slug demo-review 对于更精致的计划，建议编写语义化 HTML，而不是直接放入 <pre>。
五、限时发布 CLI 0.3.5 支持限时发布： wzrrd publish --file ./site --slug demo --expires-in 7d 时长别名包括 1h、24h、7d 和 month（30 天）。如果未来机器上的 CLI 版本较旧，只有在 wzrrd publish --help 列出 --expires-in 后才可使用该参数。
六、永久发布 wzrrd login wzrrd publish --file ./site --slug demo wzrrd login 会运行设备审批流程，并将作用域受限的智能体令牌存储在 ~/.config/wzrrd/auth.json。
七、配置化发布 项目可添加 wzrrd.config.json，包含 site.slug 和 publish.source，使智能体无需猜测即可运行 wzrrd publish。配置架构地址：https://wzrrd.sh/schema/config.json。
八、安全默认值 CLI 默认面向智能体采用非交互方式。已发布站点默认 noindex。仅当用户明确希望被搜索引擎索引时才添加 --index。建议发布小型静态产物。当前匿名限制较严格：总量 5 MB、单文件 1 MB、50 个文件、每 IP 每小时 10 次匿名发布。
九、诊断 排查问题前先运行： wzrrd doctor && wzrrd auth-status 验证已发布站点可使用： wzrrd site get --slug <slug>
十、返回格式 始终把实时 URL 提供给用户。如果是匿名发布，还需包含 claimUrl，并提醒除非认领，否则 24 小时后过期。
十一、当前 joelclaw 兼容性说明 截至 2026-06-02，本地 wzrrd --version 显示为 0.3.5；本地 CLI 0.3.5 支持 wzrrd publish 的 --expires-in。线上站点提供机器可读的发现入口，包括： https://wzrrd.sh/llms.txt https://wzrrd.sh/index.md https://wzrrd.sh/.well-known/agent-configuration https://wzrrd.sh/.well-known/api-catalog https://wzrrd.sh/.well-known/agent-skills/index.json https://wzrrd.sh/.well-known/mcp/server-card.json https://wzrrd.sh/.well-known/agent-card.json