发布、草稿与定时
三种模式
- 草稿 —— 在平台上暂存内容而不发布。安全默认,也是免费版唯一可用的模式。
- 发布 —— 尝试真正发文。仅在支持自动发布的平台上有效;在 manual 平台上会退回为草稿(见下)。
- 定时 —— 保存内容快照与解析后的目标列表,到设定时间自动发布。
每个目标会经历什么
发布时,OmniPost 会让每个目标依次经过同一组检查,并返回结构化结果。被跳过的目标不会写入记录,也不会影响安全计数器。顺序如下:
- 内容类型 —— 目标无法接收该内容类型(如把视频发到只收图文的平台)→
UNSUPPORTED_TYPE。 - 长度 —— 超出软上限只附加
CONTENT_LENGTH_WARNING,从不拦截。 - 策略 —— 你的安全规则(见下)可能跳过它:
BLACKOUT、CIRCUIT_OPEN、DAILY_LIMIT或DEDUP。 - 授权 ——
PLATFORM_NOT_LICENSED(平台需专业版)、FEATURE_NOT_AVAILABLE(免费版只能建草稿)或QUOTA_EXCEEDED(月配额用尽)。 - 校验 —— 正式发布时,缺少必填字段 →
VALIDATION_FAILED,并附上缺失项列表。 - 登录 —— 未登录 →
NEED_LOGIN。 - 发布 —— 调用适配器;成功入库,并保留一份草稿副本,方便你之后提升为正式发布。
你会拿到的结果
每个目标返回类似这些字段:平台、账号、success、stage(draft 或 published)、published(真/假)、文章或编辑器链接、记录 id,以及在相关时给出 code、error、missing 缺失字段或长度警告。
关键承诺:只有真正自动发布成功时,stage 才是 published。 否则一律为 draft。在 manual 平台上选「发布」,会返回 published: false + MANUAL_PUBLISH + 编辑器链接——绝不会给你一个假的「已完成」。
结果码
UNSUPPORTED_TYPE—— 平台不接受该内容类型。CONTENT_LENGTH_WARNING—— 超出软长度估值(不拦截)。BLACKOUT/CIRCUIT_OPEN/DAILY_LIMIT/DEDUP—— 被你的策略跳过。PLATFORM_NOT_LICENSED/FEATURE_NOT_AVAILABLE/QUOTA_EXCEEDED—— 触及套餐限制。VALIDATION_FAILED—— 正式发布缺少必填字段。NEED_LOGIN—— 该账号没有有效会话。NOT_ELIGIBLE—— 账号资格问题(未实名、等级不足、新号须先在 App 发一篇、无发布权限…),重试没有用;结果附action指向办理入口,不进补发队列。QUEUED—— 带发送间隔的发布已排队(stage: "queued"),由定时任务依次发出。SCHEDULED—— 已交给平台自带的定时发布(stage: "scheduled",scheduledFor为平台发出时间)。MANUAL_PUBLISH—— 已在 manual 平台建草稿;请手动发布。MANUAL_ONLY/DRAFT_NOT_FOUND—— 提升草稿时在边界情况下返回。
两步发布
有些流程先建草稿、稍后再发。先创建草稿、审阅,然后按记录 id 把某一篇草稿提升为正式发布。仅支持人工发布的平台会以 MANUAL_ONLY 拒绝提升。
多账号与分组
用 platforms(某平台全部已登录账号)、targets(具体账号,如 csdn:a2)或 groups(保存的命名账号集合)指定目标——可组合并自动去重。创建与编辑账户分组是专业版功能;用分组发布本身不受限。
同一篇稿发到多个目标时,targets 里的每一项都可以带自己的 title、summary、tags、category 与 extras,覆盖公共字段——一次调用就能给小红书一个 20 字标题、给头条一个 30 字标题。没带覆盖的目标行为与以前完全一致。
平台专属参数
有些平台在发布面板上有自己的选项:抖音 / 快手 / 视频号 / 小红书 / 百家号的「内容由 AI 生成」声明、视频号的「声明原创」、微博与博客园的发布形态。这些都统一声明在每个平台的 extrasSchema 里(list_platforms 可读到),编辑页的「平台专属参数」面板、MCP 工具描述和发布前校验都来自同一份声明。
- AI 生成声明默认不勾。 功能提供,用不用由你决定;勾了就随稿一起提交。
- 每个账号记住上次用的参数,下次发布自动沿用;也可用
set_account_defaults(CLI:omnipost account defaults)锁定为该账号默认值。优先级:显式传入 > 账号默认 > 上次使用 > 声明默认。 - 页面型平台的声明按钮靠真实点击完成,页面改版时可能找不到;找不到只会写进结果的
extrasIgnored,不会让发布失败。 - 每个平台的标题字数上限等写法规格也随
contentSpec一起返回,超限在发布前就会被拦下(VALIDATION_FAILED)。
安全策略
一套按账号(可选按平台)的策略,约束有风险的自动化:
- 每日上限(每账号,默认关闭)。
- 去重:N 小时内同账号同标题去重(默认 24 小时,开启)。
- 熔断:连续失败 N 次后暂停该平台(默认 5 次,冷却 30 分钟)。
- 禁发时段:设定时段内绝不发布。
- 多目标最小间隔(分钟,默认 0):一次发到多个目标时的错峰下限,发布请求没带
spacingMinutes就按它来。
被拦截的发布只回报、不入库——因此不会污染历史,也不会触发熔断计数。
定时任务
一个定时任务在创建时就锁定目标账号与内容快照(此后改分组不影响它)。后台执行器每 30 秒检查一次;应用关闭期间错过的任务会在下次启动时补发。你可以查看、立即执行、改时间、编辑或取消待执行任务。定时是专业版功能。
交给平台自带的定时发布
正式发布到头条、抖音、快手、视频号、小红书、B 站视频时,定时任务默认(deliver: auto)会立即把内容连同发出时间交给平台自带的定时发布,由平台到点发出——之后关机、登录失效都不影响;取消要到平台后台。不支持的平台和草稿照旧本地到点发;平台定时设不上(页面控件没找到、时间没填上)会在点发布之前中止,该目标自动改回本地定时并在任务里说明。deliver: local 全部本地,deliver: platform 尽量交给平台。这些开关只是让内容平台替你守时,没有任何内容经过 OmniGoAI 的服务器。头条走接口字段,其余五家靠页面控件,尚未在真机上校准,首次使用请盯一下结果。
发送间隔(错峰)
publish_post / schedule_post 的 spacingMinutes 大于 0 时,多个目标不再同时发出,而是拆成一批单目标任务按顺序每隔 N 分钟一条;立即发布会马上返回每个目标的排队结果(stage: "queued"、code: "QUEUED"、scheduledFor、batchId),定时任务页按批次显示进度,可一键取消整批。这是 agent 批量分发时的刹车,不随机、不伪装。
套餐
- 免费版 —— 8 个核心开发者平台、最多 3 个账号、每月 30 篇、仅草稿。
- 专业版 —— 全部平台、最多 50 个账号、每月 1000 篇、正式发布、Agent 自动化、定时任务与账户分组。
专业版 ¥39/月、¥99/季 或 ¥299/年——详见价格。