feat: finalize bilibili cli workflow

2026-03-25 04:29:35 +08:00
parent 03953df4ec
commit 0778e29a04
21 changed files with 99 additions and 1348 deletions
@@ -15,6 +15,10 @@ sau bilibili login --account <account>
 - 作用：
  - 自动准备 `biliup`
  - 触发 Bilibili 登录流程
+- 登录方式说明：
+  - 这个命令应该由用户自己在本地真实终端里运行
+  - 如果终端二维码显示不完整，可直接打开当前目录下的 `qrcode.png` 扫码
+  - agent 不应该在非交互环境里硬跑这个命令

 ### 校验账号

@@ -42,3 +42,8 @@ python sau_cli.py bilibili --help
 - 首次运行可能比其他平台更慢，因为要自动准备 `biliup`
 - 如果网络无法访问 GitHub Release，Bilibili 命令会失败
 - 一旦本地已经准备好 `biliup`，后续命令会直接复用
+- `sau bilibili login --account <name>` 需要用户自己在本地真实终端里执行
+- 如果终端二维码显示不完整，通常可以直接打开当前目录下的 `qrcode.png` 扫码
+- 如果国内网络访问 GitHub Release 较慢，可先用 `https://gh-proxy.com/` 或 `https://gh-proxy.org/` 辅助访问对应 release 地址排障
+- 示例：
+  - `https://gh-proxy.org/https://github.com/biliup/biliup/releases/download/v1.1.29/biliupR-v1.1.29-aarch64-linux.tar.xz`
@@ -13,6 +13,9 @@
 - 当前网络是否能访问 GitHub
 - GitHub Release 是否可访问
 - 本地目录是否有写权限
+- 国内网络较慢时，可先用 `https://gh-proxy.com/` 或 `https://gh-proxy.org/` 辅助访问对应 release 地址排障
+- 示例：
+  - `https://gh-proxy.org/https://github.com/biliup/biliup/releases/download/v1.1.29/biliupR-v1.1.29-aarch64-linux.tar.xz`

 ## 3. `check` 返回 `invalid`

@@ -28,7 +31,24 @@
 sau bilibili login --account <account>
 ```

-## 4. 上传失败
+## 4. 登录时报 `not a terminal`
+
+常见原因：
+
+- 你是在非交互环境里触发了 `sau bilibili login`
+- 例如 agent 的命令执行器、管道环境、被接管标准输出的进程
+
+建议：
+
+- 改成由用户自己在本地真实终端里执行：
+
+```bash
+sau bilibili login --account <account>
+```
+
+- 如果终端里的二维码显示不完整，直接打开当前目录下的 `qrcode.png` 扫码
+
+## 5. 上传失败

 优先检查：

@@ -37,7 +57,7 @@ sau bilibili login --account <account>
 - 标题、简介、标签是否符合平台要求
 - 当前登录信息是否仍然有效

-## 5. 上游更新后行为变化
+## 6. 上游更新后行为变化

 当前 Bilibili 集成会自动跟随上游 `biliup` 最新 release。