biliup-skills

使用命令行工具 biliup（Python 版官方 CLI，非 biliup-rs）向 B 站（bilibili）投稿视频。触发场景：用户说"投稿 B 站"、"上传到 B 站"、"发 B 站"、"bilibili 投稿"、"B 站发视频"、"上传视频到 bilibili"等相关关键字。功能：(1) 自动检测并通过...

Security Scan

The skill's files, instructions, and runtime behavior are consistent with a CLI helper that installs and drives the Python biliup tool to upload videos to Bilibili; nothing in the package appears to request unrelated credentials or perform hidden exfiltration.

Purpose & Capability

Name/description match included artifacts: SKILL.md explains installing and invoking the Python biliup CLI, the scripts help with login QR generation and pip-based installation. No unrelated env vars, binaries, or config paths are requested.

Instruction Scope

Instructions direct the agent to install biliup (pip/pipx), run 'biliup login' (PTY), capture the authorization URL, generate/send a QR image, accept user-provided video paths or download user-supplied URLs, and run biliup upload with cookies.json. All of this is within scope for a posting/upload skill; note that the agent will perform network downloads (curl) if given remote URLs and will run subprocesses that write cookies.json to the workspace.

Install Mechanism

No formal install spec in registry (instruction-only). setup_biliup.sh uses pipx or pip install --user to install biliup; qr_login.py can auto-install qrcode via pip. These are typical but do perform runtime package installs which write to disk — expected for this tool but worth noting.

Credentials

The skill requests no environment variables or external credentials. It relies on biliup producing cookies.json (the user's BiliBili access token) in the workspace — this is expected and proportional to the stated purpose.

Persistence & Privilege

always is false and the skill does not request persistent system-wide changes or modify other skills. It runs tools in the workspace and installs Python packages per-user; no elevated privileges or persistent platform presence requested.

Assessment

This skill appears to do what it says: install and run the Python biliup CLI, prompt you to scan a QR with the Bilibili app, save login credentials to cookies.json in the workspace, and upload video files (or download URLs you provide). Before installing/use: (1) review and be comfortable with runtime pip installs (biliup and qrcode) and allowlisting those operations; (2) understand that cookies.json contains your account token — keep it private and do not commit it to source control; (3) avoid giving the skill arbitrary download URLs you don't trust (it will curl and save them); (4) if you want extra safety, run the scripts in a disposable/sandboxed environment or manually perform the biliup login/upload steps yourself. No hidden endpoints or unrelated credential requests were found.

biliup-skills — B 站命令行投稿

使用 biliup（Python 版官方 CLI，PyPI 包名 biliup）投稿 B 站视频。

与 biliup-rs 的区别：本 skill 使用的是 Python 版 biliup（pip install biliup）， 不是基于 Rust 的 biliup-rs。两者功能相似，但安装方式和命令参数不同。

关于登录凭据（cookies.json）

biliup login 完成后，会在工作目录生成 cookies.json，其中保存的是 用户自己的 B 站登录凭据（access_token），仅用于后续上传视频到用户自己的账号， 不会上传至任何第三方服务器。请妥善保管该文件，不要分享或提交到 git。

核心配置

• biliup 安装方式: pip install biliup（PyPI 官方包）
• biliup 路径: ~/.local/bin/biliup（pip --user 安装路径）或系统 PATH 中
• 登录凭据文件: {workspace}/cookies.json（biliup login 保存到运行时当前目录）
• 脚本目录: 相对于本 SKILL.md 的 scripts/

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

1. biliup login 不支持 --cookie 参数：凭据固定保存到运行时的当前工作目录 cookies.json。 建议先 cd 到 workspace 根目录再执行。
2. biliup login 必须使用 PTY（pty=true），否则报 IO error: not a terminal。
3. 菜单导航偏移：启动时光标在"短信登录"（第 2 项），↓↓Enter 实际选到"浏览器登录"（第 4 项）。 使用浏览器登录模式，它会输出一个授权 URL，用 B 站 App 扫码授权即可。
4. 二维码发送：拿到授权 URL 后，生成二维码图片发给用户，同时附文字链接作为备用。
5. 进程不能提前终止：登录完成前 kill 进程会导致凭据未保存，需等进程自然退出（code 0）。

完整工作流

Step 1：检查并安装 biliup

bash scripts/setup_biliup.sh

• 若已安装则跳过，输出当前版本
• 若未安装，通过 pipx install biliup 或 pip install --user biliup 安装 PyPI 官方包
• 无需手动下载二进制文件

Step 2：登录（首次使用 / 凭据已过期）

判断是否需要登录：

• {workspace}/cookies.json 不存在，或
• 用户明确要求重新登录，或
• 上传时报认证错误（401/403）

登录流程（必须用 PTY，在 workspace 目录运行）：

cd {workspace} && 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

生成二维码并发送给用户：

python3 -c "import qrcode; qrcode.make('https://passport.bilibili.com/x/passport-tv-login/h5/qrcode/auth?auth_code=xxxxxx').save('/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 进程，否则凭据不会写入磁盘。

登录成功后凭据文件在：{workspace}/cookies.json

也可使用辅助脚本（自动捕获 URL 并生成二维码）：

python3 scripts/qr_login.py --cookie {workspace}/cookies.json --wait
# 脚本会输出二维码图片路径到 stdout，用于发送给用户

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 {workspace}/cookies.json upload \
    --title "视频标题" \
    --tid 21 \
    --tag "标签1,标签2" \
    /path/to/video.mp4

多 P 视频：在末尾追加多个文件路径。

上传线路（可选，若用户要求速度优化）： --line 可选 bda2（默认）、ws、qn、tx、txa

运行投稿命令时：

• 告知用户"投稿中，请稍候..."
• 等待命令完成（timeout 300s）
• 解析输出中的 BV 号（"bvid": "BVxxxxxxxxx"）或错误信息

Step 5：返回结果

成功时输出：

✅ 投稿成功！
BV 号：BVxxxxxxxxx
标题：xxx
可在哔哩哔哩个人主页查看审核进度～

失败时输出错误信息，常见问题：

• 401/403 → 登录凭据已过期，需重新登录（回到 Step 2）
• 文件不存在 → 检查视频路径
• 标题/标签违规 → 提示用户修改

注意事项

• biliup 是社区维护的 B 站上传工具（https://github.com/biliup/biliup）
• 通过 PyPI 官方包安装（pip install biliup），无需手动下载二进制
• cookies.json 保存用户自己的 B 站登录凭据，请妥善保管，不要分享或提交到 git
• 投稿后需等待 B 站审核，通常数小时内完成
• 分区 tid 参考：references/tid_list.md