| 1 | --- |
| 2 | name: kuaishou-upload |
| 3 | description: 当 agent 需要通过已安装的 `sau` CLI 完成快手登录、cookie 校验、视频上传或图文发布时使用这个 skill。该 skill 适用于已经安装 `social-auto-upload` 且可调用 `sau` 命令的环境。优先使用这个 skill 进行稳定的命令式快手工作流，而不是一开始就阅读 uploader 源码。 |
| 4 | --- |
| 5 | |
| 6 | # 快手上传 Skill |
| 7 | |
| 8 | 优先把 `sau` 作为主接口。 |
| 9 | |
| 10 | 不要假设当前环境一定能读取仓库源码。 |
| 11 | 不要一开始就去读 `uploader/`。 |
| 12 | 只有在命令不可用或 CLI 执行失败时，才回退到故障排查说明。 |
| 13 | |
| 14 | ## 功能概览 |
| 15 | |
| 16 | | 功能 | 命令入口 | 说明 | |
| 17 | | --- | --- | --- | |
| 18 | | 快手登录 | `sau kuaishou login --account <name>` | 生成或刷新指定账号的 cookie | |
| 19 | | cookie 校验 | `sau kuaishou check --account <name>` | 检查指定账号 cookie 是否有效 | |
| 20 | | 视频上传 | `sau kuaishou upload-video ...` | 上传并发布快手视频 | |
| 21 | | 图文上传 | `sau kuaishou upload-note ...` | 上传并发布快手图文 | |
| 22 | |
| 23 | 元数据约定： |
| 24 | |
| 25 | - 视频使用 `title + desc + tags` |
| 26 | - 图文使用 `title + note + tags` |
| 27 | |
| 28 | ## 默认工作流 |
| 29 | |
| 30 | 1. 先确认 `references/runtime-requirements.md` 里的运行前提。 |
| 31 | 2. 再确认 `references/cli-contract.md` 里的命令契约。 |
| 32 | 3. 执行匹配的 `sau kuaishou ...` 命令。 |
| 33 | 4. 如果命令失败，再看 `references/troubleshooting.md`。 |
| 34 | |
| 35 | ## 支持动作 |
| 36 | |
| 37 | - 使用 `sau kuaishou login --account <name>` 登录快手 |
| 38 | - 使用 `sau kuaishou check --account <name>` 校验 cookie 是否有效 |
| 39 | - 使用 `sau kuaishou upload-video ...` 上传快手视频 |
| 40 | - 使用 `sau kuaishou upload-note ...` 上传快手图文 |
| 41 | |
| 42 | ## 命令选择建议 |
| 43 | |
| 44 | - 当用户需要新的 cookie，或现有 cookie 已失效时，使用 `login` |
| 45 | - 当用户只需要确认 cookie 状态时，使用 `check` |
| 46 | - 当用户要发布视频时，使用 `upload-video` |
| 47 | - 当用户要发布图文时，使用 `upload-note` |
| 48 | |
| 49 | ## 执行前检查 |
| 50 | |
| 51 | - 先确认当前 shell 里是否可以调用 `sau` |
| 52 | - 如果 `sau` 不可用，按 `references/runtime-requirements.md` 里的回退方式处理 |
| 53 | - 当用户明确指定无头或有头模式时，显式传 `--headless` 或 `--headed` |
| 54 | - 只有用户明确要求定时发布时，才使用 `--schedule` |
| 55 | - 如果登录流程生成了本地二维码图片，不要只把图片路径告诉用户 |
| 56 | - 二维码图片本身就是给用户扫码的，优先直接把本地图片展示/发送给用户 |
| 57 | |
| 58 | ## 模板文件 |
| 59 | |
| 60 | 当你需要稳定的命令模板时，使用 `scripts/examples/` 下的文件： |
| 61 | |
| 62 | - `kuaishou_commands.ps1` |
| 63 | - `kuaishou_commands.sh` |
| 64 | - `kuaishou_cli_template.py` |
| 65 | |
| 66 | ## 参考文档 |
| 67 | |
| 68 | - 运行前提：`references/runtime-requirements.md` |
| 69 | - CLI 契约：`references/cli-contract.md` |
| 70 | - 故障排查：`references/troubleshooting.md` |
| 71 |