biliup-skills

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 执行的目录）

⚠️ 已知行为（实战校正）

1. biliup login 不支持 --cookie 参数：凭据固定保存到运行时的当前工作目录 cookies.json。 需要先 cd 到 ${HOME}/.biliup/ 目录再执行。
2. biliup login 必须使用 PTY（pty=true），否则报 IO error: not a terminal。
3. 二维码发送：拿到授权 URL 后，生成二维码图片发给用户，同时附文字链接作为备用。
4. 进程不能提前终止：登录完成前 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
# exec with pty=true, timeout=180s, yieldMs=8000

进程启动后显示登录方式菜单，发送 ↓↓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，不要反复追问。

视频文件处理：

• 若用户通过 QQ 发送视频（CQ 码格式），从 url= 字段提取 URL，下载到本地再上传：

  curl -L -o /tmp/biliup_upload/<filename>.mp4 "<url>"
  

• 下载后用 file 命令确认是有效的 MP4 文件

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）
• 文件不存在 → 检查视频路径
• 标题/标签违规 → 提示用户修改

注意事项

• biliup 是社区维护的 B 站上传工具（https://github.com/biliup/biliup）
• cookies.json 保存用户自己的 B 站登录凭据，请妥善保管，不要分享或提交到 git
• 投稿后需等待 B 站审核，通常数小时内完成
• 分区 tid 参考： B站投稿分区 tid 列表

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	科工机械

选择建议

• 默认值: 190（计算机技术）
• 用户不确定时，根据视频内容匹配最合适的分区
• 可参考 https://member.bilibili.com/platform/upload/video/frame 查看完整分区树