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
@@ -14,7 +14,7 @@ description: 当 agent 需要通过已安装的 `sau` CLI 完成 Bilibili 登录

 | 功能 | 命令入口 | 说明 |
 | --- | --- | --- |
-| 登录 | `sau bilibili login --account <name>` | 生成或刷新指定账号的登录信息 |
+| 登录 | `sau bilibili login --account <name>` | 需要用户自己在本地真实终端里执行，用于生成或刷新登录信息 |
 | 校验 | `sau bilibili check --account <name>` | 检查指定账号当前是否有效 |
 | 视频上传 | `sau bilibili upload-video ...` | 上传一条 Bilibili 视频 |

@@ -27,7 +27,7 @@ description: 当 agent 需要通过已安装的 `sau` CLI 完成 Bilibili 登录

 ## 命令选择建议

- 用户没有登录信息，先用 `login`
+- 用户没有登录信息，先让用户自己在本地终端执行 `login`
 - 用户只想确认账号状态，先用 `check`
 - 用户要发视频，用 `upload-video`

@@ -37,6 +37,9 @@ description: 当 agent 需要通过已安装的 `sau` CLI 完成 Bilibili 登录
 - 如果 `sau` 不在 PATH 中，可以用仓库里的 `sau_cli.py`
 - 不要要求用户手动下载 `biliup`
 - 第一次运行 Bilibili 命令时，程序可能会自动联网准备 `biliup`
+- 对 agent 来说，不要在非交互环境里硬跑 `sau bilibili login`
+- 正确做法是让用户自己在本地终端执行 `sau bilibili login --account <name>`
+- 如果终端里的二维码显示不完整，提醒用户直接打开当前目录下的 `qrcode.png` 扫码

 ## 模板文件

@@ -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。

@@ -1,4 +1,6 @@
 # 登录
+# 建议由用户自己在本地真实终端里执行。
+# 如果终端二维码显示不完整，可以打开当前目录下的 qrcode.png 扫码。
 sau bilibili login --account creator

 # 校验
@@ -1,4 +1,6 @@
 # login
+# Run this in a local interactive terminal.
+# If the terminal QR code is incomplete, open ./qrcode.png and scan that image.
 sau bilibili login --account creator

 # check