# 社媒视频多平台投放技能 — 使用指南

> 本技能提供短视频成片的**国内+海外多平台自动投放**能力。直接对话即可使用，无需记住指令。

---

## 🚀 快速上手

| 你这样问 | 我会做什么 |
|------|------|
| "把 D:/videos/demo.mp4 投到抖音和B站" | 国内通道（social-auto-upload）分发，投放前给你确认清单 |
| "把这段视频发到 YouTube 和 TikTok，明早 9 点定时发" | 海外通道（Postiz）定时排期 |
| "一条视频同时投抖音+小红书+YouTube+TikTok" | 双通道混合投放：国内平台走 SAU，海外平台走 Postiz |
| "帮我看看能投哪些平台" | 渠道状态检查：海外已连接账号 + 国内登录态一览 |
| "查一下刚才投放的结果" | 结果校验 + 投放报告 |

---

## 🌍 海外投放（Postiz）

| 你这样问 | 我会做什么 |
|------|------|
| "投到 YouTube" | 通过 Postiz API 发布，支持标题/可见性/标签 |
| "投到 TikTok，隐私设为私密" | 走 Postiz，可设置 privacy_level/duet/stitch 等 |
| "投到 X、Instagram、Facebook、LinkedIn" | 一稿多投，各平台按规格适配 |
| "这周五 10 点定时发" | schedule 模式排期 |

> **首次使用**：需要你先在 [postiz.com](https://postiz.com) 注册 → 连接目标平台账号（OAuth）→ 在 **Settings → Developers → Public API** 生成 API Key 发我（我只写入环境变量，不落盘到代码）。

---

## 🇨🇳 国内投放（social-auto-upload）

| 你这样问 | 我会做什么 |
|------|------|
| "投到抖音" | 走 SAU CLI（`sau douyin upload-video`），支持定时 |
| "投到小红书，图文+视频" | `sau xiaohongshu upload-note` |
| "投到B站、快手、视频号、百家号" | 对应 SAU 平台子命令 |
| "查一下账号登录状态" | `sau accounts` |

> **首次使用**：需要先安装 social-auto-upload（`git clone` + pip 依赖），并完成各平台扫码登录（登录态持久化在账号文件）。本机未安装时我会先引导安装。

---

## ⏰ 三种投放模式

- **立即发布**：提交即发（now）
- **定时排期**：指定时间自动发（schedule），如"明早 9 点"
- **草稿暂存**：先存草稿不发布（draft），确认后再手动/补发

---

## ⚠️ 必读提示

1. **投放前必有确认清单**：我会先展示「平台×账号×时间×标题」完整清单，你说"确认/执行"才真正投放；不确认绝不投放。
2. **国内平台风控**：浏览器自动化发布存在账号风险，首次投放建议用测试号；控制频率（单账号日发上限见知识库）。
3. **海外优先走官方 API**：Postiz 用官方 OAuth，比浏览器自动化稳定合规，TikTok/YouTube 双覆盖时默认走 Postiz。
4. **凭证安全**：API Key 只进环境变量；国内 Cookie 只存在 SAU 账号文件里。

---

## 🔧 环境要求

| 依赖 | 用途 | 检查命令 |
|------|------|---------|
| `POSTIZ_API_KEY` 环境变量 | 海外投放 | `scripts/check_env.py` |
| `sau` 命令（social-auto-upload） | 国内投放 | `sau --help` |
| Python 3.10+ | 运行辅助脚本 | `python --version` |