One CLI to publish everywhere.
跨平台视频上传自动化工具，支持 Bilibili、抖音、快手、微信视频号、YouTube。
实机演示
CLI 跨平台视频上传操作演示
产品概览
本 CLI 是 独立发布的 npm 包，可在任意项目中单独使用，无需依赖 Panda Video Generator 主项目。
在完整的视频生产流水线中，典型的工作流为：
# 多种工作流示例
Suno → 剪辑 → 视频 → pva 发布
网页抓取 → 剪辑 → 视频 → pva 发布
NotebookLM → 生成视频 → pva 发布
... → 视频 → pva 发布
通过 pva 将成片一键分发到各平台。无论视频来源如何，pva 都能完成跨平台上传。亦可单独用于已有视频的手动上传。
快速上手
# 全局安装（推荐）
npm install -g @panda-video-automation/pva
# 项目本地安装（配合 scripts）
npm install --save-dev @panda-video-automation/pva
环境要求：Node.js ≥ 20.9.0。全局安装后 pva 命令即可全局使用；本地安装可配合项目 package.json scripts 调用。
操作步骤
每个平台只需登录一次
# 语法
pva <平台> login
# 示例
pva bilibili login
打开浏览器，手动完成登录后自动检测并持久化 Session。 后续上传无需重复登录。Session 有效期因平台而异，微信视频号需要每日重新登录。
操作步骤
# 语法
pva <平台> upload --video <路径> [options]
# 示例：CLI 参数上传
pva bilibili upload \
--video ./video.mp4 \
--title "My Title" \
--desc "Description" \
--tags tag1,tag2
# 环境变量上传
export
VIDEO_PATH=./video.mp4
export VIDEO_TITLE="My Video"
pva youtube upload
# 批量发布
pva bilibili upload && pva douyin upload && pva kuaishou upload
命令参考
pva <platform> <action> [options]
| 平台 | 标识符 | 别名 |
|---|---|---|
| Bilibili | bilibili | — |
| 抖音 | douyin | — |
| 快手 | kuaishou | — |
| 微信视频号 | weixin | weixinvideo、wechat |
| YouTube | youtube | yt |
| 操作 | 说明 |
|---|---|
| login | 登录并保存浏览器 Session |
| upload | 上传视频及元数据 |
参数可通过 CLI 标志或环境变量传入。
| 参数 | 环境变量 | 说明 |
|---|---|---|
| --video | VIDEO_PATH | 视频文件路径（必填） |
| --title | VIDEO_TITLE | 视频标题（必填） |
| --desc | VIDEO_DESC | 视频描述 |
| --tags | VIDEO_TAGS | 逗号分隔的标签 |
| --cover | VIDEO_COVER | 封面图片路径 |
| --privacy | VIDEO_PRIVACY | YouTube：public / unlisted（默认）/ private |
| --headless | PVA_HEADLESS | 无头模式运行（默认有头） |
平台差异
| 平台 | 标题长度 | 描述字段 | 注意事项 |
|---|---|---|---|
| 抖音 | 30 字 | 支持 | 发布前需勾选"内容为个人观点或见解" |
| 快手 | 标题+描述合并 | 合并到标题 | 使用 contenteditable 单一字段 |
| Bilibili | 无严格限制 | 支持 | 支持 AI 生成内容标注 |
| 微信视频号 | 无严格限制 | 支持 | 使用"昨日数据"文本判断登录状态 |
| YouTube | 无严格限制 | 支持 | 支持隐私级别 |