Track bundled vendor runtime sources

vendor/social-auto-upload/skills/kuaishou-upload/references/cli-contract.md

@@ -0,0 +1,104 @@
+# 快手 CLI 契约
+
+这个 skill 默认假设当前环境已经安装并可调用 `sau` 命令。
+
+## 命令列表
+
+### 登录
+
+```bash
+sau kuaishou login --account <account>
+```
+
+- 必填参数:
+  - `--account`
+- 作用:
+  - 启动快手登录流程，为指定账号生成或刷新 cookie 文件
+  - 如果登录过程中生成本地二维码图片，agent 应优先直接把图片展示/发送给用户扫码，而不是只回传路径
+- 账号说明:
+  - `--account` 传的是用户自定义的 `account_name`，不是固定只能叫 `creator`
+  - 一个 `account_name` 对应一个账号文件，可用于多账号隔离和并发任务
+
+### 校验 cookie
+
+```bash
+sau kuaishou check --account <account>
+```
+
+- 必填参数:
+  - `--account`
+- 预期输出:
+  - `valid`：cookie 可用
+  - `invalid`：cookie 缺失或已失效
+
+### 上传视频
+
+```bash
+sau kuaishou upload-video \
+  --account <account> \
+  --file <video-path> \
+  --title "<title>" \
+  [--desc "<description>"] \
+  [--tags tag1,tag2] \
+  [--schedule "YYYY-MM-DD HH:MM"] \
+  [--thumbnail <image-path>] \
+  [--debug] \
+  [--headless | --headed]
+```
+
+- 必填参数:
+  - `--account`
+  - `--file`
+  - `--title`
+- 可选参数:
+  - `--desc`
+  - `--tags`
+  - `--schedule`
+  - `--thumbnail`
+  - `--debug`
+  - `--headless`
+  - `--headed`
+
+### 上传图文
+
+```bash
+sau kuaishou upload-note \
+  --account <account> \
+  --images <image-1> [image-2 ...] \
+  --title "<title>" \
+  [--note "<content>"] \
+  [--tags tag1,tag2] \
+  [--schedule "YYYY-MM-DD HH:MM"] \
+  [--debug] \
+  [--headless | --headed]
+```
+
+- 必填参数:
+  - `--account`
+  - `--images`
+  - `--title`
+- 可选参数:
+  - `--note`
+  - `--tags`
+  - `--schedule`
+  - `--debug`
+  - `--headless`
+  - `--headed`
+
+## 发布策略
+
+- 如果不传 `--schedule`，CLI 使用立即发布
+- 如果传了 `--schedule`，CLI 自动切换为定时发布
+- 时间格式为:
+
+```text
+YYYY-MM-DD HH:MM
+```
+
+## 额外说明
+
+- `upload-video` 每次命令只支持一个视频文件
+- `upload-note` 每次命令支持多张图片
+- 视频描述字段统一使用 `--desc`
+- 图文正文统一使用 `--note`
+- `upload-note` 当前要求传入真实的多张图片文件，而不是同一路径重复多次