douyin-smart-publish

Files (6)

• SKILL.md
• douyin-workflow.md · references/
• handoff-and-human-trace.md · references/
• publish.py · scripts/
• content-style-guide.md · templates/
• tool-demo-script.md · templates/

SKILL.md (first lines)

# 抖音智能发布 v1.1

> 📋 **发布前请确认内容合规**：`~/clawd/projects/MediaClaw/references/platforms/douyin.md`（社区公约11大类违规、AIGC标识、账号健康分）

## ⚠️ 默认发布策略

- **默认目标是存草稿，不是直接发布。**
- **只有 Daniel 明确确认后，才允许点“发布”。**
- 在自动化填完内容后，优先截图回传当前页面，确认标题/描述/封面/话题都正确。
- 如果遇到登录验证、滑块、频率限制、上传卡住，不要死磕；保留截图和当前状态，转为“待 Daniel 接管”。

## ⚡ v1.1 安全增强

### Pre-flight Checklist（飞行前检查）

**每次发布前必须验证以下所有项目，缺一不可**：

```bash
# 1. 浏览器连接测试
curl -s http://127.0.0.1:18800/json/version | grep -q webkit && echo "✅ Browser OK" || echo "❌ Browser Down"

# 2. 登录态验证
python3 scripts/publish.py doctor --no-headless \
  --url "https://creator.douyin.com/creator-micro/content/upload?default-tab=3" \
  --screenshot /tmp/douyin_preflight.png

# 3. 文件验证
ls -lh "$VIDEO_OR_IMAGE_FILE"
```

**检查清单**：
- [ ] 浏览器运行中
- [ ] 登录态有效（未过期）
- [ ] 文件存在且格式正确
- [ ] doctor 冒烟测试通过（selector 都能找到）

### Safety Screenshots（安全截图）

**在每个按钮点击前必须截图当前状态**：

```
打开上传页 → [截图#1: 页面加载] → 上传文件 → [截图#2: 文件上传完成]
→ 填描述 → [截图#3: 描述已填] → 设置封面 → [截图#4: 封面已选]
→ 填话题 → [截图#5: 话题已填] → 点击存草稿 → [截图#6: 草稿确认]
```

**截图命名**：`/tmp/douyin_safety_{N}_{step_name}_{timestamp}.png`

### Error Escalation（错误升级规则）

**3次失败即停止**：

| 失败点 | 失败次数 | 行为 |
|--------|---------|------|
| 文件上传 | ≥3次失败 | 停止，截图，报告 |
| 描述填充 | ≥3次失败 | 停止，截图，报告 |
| 按钮点击 | ≥2次失败 | 停止，截图，报告 |
| 登录验证 | 失败 | 停止，提示重新登录 |

**停止后操作**：
1. 截图当前页面
2. 保存所有安全截图到 `/tmp/douyin_safety/`
3. 报告具体失败步骤和错误信息
4. **转为"待 Daniel 接管"**

### 恢复模式（Recovery）

如果发布流程中断：

1. 检查草稿箱：`https://creator.douyin.com/creator-micro/content/manage`
2. 查看安全截图：`ls /tmp/douyin_safety/*.png`
3. 判断是否需要重跑：
   - 截图#5已存在 → 草稿按钮前失败了，需要重跑
   - 截图#4已存在 → 话题填写后失败了，需要重跑
   - 截图#2已存在 → 文件已上传，可跳过上传步骤
4. 重新运行时使用 `--mode draft`，绝不自动切换到 `--mode publish`

### 草稿按钮文案变体

**已知变体**（抖音 UI 经常变化）：

| 文案 | 出现场景 | 对应 selector |
|------|---------|---------------|
| `存草稿` | 视频上传页 | `button:has-text('存草稿')` |
| `暂存离开` | 图文上传页 | `button:has-text('暂存离开')` |
| `草稿` | 部分版本 | `button:has-text('草稿')` |

**脚本已覆盖所有变体**：`button:has-text('存草稿'), button:has-text('草稿'), button:has-text('暂存离开')`

---

## 平台入口

- **创作者中心**: https://creator.douyin.com
- **内容上传**: https://creator.douyin.com/creator-micro/content/upload
- **图文上传**: https://creator.douyin.com/creator-micro/content/upload?default-tab=3
- **登录方式**: 抖音 APP 扫码 / 手机号验证码

## 发布类型

| 类型 | URL参数 | 说明 |
|------|---------|------|
| 视频 | `default-tab=1`(默认) | 短视频/长视频 |
| 图文 | `default-tab=3` | 图片轮播+描述 |
| 全景视频 | `default-tab=3`(全景) | VR视频 |
| 文章 | `default-tab=4` | 长文(≤8000字+30图) |

## 排版规则

### 视频规范

| 项 | 规则 |
|----|------|
| 时长 | 15秒-60分钟（≥15分钟需粉丝≥1000） |
| 格式 | MP4, WebM（推荐MP4 H.264） |
| 分辨率 | ≥720×1280，推荐1080×1920，最高4K |
| 帧率 | ≤60fps，推荐30fps |
| 大小 | ≤16GB |
| 画幅 | 9:16竖屏(最优) / 16:9横屏 / 3:4 / 4:3 |

From aAAaqwq/AGI-Super-Team, MIT.

More from aAAaqwq/AGI-Super-Team