douyin-video

用 Ego Lite 会话把本地视频发到 抖音创作者中心。终点是跳到内容管理（content/manage）或页面出现**「发布成功」**。

Publish a local video file to the Douyin creator center. Success is a redirect to content management or the text 发布成功. This skill does not download video and does not call yt-dlp.

搬运他人内容前，确认调用方拥有相应权利。平台会打击未授权搬运。

先装 Ego

先装 Ego Lite，保证 ego-browser 在 PATH。缺失则 soft-fail / 告知用户去装，不要硬调浏览器。

Install Ego Lite and put ego-browser on PATH. If either is missing, soft-fail and tell the user. Do not hard-require the browser.

在 Ego 里已经登录抖音时效果更好。每次发布前把这句话告诉用户。

Being logged into Douyin inside Ego works better. Say that to the user before every publish.

每次发布前：登录闸门（必做）

Agent 在上传之前必须跑：

node scripts/check-login.mjs
# 需要把窗口留给人扫码时：
node scripts/check-login.mjs --keep

详见 references/login.md。不要另做 cookie-healthcheck 技能。

默认 finish({ keep: [] })。--keep 才把登录页留着并 handOff()。

输入（通用，无本机产品路径）

调用方提供本地文件和文案。见 references/inputs.md。本技能不绑定任何产品系列、播客或业务目录，也不下载视频。

最少需要：本机 video 路径、title（独立输入框，最多 30 个 Unicode 码位）、desc（话题写在简介里）。

默认设置即合理：公开、允许保存、立即发布。不要额外去改这些开关。

CLI

ego-browser nodejs 不继承 shell 环境变量，也不转发 shell argv。publish.sh 先把 JSON 写到 /tmp/douyin-video-publish.json，再交给 ego。

# 仓库根目录
node skills/douyin-video/scripts/check-login.mjs
node skills/douyin-video/scripts/check-login.mjs --keep
bash skills/douyin-video/scripts/publish.sh /absolute/path/to/video.mp4 "标题" "简介 #话题"
# 登录 handOff 或位置权限弹窗中断后，第 4 个参数传 spaceId。第 5 个参数 1 才保留浏览器页。
bash skills/douyin-video/scripts/publish.sh /absolute/path/to/video.mp4 "标题" "简介" 6
bash skills/douyin-video/scripts/publish.sh /absolute/path/to/video.mp4 "标题" "简介" 6 1

已安装的技能目录里用相对路径：node scripts/check-login.mjs、bash scripts/publish.sh …。

创作者表单没有 wujie。Agent 不要另写一套填表脚本，除非脚本报了 flow error 并留下 spaceId。

发布脚本在做什么

1. 若当前 URL 已是 /content/post/video（带 spaceId 续跑），跳过上传。
2. 否则打开 https://creator.douyin.com/creator-micro/content/upload。
3. 用正文判断登录：出现「扫码登录 / 二维码登录 / 请登录」，或没有「点击上传 / 上传视频」，则 exit 2 并 handOff()。文档标题里的产品名不算已登录。
4. 先 waitForFileChooser，再点去空白后文本恰好是「上传视频」的按钮（文本可能被拆成「上传」「视频」）。
5. 等到 URL 含 /content/post/video，并且正文出现「作品描述」或「添加作品简介」。
6. 用 native setter 写标题（占位含「作品标题」），回读必须和传入标题一致。超过 30 个码位直接失败。
7. 用 execCommand('insertText') 写简介（contenteditable，占位「添加作品简介」），回读必须一致。
8. 用 TreeWalker 找 <button>，其自身文本恰好是「发布」（不是「立即发布 / 定时发布 / 同时发布」），scrollIntoView 后坐标点击。
9. 成功：URL 含 content/manage，或正文出现「发布成功」。

成功时默认 finish({ keep: [] })。其它流程错误也会关掉 space。登录墙和位置权限打断不关，以便用同一个 spaceId 续跑。第 5 个参数 1 才在成功后保留页面。

位置权限打断

首次点击上传时，抖音可能申请地理位置。ego 会以 user-control 错误停掉这次调用。让用户在浏览器里处理（建议拒绝），然后用打印的 spaceId 重跑。点击通常已经生效，脚本看到发布表单就跳过重复上传。

评论

评论管理还没有脚本。需要发评论时走人工，或先探测页面再操作。不要在本技能里发明评论步骤。说明见 references/pitfalls.md。

避坑

完整清单在 references/pitfalls.md。发布前先 login-check；exit 2 必须停。

手动兜底

publish.js 报错后，JSON 里的 spaceId 可以回到原 space。不要为了排查再开一个 space。

ego-browser nodejs <<'EOF'
const task = await taskSpace(4);
const page = task.page("p1");
console.log({ url: await page.url() });
console.log(await page.snapshot());
EOF

把 4 换成实际 spaceId。看完执行 finish({ keep: [] })。

测试

npm test