| name | biliup-skills |
| description | 使用命令行工具 biliup（Python 版官方 CLI，非 biliup-rs）向 B 站（bilibili）投稿视频。触发场景：用户说"投稿 B 站"、"上传到 B 站"、"发 B 站"、"bilibili 投稿"、"B 站发视频"、"上传视频到 bilibili"等相关关键字。功能：(1) 自动检测并通过 uv 安装 biliup，(2) 浏览器扫码登录并发送二维码图片给用户，(3) 收集视频信息后执行投稿，(4) 返回投稿结果。 |
biliup-skills — B 站命令行投稿
使用 biliup（Python 版官方 CLI，PyPI 包名 biliup）投稿 B 站视频。
关于登录凭据（cookies.json）
biliup login 完成后，会生成 cookies.json，其中保存的是 用户自己的 B 站登录凭据（access_token），仅用于后续上传视频到用户自己的账号，不会上传至任何第三方服务器。请妥善保管该文件，不要分享或提交到 git。
要求保存到 ${HOME}/.biliup/ 目录下，如果用户是需要自己登录，则引导用户在这个目录下执行 biliup login，登录完成后再使用此工具，如果用户不想使用命令行登录，则参考后面的 Step 2：登录
核心配置
- biliup 安装方式:
uv tool install biliup（PyPI 官方包）
- biliup 路径: 系统 PATH 中
- 登录凭据文件:
${HOME}/.biliup/cookies.json（biliup login 执行的目录）
⚠️ 已知行为（实战校正）
biliup login 不支持 --cookie 参数：凭据固定保存到运行时的当前工作目录 cookies.json。
需要先 cd 到 ${HOME}/.biliup/ 目录再执行。biliup login 必须使用 PTY（pty=true），否则报 IO error: not a terminal。- 二维码发送：拿到授权 URL 后，生成二维码图片发给用户，同时附文字链接作为备用。
- 进程不能提前终止：登录完成前 kill 进程会导致凭据未保存，需等进程自然退出（code 0）。
完整工作流
Step 1：检查已安装 biliup
- 若已安装则跳过，输出当前版本
- 若未安装，通过
uv tool install biliup 安装 PyPI 官方包
- 无需手动下载二进制文件
Step 2：登录（首次使用 / 凭据已过期）
判断是否需要登录：
${HOME}/.biliup//cookies.json 不存在，或- 用户明确要求重新登录，或
- 上传时报认证错误（401/403）
登录流程（必须用 PTY，在 workspace 目录运行）：
cd ${HOME}/.biliup/ && biliup login
进程启动后显示登录方式菜单，发送 ↓↓Enter 选中"浏览器登录"，输出授权 URL：
https://passport.bilibili.com/x/passport-tv-login/h5/qrcode/auth?auth_code=xxxxxx
生成二维码并发送给用户：
系统需要已安装qr命令，检测如果未安装，则执行 uv tool install qrcode[pil] 安装
qr 'https://passport.bilibili.com/x/passport-tv-login/h5/qrcode/auth?auth_code=xxxxxx' > '/tmp/biliup_qr.png'
先单独发一条图片消息，再发一条文字备用链接：
# 图片消息（单独一条）
MEDIA: /tmp/biliup_qr.png
# 文字备用（单独一条）
🅱 B站扫码登录链接（图片看不到时使用）：
https://passport.bilibili.com/x/passport-tv-login/h5/qrcode/auth?auth_code=xxxxxx
用 B站 App 扫码授权后，请稍等，我会自动检测登录结果～
然后 poll 进程输出，最长等 120 秒，等待进程退出码 0（登录成功）。
⚠️ 不要提前 kill 进程，否则凭据不会写入磁盘。
登录成功后凭据文件在：${HOME}/.biliup/cookies.json
如果无法登录成功，则引导用户进入命令行自行登录，使用 cd ${HOME}/.biliup/ & biliup login 命令
Step 3：收集投稿信息
向用户收集以下信息（必填项优先，可选项若用户未提及则跳过）：
| 参数 | 必填 | 说明 |
|---|
| 视频文件路径 | ✅ | 本地路径，支持多个（多 P） |
标题 --title | ✅ | 视频标题，最长 80 字 |
分区 --tid | ✅ | 见 references/tid_list.md；默认 21（虚拟主播综合） |
标签 --tag | ✅ | 逗号分隔，至少 1 个 |
简介 --desc | 可选 | 视频简介 |
封面 --cover | 可选 | 本地图片路径或 URL |
是否原创 --copyright | 可选 | 1=自制（默认），2=转载 |
转载来源 --source | 转载时必填 | 原始来源说明 |
若用户一次性提供了所有信息，直接进入 Step 4，不要反复追问。
视频文件处理：
Step 4：执行投稿
biliup -u ${HOME}/.biliup/cookies.json upload \
--title "视频标题" \
--tid 21 \
--tag "标签1,标签2" \
/path/to/video.mp4
多 P 视频：在末尾追加多个文件路径。
上传线路（可选，若用户要求速度优化）：
--line 可选 bda2（默认）、ws、qn、tx、txa
上传方式 (一个方式失败时可以换另一个方式)
--submit 可选 app(默认)、 web, b-cut-android
运行投稿命令时：
- 告知用户"投稿中，请稍候..."
- 等待命令完成（timeout 300s）
- 解析输出中的 BV 号（
"bvid": "BVxxxxxxxxx"）或错误信息
Step 5：返回结果
成功时输出：
✅ 投稿成功！
BV 号：BVxxxxxxxxx
标题：xxx
可在哔哩哔哩个人主页查看审核进度～
失败时输出错误信息，常见问题：
401/403 → 登录凭据已过期，需重新登录（回到 Step 2）- 文件不存在 → 检查视频路径
- 标题/标签违规 → 提示用户修改
注意事项
B站投稿分区 tid 列表
常用分区（直接投稿用）
| tid | 分区名 | 说明 |
|---|
| 17 | 单机游戏 | 单机、主机游戏相关 |
| 65 | 网络游戏 | 网游、手游相关 |
| 171 | 电子竞技 | 电竞赛事、职业比赛 |
| 172 | 手机游戏 | 手机游戏 |
| 21 | 日常 | 生活、日常记录 |
| 95 | 数码 | 数码评测、开箱 |
| 122 | 野生技术协会 | 技术教程、DIY |
| 124 | 生活 | 生活类视频 |
| 160 | 生活其他 | 其他生活内容 |
| 130 | 音乐综合 | 音乐相关 |
| 193 | MV | 音乐 MV |
| 243 | 原创音乐 | 原创歌曲 |
| 75 | 知识 | 科普、教育 |
| 78 | 科学科普 | 自然、科学 |
| 176 | 校园学习 | 教育、课程 |
| 36 | 知识其他 | 其他知识 |
| 201 | 美食制作 | 烹饪教程 |
| 76 | 美食 | 美食相关 |
| 119 | 人文历史 | 历史、文化 |
| 155 | 时尚 | 穿搭、美妆 |
| 168 | 时尚其他 | 其他时尚 |
| 229 | 影视综合 | 影视评论 |
| 182 | 影视杂谈 | 影视相关 |
| 203 | 动物圈 | 萌宠动物 |
| 121 | 动物 | 动物相关 |
| 22 | 三次元舞蹈 | 舞蹈 |
| 26 | 舞蹈综合 | 舞蹈综合 |
科技区（常用）
| tid | 分区名 |
|---|
| 188 | 数码 |
| 189 | 软件应用 |
| 190 | 计算机技术 |
| 191 | 科工机械 |
选择建议
