技能介绍

要解决的问题

把视频发到抖音，看起来只是"上传 + 填文案 + 点发布"，但放进自动化流水线里就会撞到三个具体障碍：上传控件嵌在页面 DOM 里、文案编辑区是 contenteditable 节点而不是普通输入框、发布按钮文案和成功跳转的判定条件与其他平台完全不同。这个 Skill 要做的就是把这些步骤收敛成一个稳定的命令行调用，让 AI Agent 能在流水线里直接把本地视频推上抖音。

核心能力与工作流程

它基于 Stagehand + Playwright 做浏览器自动化，调用方式是脚本参数：

--video= 视频文件绝对路径（必填）
--desc= 视频描述，可带 #话题 标签
--title= 短标题

Agent 侧的执行顺序很明确：先收集发布信息并与用户确认，再执行发布脚本，处理登录，最后检查输出。脚本结束会给出明确信号：🎉 发布成功且 URL 跳转到 /content/manage，或输出 ⚠️ 表示需要人工介入检查。

登录态与架构细节

首次运行需要在弹出的浏览器里用抖音 App 扫码，之后登录态写入 ~/.douyin-publish/chrome-data/ 这个 Playwright 用户数据目录，cookie 与 localStorage 全部落盘，后续运行直接复用，不必重复扫码。

与微信视频号相比，抖音没有 wujie 这类微前端框架，脚本直接操作主页面 DOM：上传走 input[type="file"] + setInputFiles，编辑区是 contenteditable div，发布按钮文案为"发布"（视频号是"发表"），且抖音不存在原创声明弹窗流程。

适用边界与注意点

几个需要提前知道的坑：

环境要求 Node.js >= 18 与 npm，Stagehand 还需要 LLM API，需在项目根目录 .env 中配置。
描述填写失败通常是抖音改版了 DOM 结构。脚本会先尝试直接 DOM 操作，失败后回退到 stagehand.act() 的 AI 辅助，两条路都不通就得更新选择器。
上传失败时脚本会提示在浏览器中手动上传，完成后按回车继续。
原创声明不在本 Skill 处理范围内，需在创作者后台自行设置。
抖音与视频号可以同时发布，两者使用独立的浏览器数据目录，互不影响。
删除 ~/.douyin-publish/chrome-data/、在其他设备退出登录或长期闲置，都会让登录态失效并触发重新扫码。