社交媒体发布 — 用户手册 | YoBench

「社交媒体」模块的用途

本模块是面向 18 个平台 的统一编辑器与发布计划器。您在 TipTap 编辑器中撰写内容、添加媒体、选择目标、设定时间 —— 帖子立即发送或按计划发送。同时支持具备自动刷新的 OAuth 提供商和直接 API 令牌方式。

您将获得:

• 一篇帖子 → 多个平台 —— 一次草稿同时发布到多个所选网络。
• 富文本编辑器 —— TipTap;内容以三种格式同时保存(content_json、content_html、content_text)。
• 定时发布 —— scheduled_at(ISO 8601)或即时发送。
• 媒体 —— 拖放并预览。
• 平台特定字段 —— YouTube 标题、Reddit NSFW、Telegram parse_mode 等。
• OAuth 自动刷新 —— 在过期前 1 分钟预留时间自动续期。
• 本地 OAuth 服务器 —— 端口 19284 用于交互式登录。

支持的平台(18 个)

均有可工作的适配器:Discord、Telegram、VK、OK、Twitter (X)、Facebook、Instagram、Threads、TikTok、YouTube、WhatsApp、Reddit、LinkedIn、Substack、Boosty、Patreon、WeChat、Weibo。

鉴权方式:

• OAuth(自动刷新) —— Reddit、Instagram、Facebook、LinkedIn、Threads、Patreon、YouTube、TikTok。
• API 令牌 + 扩展字段:
  • Telegram —— bot_token + chat_id。
  • Discord —— webhook_url。
  • VK —— access_token + group_id。
  • OK —— app_id、app_public_key、app_secret、access_token、session_key、group_id。
  • Weibo —— access_token + uid。
  • WeChat —— app_id、app_secret、token、aes_key。
  • Twitter —— OAuth 1.0a:api_key、api_secret、access_token、access_token_secret。
  • WhatsApp —— template_id、recipient_phone。

帖子参数

• 内容 —— content_json(TipTap)、content_html、content_text。
• 媒体 —— 文件数组,含 mime_type、size、本地路径。
• 目标平台 —— 账户列表。
• 定时 —— scheduled_at;为空表示立即发送。
• 状态 —— draft / scheduled / sending / sent / partial / failed / cancelled。
• 平台字段 —— extra_fields(JSON),按账户单独配置。

平台特定字段

全局设置

中心设置中无专门的 posting* 键。所有内容都保存在数据库(posting_platforms、posting_posts、posting_post_platforms、posting_media)。

使用流程

1. 接入平台

1. 在左侧菜单打开 发布 模块。
2. 在 平台 中添加账户。
3. 填写令牌或完成 OAuth 流程(浏览器打开 localhost:19284)。
4. 测试连接 验证访问。

2. 创建帖子

1. 在 帖子 中点击 新建帖子。
2. 在 TipTap 编辑器中撰写内容,添加媒体。
3. 选择目标平台(可多选)。
4. 填写平台特定字段(例如 Reddit 的 subreddit)。

3. 发送

• 立即发送 —— 帖子即刻发出。
• 计划发送 —— 设置 scheduled_at,调度器自动发布。
• 取消 —— 草稿和定时发布的帖子在实际发送前可以取消;帖子被标记为 cancelled,不会被发送。

4. 跟踪状态

帖子列表会显示各种状态。partial 表示帖子已发到部分平台但不是全部。打开详情可以看到每个平台的错误 —— 你可以只对失败的平台重试,无需再重新发送到已经成功的平台。

下一步

• 从 RSS 与 RAG 上下文 获取内容素材,在 AI 聊天 中生成想法。
• 在 文档 中起草长篇内容。

帮助与反馈

希望支持 Mastodon、Bluesky、Pinterest 或帖子 A/B 测试?通过反馈表单联系我们。