Expand publishing and virtual product workflows

browser-extension/multi-platform-publisher-1.1.17/README.md

@@ -0,0 +1,60 @@
+# 易代码多平台发布助手
+
+该扩展与后台“发布管理”页面配合，将视频、图片、封面、标题、文案、标签和商品信息填写到小红书、抖音、视频号、B站或闲鱼卖家工作台。
+
+## 安装
+
+1. 在 Chrome 地址栏打开 `chrome://extensions/`。
+2. 打开右上角“开发者模式”。
+3. 点击“加载已解压的扩展程序”。
+4. 选择解压后的目录 `browser-extension/multi-platform-publisher-1.1.17`。
+5. 登录易代码后台以及需要使用的创作者平台。
+6. 重新打开后台“发布管理”页面，确认页面显示“发布扩展已连接”。
+
+修改扩展代码后，需要在扩展管理页点击该扩展的“重新加载”，并刷新后台和平台页面。
+
+点击浏览器工具栏中的扩展图标会打开右侧“多平台发布助手”。侧边栏展示凭证有效期内各平台的最新发布任务；点击平台名称可定位对应标签页，点击刷新图标会重新打开干净的发布页面并重试填写。已发布成功的任务禁止重试，避免重复发布。
+
+## 工作范围
+
+- 后台页面创建带短期凭证的发布任务。
+- 多平台发布会一次创建多个任务，扩展按小红书、抖音、视频号、B站、闲鱼的顺序逐个平台处理，避免同时上传多个大文件。
+- 批次中的平台达到待手动发布、失败或需要登录后会继续下一个；页面状态异常时最多等待4分钟，避免整个批次永久卡住。
+- 扩展打开目标平台、读取任务资料、上传素材并填写文本。
+- 填写完成后任务状态为 `READY_TO_PUBLISH`（待手动发布）。
+- 扩展不会查找或点击最终发布按钮。
+- 用户手动发布后，扩展只观察平台新增的明确成功或失败提示并回写结果。
+- 扩展不会处理扫码、验证码、安全校验或平台密码。
+- B站视频会打开创作中心投稿页，上传视频并填写标题、简介和标签文案；分区等投稿选项由用户检查或手动选择。
+- 小红书文案会按模板原有段落写入富文本编辑器，保留换行和空行。
+- 抖音文案使用原生选区替换并兼容平台的话题节点，重复校验时不会再次追加全文。
+- 抖音文案一次性写入带换行节点的富文本，保留模板换行且避免编辑器重绘造成内容错乱。
+- 视频号只填写视频描述，不再填写短标题。
+- 多平台批次在平台启动失败或状态回写短暂异常时仍会继续处理后续平台。
+- 闲鱼商品只在闲管家网页中上传图片、选择分类并填写标题和文案；有历史分类时优先使用，否则固定选择“家居/服务/IT技术/软件/程序/网站开发”。
+- 扩展沿用页面当前选中的闲鱼店铺，不自动切换店铺；遇到“高级版已过期”阻断提示时只关闭提示并继续填写。
+- 扩展不填写闲鱼商品售价、原价和库存，不调用闲管家开放接口，也不读取或保存闲管家 Cookie。
+
+## 权限说明
+
+- `tabs`：打开对应平台创作者中心，并将任务绑定到该标签页。
+- `storage`：在浏览器重载或平台登录跳转期间保存任务上下文。
+- 后台及五个发布平台的站点权限：建立任务桥接、填写表单和上传素材。
+
+扩展只允许从以下后台来源接收任务：
+
+- `https://feast.yidaima.cn/office/publish*`
+- 本地开发环境的 `localhost` 或 `127.0.0.1` 发布管理页面
+
+## 测试清单
+
+1. 页面能识别扩展已连接。
+2. 创建任务后只打开所选平台。
+3. 未登录时状态变为“需要登录”，不伪装成功。
+4. 视频或图片能够进入平台上传控件。
+5. 标题、文案和标签填写正确；B站还需确认投稿分区，闲鱼商品还需确认图片、分类、标题和描述正确。
+6. 页面停在最终发布按钮前，扩展不点击该按钮。
+7. 关闭未完成的平台标签页后，后台状态变为“已取消”。
+8. 找不到关键控件或平台提示上传失败时，后台状态变为“发布失败”。
+
+平台页面会持续更新。如果某个平台出现“未找到控件”，应根据当时页面 DOM 调整该平台单独的内容脚本，不能放宽到点击任意包含“发布”的按钮。