69 lines
4.4 KiB
Markdown
69 lines
4.4 KiB
Markdown
# 多平台发布管理部署与验证
|
||
|
||
## 部署顺序
|
||
|
||
1. 在业务数据库执行 `sql/platform_publish.sql`，创建发布任务表和“发布管理”菜单。
|
||
2. 重新构建并部署后端与 `ruoyi-ui`。
|
||
3. 在 Chrome 中加载 `browser-extension/multi-platform-publisher` 目录。
|
||
4. 分别登录小红书、抖音、视频号、B站创作者中心和闲管家卖家工作台。
|
||
5. 重新进入后台“工作室运营 → 发布管理”，确认右上角显示“发布扩展已连接”。
|
||
|
||
非管理员角色还需要在角色管理中勾选新菜单及“发布资料查询”“创建发布任务”权限。
|
||
|
||
## 使用流程
|
||
|
||
1. 在项目所在行点击“发布小红书”“发布抖音”“发布视频号”“发布B站视频”或“发布闲鱼商品”。
|
||
2. 检查后台自动带出的标题和模板文案，并手动选择本次发布使用的图片、视频或封面。
|
||
3. 点击“交给扩展填写”。
|
||
4. 扩展打开对应平台并依次上传、填写。
|
||
5. 后台状态显示“待手动发布”后，在平台页面检查全部资料。
|
||
6. 用户手动点击平台最终发布按钮。
|
||
7. 扩展观察到平台新增的明确成功提示后，将后台状态更新为“发布成功”。
|
||
|
||
### 多平台发布
|
||
|
||
1. 在项目名称下点击“多平台发布”，勾选本次需要的平台。
|
||
2. 视频由抖音、视频号和B站共用；图片由小红书和闲鱼共用；各平台标题、文案和标签可分别修改。
|
||
3. 后台通过一个事务批量创建任务，不会出现只创建部分平台任务的情况。
|
||
4. 扩展按小红书、抖音、视频号、B站、闲鱼的顺序执行；当前平台到达“待手动发布”、失败、需要登录或页面被关闭后，再继续下一个平台。
|
||
5. 所有平台的最终发布按钮仍由用户手动确认。
|
||
6. 视频号批次等待上传状态最多30秒；任一平台超过4分钟没有返回状态时会标记超时并继续后续平台，避免整批任务停住。
|
||
|
||
### 发布文案模板规则
|
||
|
||
- 发布小红书时匹配“小红书”分组，发布抖音时匹配“抖音”分组，发布视频号时匹配“视频号”分组，发布B站时匹配“B站”分组，发布闲鱼时匹配“闲鱼”分组。
|
||
- 也支持“抖音、视频号、小红书”这类包含平台名称的共享分组。
|
||
- 平台专用的精确分组优先于共享分组。
|
||
- 匹配分组只有一个启用模板时直接使用；有多个启用模板时随机选择一个。
|
||
- 模板中的项目变量由后端渲染后自动写入发布文案，弹窗会显示本次选择的分组和模板名称。
|
||
|
||
## 安全边界
|
||
|
||
- 后台页面不会向扩展提供后台登录 Token、Cookie 或平台密码。
|
||
- 扩展用随机短期凭证读取单个发布任务，凭证默认 4 小时失效。
|
||
- 素材下载地址由后端根据已保存任务生成，网页不能要求扩展访问任意脚本或选择器。
|
||
- 扩展只切换“图文/视频”类型标签、设置上传控件和填写文本，不扫描或点击普通发布按钮。
|
||
- B站扩展会上传视频并填写标题、简介和标签文案，投稿分区等选项保留给用户检查或手动选择。
|
||
- 闲鱼发布仅通过扩展操作闲管家网页表单，不调用闲管家开放接口，也不读取或保存闲管家 Cookie。
|
||
- 闲鱼有历史分类快捷项时优先使用；没有时固定选择“家居/服务/IT技术/软件/程序/网站开发”，且不填写售价、原价和库存。
|
||
- 扫码、验证码和安全校验必须由用户处理。
|
||
|
||
## 状态说明
|
||
|
||
- `PENDING`：等待扩展接收。
|
||
- `OPENING`：正在打开创作者中心。
|
||
- `LOGIN_REQUIRED`：平台尚未登录或发布表单不可见。
|
||
- `DOWNLOADING`：读取后台素材。
|
||
- `UPLOADING`：素材已交给平台上传。
|
||
- `FILLING`：填写标题、文案和标签。
|
||
- `READY_TO_PUBLISH`：填写完成，等待用户手动发布。
|
||
- `SUCCEEDED`：观察到平台明确的发布成功提示。
|
||
- `FAILED`：关键控件缺失、素材读取失败或平台明确提示失败。
|
||
- `CANCELLED`：任务未完成时平台标签页被关闭。
|
||
|
||
## 平台适配验证
|
||
|
||
五个平台的发布页面会不定期改版。每次正式部署前，都应使用测试账号真实验证上传控件、标题控件、文案控件、商品字段和上传进度。未经过登录账号实测的平台不能标记为“已完成适配”。
|
||
|
||
扩展没有最终发布动作。检索扩展内容脚本中的 `.click()` 时，只应看到发布类型标签切换逻辑。
|