root/geo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
beb290a5a725d39636dbbddf791c23a7a541e82b
geo/user-manual/05-媒体管理与发布.md
T
root ab62d666b4 docs(user-manual): add product user manual aligned to live code 
Cover onboarding, workspace, article creation, brand library, media
publishing, knowledge base, image library, GEO tracking, desktop client,
KOL marketplace, AI points, and FAQ — sourced from actual views and i18n
rather than the v1 PRD.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 00:20:47 +08:00

5.6 KiB
Raw Blame History

媒体管理与发布

路径 /media。这是 Web 端的只读+查看页面，用来看当前租户绑定的发布媒体账号、它们的健康度、最近一次校验时间。真正的"绑定"和"发布"动作都在桌面客户端里执行。

1. 当前支持的发布平台

省心推目前内置 13 个发布媒体平台：

平台 短名 备注
头条号 头 UGC 媒体
百家号 百 UGC 媒体，要求封面图
搜狐号 搜 UGC 媒体
企鹅号 Q UGC 媒体
知乎 知 UGC 媒体
网易号 网 UGC 媒体
简书 简 UGC 媒体
bilibili B UGC 视频/专栏
稀土掘金 掘 技术社区
什么值得买 值 电商内容
微信公众号 微 要求封面图
中关村在线 Z 数码垂直
懂车帝 懂 汽车垂直，要求封面图

平台列表会随后端配置变化。最新支持平台以桌面客户端 媒体账号 页的卡片为准。

2. Web 端：媒体管理页

进入 /media 后会看到：

顶部「浏览器发布器」状态

历史名称为 GEO Publisher 浏览器插件；当前实现已迁移为桌面客户端，但提示文案仍保留以兼容旧用户：

  • 插件已连接 / 未连接
  • 插件版本、安装实例 ID
  • 本地已登录平台 数量
  • 重新检测 按钮：触发与桌面客户端的状态同步

平台卡片列表

每张平台卡片包含：

  • 平台 Logo + 平台名称
  • 当前租户在该平台的绑定数量（已绑定 N 个账号）
  • 最近一次同步时间
  • 关键状态徽标：
    • 已绑定 / 未绑定
    • 需要处理（账号失效、风控、过期）
    • 本地未登录 / 本地账号不匹配：桌面客户端登录态异常
    • 已就绪 / 可发布 / 不可用

操作按钮

  • 去绑定 / 重新绑定：跳转/打开桌面客户端执行真实绑定
  • 解绑：删除该租户与该账号的关联（需二次确认）。解绑后该账号不再可用于发布，但本地 cookie 仍由桌面客户端控制

⚠️ 服务端不存储任何第三方平台 cookie 或 access token。绑定的本质是把"桌面客户端在该平台的登录态" 与"省心推租户" 关联起来，并把平台 UID、昵称、头像等公开信息同步到 SaaS。

3. 在桌面客户端绑定账号

完整步骤见 桌面客户端 §媒体账号。简版：

  1. 桌面客户端左侧导航 → 媒体账号
  2. 找到目标平台的卡片，点击 去绑定
  3. 弹出受控浏览器窗口，自动跳到平台登录页
  4. 在受控窗口里完成账号登录、扫码、短信验证
  5. 客户端检测到登录态后，把 UID、昵称、头像同步回省心推服务端
  6. 回到 Web 端 /media 页面 → 卡片状态变为 已绑定 + 已就绪

4. 发起手动发布

发布动作可以从三处触发：工作台 → 最近生成 → 发布、文章列表 → 发布、文章编辑页 → 发布。三个入口都会打开同一个 PublishArticleModal 弹窗。

发布弹窗里能做的事

  1. 选择发布平台：弹窗会自动回填"文章里之前选过且当前已绑定"的账号；未绑定/本地登录态异常的平台不可勾选
  2. 上传封面图：默认关闭；点击 上传封面图 后会弹出图片选择器，可从 图片管理 素材库选，也可本地上传
  3. 封面合规校验：如果你勾选的平台里包含百家号、微信公众号、懂车帝等"必须封面"的平台，没传封面会被拦截，提示「已选择需要封面的发布平台，请先上传封面图」
  4. 提交发布：服务端把任务派发给当前租户在线的桌面客户端，客户端按平台依次执行真实发布

发布状态回写

  • 单平台成功：消息 发布成功
  • 部分成功：消息 部分发布失败，会逐条列出失败平台和原因
  • 全部失败：消息 发布失败，提供逐条失败原因

每条发布记录在文章详情抽屉的 已发布详情 Tab 里能看到：

  • 已发布平台、发布状态、发布时间
  • 已发布链接：可 打开（在新标签页跳转）或 复制
  • 部分平台只有"管理后台"链接（仅有管理页面），在 Web 端会提示"请在客户端打开管理页面查看"

5. 平台账号状态规则

状态 含义 处理建议
已授权 / 已就绪 客户端在线 + 本地登录有效 + 服务端有绑定 可直接发布
本地未登录 服务端有绑定但当前桌面客户端没检测到登录态 在客户端重新走一遍登录
本地账号不匹配 客户端检测到的账号 UID 与服务端绑定不一致 在客户端切回正确账号或解绑后重绑
需人工验证 / 触发风控 平台返回登录态异常 在客户端的受控浏览器里完成验证
授权过期 Cookie / Session 失效 重新绑定
已停用 服务端标记为 revoked（如租户主动解绑、违规处理） 联系管理员

6. 常见问题

  • Web 端显示已绑定，但发布弹窗里平台不可选：通常是当前桌面客户端不在线或本地登录态丢失。打开桌面客户端的 控制台 确认运行状态，必要时重新检测
  • 部分发布失败但未提示原因：到文章详情抽屉的 已发布详情 看具体失败原因；常见的是平台触发风控、内容触发合规拦截、网络超时
  • 多账号场景：单平台支持绑定多个账号，发布时弹窗会让你选具体哪个账号
Reference in New Issue View Git Blame Copy Permalink