| 1 | # 运行前提 |
| 2 | |
| 3 | 这个 skill 默认假设当前环境已经具备： |
| 4 | |
| 5 | - 已安装 `social-auto-upload` |
| 6 | - 可以调用 `sau`，或者至少可以执行 `python sau_cli.py` |
| 7 | - 当前机器首次运行时可以联网访问 GitHub Release |
| 8 | |
| 9 | ## 关键说明 |
| 10 | |
| 11 | 用户不需要自己安装 `biliup`。 |
| 12 | |
| 13 | 当你执行 `sau bilibili ...` 时： |
| 14 | |
| 15 | - 如果本地没有 `biliup`，程序会自动下载 |
| 16 | - 如果上游 GitHub Release 有更新，程序会自动更新后再继续执行 |
| 17 | |
| 18 | ## 推荐调用方式 |
| 19 | |
| 20 | ### `sau` 已在 PATH 中 |
| 21 | |
| 22 | ```bash |
| 23 | sau bilibili --help |
| 24 | ``` |
| 25 | |
| 26 | ### 仓库内直接调用 |
| 27 | |
| 28 | PowerShell： |
| 29 | |
| 30 | ```powershell |
| 31 | .\.venv\Scripts\python.exe sau_cli.py bilibili --help |
| 32 | ``` |
| 33 | |
| 34 | bash / zsh： |
| 35 | |
| 36 | ```bash |
| 37 | python sau_cli.py bilibili --help |
| 38 | ``` |
| 39 | |
| 40 | ## 首次运行注意事项 |
| 41 | |
| 42 | - 首次运行可能比其他平台更慢，因为要自动准备 `biliup` |
| 43 | - 如果网络无法访问 GitHub Release，Bilibili 命令会失败 |
| 44 | - 一旦本地已经准备好 `biliup`，后续命令会直接复用 |
| 45 | - `sau bilibili login --account <name>` 需要用户自己在本地真实终端里执行 |
| 46 | - 如果终端二维码显示不完整，通常可以直接打开当前目录下的 `qrcode.png` 扫码 |
| 47 | - 如果国内网络访问 GitHub Release 较慢，可先用 `https://gh-proxy.com/` 或 `https://gh-proxy.org/` 辅助访问对应 release 地址排障 |
| 48 | - 示例： |
| 49 | - `https://gh-proxy.org/https://github.com/biliup/biliup/releases/download/v1.1.29/biliupR-v1.1.29-aarch64-linux.tar.xz` |
| 50 |