| 1 | # 抖音 CLI 契约 |
| 2 | |
| 3 | 这个 skill 默认假设当前环境已经安装并可调用 `sau` 命令。 |
| 4 | |
| 5 | ## 命令列表 |
| 6 | |
| 7 | ### 登录 |
| 8 | |
| 9 | ```bash |
| 10 | sau douyin login --account <account> |
| 11 | ``` |
| 12 | |
| 13 | - 必填参数: |
| 14 | - `--account` |
| 15 | - 作用: |
| 16 | - 启动抖音登录流程，为指定账号生成或刷新 cookie 文件 |
| 17 | - 如果登录过程中生成本地二维码图片，agent 应优先直接把图片展示/发送给用户扫码，而不是只回传路径 |
| 18 | - 账号说明: |
| 19 | - `--account` 传的是用户自定义的 `account_name`，不是固定只能叫 `creator` |
| 20 | - 一个 `account_name` 对应一个账号文件，可用于多账号隔离和并发任务 |
| 21 | |
| 22 | ### 校验 cookie |
| 23 | |
| 24 | ```bash |
| 25 | sau douyin check --account <account> |
| 26 | ``` |
| 27 | |
| 28 | - 必填参数: |
| 29 | - `--account` |
| 30 | - 预期输出: |
| 31 | - `valid`：cookie 可用 |
| 32 | - `invalid`：cookie 缺失或已失效 |
| 33 | |
| 34 | ### 上传视频 |
| 35 | |
| 36 | ```bash |
| 37 | sau douyin upload-video \ |
| 38 | --account <account> \ |
| 39 | --file <video-path> \ |
| 40 | --title "<title>" \ |
| 41 | [--desc "<description>"] \ |
| 42 | [--tags tag1,tag2] \ |
| 43 | [--schedule "YYYY-MM-DD HH:MM"] \ |
| 44 | [--thumbnail <image-path>] \ |
| 45 | [--product-link <url>] \ |
| 46 | [--product-title "<title>"] \ |
| 47 | [--debug] \ |
| 48 | [--headless | --headed] |
| 49 | ``` |
| 50 | |
| 51 | - 必填参数: |
| 52 | - `--account` |
| 53 | - `--file` |
| 54 | - `--title` |
| 55 | - 可选参数: |
| 56 | - `--desc` |
| 57 | - `--tags` |
| 58 | - `--schedule` |
| 59 | - `--thumbnail` |
| 60 | - `--product-link` |
| 61 | - `--product-title` |
| 62 | - `--debug` |
| 63 | - `--headless` |
| 64 | - `--headed` |
| 65 | |
| 66 | ### 上传图文 |
| 67 | |
| 68 | ```bash |
| 69 | sau douyin upload-note \ |
| 70 | --account <account> \ |
| 71 | --images <image-1> [image-2 ...] \ |
| 72 | --title "<title>" \ |
| 73 | [--note "<content>"] \ |
| 74 | [--tags tag1,tag2] \ |
| 75 | [--schedule "YYYY-MM-DD HH:MM"] \ |
| 76 | [--debug] \ |
| 77 | [--headless | --headed] |
| 78 | ``` |
| 79 | |
| 80 | - 必填参数: |
| 81 | - `--account` |
| 82 | - `--images` |
| 83 | - `--title` |
| 84 | - 可选参数: |
| 85 | - `--note` |
| 86 | - `--tags` |
| 87 | - `--schedule` |
| 88 | - `--debug` |
| 89 | - `--headless` |
| 90 | - `--headed` |
| 91 | |
| 92 | ## 发布策略 |
| 93 | |
| 94 | - 如果不传 `--schedule`，CLI 使用立即发布 |
| 95 | - 如果传了 `--schedule`，CLI 自动切换为定时发布 |
| 96 | - 时间格式为: |
| 97 | |
| 98 | ```text |
| 99 | YYYY-MM-DD HH:MM |
| 100 | ``` |
| 101 | |
| 102 | ## 额外说明 |
| 103 | |
| 104 | - `upload-video` 每次命令只支持一个视频文件 |
| 105 | - `upload-note` 每次命令支持多张图片 |
| 106 | - 视频描述字段统一使用 `--desc` |
| 107 | - 图文正文统一使用 `--note` |
| 108 | - `upload-note` 当前不支持 GIF |
| 109 | - `upload-note` 当前最多支持 35 张图片 |
| 110 |