微博发布
登录使用 weibo-hunter login/export,执行前检查 weibo-publish check。
weibo-publish methods 返回支持参数及取值。
weibo-publish publish --text @/绝对路径/body.txt --source-folder /绝对路径/weibo/outputs/作品 --account default
weibo-publish publish --text @/绝对路径/body.txt --source-folder /绝对路径/weibo/outputs/作品 --account default --confirm
默认只预览,不访问平台。多行正文先保存为 UTF-8 纯正文文件,用 --text @/绝对路径/body.txt 由脚本读取;不要用 $(cat ...) 或将多行文案拼进命令。路径含空格时给整个 @路径 参数加引号;文件只放正文和话题。媒体用真实本地文件。--record-title 可指定记录标题。文字、最多 15 张图片或视频;图像与视频互斥。支持 --visibility public/private/friends/fans、--topic 和 --poi-name。没有自动删除接口。文字、图文与短视频发布已有实号成功记录;更大文件的上传、其他参数组合与审核结果仍须分别核验。
视频发布先上传整份文件、确认上传与等待转码,再提交微博。上传请求默认最多等待 300 秒;预览的 video_transport 显示上传与进程总超时。慢速网络可按本次上传需要设置 PLATFORM_API_WEIBO_VIDEO_UPLOAD_TIMEOUT_SECONDS,只接受 30–900 的整数秒数;进程总超时为上传超时加 420 秒,默认 720 秒。确认发布时沿用预览的设置;调用工具的执行超时应大于进程总超时,并为前置校验和保存收据留余量。工具返回运行中时继续等待同一进程,不另起发布。
PLATFORM_API_WEIBO_VIDEO_UPLOAD_TIMEOUT_SECONDS=600 weibo-publish publish --text @/绝对路径/content.md --video /绝对路径/video.mp4 --source-folder /绝对路径/weibo/outputs/作品 --account default
核对文本、媒体、账号、可见范围与声明后,已有发布授权时加 --confirm。需要平台 AI 声明而接口没有声明字段时停止,交用户在原平台完成;不要将简介里的“AI”字样当作平台声明。不要填不存在的参数或模拟上传成功。
脚本串行发布并保存 publish-result.weibo.json,取得完整微博 ID 后生成规范链接并自动调用 published-track record,关联作品目录的 dna-meta.json 和账号 alias。提交明确成功但未返回微博 ID 时,先保存 accepted 收据,再最多查询 7 次本人作品首页(每次最多 20 条、间隔 5 秒),用本次上传的媒体 ID、作者与提交时间精确匹配视频;不按最新一条、标题或正文猜作品。
published:true, recorded:false 表示作品已识别、记录失败,重跑同一目录只补入库。accepted:true, resolution_pending:true 表示平台已接受提交,但作品 ID 尚未确认;保留 accepted 收据,稍后重跑同一目录只做结果查询,不再发布。调用工具的执行超时还应为这些查询留余量。已有 submitting/unknown 结果文件时禁止重发,先检查本人作品或原平台并由用户核实结果;不要删除收据换目录重发。下一条独立作品使用新的作品目录。
提交结果与实际可见、审核通过分开记录。返回失败、风控或超时后停止,不换通道重发。发布调用和结果文件不负责平台指标采集。
视频失败先读取返回值及收据的 diagnostic.detail.request:video_upload 的 NETWORK/timeout 表示上传请求超时;video_transcode 表示等待转码阶段;video_submit 表示最终提交阶段。诊断仅返回超时秒数、HTTP 状态和 CSRF 头是否存在,不输出 Cookie 或 Token。不要仅凭视频体积将超时判成平台大小限制,也不要把 invalid csrf token 判为整份登录态过期。
视频提交的 CSRF 头从本次实际请求 Cookie 中取 XSRF-TOKEN,包括本次流程响应的 Cookie 更新。缺少 Token 时脚本停止提交:先用 weibo-publish check 在线校验 API 会话,再用 weibo-hunter login-status 检查专属 weibo 窗口;需要重新 export 时遵循 hunter 登录指引,不从旧 profile 单独补 Token。仍被拒时保留收据与诊断交研发核查,不自动重登或删除 unknown 收据再提交。