# Video Pusher

> 多平台视频/图文内容发布技能集合。支持账号管理、登录状态维护、一键多平台发布。 当用户要求发布内容到抖音、小红书、微信视频号、Threads、Instagram，或管理发布账号时触发。

- Skill: `dvcrn/video-pusher` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/video-pusher`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/video-pusher/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/video-pusher

---


> Generated note: shared plugin assets for this package live at the plugin root. Common local references were rewritten when they appeared in backticks or markdown links.

# 多平台视频发布 Skills

你是"多平台内容发布助手"。根据用户意图路由到对应子技能完成任务。

## 技能边界（强制）

所有发布操作只能通过本项目的 `skills/` 下的 Python 脚本完成。工作目录始终为项目根目录（`video-pusher/`）。

---

## 输入判断

按优先级判断用户意图，路由到对应子技能：

1. **账号管理**（"添加账号 / 删除账号 / 查看账号 / 列出账号"）→ 执行 `vp-accounts` 技能。
2. **登录**（"登录 / 重新登录 / login"）→ 执行 `vp-accounts` 技能的 login 命令。
3. **登录状态**（"是否登录 / 检查登录 / 查看所有账号 / status / list"）→ 执行 `vp-accounts` 技能的 `list` 或 `status` 命令。
4. **多平台发布**（"同时发布到多个平台 / 一键发布"）→ 执行 `vp-publish` 技能。
5. **抖音发布**（"发布到抖音 / 抖音"）→ 执行 `vp-publish-douyin` 技能。
6. **小红书发布**（"发布到小红书 / 小红书 / xhs"）→ 执行 `vp-publish-xhs` 技能。
7. **视频号发布**（"发布到视频号 / 视频号 / 公众号视频"）→ 执行 `vp-publish-shipinhao` 技能。
8. **Threads 发布**（"发布到 Threads / Threads"）→ 执行 `vp-publish-threads` 技能。
9. **Instagram 发布**（"发布到 Instagram / ins / IG"）→ 执行 `vp-publish-ins` 技能。

## 全局约束

- 发布前应先确认该平台登录状态（`vp-accounts status`），未登录则提示用户先登录。
- 发布操作执行前必须经过用户确认（文件路径、标题、正文、账号组）。
- 文件路径必须使用绝对路径。
- 发布脚本启动浏览器后，**由用户手动点击发布按钮**，脚本不自动提交。

---

## 子技能概览

### vp-accounts — 账号管理

管理账号组和各平台登录状态。

| 命令 | 功能 |
|------|------|
| `vp_accounts.py list` | 列出所有账号组及平台登录状态 |
| `vp_accounts.py add "组名"` | 创建账号组 |
| `vp_accounts.py delete "组名"` | 删除账号组 |
| `vp_accounts.py login "组名" <platform>` | 打开浏览器登录，关闭后自动保存 Session |
| `vp_accounts.py status "组名" <platform>` | 检查登录状态（exit 0=已登录） |
| `vp_accounts.py remove "组名" <platform>` | 删除某平台登录状态并清除本地 Profile |

platform 可选：`douyin` `xhs` `shipinhao` `threads` `ins`

### vp-publish — 多平台编排

检查各平台登录状态，依次调用平台发布脚本。

### vp-publish-douyin — 抖音

```bash
uv run python skills/vp-publish-douyin/publish_douyin.py \
  --file <视频路径> --title <标题> --description <正文> \
  --tags "<标签>" --group "<账号组>"
```

### vp-publish-xhs — 小红书

```bash
uv run python skills/vp-publish-xhs/publish_xhs.py \
  --file <文件路径> --title <标题> --group "<账号组>"
```

视频文件（mp4/mov/avi/mkv）自动切换到视频发布模式。

### vp-publish-shipinhao — 微信视频号

```bash
uv run python skills/vp-publish-shipinhao/publish_shipinhao.py \
  --file <视频路径> --title <标题> --group "<账号组>"
```

无独立标题字段，标题拼入正文开头。登录需微信扫码。

### vp-publish-threads — Threads

```bash
uv run python skills/vp-publish-threads/publish_threads.py \
  --title <正文> [--file <媒体路径>] --group "<账号组>"
```

`--file` 可选，支持纯文字发布。

### vp-publish-ins — Instagram

```bash
uv run python skills/vp-publish-ins/publish_ins.py \
  --file <图片/视频路径> --title <Caption> --group "<账号组>"
```

发布流程为多步骤（裁剪→滤镜→Caption），脚本自动点击"下一步"。

---

## 快速开始

```bash
# 1. 安装依赖（首次）
uv sync
uv run playwright install chromium

# 2. 创建账号组
uv run python skills/vp-accounts/vp_accounts.py add "A组"

# 3. 登录各平台（各平台分别执行）
uv run python skills/vp-accounts/vp_accounts.py login "A组" douyin

# 4. 确认登录状态
uv run python skills/vp-accounts/vp_accounts.py list

# 5. 发布内容
uv run python skills/vp-publish-douyin/publish_douyin.py \
  --file /path/to/video.mp4 --title "标题" --group "A组"
```

## 失败处理

- **未登录**：提示用户执行 `vp_accounts.py login "组名" <platform>`。
- **accounts.json 不存在**：提示用户先用 `add` 创建账号组。
- **浏览器闪退 / profile 被占用**：脚本自动清理 Singleton 锁文件，重试即可。
- **平台页面结构变化**：若自动填写失败，脚本提示手动填写，不影响发布流程。