企业官网建设流程全解析

用 MatrixMedia（矩媒）做视频矩阵批量发布时，某个账号"发布失败"几乎是每个运营者都会遇到的情况。别慌：这款多平台批量发布工具为失败场景准备了三层保险——失败截图、自动重试、草稿兜底。本文带你 10 分钟读懂它的失败处理机制，快速定位原因、低成本恢复。

第一步：先看发布状态，分清「失败」和「异常」

批量发布到抖音、快手、视频号、小红书、哔哩哔哩等多个平台后，每条记录在「视频管理」页都会显示一个状态标签。先判断属于哪种，再对症下药：

💡 一个容易踩坑的设计：「异常」不会被记成「失败」。因为异常意味着"不确定有没有发出去"，如果按失败处理就会触发自动重试，造成重复发布。状态判定逻辑见 src/main/services/upLoad/publishOutcome.js。

如果你通过 CLI 发布，退出码也遵循同样语义：0成功、3业务失败（如登录态失效）、4发布异常或草稿兜底、需要人工介入。

快速自查：先排除「根本没启动」的情况

在深挖失败原因前，花 1 分钟确认是发布失败而不是应用没跑起来：

• macOS 首次打开提示"已阻止使用"时，在「系统设置 → 隐私与安全性」中点「仍要打开」即可（见下图）；
• 登录态过期时，matrixmedia cli accounts会直接报cookie 已过期，回 GUI 重登一次即可；
• 网络不畅时 CLI 发布会报"发布超时，请检查网络或登录态"。

失败截图：失败瞬间的现场照片

平台报错往往只有一句"上传失败"，到底是被风控拦了、还是登录过期、还是页面改版？MatrixMedia 会在失败、发布异常、达到最大重试次数等时刻自动对发布页截图并落盘：

• 📍 存储位置：文档/MatrixMedia/fail-screenshots，与业务数据同目录，卸载应用后也不会丢失，可直接附在问题反馈里；
• 🏷️ 文件名：平台-账号-时间.png，如抖音-13800138000-20261021-153012-123.png，肉眼即可辨认；
• 🧹 截图只保留 14 天，超期自动清理，不会撑爆磁盘；
• ⏱️ 截图最多等 10 秒，绝不因为"没截到图"而卡住失败回执。

查看方式：进入「视频管理」页，点击记录中的**「失败 n 次」或「异常 n 次」**即可弹窗预览当时的页面画面，还能一键「用系统看图打开」。核心实现见 src/main/services/upLoad/failureScreenshot.js。

看到截图后基本可以秒判：出现登录页说明登录态过期；出现滑块/风控弹窗说明触发安全校验；页面正常但按钮点不动，多半是平台改版。

自动重试：失败后最多再试 5 次

并不是每次失败都要你手动操作。发布队列收到失败回执后会自动重开窗口重试：

1. 默认最多尝试5 次，每次间隔 1 秒，窗口标题会显示账号 (尝试2/5)，过程一目了然；
2. 小红书执行更保守的单次尝试策略，避免频繁操作触发风控（见 src/shared/xhsPublishPolicy.js）；
3. 重试耗尽仍失败，才会回执"已达到最大重试次数，发布失败"，并附上失败截图；
4. 登录态异常（未登录 / cookie 失效）直接终止不盲目重试——重登一次比重试 5 次更快。

队列重试的核心逻辑见 src/main/services/puppeteerFile.js。

草稿兜底：发不出去，先把内容留住

对运营者来说，"失败了但内容丢了"才是最痛的。MatrixMedia 的兜底思路是：流程走到一半失败时，尽量把视频保存为平台草稿。

以视频号为例：当视频链接/合集添加失败时，它不会直接报错结束，而是等待视频处理完成后自动点击「存草稿」，回执提示"视频号链接添加失败，视频已保存为草稿"，状态标记为需关注（needs_attention），见 src/main/services/upLoad/sph.js。

此外还有两个主动"进草稿箱"的开关：

• 账号级：账号管理 → 发布设置，可把某账号设为"默认发布到草稿"，先囤稿再手动发；
• 请求级：CLI 发布时显式传--draft，与 GUI「存草稿」等价。

统一的状态归口在 src/shared/publishResult.js，CLI / HTTP API / MCP 三种入口拿到的结果语义完全一致。

手动重发：发布记录页一键再来一次

自动重试耗尽、或者异常需要人工确认后，直接回到「视频管理」页操作：

• 每条记录会统计重发次数、成功次数、失败次数、异常次数，一眼看清这个视频在哪个平台卡住了；
• 点操作列的**「重新发布」**，自动带上原标题、简介、标签重发，不用重新填写；
• 点**「获取状态」**可回查平台侧的审核/发布状态，确认那条"异常"到底发没发出去。

页面实现见 src/renderer/views/videoManager/index.vue。CLI 用户则可以用matrixmedia cli history --days 7查看本机发布记录，再对失败平台重跑一次cli publish即可，完整参数见 docs/cli.md。

常见问题速查

小结

MatrixMedia 矩媒面对发布失败的思路可以总结成三步：先判状态 → 再看截图 → 最后决定重发还是进草稿。自动重试处理瞬时抖动，失败截图帮你 30 秒定位根因，草稿兜底保证内容不丢。配合 docs/publish-history-export.md 的历史记录导出，多账号矩阵的失败恢复基本可以做到"无人值守也能收得住"。