douyin-publish：基于 camoufox-cli 持久化会话的抖音创作者中心纯浏览器发布方案

人工智能AI Agent大模型AI 应用媒体生成【免费下载链接】xiaobei为OPC/中小微企业量身打造的自媒体获客智能体项目地址https://gitcode.com/gh_mirrors/wi/xiaobei点击查看免费下载本指南完整解析 xiaobei 项目中douyin-publish技能SKILL.md的设计与实战用法。该技能面向OPC/中小微企业自媒体获客场景用纯浏览器自动化在抖音创作者中心完成视频上传、表单填写、AI 自主声明、发布与取链全程不触碰 cookie、不依赖开放平台资质。读完你将掌握run一键发布与upload / fill / publish / get-link分步编排、登录态判定与重登闭环、aweme_id捕获与三级取链策略以及完整退出码约定与避坑清单。一、方案定位纯浏览器操作不吃 cookie不复用开放平台douyin-publish是 xiaobei 项目中用于抖音内容发布的技能其核心设计约束记录在 SKILL.md 开头与脚本入口的模块注释中纯浏览器模拟发布动作全部通过 forked 版camoufox-cli在抖音创作者中心页面内完成上传、填表、点按钮形态与wechat-channels-publish同构。不依赖开放平台源码测试里有一条专门的断言——脚本源码中不得出现open_platform、client_key、client_secret、access_token等开放平台凭据字样见 test_publish_douyin.py 的test_no_douyin_open_platform_credentials。用户上下文显示抖音开放平台发布能力因主体资质被驳回后才改走浏览器模拟路线。复用 login-manager 准备好的持久化 session登录态与浏览器指纹一起冻结在磁盘 profile 里本技能只消费它绝不自行造登录。会话与依赖模型项约定依据持久化 session 名douyin一个且只有一个publish_douyin.py 中PERSISTENT_SESSION douyin测试test_platform_key断言浏览器后端camoufox-clifork 自 Bin-Huang/camoufox-cli 0.6.2camoufox-cli fork README运行时依赖python3camoufox-cliSKILL.md frontmattermetadata.openclaw.requires.bins登录态管理探活 / 有头登录 / 导出 cookieUA 全交login-managerlogin-manager SKILL.md命令入口douyin-publish cmdbash wrapper 转调 Pythondouyin-publish.sh⚠️红线一本技能没有login子命令也没有cleanup子命令。执行过程中任何时候发现登录态失效一律重走 login-manager 流程不在技能内自管重登。为什么一个持久化 session fail-first 队列fork 版 camoufox-cli 在 daemon 侧实现了fail-first 队列同一 session 同一时刻只允许一条命令在跑新命令到达时立即失败并返回文本session douyin 正忙请等待当前操作完成后再试见 camoufox-cli fork README §2。设计动机是同 session 并发不是良性失败而是互相踩踏。因此 agent 读到这条失败文本时的正确动作是等待当前操作完成再重试不要盲试、不要自动排队。close命令不受队列限制session 卡死时可随时 teardown。二、发布前置必做open 上传页 agent 判定登录态这是本技能区别于普通一条命令发视频方案的关键环节源自一次实战教训抖音 cookie 存在预热机制直接douyin-publish run可能因 cookie 未激活而不生效。因此每次发布前必须先 open 上传页无头 persistent session由 agent 在此页面根据元素判定登录态之后再走run。标准三步流程# 1. open 上传页无头 persistent session douyin douyin-publish open-page # 输出: {ok: true, session: douyin, url: ..., hint: agent 用 camoufox-cli eval/snapshot 判定登录态} # 2. agent 判定登录态通过页面元素用户头像/用户名等判定 camoufox-cli --session douyin --persistent --json eval document.querySelector(头像 selector) ? logged_in : not_logged_in # 3a. 判定为已登录 → 走发布 douyin-publish run --video /path/to/video.mp4 --title 标题 --caption 描述 # 3b. 判定为未登录 → 见登录失效章节走 login-manager 有头重登open-page的实现cmd_open_page只做两件事camoufox_open(session, UPLOAD_URL)打开上传页等待 2 秒渲染后回读当前 URL输出 JSON含hint字段提示 agent 用 eval/snapshot 判定登录态不做任何登录态断言。_check_logged_in为何被 mute 成 no-op原版脚本用URL 跳转 cookies export双信号判登录态2026-08-04 实测发现误判率高cookie 预热机制、临时 profile 等因素会导致SESSION_EXPIRED假阳性。因此脚本中_check_logged_in保留签名但不再做任何检查、不再exit 2见 publish_douyin.py 中的函数注释对应单测TestCheckLoggedIn专门断言no-op 不抛 SystemExit、返回 None登录态判定职责上移给 agent在open-page打开的页面上根据用户头像/用户名等真实页面元素判断也可以截图调用视觉模型判定。 若最终走上run脚本假设 login-manager 已把持久化 sessiondouyin的登录态准备好直接复用做发布操作。三、登录失效时走 login-manager 有头重登闭环抖音的持久化 session 由login-manager技能统一管理login-manager SKILL.md# 1. 有头打开抖音首页通知用户在窗口里手动完成创作者中心登录 camoufox-cli --session douyin --persistent --headed --json open https://www.douyin.com # 2. 用户确认登录完成后一条命令闭环导出 验证 落中央存储 close session login-manager --platform douyinlogin-manager 的流程约束与本技能强相关强制有头手动登录agent 不主动触发登录动作只开浏览器等用户扫码/短信/账密完成3 分钟无回复发超时提示并退出。两层探活验证后才 commit导出 cookie 到临时 → Tier 1 检查关键字段 → Tier 2 平台 pong → 通过才写入中央存储验证不过exit 2且不重试避免风控。失败时保留 session任何错误路径都不 close session浏览器进程留着让用户原窗口重试避免登录态丢失又要重新扫码。cookie 与 UA 必须同时导出同一指纹下的 cookie 才不会被风控错配落盘到~/.openclaw/logins/douyin.json与douyin.ua.json供 viral-chaser / published-track 等下游消费。抖音的具体探活规则可参考 _shared/check-session.tsTier 1 关键 cookiesessionidsid_ttuid_tt三个必须全在出现sid_ucp_sso_v1、ssid_ucp_sso_v1、sso_uid_tt、toutiao_sso_user、toutiao_sso_user_ss等过期系 cookie 判失效。Tier 2 pongGET https://www.douyin.com/aweme/v1/web/history/read/带a_bogus签名status_code 0判已登录、 8判未登录。⚠️红线二严禁cookies import造登录会话。浏览器操作不开临时 session 再 import cookie 那一套——抖音a1/websectiga等设备指纹 cookie 导入到不同指纹的浏览器会话会错配触发平台风控。本技能也不导出 cookie/UA导出是 login-manager 的事脚本不调用cookies export/identity export。四、使用方式一键全流程与分步编排4.1 一键全流程rundouyin-publish run \ --video /path/to/video.mp4 \ --title 视频标题 \ --caption 视频描述 #话题1 #话题2run内部串联cmd_runupload → fill → publish → get-link并在finally中用完即 close 持久化 session——登录态在磁盘 profile不留进程占内存下次发布--session douyin --persistent重起无头即恢复。⚠️发布前必做open-page 登录态判定见第二章否则可能因 cookie 未预热而不生效。4.2 分步调用agent 按需编排# 1. 上传视频返回 session 名后续步骤用 douyin-publish upload --video video.mp4 # 2. 填标题/描述 自主声明 # fill 命令内部自动完成填标题 - 填简介 - 选自主声明内容由AI生成 - 点确定按钮 # 自主声明下拉不存在时不阻断部分账号/页面无此选项 douyin-publish fill --session s --title 标题 --caption 描述 # 3. 点发布注入拦截器捕获 aweme_id 写入 localStorage返回 aweme_id douyin-publish publish --session s # 4. 取视频链接 douyin-publish get-link --session s各子命令的参数在 publish_douyin.py 的build_parser()中定义upload必填--videofill必填--session--title/--caption可选默认空字符串publish/get-link必填--session。4.3 几个值得注意的内置行为草稿恢复框清理uploadopen 上传页后会检测「你还有上次未发布的视频是否继续编辑」弹窗并点「放弃」清掉。这是 2026-07-17 事故根因之一上次失败发布留了草稿新发布被旧草稿带偏页面跳到管理页但实际没发出去见_dismiss_draft_dialog实现含二次确认「确定放弃」的处理。自主声明流程2026-07-17 真机确认点开请选择自主声明下拉 → 选内容由AI生成 →必须点弹窗右下角粉色确定按钮声明才生效。_select_ai_declaration已内置此流程且当下拉不存在页面改版去掉声明区时返回 True 不阻断。标题 input 选择器收窄input[placeholder*填写作品标题]特意避开付费场景的标题 inputplaceholder 为请输入付费场景下的视频标题防止误填。简介是 contenteditable 富文本抖音简介是 editor-kit 的div[contenteditabletrue][data-placeholder*作品简介]普通 value setter 无效需走 focus execCommand(insertText)标准路径读回为空再回退 textContent input 事件camoufox_type_contenteditable。4.4 创作者中心 URL用途URL上传页https://creator.douyin.com/creator-micro/content/upload?enter_fromdou_web视频管理页取链接用https://creator.douyin.com/creator-micro/content/manage五、发布成功判定与 aweme_id 捕获源码级机制拆解这是本技能技术含量最高的部分源自 2026-07-17 的两起事故修正。5.1 发布前的 fetch/XHR 拦截器publish命令在点发布按钮前先注入拦截器 JSjs_intercept全量捕获发布期间所有 fetch/XHR 请求的响应URL/method/status/响应片段上限 300 条对每个响应深度搜索aweme_id/item_id/awemeId/itemId/video_id字段递归 walk深度上限 10命中即写入localStorage.douyin_last_aweme_id跨同源导航存活发布后页面跳管理页也能读回所有请求日志写入localStorage.douyin_publish_debug发布后落盘/tmp/dy-publish-debug-ts.json供排查。但拦截器只是兜底——抖音发布实际走 form/导航非 fetch/XHR拦截器通常抓不到 aweme_id。主路是下面的 work_list API。5.2 主路work_list API 锁定本次作品发布成功后页面跳转/creator-micro/content/manage这是权威成功信号camoufox_wait_for_url_contains轮询确认。随后记录publish_start时刻点发布按钮前直接同源 fetch 作品管理 list APIhttps://creator.douyin.com/janus/douyin/creator/pc/work_list?status0count20max_cursor0scenestar_atlasdevice_platformandroidaid1128拿到aweme_list后按create_time自排序取最新列表不按时间排必须自排筛create_time publish_start - 120锁定本次作品避免误中上一次的旧作品status_code8是间歇鉴权失败非签名/非真掉登同 session 同 URL 连发通常全 0helper 内置 3 次重试3 次全 8 才exit 2交 login-manager 重登拿到的 aweme_id 写入localStorage.douyin_last_aweme_id供get-link复用。对应单测test_publish_douyin.py覆盖了拦截器命中走 localStorage、拦截器 miss 回退 work_list、work_list 三次鉴权失败exit 2、重试后恢复返回 id、sc0但无作品不重试等路径。5.3get-link三级取链策略策略优先级说明① localStorage首选读publish写入的douyin_last_aweme_id跨发布→管理导航存活无需重开页面② work_list API兜底取全局最新作品无 since 筛选拼https://www.douyin.com/video/aweme_id③ 管理页 DOM最后a[href*/video/]或[data-aweme-id]等属性提取可能因改版失效run全流程在closesession之前就能拿到链接不依赖 close 后重开。5.4 aweme_id 未捕获 发布可能未真正成功若拦截器 work_list 都未命中 aweme_id脚本不再误报发布成功这是 2026-07-17 事故根因之二而是exit 3提示人工到管理页核实是否真有新作品并把/tmp/dy-publish-debug-*.json回传给研发定位真实发布 API。六、Exit codes 约定调用方该做什么code含义调用方动作0发布成功aweme_id 已捕获cookieUA 在 login-manager 中央存储继续下游1参数错 / crash / DOM 改版按钮/input 未找到/ 上传转码超时排查后重试2SESSION_EXPIRED——未登录或登录态失效URL 跳登录页 或 cookies 缺 sessionid/sid_tt/uid_tt走 login-manager--platform douyin有头重登后重试3发布流程走完但未捕获到 aweme_id——发布可能未真正成功发布 API 未命中拦截器或被服务端拒人工到管理页核实是否真有新作品把/tmp/dy-publish-debug-*.json回传给研发七、必做约束清单用完即 close 持久化 sessiondouyin登录态 指纹冻结在磁盘 profile不留进程占内存只在 session 卡死时camoufox-cli --session douyin --json closeteardown。fail-first 队列读到session douyin 正忙请等待当前操作完成后再试就等当前操作完成再重试不要盲试。严禁cookies import浏览器操作不开临时 session 再 import cookie会触发平台风控。不导出 cookie / UA导出是 login-manager 的事本技能不调用cookies export/identity export。登录态失效即交 login-manager任何时候发现失效走有头重登流不在技能内自管重登。关于 camoufox-cli 调用一致性源码注释里记录了一条 2026-07-18 的 get-link 事故根因所有 camoufox-cli 调用必须一致带--persistent。若某个 eval 恰好是首个触发 daemon spawn 的调用却没带--persistent会起一个非持久 daemon临时 profile无 auth cookie后续--persistent调用也复用这个非持久 daemon → 全程临时 profile → 登录页 work_listsc8。因此脚本内camoufox_open、camoufox_eval等所有封装都固定带--persistent --json。八、Pitfalls七类已知坑与处置pitfall: douyin_login_required_on_creator_center触发访问creator.douyin.com未登录态症状页面跳到creator.douyin.com/login或出现登录弹窗workaround脚本返回exit 2session 失效由调用方走login-manager 有头手动重登流不在本 skill 内自管重登pitfall: real_name_auth_required触发未实名认证的账号症状创作者中心提示请先完成实名认证才能发布workaround用户自己走实名认证流程脚本帮不上pitfall: video_too_long_or_wrong_format触发上传非 mp4 / mov 格式或视频时长超限症状上传后转码失败 / 客户端拒收workaround转 mp4 检查时长抖音支持最长 15 分钟pitfall: dom_changes_creator_center触发抖音创作者中心前端改版症状selector 找不到input / button 位置变化workaround部署后真机验证更新 selectorSKILL.md 中约定为docs/post-deploy-verification.md流程注意该文档未收录于本仓库需按实际部署环境维护pitfall: upload_transcode_timeout触发视频上传后转码超时大文件 / 网络波动症状camoufox_wait_for_selector轮询标题表单超时脚本报视频上传/转码超时标题表单未出现workaround检查视频大小建议 100MB脚本上传超时上限 300 秒、转码等待上限 600 秒见脚本常量UPLOAD_TIMEOUT_S/TRANSCODE_MAX_WAIT_S超时后截图排查是 DOM 改版还是转码慢确认 DOM 已渲染后可用分步命令fill/publish手动继续 源码里还记录了一条真机经验抖音上传页根本没有上传成功这四个字转码完成的真实信号是标题表单渲染出来input[placeholder*填写作品标题]出现用文本匹配旧写法必超时。pitfall: ai_declaration_confirm触发选完自主声明内容由AI生成后未点确定按钮症状声明弹窗卡住发布按钮被遮挡无法点发布workaroundfill命令已内置点确定步骤分步手动操作时需注意选完声明后必须点确定pitfall: rate_limit_after_burst_publish触发短时间内连续发布多条症状平台风控 / 上传被拒 / 提示操作过于频繁workaround每天 ≤ 5 条触发后 30 分钟内不重试九、操作纪律与限频建议限频单抖音号每 24h ≤ 5 条发布触发风控立即降级SKILL.md Notes 与 pitfall 双重强调。失败回退浏览器模拟失败 → 维持现状让用户自己手动发不做二次盲目重试。DOM 改版频繁抖音创作者中心前端迭代快selector 需在每次部署后真机验证脚本对按钮/input 未找到统一exit 1通过 exit code 让调用方感知改版而非静默失败。Docker 环境Docker 内对内 crew exec 为 full 权限无 allowlist 限制技能命令可按需直调。十、验证体系单测如何锁定这套行为test_publish_douyin.py 用 mock 掉所有 camoufox-cli/subprocess 调用覆盖了常量断言上传 URL 必须指向creator.douyin.com且带enter_fromdou_webPERSISTENT_SESSION douyin源码不得含开放平台凭据关键字。会话命名douyin-publish-{nonce}/douyin-upload-{nonce}格式。upload 失败模式视频文件不存在exit 1upload 注入失败exit 1。mute 的_check_logged_in不抛异常、返回 None。work_list 重试逻辑成功返回最新 id三次sc8后exit 2且恰好调用 3 次先 8 后 0 能恢复sc0无作品不重试。publish 三重结局拦截器命中 localStorage 直接返回拦截器 miss 回退 work_list两者都 missexit 3不误报成功。get-link 三级策略localStorage 命中不重开页面work_list 兜底管理页 DOM 兜底全部 miss 返回ok: true, url: null发布已成功但链接提取失败不 exit 报错。run 顺序upload → fill → publish → get-link依次调用一次。CLI smoke--help可执行且含upload。这套测试把最易回归的误报发布成功假阳性掉登取不到链接三类风险锁死是理解脚本行为的可靠入口。总结douyin-publish是 xiaobei 自媒体获客体系中抖音发布这一环的纯浏览器自动化实现以 login-manager 维护的持久化 sessiondouyin为登录态底座以 camoufox-cli 的upload命令底层 PlaywrightsetInputFiles穿透 shadow DOM为上传通道以open-page 预热 agent 判登录态为发布前置以拦截器 work_list API 管理页 DOM三级策略兜底 aweme_id 捕获。其设计处处体现宁可误判失败让人工核实不可误报成功的工程取舍以及登录态只走真实登录 指纹冻结、严禁 cookie import的风控纪律。若你需要在自建智能体中接入抖音自动发布这套持久化 session fail-first 队列 退出码契约 三级取链的骨架可以直接参考复用。赞分享人工智能AI Agent大模型AI 应用媒体生成【免费下载链接】xiaobei为OPC/中小微企业量身打造的自媒体获客智能体项目地址https://gitcode.com/gh_mirrors/wi/xiaobei点击查看免费下载相关推荐xiaobei 智能体 Twitter/X 发布技能实战指南基于 camoufox-cli 的纯浏览器自动化发帖方案xiaobei 智能体 Twitter/X 发布技能实战指南基于 camoufox cli 的纯浏览器自动化发帖方案 导读 本文围绕 xiaobei为 OP人工智能AI Agent大模型AI 应用媒体生成如何将 Web 项目迁移到 Lynx元素映射、滚动容器与事件处理调整如何将 Web 项目迁移到 Lynx元素映射、滚动容器与事件处理调整 如果你手上有一个基于 Web 标签体系的项目 div / span / img 加 o人工智能AI Agent大模型AI 应用媒体生成AI短视频生成实战MoneyPrinterTurbo 输入一个主题5分钟出带配音的短视频AI短视频生成实战MoneyPrinterTurbo 输入一个主题5分钟出带配音的短视频 自媒体账号日更最耗时的不是写文案而是写文案→找素材→配音→剪人工智能AI Agent大模型AI 应用媒体生成上一篇如何永久保存你的微信聊天记录这款开源工具让你轻松实现数据自由下一篇终极AI图层分离指南如何在3分钟内将插画自动分层创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考