Files
contentm_agent/.workbuddy/skills/aigc-idea-impression/subskill/content-publish/references/投放流程规范.md
T

91 lines
4.5 KiB
Markdown
Raw Normal View History

# 投放流程规范
> 本文件是社媒视频多平台投放技能的**规则权威源**,与 SKILL.md 配合使用。冲突时以本文件为准。
---
## 一、6 步投放流程总览
| 步骤 | 名称 | 关键产出 | Gate |
|:----:|------|---------|:----:|
| 1 | 意图识别 | 五要素状态表 + 缺失清单 | Gate-0 投放需求确认 |
| 2 | 投放准备 | 素材校验 + 投放清单 | Gate-1 素材与清单确认 |
| 3 | 渠道状态检查 | 渠道状态表 | Gate-2 渠道就绪确认 |
| 4 | 执行投放 | 执行记录 | Gate-3 执行前最终确认 🔴 |
| 5 | 结果校验 | 校验结果表 | Gate-4 校验结果确认 |
| 6 | 投放报告 | 投放报告 | 交付 |
**Gate 机制:**
- 默认**共创模式**:每个 Gate 展示当前产物 → 用户确认 → 推进
- Gate-3(执行前确认)**强制生效**,不可跳过、不可静默执行
- 用户可随时切换到自动模式(Gate 自动通过),但 Gate-3 例外——投放动作必须显式确认
- 修改超过 5 轮仍未确认时,输出分歧分析并停止
---
## 二、投放需求五要素
| 要素 | 说明 | 必填 |
|------|------|:----:|
| 内容源 | 视频文件路径 / 已生成成片 / 平台已有视频 | ✅ |
| 目标平台 | 具体平台列表(含渠道/账号) | ✅ |
| 账号 | 各平台的投放账号(Postiz 集成 / SAU account) | ✅ |
| 时间 | 立即 / 具体时间(定时) / 草稿 | ✅ |
| 投放模式 | now / schedule / draft + 特殊设置 | ✅ |
---
## 三、凭证与安全规则
1. **POSTIZ_API_KEY**:只从环境变量读取。用户提供后写入环境变量(Windows: `setx POSTIZ_API_KEY "..."` 或会话级 `export`),**禁止写入脚本/文档/配置文件**
2. **国内 Cookie**:由 social-auto-upload 管理,存储于其账号文件(`cookies/<account_name>/`),禁止外泄
3. **日志脱敏**:执行日志中不得出现 API Key、Cookie、Token 明文
4. **脚本规范**:`scripts/` 下脚本读取凭证一律通过环境变量,且运行时先执行 `check_env.py` 检查
---
## 四、风控规则
### 国内平台(浏览器自动化,风险高)
- 单账号日投放上限:抖音 ≤10 条、快手 ≤10 条、小红书 ≤8 条、B站 ≤15 条、视频号 ≤5 条(新号减半)
- 投放间隔:同平台连续投放间隔 ≥5 分钟
- 新号冷启动:注册 <30 天或粉丝 <100 的账号,日投放 ≤3 条,且前 3 次投放用测试内容验证
- 触发风控(限流提示/登录异常/内容审核驳回)→ **立即停止该账号投放**,报告并等待处理
- 详细策略见:[国内平台风控策略.md](知识库/02_风控合规/国内平台风控策略.md)
### 海外平台(官方 API)
- Postiz 创建贴文限流:90 次/小时(云版 100 次/小时);批量多平台时**单请求合并提交**(一个 POST /posts 的 posts 数组包含多个平台)
- 各平台自身 API 配额:TikTok Content Posting API 有每日配额,超限报错时降低频率
- 详细说明见:[海外API限流与合规.md](知识库/02_风控合规/海外API限流与合规.md)
---
## 五、落盘规范
| 产物 | 落盘位置 | 命名 |
|------|---------|------|
| 投放报告 | `{投放工作目录}/投放报告/` | `投放报告_{YYYY-MM-DD}_{批次}.md` |
| 投放清单(开发模式) | `{投放工作目录}/投放清单/` | `投放清单_{YYYY-MM-DD}_{批次}.md` |
- 投放工作目录:默认 `D:\dshworkspace\投放任务\`(dsh 部署环境);开发机与用户环境默认桌面 `MCNSkill投放项目/`;用户自定义路径优先
- 开发模式:每步产物全落盘(1~6 步 md 文件);共创/自动模式:只落盘最终投放报告
---
## 六、硬编码禁止规则
投放流程、知识库标准库中禁止硬编码任何具体账号信息(账号名/账号 ID/API Key/Cookie 路径)。投放工作目录、平台规格值(如平台限制)属规则数据不算硬编码。
---
## 七、错误处理
| 场景 | 处理 |
|------|------|
| POSTIZ_API_KEY 缺失 | 提示用户在 postiz.com 生成并配置,跳过海外投放 |
| Postiz 返回 401 | API Key 无效或过期 → 请用户重新生成 |
| Postiz 返回 429 | 触发限流 → 停止 1 小时或拆分请求 |
| sau 命令不存在 | 引导安装 social-auto-upload(git clone + pip install -r requirements.txt) |
| 平台登录过期 | `sau accounts` 显示未登录 → 引导用户扫码/重新登录 |
| 素材文件不存在 | 拦截并让用户提供正确路径 |
| 投放失败(平台审核) | 记录失败原因,建议用户登录平台查看,不自动重试国内平台 |