核心用法
bilibili-upload 是一款面向 Bilibili(哔哩哔哩)平台的内容上传工具,基于 biliup 开源库封装,提供命令行式的视频投稿能力。用户首次需扫码登录完成 Cookie 持久化,后续即可通过脚本参数指定视频路径、标题、描述、标签及分区 ID(tid)实现自动化上传。
关键流程
1. 首次登录:执行 biliup login,终端显示二维码,使用 Bilibili App 扫描完成授权
2. 日常投稿:调用封装脚本 upload.py,传入视频路径与元数据参数
3. 环境适配:Windows 用户需预执行 chcp 65001 与 PYTHONIOENCODING=utf-8 避免中文编码异常
显著优点
- 自动化程度高:登录态持久化后,无需重复授权即可批量投稿
- 分区映射清晰:内置常见分区 ID 对照表(如 138 日常、171 科技、201 动画),降低新用户试错成本
- 编码兼容性:针对 Windows 默认 GBK 编码环境做了显式修复,减少 Unicode 报错
- 路径智能处理:支持
~家目录展开,兼容绝对与相对路径
潜在缺点与局限性
- 依赖外部生态:核心功能绑定
biliup第三方库,若上游 API 变更或风控升级可能导致功能失效 - 登录交互门槛:首次登录必须人工扫码,无法完全无人值守初始化
- 审核不可控:视频上传后进入 Bilibili 机审+人工审核队列,脚本无法返回审核状态或预测过审时间
- 分区 ID 硬编码:分区映射表静态维护,平台侧分区调整时可能需手动更新
- 无失败重试机制:文档未提及网络异常或接口限流时的自动重试策略
适合人群
- 需要将 AI 生成视频、每日简报等内容定时批量同步至 Bilibili 的创作者
- 熟悉命令行操作、追求自动化工作流的技术型 UP 主
- 使用 Windows 环境且受困于中文编码问题的国内用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| **账号安全** | Cookie 本地明文存储(`biliup` 默认行为),若设备共享或被入侵可能导致账号盗用 |
| **平台合规** | 自动化投稿若用于搬运、低创刷量,可能触发 Bilibili 风控限流甚至封号 |
| **内容审核** | 涉政、版权争议内容可能无法过审,脚本不校验内容合规性 |
| **依赖过时** | `biliup` 非官方维护,Bilibili 接口升级时可能出现长期不兼容 |
总结
该 skill 是 Bilibili 内容创作者的实用效率工具,核心价值在于消除重复登录与编码调试的摩擦。适合已熟悉命令行、有稳定产出节奏的用户;对纯新手而言,首次登录的交互步骤与 Windows 编码修复仍有一定门槛。建议搭配定时任务(如 Windows Task Scheduler/cron)实现真正意义上的无人值守投稿。