douyin-upload

1# 抖音上传 Skill
2 
3优先把 `sau` 作为主接口。
4 
5不要假设当前环境一定能读取仓库源码。
6不要一开始就去读 `uploader/`。
7只有在命令不可用或 CLI 执行失败时，才回退到故障排查说明。
8 
9## 功能概览
10 
11| 功能 | 命令入口 | 说明 |
12| --- | --- | --- |
13| 抖音登录 | `sau douyin login --account <name>` | 生成或刷新指定账号的 cookie |
14| cookie 校验 | `sau douyin check --account <name>` | 检查指定账号 cookie 是否有效 |
15| 视频上传 | `sau douyin upload-video ...` | 上传并发布抖音视频 |
16| 图文上传 | `sau douyin upload-note ...` | 上传并发布抖音图文 |
17 
18元数据约定：
19 
20- 视频使用 `title + desc + tags`
21- 图文使用 `title + note + tags`
22 
23## 默认工作流
24 
251. 先确认 `references/runtime-requirements.md` 里的运行前提。
262. 再确认 `references/cli-contract.md` 里的命令契约。
273. 执行匹配的 `sau douyin ...` 命令。
284. 如果命令失败，再看 `references/troubleshooting.md`。
29 
30## 支持动作
31 
32- 使用 `sau douyin login --account <name>` 登录抖音
33- 使用 `sau douyin check --account <name>` 校验 cookie 是否有效
34- 使用 `sau douyin upload-video ...` 上传抖音视频
35- 使用 `sau douyin upload-note ...` 上传抖音图文
36 
37## 命令选择建议
38 
39- 当用户需要新的 cookie，或现有 cookie 已失效时，使用 `login`
40- 当用户只需要确认 cookie 状态时，使用 `check`
41- 当用户要发布视频时，使用 `upload-video`
42- 当用户要发布图文时，使用 `upload-note`
43 
44## 执行前检查
45 
46- 先确认当前 shell 里是否可以调用 `sau`
47- 如果 `sau` 不可用，按 `references/runtime-requirements.md` 里的回退方式处理
48- 当用户明确指定无头或有头模式时，显式传 `--headless` 或 `--headed`
49- 只有用户明确要求定时发布时，才使用 `--schedule`
50- 如果登录流程生成了本地二维码图片，不要只把图片路径告诉用户
51- 二维码图片本身就是给用户扫码的，优先直接把本地图片展示/发送给用户
52 
53## 参考文档
54 
55- 运行前提：`references/runtime-requirements.md`
56- CLI 契约：`references/cli-contract.md`
57- 故障排查：`references/troubleshooting.md`