微信视频号批量发布工具：把一周的视频一次排完

做视频号更新，最累的不是剪视频，而是发布。 上传、填描述、填短标题、选位置、设定时、勾原创、点发表——一条视频点七八下，二十条视频就是一百多下。而且定时发布的时间还得一个个手动调，稍不留神就填错。 这个工具就是为了解决这件事：把一批视频的发布信息写进一张表格，跑一次，全部自动排完。

一、它能做什么

简单说：你填一张 CSV 表格，它替你把表格里的视频一条条发出去。

具体能力：

二、目录结构

 wechat_video_publisher/
 ├── publisher.py          # 主程序
 ├── schedule.csv          # 排期表（默认读取）
 ├── videos/               # 视频文件放这里
 ├── browser_data/         # 登录信息（扫码一次，长期有效）
 ├── logs/                 # 运行日志
 ├── screenshots/          # 出错截图
 ├── publish_state.json    # 发布进度状态
 └── failed_xx.csv         # 失败清单（有失败时才生成）

视频文件集中在 videos/ 目录，表格里只写文件名即可。

三、排期表怎么填

CSV 共 7 列，建议用 Excel 编辑后另存为 CSV：

 video,title,short_title,location,publish_time,collection,original
 1.mp4,这是第一个视频,第一个短标题,,2026-09-01 18:00,我的合集,yes
 2.mp4,这是第二个视频,第二个短标题,东京,2026-09-01 18:05,,yes
 3.mp4,这是第三个视频,第三个短标题,,2026-09-01 18:10,,

字段详解：

几个容易踩的点：

• location 留空 ≠ 默认位置，而是明确选择「不显示位置」。想显示某地点就填关键词，工具会自动搜索并选中匹配项。
• collection 合集名称要填完整，不能只填关键字。另外会员专区不支持合集，这一列会被忽略。
• 定时发布时间建议每条错开 5 分钟以上，密集发布容易被平台限流。

四、常用命令

 # 发布普通视频（按 schedule.csv 全部排期）
 python3 publisher.py
 ​
 # 发布到会员专区
 python3 publisher.py --vip
 ​
 # 先试跑第一条
 python3 publisher.py --max-count 1
 ​
 # 从第 20 条开始发
 python3 publisher.py --start 20
 ​
 # 本次只发 10 条
 python3 publisher.py --max-count 10
 ​
 # 失败重试 3 次
 python3 publisher.py --retry 3
 ​
 # 跑完不关浏览器，方便自己检查
 python3 publisher.py --keep-open
 ​
 # 指定其它排期表
 python3 publisher.py --csv 08.csv

五、进阶用法

1. 中断了不用怕，直接重跑

每条视频发完，进度会立刻写入 publish_state.json。中途断网、手滑关掉、按了 Ctrl+C——重新执行原来的命令就行，已成功的会自动跳过。

 [3/55] 已完成，跳过：48回.mp4

2. 只重跑失败的那几条

跑完如果有个别失败，会自动生成 failed_21.csv（21 是原始 CSV 名），里面只有失败的那几条，字段和原表完全一致：

 python3 publisher.py --only-failed

也可以直接指定这个清单文件：

 python3 publisher.py --csv failed_21.csv

如果只想把失败项改一改再发，直接编辑这个文件即可。

3. 重置发布状态

# 只把「已成功」重置为待发布，失败记录保留
python3 publisher.py --reset

# 清空全部记录（会重复发布已成功的，慎用）
python3 publisher.py --reset-all

4. 控制上传等待时间

默认选择视频后会先等待 60 秒，再开始判断视频是否上传完成：

# 大文件或网速慢，加长到 120 秒
python3 publisher.py --upload-wait 120

# 网速快，完全靠自动判断，不等固定时间
python3 publisher.py --upload-wait 0

这一项建议保留默认值。 工具在固定等待之后，还会主动检测视频是否真上传完——没传完就一直等，最长等 20 分钟。所以即使固定等待设短了，通常也不会出错；但如果网络特别好，把固定等待调小能省下不少时间。

5. 任务之间留间隔

# 每条视频之间间隔 10 秒
python3 publisher.py --delay 10

六、参数速查表

七、出了错怎么查

工具在三个地方留了痕迹：

• logs/publisher_*.log——每次运行一个日志，记录每一步做了什么。出问题先看这里。
• screenshots/——出错瞬间自动截图，文件名带错误类型，比如 publish_button_not_found、upload_control_not_found。看图基本能判断卡在哪。
• publish_state.json——每条视频的成功/失败状态和失败原因。

常见失败原因：

如果频繁出现登录相关错误，删掉 browser_data/ 重新扫码即可。

八、几个使用建议

1. 先跑 1 条验证。确认描述、短标题、位置、定时都填对了，再批量跑。
2. 定时时间拉开间隔。一般每条间隔 5 分钟，一小时排 12 条。
3. 大批量分批处理。比如 55 条分 5 批，每批 11 条，中间自己检查一次，比一次性全跑更稳妥。
4. 跑完用 --keep-open 抽查。结束后浏览器不关，手动翻几条确认无误。
5. 定期备份 publish_state.json。这个是你所有发布进度的记录，丢了就得靠日志重新核对。

九、适合谁用

• 有稳定更新节奏的视频号（评书、有声书、课程、连载内容等）
• 需要提前批量排期，一次排完一周甚至一个月的量
• 视频数量多、手动发布容易填错信息

如果你每天只发一两条，手动点更省事；但如果要一次排几十条，这个工具能省下大把机械操作的时间。

写在最后：这个工具的核心价值不在"能不能发"，而在发布状态的可靠管理——上传没完成不会误点发表、失败了能精确定位到哪几条、中断后能无缝续跑。批量场景下，这些细节才是真正省时间的地方。