人工智能AI Agent大模型AI 应用媒体生成【免费下载链接】xiaobei为OPC/中小微企业量身打造的自媒体获客智能体项目地址https://gitcode.com/gh_mirrors/wi/xiaobei点击查看免费下载本文围绕 xiaobei 仓库中 wechat-channels-publish 技能文档 展开完整讲解如何基于camoufox-cli的持久化 sessionwechat-channel在微信视频号创作者中心自动发布视频从无头扫码登录、wujie 微前端 shadow DOM 下的表单操作到上传/转码状态轮询、标题描述填写、即时发布与获取分享链接最后落库约束一并讲清。读完本文你将掌握一套可直接运行的视频号自动化发布流程并理解其背后的 fail-first 队列、Session 共享与风控规避设计。一、技术底座camoufox-cli 与持久化 Session微信视频号发布全流程基于仓库内 fork 的camoufox-cli见 patches/camoufox-cli/README.md。该 fork 相对上游 0.6.2 增加了三个关键能力其中两个是视频号发布的核心依赖upload命令camoufox-cli upload ref|selector file [more files...]底层走 Playwrightlocator.setInputFiles(paths)接受 snapshot ref如e1或原始 CSS 选择器支持一次传多个文件。上游本身没有 upload 命令这是 fork 为发布类技能douyin-publish / xhs-publish / weibo-publish / zhihu-publish / wechat-channels-publish 等专门加的。Fail-first 队列daemon 侧同一 session 一次只跑一个命令命令还在执行时新命令立即失败并返回session name 正忙请等待当前操作完成后再试。不隐藏排队、不自动等待——由 Agent 读到失败文本后决定何时重试close命令绕过队列卡死的 session 随时可以close --all强制拆除。本技能以及共管 session 的wx-channel-engagement全部命令统一形如camoufox-cli --session wechat-channel --persistent --json command--session wechat-channel固定 session 名登录态 指纹冻结在磁盘 profile 目录~/.camoufox-cli/profiles/wechat-channel--persistent每次命令都带复用同一 daemon 同一 profile避免不带 profile 导致 cookie/登录态不恢复--json命令输出走 JSON envelope便于脚本解析无头是默认行为无需--headless参数。主力后端为targetcamoufox本文命令只针对该后端。若使用targethost/targetnode只需按本技能「流程 提示事项」执行改用当前后端自带的浏览器工具语义调用即可——无头、频率限制、错误处理约定与后端无关。二、前置条件无头截图扫码登录1. 登录态闭环设计持久化 sessionwechat-channel已登录登录态存 session profile 里。本技能与 login-manager完全无关——自管探活 登录不导出 cookie/UA 落中央存储不调用cookies export/identity export登录态只在 session profile 里闭环不落~/.openclaw/logins/。登录和发布全部走无头模式。2. 首次使用 / 登录态失效时的登录流与 wx-mp-engagement 同机制的无头截图扫码登录# 1) 打开视频号创作者中心首页 camoufox-cli --session wechat-channel --persistent --json open https://channels.weixin.qq.com/platform/home # 2) 轮询 eval 检查登录页 QR 二维码 img 注入完成 # 检查 document.querySelectorAll(img) 有 src 以 data:image 开头的元素最多等 10s # 3) 截 QR PNG camoufox-cli --session wechat-channel --persistent --json screenshot /tmp/qr-wechat-channel.png随后把 QR PNG 发给用户告知「微信视频号登录已失效请用微信扫码确认完成后回复已扫码」然后Stop and wait。用户回复后轮询当前 URLcamoufox-cli --session wechat-channel --json url确认已跳走登录页URL 含platform/home且不含login即登录就位。登录后close session——登录态落磁盘 profile不留进程占内存下次--session wechat-channel --persistent重起无头即恢复用完再 close。三、发布流程九步走视频号创作者中心使用wujie 微前端所有表单元素在wujie-app::shadow-root内——camoufox-cli 的snapshot默认穿透 shadow DOM 拿 ref后续click/type/upload按 ref 操作即可无需 CDP hack。Step 1: 导航到发布页camoufox-cli --session wechat-channel --persistent --json open https://channels.weixin.qq.com/platform/post/create等待5 秒wujie 需要额外时间初始化 shadow DOM。Step 2: 检查登录态snapshot看页面 URL 是否含login或出现登录二维码——命中则走前置条件的无头截图扫码登录流。Step 3: 上传视频# 1. snapshot 拿到上传触发按钮 refshadow DOM 内的 span.add-icon 或 div.upload-content # 2. 点击上传触发按钮 camoufox-cli --session wechat-channel --persistent --json click 上传触发-ref # 3. snapshot 拿到弹出的 input typefile ref # 4. 上传视频文件 camoufox-cli --session wechat-channel --persistent --json upload input-ref video.mp4camoufox-cliupload命令底层走 Playwright setInputFiles穿透 shadow DOM无需 CDP setFileInput / base64 hack。支持的视频格式.mp4、.mov、.avi、.webmStep 4: 等待上传 转码完成每 3 秒snapshot检查一次页面状态最长等待3 分钟大视频转码可能较慢状态检测信号shadow DOM 内上传中[class*uploading]或[class*progress]转码中[class*transcoding]完成出现video预览或[class*preview-video]或文本上传成功/转码完成失败[class*upload-fail]或文本上传失败Step 5: 填写标题# 1. snapshot 拿到标题输入框 refinput[placeholder*短标题]在 shadow DOM 内 # 2. 输入短标题 camoufox-cli --session wechat-channel --persistent --json type 标题-ref 短标题建议 6-16 字最长约 30 字。Step 6: 填写描述# 1. snapshot 拿到描述输入框 refdiv[contenteditable][data-placeholder添加描述] # 2. 点击聚焦 camoufox-cli --session wechat-channel --persistent --json click 描述-ref # 3. 输入描述话题标签直接写在描述中 camoufox-cli --session wechat-channel --persistent --json type 描述-ref 描述内容 #话题1 #话题2最长约 300 字。Step 7: 发布视频号发布不必勾选原创声明发布后用户会在手机端补充。# 1. snapshot 拿到发表按钮 ref文本为发表或发布在 shadow DOM 内 # 2. 确认按钮不是 disabled 状态snapshot 看 # 3. 点击发表 camoufox-cli --session wechat-channel --persistent --json click 发表-ref # 4. 若弹出原创声明弹窗snapshot 拿直接发表按钮 ref → clickStep 8: 确认发布成功等待 4 秒后snapshot检查页面自动跳转到视频管理列表页或 URL 变为https://channels.weixin.qq.com/platform/post/list。刚发表的作品通常在第一个但可能处于转码中——封面缩略图为灰色、转圈。每隔 5 秒snapshot看转码是否完成封面缩略图出现完成后才能取链接。Step 9: 获取已发布视频链接发布成功后在视频号管理后台的视频列表页获取视频公开链接# 1. snapshot 找到刚发布的视频列表第一条或按标题匹配ref # 2. snapshot 找该视频的分享按钮 ref → click # 3. snapshot 在弹出的分享面板中找复制视频链接按钮 ref → click # 4. 从剪贴板或弹窗读取链接 camoufox-cli --session wechat-channel --persistent --json eval navigator.clipboard.readText()链接格式通常为https://weixin.qq.com/sph/xxxxxxsph 即视频号拼音缩写。注意如果刚发布的视频还在审核中分享按钮可能不可用。此时可先完成发布记录publish_url 留空待审核通过后再补充链接。四、保存草稿与手动模式保存草稿在 Step 7 中 snapshot 找存草稿按钮 ref → click而非发表。手动模式如果需要人工检查表单后再发布——完成到 Step 6所有字段已填写不自动 click 发表告知用户在浏览器中手动检查并点击。注意不操作时标签页约 30 秒后可能被重置为空白页见下文form_reset_on_idlepitfall。五、必做约束与 Session 共享与 wx-channel-engagement 共管必做约束用完即 close 持久化 sessionwechat-channel——登录态 指纹冻结在磁盘 profile不留进程占内存下次发布--session wechat-channel --persistent重起无头即恢复。只在 session 卡死时camoufox-cli --session wechat-channel --json closeteardown。同 session 已有命令在跑时新命令 fail-first返回session wechat-channel 正忙请等待当前操作完成后再试——读到这条文本就等当前操作完成再重试不要盲试。Session 共享约束本技能与 wx-channel-engagement共用同一个wechat-channel持久化 session靠 session 名字符串约定共享同一 profile 目录与登录态——任一技能登录后另一个不需重登反之亦然。单一 session、单一 IP、单一 profile避免多 session 多 IP 的风控风险。这与twitter-posttwitter-interact的 session 共享模式靠 session 名字符串约定共享同一 profile 目录与登录态如出一辙。关键约定fail-first 队列同 session 已有命令在跑时新命令直接 fail。读到session wechat-channel 正忙→ exit 3调用方agent等待当前操作完成后再试不自动排队、不自动 close 正在跑的 sessionclose 会 tear down 正在跑的发布操作。登录态闭环不导出 cookie/UA/token——登录态在wechat-channelsession profile 里就位即可。失效时走本技能前置条件的无头截图扫码重登流或由wx-channel-engagement自己的重登流触发。与 login-manager 完全无关本技能自管wechat-channelsession 的探活 登录 重登。wx-channel-engagement同理自管不调 login-manager。从 fetch_engagement.py 源码可以看到这套约定的工程化落地脚本中SESSION_NAME wechat-channel、camoufox_run()固定拼--persistent --json登录流程里cmd_login用--reset在扫码污染 cookie 后强制清理 profilecmd_login_confirm轮询当前页 URL 等待「URL 含/platform/且不含 login」判登录就位。发布与抓取两条链路正是靠这一个 session 名完成桥接的。六、Pitfalls四个高频坑pitfall: wujie_shadow_dom触发访问创作者中心任何页面症状常规 DOM 选择器找不到表单元素workaroundcamoufox-cli snapshot默认穿透 shadow DOM 拿 ref后续click/type/upload按 ref 操作即可。fallback 才需要eval里手写document.querySelector(wujie-app).shadowRoot.querySelector(selector)。pitfall: video_transcode_timeout触发大视频文件上传后转码症状等待超过 3 分钟仍未完成workaround增加等待时间或检查视频格式是否兼容。pitfall: login_qr_only触发访问视频号页面未登录症状跳转到扫码登录页无用户名/密码选项workaround走前置条件的无头截图扫码流程screenshot QR PNG → 发用户扫码 → 轮询 URL 确认登录就位与 wx-mp-engagement 同机制。pitfall: form_reset_on_idle触发填写完表单后长时间不操作症状标签页被重置为空白页约 30 秒空闲超时workaround填完表单后立即发布或使用手动模式让用户快速操作。七、错误处理速查表情况处理未登录走前置条件的无头截图扫码登录流重试一次上传失败检查视频格式mp4/mov/avi/webm重试一次转码超时增加超时时间或告知用户稍后在创作者中心检查发表按钮 disabled检查必填字段是否已填写视频是否上传完成shadow DOM 元素找不到等待更长时间让 wujie 初始化或刷新页面session 正忙fail-first等当前操作完成再重试不要盲试八、发布后入库约束为什么 record.sh 必须传完整描述本技能只管发布到视频号后台不调record.sh——入库走 main crew 工作流AGENTS.md 的「发布后数据记录流程」段。但调用方需注意一条关键约束record.sh --platform wx_channel --title必须传 Step 6 填的完整描述文案含 hashtag最长约 300 字不要传 Step 5 的短标题。原因在于平台语义视频号作品没有「标题」概念作品管理页展示与wx-channel-engagement抓取匹配用的都是描述文案。pub_wx_channel.title列存的就是完整 descwx-channel-engagement fetch按它匹配后台才能成功。传短标题会导致抓取匹配全部失败。这一点在 fetch_engagement.py 的match_post()中有明确印证匹配策略是「用发布日期±1天筛同日候选 → 拿 desc 前 60 字归一化包含匹配」而 record.sh 的--title参数会原样写入pub_wx_channel.title列——两者必须同源完整描述文案闭环才能跑通。九、设计要点总结回顾整套方案几个值得借鉴的设计决策影子 DOM 处理无需 CDP hackwujie 微前端把表单全部塞进wujie-app::shadow-rootcamoufox-clisnapshot默认穿透拿 ref把「找元素」与「操作元素」解耦成 ref 传递脚本稳定且可读。fail-first 队列替代自动排队同 session 并发不是良性失败而是互相踩踏原server.js无锁 共享page.goto所以做成显式失败 调用方感知重试卡死可close --all强制回收。登录态 profile 闭环不导出 cookie/UA登录态只活在自己的持久化 profile 里靠 session 名字符串约定跨技能共享把多 session 多 IP 的风控风险降到最低。发布与抓取同一数据语义视频号以描述文案为唯一标识发布时写完整 desc 到 DB抓取时按 desc 匹配全链路一致避免「标题-描述」错位导致的抓取失败。对于需要自动化运营微信视频号的团队这套「camoufox-cli 持久化 session 无头扫码登录 流程化表单操作 共享 session 风控约束」的组合是一个可直接落地的完整参考实现。赞分享人工智能AI Agent大模型AI 应用媒体生成【免费下载链接】xiaobei为OPC/中小微企业量身打造的自媒体获客智能体项目地址https://gitcode.com/gh_mirrors/wi/xiaobei点击查看免费下载相关推荐OpenCLI 视频号WeChat Channels发布适配器实战指南基于已登录 Chrome 的浏览器自动化视频发布OpenCLI 视频号WeChat Channels发布适配器实战指南基于已登录 Chrome 的浏览器自动化视频发布 视频号创作者中心整体运行在 wuj开发工具CLI人工智能AI 应用浏览器控制GUI 自动化微信视频号 Engagement 抓取实战基于 camoufox-cli 与 wujie 微前端 shadow DOM 解析的 wx-channel-engagement 技能全解微信视频号 Engagement 抓取实战基于 camoufox cli 与 wujie 微前端 shadow DOM 解析的 wx channel enga人工智能AI Agent大模型AI 应用媒体生成xiaobei 智能体 Twitter/X 发布技能实战指南基于 camoufox-cli 的纯浏览器自动化发帖方案xiaobei 智能体 Twitter/X 发布技能实战指南基于 camoufox cli 的纯浏览器自动化发帖方案 导读 本文围绕 xiaobei为 OP人工智能AI Agent大模型AI 应用媒体生成上一篇OpenRGB3个步骤彻底解决多品牌RGB设备管理难题的开源方案下一篇终极分子绘图工具Ketcher免费在线化学结构编辑器完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考