# 媒体管理与发布

路径 `/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. 在桌面客户端绑定账号

完整步骤见 [桌面客户端 §媒体账号](./09-桌面客户端.md#3-媒体账号)。简版：

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

## 4. 发起手动发布

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

### 发布弹窗里能做的事

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

### 发布状态回写

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

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

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

## 5. 平台账号状态规则

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

## 6. 常见问题

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