| 1 | # Bilibili 常见问题 |
| 2 | |
| 3 | ## 1. 首次运行很慢 |
| 4 | |
| 5 | 这是正常情况。 |
| 6 | |
| 7 | 原因通常是程序正在自动下载 `biliup`。 |
| 8 | |
| 9 | ## 2. 自动下载失败 |
| 10 | |
| 11 | 先检查： |
| 12 | |
| 13 | - 当前网络是否能访问 GitHub |
| 14 | - GitHub Release 是否可访问 |
| 15 | - 本地目录是否有写权限 |
| 16 | - 国内网络较慢时，可先用 `https://gh-proxy.com/` 或 `https://gh-proxy.org/` 辅助访问对应 release 地址排障 |
| 17 | - 示例： |
| 18 | - `https://gh-proxy.org/https://github.com/biliup/biliup/releases/download/v1.1.29/biliupR-v1.1.29-aarch64-linux.tar.xz` |
| 19 | |
| 20 | ## 3. `check` 返回 `invalid` |
| 21 | |
| 22 | 常见原因： |
| 23 | |
| 24 | - 账号文件不存在 |
| 25 | - 登录信息已失效 |
| 26 | - `biliup renew` 失败 |
| 27 | |
| 28 | 建议： |
| 29 | |
| 30 | ```bash |
| 31 | sau bilibili login --account <account> |
| 32 | ``` |
| 33 | |
| 34 | ## 4. 登录时报 `not a terminal` |
| 35 | |
| 36 | 常见原因： |
| 37 | |
| 38 | - 你是在非交互环境里触发了 `sau bilibili login` |
| 39 | - 例如 agent 的命令执行器、管道环境、被接管标准输出的进程 |
| 40 | |
| 41 | 建议： |
| 42 | |
| 43 | - 改成由用户自己在本地真实终端里执行： |
| 44 | |
| 45 | ```bash |
| 46 | sau bilibili login --account <account> |
| 47 | ``` |
| 48 | |
| 49 | - 如果终端里的二维码显示不完整，直接打开当前目录下的 `qrcode.png` 扫码 |
| 50 | |
| 51 | ## 5. 上传失败 |
| 52 | |
| 53 | 优先检查： |
| 54 | |
| 55 | - `--tid` 是否正确 |
| 56 | - 视频文件是否真实存在 |
| 57 | - 标题、简介、标签是否符合平台要求 |
| 58 | - 当前登录信息是否仍然有效 |
| 59 | |
| 60 | ## 6. 上游更新后行为变化 |
| 61 | |
| 62 | 当前 Bilibili 集成会自动跟随上游 `biliup` 最新 release。 |
| 63 | |
| 64 | 如果上游命令行为变化，可能会影响本项目的 Bilibili CLI。 |
| 65 | |
| 66 | 排障时请同时确认： |
| 67 | |
| 68 | - 当前下载到的 `biliup` 版本 |
| 69 | - 上游 release 是否有最近变更 |
| 70 |