channels-video-publish
内容做好之后的视频号自动发布。成品视频 + 文案就绪后,一条命令完成上传、填短标题/描述、归入合集、声明原创、设定时发表;支持按天批量排期,一次配好让系列内容自动逐日发出。也能对账「哪些发了哪些没发」、给已排期内容改时间。当用户说「发视频号」「视频号发布」「上传视频号」「视频号定时发表」「视频号排期」「查一下哪些没发」「改一下发布时间」时使用。
视频号自动发布
它接的是哪一段
内容生产之后的那一段。
你已经有成品 mp4 和写好的文案,接下来要在网页后台里做一堆重复动作:传文件、填短标题、写描述、选合集、勾原创、点日历设定时。这些动作每条视频都要重来一遍,跟内容质量毫无关系,但必须人肉完成。
本 skill 把这整段收敛成一条命令。
| 它负责 | 它不负责 |
|---|---|
| 上传成品视频 | 剪辑、合成、加字幕 |
| 填短标题、描述 | 写文案、想选题 |
| 归入合集 | 做封面、生成素材 |
| 声明原创 | 互动、评论、看数据 |
| 设定时 / 按天批量排期 | 删除已发布内容(不可逆,本 skill 不做) |
| 发完之后:对账、改期 | — |
When to use
- 「把这条视频发到视频号」「视频号定时发 10-15 07:00」
- 「这十几条视频排一下,每天发一条」
- 「查一下视频号里哪些发了哪些没发」
- 「把已经排上的那条改到后天」
前置条件
- Chrome 带远程调试端口、用独立 profile 启动(别污染常用浏览器):
在该浏览器里手动扫码登录视频号助手。会话会过期,脚本退出码 3 会提示。bash /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \ --remote-debugging-port=9222 --user-data-dir=/Users/jx/ChromeAutomation & - node 依赖
ws:/Users/jx/.workbuddy/binaries/node/workspace/node_modules - 跑之前必须清代理(否则 9222 流量被劫持到 80):
Bash 工具里需要bash unset http_proxy https_proxy all_proxy HTTP_PROXY HTTPS_PROXY ALL_PROXY NODE_OPTIONS export NO_PROXY='127.0.0.1,localhost'dangerouslyDisableSandbox: true。
Workflow
Step 1 — 确认输入
- 成品视频(mp4)、短标题 ≤16 字、描述、合集名(默认「怎么活得更好」)
- 目标日期:必须 ≤ 今天+14 天(视频号硬限制,脚本会自动校验并中止)
Step 2 — 先用 dry-run 跑一遍
node scripts/cdp-publish.js --file /path/a.mp4 --title "标题" \
--desc "描述" --album "怎么活得更好" --duration 516 --day 15 --hour 07 --dry-run
dry-run 会做完上传 + 填字段 + 保存草稿,不点发表。确认草稿箱里内容无误再正式跑。
Step 3 — 正式发布
- 定时:去掉
--dry-run,带--day/--hour(可加--month) - 即时发表:加
--immediate - 批量:维护 episodes.json,用
--episodes <文件> --ep <编号>
Step 4 — 核对
- 到草稿箱/发表记录核对日期时间与原创标记
- 核查原创:
node scripts/check-original.js
批量排期(最常用的姿势)
做一个系列时,真正省时间的用法是一次配好,按天自动发:
# episodes.json 里放好每一期的 file / title / desc / day
node scripts/cdp-publish.js --episodes episodes.json --ep 24 --day 15 --hour 07
完成后视频号里会排成一列「将于 X 月 X 日 07:00 发表」,你不用再管它。 注意视频号定时最远只能选 14 天后,超窗脚本直接中止(退出码 4),所以批量要按滚动窗口分批排。
发完之后
- 对账:
node scripts/list-all.js— 一次拉全量列表(标题/时间/原创状态), 和本地文件一比就知道哪些没发、哪条漏了原创 - 改期:
node scripts/reschedule.js <ep> <月> <日> <时> [分]— 已排上定时但还没发的内容改时间,走「修改并重新发表」链路,不用删稿重传
CLI
node scripts/cdp-publish.js --file <mp4> --title <短标题> [--desc <描述>]
[--album <合集>] [--duration <秒>] [--day <日> --hour <时> [--minute <分>]]
[--immediate] [--dry-run]
node scripts/cdp-publish.js --episodes episodes.json --ep 24 --day 15 --hour 07
node scripts/check-original.js [--all]
node scripts/list-all.js
node scripts/reschedule.js <ep> <月> <日> <时> [分]
退出码:0 成功|1 失败|3 登录态失效需重扫|4 定时日期超窗口(未发布)
安全规则(不要跳过)
- 目标日超 14 天窗口 → 中止,不发布(宁可少发不错发)
- 日期/时间回填校验不符 → 中止
- 原创声明必须真实点击,不要只改 DOM 属性
- 删除已发布条目不可逆且丢播放/赞数据,必须用户明确确认(本 skill 不含删除动作)
- 已发布条目不能补声明原创;>6 个月的连修改都不行,只能删旧重发
已知限制
- ✅ 已跑通:上传、短标题、描述、合集、原创、定时发表、改期
- ⚠️ 时间面板的小时点选偶发失效 → 脚本已内置「校验 + 重试 + 面板自动重开」
- ⚠️ 合集计数只统计已发布视频:合集管理页/下拉里显示「共 N 个内容」不含定时中的条目, 「共 1 个内容」不代表定时稿没选上合集。验证定时稿的合集绑定: 列表行悬浮「修改并重新发表」打开编辑页,看合集字段是否回显目标合集名。
视频号助手新版是 SPA,发布表单藏在 0×0 的 iframe 里,鼠标坐标点击全部失效, 这也是为什么必须用 CDP 直连而不是普通的浏览器自动化。全部踩坑记录在
references/troubleshooting.md,改脚本前先读它。
相关
- 抖音发布见 skill
douyin-video-publish(同一套思路,但 DOM 结构完全不同,脚本不可互换)
创建新合集(发布页内可完成)
「添加到合集」下拉里自带「创建新合集」入口(.create),流程:
点下拉 → 点「创建新合集」→ 弹窗输入标题(上限 10 字,创建后不可修改)→ 点「创建」→
出现「已创建合集」提示 → 重新打开下拉选中新合集 → Escape 关闭。
参考实现:macros/ch-ep01-publish.js 第 4 节。立即发布 = radio 保持 value=0(不定时,默认值)。
文件
scripts/cdp-publish.js— 主发布脚本(上传 / 填字段 / 合集 / 原创 / 定时 / 批量)scripts/list-all.js— 全量列表导出,用于对账「哪些发了哪些没发」scripts/reschedule.js— 改已排期条目的时间scripts/check-original.js— 原创声明状态核查references/troubleshooting.md— 踩坑清单,改代码前必读assets/episodes.example.json— 批量排期配置模板
更新日志
v1.2.1(2026-10-20)
- 🔴 定时/改期必须回读校验日期:只校验时间会静默按旧日期发出,
references/troubleshooting.md新增第 13 条(含防御代码) - 新增第 14 条:已定时条目走「修改并重新发表」改期,比删了重传快且不产生重复条目
- 已知限制补充:合集计数只统计已发布视频,定时稿的合集绑定要看编辑页回显
v1.2.0(2026-10-11)
- 定位重写:明确为「内容做好之后的发布环节」,主线是自动发布与批量排期, 对账/改期降为发完之后的辅助能力
- 新增「它负责 / 不负责」边界表,避免被当成剪辑或文案工具调用
- 批量排期提升为独立章节(系列内容一次配好、按天自动发)
v1.1.0(2026-10-10)
- 新增
reschedule.js:已排期未发布条目可直接改时间,不用删稿重传 - 新增
list-all.js:一次性拉全量列表,用于对账 - 时间面板 hour/minute 点选加「校验 + 重试 + 面板自动重开」,修掉偶发不生效
- 时间戳对账要用北京时区换算(
toISOString()是 UTC,差 8 小时)
- Downloads
- 528All time
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v1.2.1
- License
- MIT-0
