| 1 | --- |
| 2 | name: bilibili-upload |
| 3 | description: 当 agent 需要通过已安装的 `sau` CLI 完成 Bilibili 登录、账号校验或视频上传时使用这个 skill。优先使用 `sau bilibili ...`，程序会自动准备 `biliup`，不要求用户手动安装。 |
| 4 | --- |
| 5 | |
| 6 | # Bilibili 上传 Skill |
| 7 | |
| 8 | 优先把 `sau` 作为主接口。 |
| 9 | |
| 10 | 不要一开始就让用户自己找 `biliup` 或手动下载 release。 |
| 11 | 程序会在运行时自动检查、自动下载、自动更新 `biliup`。 |
| 12 | |
| 13 | ## 功能概览 |
| 14 | |
| 15 | | 功能 | 命令入口 | 说明 | |
| 16 | | --- | --- | --- | |
| 17 | | 登录 | `sau bilibili login --account <name>` | 需要用户自己在本地真实终端里执行，用于生成或刷新登录信息 | |
| 18 | | 校验 | `sau bilibili check --account <name>` | 检查指定账号当前是否有效 | |
| 19 | | 视频上传 | `sau bilibili upload-video ...` | 上传一条 Bilibili 视频 | |
| 20 | |
| 21 | ## 默认工作流 |
| 22 | |
| 23 | 1. 先确认 `references/runtime-requirements.md` |
| 24 | 2. 再确认 `references/cli-contract.md` |
| 25 | 3. 执行匹配的 `sau bilibili ...` 命令 |
| 26 | 4. 如果命令失败，再看 `references/troubleshooting.md` |
| 27 | |
| 28 | ## 命令选择建议 |
| 29 | |
| 30 | - 用户没有登录信息，先让用户自己在本地终端执行 `login` |
| 31 | - 用户只想确认账号状态，先用 `check` |
| 32 | - 用户要发视频，用 `upload-video` |
| 33 | |
| 34 | ## 执行前检查 |
| 35 | |
| 36 | - 优先确认当前环境能运行 `sau` |
| 37 | - 如果 `sau` 不在 PATH 中，可以用仓库里的 `sau_cli.py` |
| 38 | - 不要要求用户手动下载 `biliup` |
| 39 | - 第一次运行 Bilibili 命令时，程序可能会自动联网准备 `biliup` |
| 40 | - 对 agent 来说，不要在非交互环境里硬跑 `sau bilibili login` |
| 41 | - 正确做法是让用户自己在本地终端执行 `sau bilibili login --account <name>` |
| 42 | - 如果终端里的二维码显示不完整，提醒用户直接打开当前目录下的 `qrcode.png` 扫码 |
| 43 | |
| 44 | ## 模板文件 |
| 45 | |
| 46 | - `scripts/examples/bilibili_commands.ps1` |
| 47 | - `scripts/examples/bilibili_commands.sh` |
| 48 | - `scripts/examples/bilibili_cli_template.py` |
| 49 | |
| 50 | ## 参考文档 |
| 51 | |
| 52 | - 运行前提：`references/runtime-requirements.md` |
| 53 | - CLI 契约：`references/cli-contract.md` |
| 54 | - 故障排查：`references/troubleshooting.md` |
| 55 |