| 1 | # 快手 CLI 契约 |
| 2 | |
| 3 | 这个 skill 默认假设当前环境已经安装并可调用 `sau` 命令。 |
| 4 | |
| 5 | ## 命令列表 |
| 6 | |
| 7 | ### 登录 |
| 8 | |
| 9 | ```bash |
| 10 | sau kuaishou 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 kuaishou check --account <account> |
| 26 | ``` |
| 27 | |
| 28 | - 必填参数: |
| 29 | - `--account` |
| 30 | - 预期输出: |
| 31 | - `valid`：cookie 可用 |
| 32 | - `invalid`：cookie 缺失或已失效 |
| 33 | |
| 34 | ### 上传视频 |
| 35 | |
| 36 | ```bash |
| 37 | sau kuaishou 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 | [--debug] \ |
| 46 | [--headless | --headed] |
| 47 | ``` |
| 48 | |
| 49 | - 必填参数: |
| 50 | - `--account` |
| 51 | - `--file` |
| 52 | - `--title` |
| 53 | - 可选参数: |
| 54 | - `--desc` |
| 55 | - `--tags` |
| 56 | - `--schedule` |
| 57 | - `--thumbnail` |
| 58 | - `--debug` |
| 59 | - `--headless` |
| 60 | - `--headed` |
| 61 | |
| 62 | ### 上传图文 |
| 63 | |
| 64 | ```bash |
| 65 | sau kuaishou upload-note \ |
| 66 | --account <account> \ |
| 67 | --images <image-1> [image-2 ...] \ |
| 68 | --title "<title>" \ |
| 69 | [--note "<content>"] \ |
| 70 | [--tags tag1,tag2] \ |
| 71 | [--schedule "YYYY-MM-DD HH:MM"] \ |
| 72 | [--debug] \ |
| 73 | [--headless | --headed] |
| 74 | ``` |
| 75 | |
| 76 | - 必填参数: |
| 77 | - `--account` |
| 78 | - `--images` |
| 79 | - `--title` |
| 80 | - 可选参数: |
| 81 | - `--note` |
| 82 | - `--tags` |
| 83 | - `--schedule` |
| 84 | - `--debug` |
| 85 | - `--headless` |
| 86 | - `--headed` |
| 87 | |
| 88 | ## 发布策略 |
| 89 | |
| 90 | - 如果不传 `--schedule`，CLI 使用立即发布 |
| 91 | - 如果传了 `--schedule`，CLI 自动切换为定时发布 |
| 92 | - 时间格式为: |
| 93 | |
| 94 | ```text |
| 95 | YYYY-MM-DD HH:MM |
| 96 | ``` |
| 97 | |
| 98 | ## 额外说明 |
| 99 | |
| 100 | - `upload-video` 每次命令只支持一个视频文件 |
| 101 | - `upload-note` 每次命令支持多张图片 |
| 102 | - 视频描述字段统一使用 `--desc` |
| 103 | - 图文正文统一使用 `--note` |
| 104 | - `upload-note` 当前要求传入真实的多张图片文件，而不是同一路径重复多次 |
| 105 |