跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

douyin-publish

在抖音创作者中心填写并发布图文或视频作品,包括本地素材上传、视频封面设置、音乐选择、发布前校验和显式确认点击。用户要求发布抖音图文/视频或检查待发布内容时使用;不用于草稿管理或定时发布。

zJay26 · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add zJay26/douyin-skills --skill douyin-publish

技能说明


name: douyin-publish description: 在抖音创作者中心填写并发布图文或视频作品,包括本地素材上传、视频封面设置、音乐选择、发布前校验和显式确认点击。用户要求发布抖音图文/视频或检查待发布内容时使用;不用于草稿管理或定时发布。

发布抖音图文或视频

只使用 python "{baseDir}/../../scripts/cli.py" <子命令> 完成抖音页面操作。可以使用普通图片、视频工具准备和肉眼检查素材,但不要换用其他发布实现。

共同强制流程

  1. 确认目标账号并运行 check-login。
  2. 检查全部素材、标题和文案,并确定本次发布类型是图文还是视频。
  3. 使用对应的填表命令,人工查看页面,再使用对应的只读校验命令。
  4. 用户没有预先明确授权发布时,展示最终内容并取得授权。
  5. 只有校验返回 success: true、state: ready 后,才执行对应的 click-publish* --confirm。
  6. 根据 published 与 status 判断结果;点击后未确认时绝不自动重试。

不要把图文校验器用于视频页,也不要把视频校验器用于图文页。任何 wrong_page、验证码/风控、字段不一致、上传未完成或封面缺失都必须先解决。

图文发布

图片必须是存在的绝对路径,格式为 JPG、JPEG、PNG 或 WebP。标题、正文和至少一张图片都不能为空;正文先写入 UTF-8 文本文件。

python "{baseDir}/../../scripts/cli.py" fill-publish-image \
  --title "作品标题" \
  --desc-file "/absolute/path/desc.txt" \
  --images "/absolute/path/01.jpg" "/absolute/path/02.jpg"

只有 success: true、status: filled 且页面中的标题/正文与请求值完全一致时才继续。然后选择音乐:

python "{baseDir}/../../scripts/cli.py" select-music --names "目标音乐1" "目标音乐2"

检查图片数量、裁切、标题、正文和音乐后运行:

python "{baseDir}/../../scripts/cli.py" validate-publish

用户明确要求热点时才加入 --require-topic。最终发布命令为:

python "{baseDir}/../../scripts/cli.py" click-publish --confirm

视频发布

  • 视频必须是存在的绝对路径。支持 AVI、FLV、M4V、MKV、MOV、MP4、MPEG4、MPG、TS、WEBM、WMV。
  • 标题和作品简介不能为空;作品简介先写入 UTF-8 文本文件。
  • 推荐提供 JPG、JPEG、PNG 或 WebP 自定义封面。发布前必须看到至少一个已设置封面,不能把“AI 封面生成中”当成封面已完成。
  • 页面常驻提示里可能出现“上传中”;只有远端视频预览或明确的“重新上传”控件,且没有真实进度条/“上传失败”,才算视频上传完成。

一次上传、填写并设置封面:

python "{baseDir}/../../scripts/cli.py" fill-publish-video \
  --video "/absolute/path/video.mp4" \
  --cover "/absolute/path/cover.jpg" \
  --title "作品标题" \
  --desc-file "/absolute/path/desc.txt"

如果没有在填表时传 --cover,命令可能返回 status: filled_needs_cover。准备好封面后,在当前视频发布页执行:

python "{baseDir}/../../scripts/cli.py" set-video-cover \
  --cover "/absolute/path/cover.jpg"

人工检查视频预览、标题、作品简介、竖/横封面和可见性设置,再运行:

python "{baseDir}/../../scripts/cli.py" validate-publish-video

用户明确要求热点时才加入 --require-topic。任何 errors 都必须先解决。最终发布命令为:

python "{baseDir}/../../scripts/cli.py" click-publish-video --confirm

结果解释

  • published: true、status: publish_confirmed:页面已给出明确成功信号。
  • published: false、status: publish_clicked_unconfirmed:已经点击,但成功状态未知。不要自动重试;先到作品管理核对,避免重复发布。
  • status: publish_outcome_unknown、clicked: null、retry_safe: false:指令期间异常,是否点击未知;先去作品管理核对,禁止自动重试。
  • success: false:先检查上述状态和 retry_safe;只有确认发布前校验失败且未点击时,才按 validation.errors 修复。

会话丢失或页面已关闭时,后续发布步骤不会自动选择另一个标签页。先用 browser-status --include-tabs 在本地确认目标,再通过全局 --target-id 指定现有表单,或重新准备内容。

风控与边界

  • 优先复用已有的本地 Chrome 调试实例;只有 JSON 明确返回 needs_user_verification: true 才停下请用户处理验证码或身份验证。
  • 不尝试绕过验证码、风控或平台限制。
  • 不支持一键跳过复核、草稿管理、定时发布、自动远程素材下载或远程 Chrome 发布承诺。