用途：将本地生成的 HTML 文档发布到 DocSmith Cloud，返回在线预览 URL，适用于需要把 doc-smith-create 产出的文档上线预览的场景。
主要能力：支持指定发布目录（--dir，默认自动检测 .aigne/doc-smith/dist 或含 assets/nav.js 的目录）；支持自定义 DocSmith Hub（--hub，默认 https://docsmith.aigne.io）；从 .aigne/doc-smith/config.yaml 读取 projectName 与 projectDesc 作为标题和描述；自动检测 GitHub 仓库并获取 owner 头像作为封面；发布后自动清除 Hub 缓存并将预览 URL 写入 config.yaml 的 appUrl 字段。
使用方式：命令为 /doc-smith-publish，可加 --dir 与 --hub 参数。若消息中含 blocklet- 开头的凭证，先执行 node {skill_path}/scripts/save-token.mjs --token "<credential>" --hub <hub-url> 保存，凭证持久化到 ~/.aigne/。发布前检查依赖：test -d {skill_path}/scripts/node_modules || (cd {skill_path}/scripts && npm install)。随后通过 node {skill_path}/scripts/publish.mjs --config-stdin 传入包含 source、hub、workspace、metadata 的配置 JSON 执行发布。
限制：需先运行 /doc-smith-create 生成文档，否则报错；config.yaml 缺失时提示非有效 workspace；401/403 会清除 token 需重新运行；Private mode 错误需改为 public 或升级账户；云端 Agent 授权超时可从 https://docsmith.aigne.io/openclaw 获取发布 prompt。