视频号自动发布【智灵影视AIX出品】

> 一句话：把成片送进视频号草稿箱，位置清空，存没存上按接口核验。发表永远由人点。
>
> 本技能是独立技能：不依赖、也不修改任何其他技能。装它不会动你电脑上已有的技能。

〇、三步上手（看这一段就会用）

第 1 步  装依赖      一条命令，30 秒
第 2 步  扫码一次    微信扫一下，之后长期有效
第 3 步  说一句话    对着助手说「传视频号」，剩下它来

第 1 步 · 装依赖

~/.workbuddy/binaries/python/envs/default/bin/pip install playwright

> 如果提示找不到浏览器内核，再补一条：
> ~/.workbuddy/binaries/python/envs/default/bin/python -m playwright install chromium

第 2 步 · 扫码一次

PY=~/.workbuddy/binaries/python/envs/default/bin/python
SC="$HOME/.workbuddy/skills/wxchannels-auto-draft/scripts/upload_draft.py"
$PY "$SC" --login

弹窗 → 用要发视频的那个微信号扫 → 看到 ✅ 已登录 就完事。

第 3 步 · 以后每次只要说一句话

> 「把这条片子传视频号」/「发视频号」/「存草稿箱」

助手会自动：上传视频 → 填标题话题 → 传封面（三步确认）→ 把位置改成「不显示位置」→ 保存草稿 → 按接口核验 → 回报结果。
它不会点发表，最后那一下你自己在手机上点。

一、它到底干什么（边界写死）

二、首次安装（只做一次，约 3 分钟）

第 1 步：装依赖

~/.workbuddy/binaries/python/envs/default/bin/pip install playwright

Chromium 内核优先复用本机缓存；没有就装一次：

~/.workbuddy/binaries/python/envs/default/bin/python -m playwright install chromium

第 2 步：扫码登录（只需一次）

PY=~/.workbuddy/binaries/python/envs/default/bin/python
SC="$HOME/.workbuddy/skills/wxchannels-auto-draft/scripts/upload_draft.py"
$PY "$SC" --login

会弹出浏览器窗口 → 用要发布视频的那个微信号扫码 → 看到 ✅ 登录态有效 即完成。

> 🔴 一个 --profile 名字 = 一个视频号账号的登录态。
> 默认 weixin-channels。换账号就换名字：--profile 我的另一个号，
> 首次会重新弹码，不会串号。

第 3 步：自检

$PY "$SC" --list

能打印出草稿箱里现有草稿（含 videoPlayLen 时长、city 定位）就是装好了。

完整对话脚本见 references/first-run-dialog.md —— 首次装机时照着说即可。

三、什么时候触发（做完视频之后）

3.1 触发时机（两条任一即可）

1. 用户说了动词：「传视频号」「发视频号」「存草稿箱」「帮我把这条发上去」……
2. 片子刚交付完 + 用户点头：成片已经发到对话框给用户看过，用户说「可以」「传吧」「发吧」。

3.2 🔴 顺序铁律：先给看，再上传

出片 → 把成片发到对话框让用户看 → 等一句「可以」→ 才跑上传

用户没明确说「传」时，只问一句，绝不擅自上传：

> 成片好了，要先存进视频号草稿箱吗？说「传」我就传（只存草稿，不发表）。

3.3 参数从哪来（不要每次重问）

按顺序找，找到就用，不要反问用户：

1. 本期交付目录里的 发布标题与话题.txt / 发布信息.txt
2. 上一轮对话里用户已经说过的标题 / 话题
3. 都没有 → 才问一句：「标题和话题给我一下，短标题我按 6~16 字帮你压。」

字段对应关系：

四、标准执行（一条命令）

PY=~/.workbuddy/binaries/python/envs/default/bin/python
SC="$HOME/.workbuddy/skills/wxchannels-auto-draft/scripts/upload_draft.py"

$PY "$SC" \
  --video "…/交付/成片.mp4" \
  --cover "…/交付/封面.png" \
  --title "只要装这 4 个技能，WorkBuddy 几分钟出片" \
  --desc "分镜、画面、配音、字幕，四步串成一条流水线。" \
  --tags "#AI工具 #WorkBuddy #效率" \
  --short "4 个技能出片"

或者用 JSON（Agent 调用推荐，字段少写错）：

$PY "$SC" --json publish-info.json      # 模板见 templates/publish-info.json

退出码：0 成功｜2 参数错｜3 缺依赖｜6 未登录｜7 进不了创作页｜8 上传失败｜9 等转码超时｜10 没点中保存｜11 接口核验未通过

脚本最后一行是 RESULT_JSON: {...}，Agent 直接读这行判断成败，不要靠猜日志。

五、🔴 八条铁律（违反必失败，逐条都是真金白银）

1. 绝不点「发表」
   脚本只找「保存草稿」类按钮。发布是人来决定的。

2. 封面必须走三步
   ① 点封面缩略图「编辑」→ ② 点弹窗左下虚线框「上传封面」→ ③ 点右下角橙色「确认」。
   漏第③步封面不生效，但接口照样返回成功、日志照样报"已提交" —— 极具欺骗性。
   脚本已加硬校验：弹窗没关掉就整轮重试。

3. 只能点真实鼠标 / locator
   视频号前端校验 isTrusted，element.click()、dispatchEvent 会被静默忽略。
   关键按钮一律 page.mouse.click() 或 locator.click()。

4. 必须等视频真的传完
   创作器表单渲染得很早（进度条才 33%），此时封面上传口还不可用。
   判据：取消上传/上传中 消失 + 封面区生成中 消失 + 「发表」按钮出现。

5. 位置必须清成「不显示位置」
   创作页默认带出账号所在地区（哪怕从没填过）。
   必须按元素中心真实鼠标点开下拉，再点「不显示位置」；读 textContent 判断会永远误判成已清空。

6. 短标题 6~16 个字符，两头都卡
   少了红字「标题至少6个字」，多了红字「标题超过16字限制」。
   两种都表现为「保存草稿」点了毫无反应，看起来像按钮点不到，其实是表单校验没过。

7. 核验只认接口
   get_draft_list 返回里的 videoPlayLen（时长）+ 标题 + city（定位）才是硬证据。
   页面文字核验会误报（草稿列表是异步渲染，文本读早了就是空）。

8. 账号按 profile 隔离
   一份登录态目录 = 一个视频号账号。要换号就换 --profile 名，别共用目录。

六、交付话术（跑完给用户看什么）

脚本成功后，这样回报（别只丢一堆日志）：

✅ 已存进视频号草稿箱（只存草稿，没发表）
· 标题：xxx
· 短标题：xxx（n 字符）
· 封面：已上传 ✔
· 位置：不显示位置 ✔
· 接口核验：草稿箱共 N 条，本条时长 xx.x 秒 ✔
下一步：手机视频号助手 → 内容管理 → 草稿箱 → 点开这条 → 点「发表」

失败时说清哪一步、给一条可执行建议，不甩原始报错：

七、排错速查

更多细节见 references/tech-breakdown.md（机制 + 踩坑时间线）与 references/troubleshooting.md。

八、文件结构

wxchannels-auto-draft/
├── SKILL.md                        # 本文件（技能定义 + 执行流程）
├── README.md                       # 人读的安装说明
├── scripts/
│   └── upload_draft.py             # 主脚本：上传 / 核验 / 列草稿，可独立运行
├── references/
│   ├── first-run-dialog.md         # 首次安装话术 + 做完视频后的触发对话（照读）
│   ├── tech-breakdown.md           # 六个核心机制 + 踩坑时间线
│   └── troubleshooting.md          # 按现象查原因
└── templates/
    └── publish-info.json           # 参数模板，复制改值即可

技术来源：拆解自本机 Easel（~/WorkBuddy/Easel）的 web_publisher.py 通用网页发布框架，
按「只存草稿、不发布」改造，并补齐封面三步确认、位置清空、接口级核验三条链路。
作者：智灵影视AIX（吉老师）。