feat: add bilibili upload skill

This commit is contained in:
home-dev-pookz
2026-03-25 03:46:17 +08:00
parent 1bc8ae7698
commit 6d3fc819b3
9 changed files with 318 additions and 26 deletions
@@ -0,0 +1,59 @@
# Bilibili CLI 契约
这个 skill 默认假设当前环境已经安装并可调用 `sau` 命令。
## 命令列表
### 登录
```bash
sau bilibili login --account <account>
```
- 必填参数:
- `--account`
- 作用:
- 自动准备 `biliup`
- 触发 Bilibili 登录流程
### 校验账号
```bash
sau bilibili check --account <account>
```
- 必填参数:
- `--account`
- 预期输出:
- `valid`
- `invalid`
### 上传视频
```bash
sau bilibili upload-video \
--account <account> \
--file <video-path> \
--title "<title>" \
--desc "<desc>" \
--tid <category-id> \
[--tags tag1,tag2] \
[--schedule "YYYY-MM-DD HH:MM"]
```
- 必填参数:
- `--account`
- `--file`
- `--title`
- `--desc`
- `--tid`
- 可选参数:
- `--tags`
- `--schedule`
## 额外说明
- `--tid` 第一版必须传
- `--tags` 使用逗号分隔
- `--schedule` 走 `sau` 统一时间格式
- 程序会自动准备和更新 `biliup`
@@ -0,0 +1,44 @@
# 运行前提
这个 skill 默认假设当前环境已经具备:
- 已安装 `social-auto-upload`
- 可以调用 `sau`,或者至少可以执行 `python sau_cli.py`
- 当前机器首次运行时可以联网访问 GitHub Release
## 关键说明
用户不需要自己安装 `biliup`。
当你执行 `sau bilibili ...` 时:
- 如果本地没有 `biliup`,程序会自动下载
- 如果上游 GitHub Release 有更新,程序会自动更新后再继续执行
## 推荐调用方式
### `sau` 已在 PATH 中
```bash
sau bilibili --help
```
### 仓库内直接调用
PowerShell:
```powershell
.\.venv\Scripts\python.exe sau_cli.py bilibili --help
```
bash / zsh:
```bash
python sau_cli.py bilibili --help
```
## 首次运行注意事项
- 首次运行可能比其他平台更慢,因为要自动准备 `biliup`
- 如果网络无法访问 GitHub Release,Bilibili 命令会失败
- 一旦本地已经准备好 `biliup`,后续命令会直接复用
@@ -0,0 +1,49 @@
# Bilibili 常见问题
## 1. 首次运行很慢
这是正常情况。
原因通常是程序正在自动下载 `biliup`。
## 2. 自动下载失败
先检查:
- 当前网络是否能访问 GitHub
- GitHub Release 是否可访问
- 本地目录是否有写权限
## 3. `check` 返回 `invalid`
常见原因:
- 账号文件不存在
- 登录信息已失效
- `biliup renew` 失败
建议:
```bash
sau bilibili login --account <account>
```
## 4. 上传失败
优先检查:
- `--tid` 是否正确
- 视频文件是否真实存在
- 标题、简介、标签是否符合平台要求
- 当前登录信息是否仍然有效
## 5. 上游更新后行为变化
当前 Bilibili 集成会自动跟随上游 `biliup` 最新 release。
如果上游命令行为变化,可能会影响本项目的 Bilibili CLI。
排障时请同时确认:
- 当前下载到的 `biliup` 版本
- 上游 release 是否有最近变更