omni-post · Cursor Skill Card

> 一线插件。一次创作 → N 平台 × M 账号 → 统一任务/截图/秒传归档。

1 · 何时触发我

代理在用户出现以下意图时优先调用 omni-post 的工具，而不是让用户 去平台 UI 手动上传：

• "这条视频同时发抖音、小红书、B 站"
• "帮我把这篇图文分发到小红书和微博"
• "明天上午 10 点 3 个账号定时发这条视频"
• "这条素材我已经发过一次了，能不能秒传归档并回填 publish_receipt 给

idea-research"

不应触发 omni-post：

• 仅生成内容，不发布 → 调 avatar-studio / seedance-video /

tongyi-image

• 仅抓平台舆情/选题 → 调 idea-research
• 需要跨平台实名认证 / 人工审核绕过 → 拒绝

2 · 工具清单（0.2.0 发布版，14 个）

| 工具名 | 用途 | 关键参数 | |---|---|---| | omni_post_publish | 创建一组发布任务（N 平台 × M 账号扇出） | asset_id, payload, platforms[], account_ids[], client_trace_id | | omni_post_schedule | 定时发布（Sprint 3 启用） | tasks[], run_at, timezone | | omni_post_retry_task | 重投失败任务，继承原 client_trace_id | task_id | | omni_post_cancel_task | 取消 pending / running 任务 | task_id | | omni_post_get_task | 查询单任务状态 | task_id | | omni_post_list_tasks | 过滤任务列表 | platform?, status?, limit? | | omni_post_ingest_asset | 由其他插件（例如 avatar-studio）直接入库一段素材 | kind, storage_path, md5?, tags[]? | | omni_post_list_assets | 素材库检索 | kind?, tag?, limit? | | omni_post_account_bind | 绑定一个平台账号（Cookie 注入或 MultiPost 引导） | platform, engine, credentials | | omni_post_account_list | 列出当前账号矩阵及健康状态 | platform? | | omni_post_account_unbind | 解绑账号并擦除 Cookie | account_id | | omni_post_selectors_probe | 自愈探针：给定 platform 单跑一次 | platform | | omni_post_settings_get | 读取插件配置 | — | | omni_post_settings_update | 更新插件配置 | 字段白名单见 SettingsUpdateRequest |

3 · 关键输入 schema

所有 POST body 都用 Pydantic v2 + extra="forbid" 严格校验（沿用 Pixelle C6，不会静默丢字段）。以 omni_post_publish 为例：

jsonc
{
  "asset_id": "ast_...",
  "payload": {
    "title": "今天在峨眉山看到的……",
    "description": "附带 Hashtag 说明",
    "tags": ["峨眉山", "旅行"],
    "cover_asset_id": "ast_...?",
    "topic": "旅行"
  },
  "platforms": ["douyin", "rednote", "bilibili"],
  "account_ids": ["acc_...", "acc_..."],
  "client_trace_id": "2026-04-24T10:00:00Z-douyin-峨眉山"
}

返回 {"task_ids": ["tsk_...", ...]}；后续状态走 SSE plugin:omni-post:task_update 推送，UI 端 Tasks Tab 自动更新。

4 · 错误码速查

13 类 ErrorKind（9 标准 + 4 omni-post 专属），每条都有中英 ErrorHint：

| kind | 典型触发 | 代理处置 | |---|---|---| | network / timeout | 上传流量抖动、渲染超时 | 指数退避重试 | | rate_limit | 插件自身排队过于激进 | 让 pipeline 回退 | | rate_limited_by_platform | 平台实际限频 | 冷却 10 min 再试 | | auth / cookie_expired | Cookie 失效或首次登录 | 引导重新绑定 | | moderation / content_moderated | 平台审核驳回 | 不重试，回传给用户改稿 | | not_found | 账号/素材消失 | 结束任务 | | quota | 单账号当日已达上限 | 推迟到次日窗口 | | dependency | 缺 ffmpeg / ffprobe / Playwright 浏览器 | 引导装依赖 | | platform_breaking_change | 选择器自愈命中率跌破阈值 | 告警 + 拉 MultiPost Compat 兜底 | | unknown | 其它 | 保留截图等待人工 |

5 · 与其它插件的握手

omni-post 是 Asset Bus 上的双向节点：

• 作为消费者：收 avatar-studio / seedance-video / tongyi-image

产出的素材，通过 omni_post_ingest_asset 秒传入库。

• 作为生产者：发布成功后推 publish_receipt 到 Asset Bus，shared_with=["*"]。

metadata 严格遵循：{platform, account_id, asset_id, published_url, published_at, task_id, engine}。idea-research / fin-pulse 按 asset_kind="publish_receipt" 订阅即可。

6 · 边界与限制

• 不代理登录。Cookie 必须由用户在本机浏览器手动拷贝或通过 MultiPost

扩展注入。

• 不代办实名 / 绑卡 / 解封。
• S1 仅开放 3 平台选择器；S2 进 7 个；S3 补定时与矩阵模式；S4 落自愈

与 MDRM。

• 单 host 单 Chromium；如需更大并发应考虑多实例部署，而不是在本插件里

再起多个 playwright 进程（会抢 CPU / GPU）。

7.5 · S4 专属能力

• 双引擎选择：settings.engine = "auto" | "pw" | "mp"。auto 探测到

MultiPost 就走扩展（复用日常浏览器登录态），否则回落 Playwright。

• MultiPostGuide：Settings Tab 顶部，3s postMessage PING 检测扩展、

版本号、信任域；不满足时给出 Chrome Web Store / GitHub 安装链接和 配置指引。

• 选择器自愈：SelfHealTicker 每 24h 扫一次 selectors_health；

低于 60% 命中率且 24h 内未告警过的平台会广播 selector_alert UI 事件，由任一 IM 桥插件订阅转发。

• MDRM 写入：每次终态（成功或失败）通过 OmniPostMdrmAdapter 写

一条 SemanticMemory(type=experience, subject="omni-post:publish:{platform}:{account}", tags=[platform:…,account:…,hour:…,weekday:…,engine:…,outcome:…])。 无 memory.write 权限时返回 {"status": "skipped"}，绝不阻塞发布。

7 · 测试入口

bash
py -3.11 -m pytest plugins/omni-post/tests -q

应输出 all passed。Playwright / ffmpeg 测试不会默认跑（hermetic）， 打 -m integration 才触发。