# 抖音口播爆款内容洞察技能包 Spec

> 日期：2026-05-08  
> 范围：主线二 / 场景一 / 1.1 爆款内容洞察闭环。P0 只做抖音平台，不做视频生成、自动发布、投后归因和私域导流。

## 1. 产品定义

`douyin-speaking-daily` 为抖音口播账号提供每日爆款选题日报。它解决的问题不是“直接写一篇泛文案”，而是：

- 今天该讲什么；
- 同行业爆款为什么爆；
- 哪些选题适合当前账号定位；
- 哪些视频值得补逐字稿做深拆；
- 用户反馈如何沉淀到下一轮。

## 2. P0 闭环

```text
问答建档 / 读取记忆
  -> 关键词视频采集
  -> 已确认账号近期作品采集
  -> 评论采集
  -> 自动选择 Top N 爆款视频补逐字稿
  -> 每日稿件日报
  -> 用户校准反馈写回记忆
```

P0 已支持：

- 抖音关键词视频采集；
- 指定或确认账号近期作品监听；
- 评论采集；
- 抖音分享链接解析到音频；
- `iflytek-gateway` 网关转写；
- 逐字稿回灌日报证据链；
- profile/memory 写回。

## 3. 角色设定

OpenClaw 启动本技能包时，应扮演：

```text
抖音口播爆款内容策划师 + 数据化选题编辑
```

职责：

- 用真实样本做选题判断；
- 输出可拍摄的口播选题和结构；
- 标注每条选题的证据链与置信度；
- 主动追问校准反馈；
- 维护账号长期记忆。

边界：

- 不伪造数据；
- 不把标题当完整逐字稿；
- 不自动发布；
- 不做投后归因；
- 不替代用户做最终选题决策。

## 4. 记忆系统

主记忆：

```text
memory/douyin-speaking-profile.json
```

模板：

```text
douyin-speaking-daily/memory-templates/douyin-speaking-profile.json
```

写回技能：

```text
douyin-speaking-profile-memory
```

核心字段：

| 字段 | 作用 |
|---|---|
| `state` | 流程状态 |
| `industry` | 行业/品类 |
| `accountPositioning` | 账号身份 |
| `targetAudience` | 目标人群 |
| `conversionGoal` | 转化目标 |
| `keywords` | 长期监听关键词 |
| `confirmedAccounts` | 已确认监听账号 |
| `candidateAccounts` | 待确认候选账号 |
| `forbiddenTopics` | 禁区 |
| `calibrationNotes` | 日报后反馈 |
| `lastRunSummary` | 最近一次运行摘要 |

状态机：

```text
emptyProfile
  -> collectingProfile
  -> awaitingProfileConfirm
  -> readyForManualRun
  -> awaitingReportCalibration
  -> tunedProfile
  -> automationReady
```

## 5. 技能组成

| 技能 | 类型 | 作用 |
|---|---|---|
| `douyin-speaking-profile-builder` | conversational | 问答建档 |
| `douyin-speaking-profile-memory` | local-script | profile 写回与校准 |
| `douyin-speaking-keyword-monitor` | orchestration | 关键词监听 |
| `douyin-user-posts` | api | 指定账号近期作品 |
| `douyin-speaking-account-monitor` | orchestration | 对标账号监听 |
| `douyin-video-transcript` | local-script | 抖音链接/音视频转逐字稿 |
| `douyin-speaking-daily-report` | local-script | 日报生成 |
| `douyin-speaking-daily-runner` | local-script | P0 总入口 |

## 6. Runner 参数

小样本测试：

```powershell
node scripts\tools\douyin-speaking-daily-runner.js --profile memory\douyin-speaking-profile.json --output outputs\run --videos-per-keyword 1 --max-keywords 1 --max-videos-with-comments 1 --max-comment-pages 1 --include-replies false --accounts-limit 1 --posts-per-account 1 --auto-transcript-top-n 1 --auto-transcript-provider iflytek-gateway --write-profile true
```

正式日报：

```powershell
node scripts\tools\douyin-speaking-daily-runner.js --profile memory\douyin-speaking-profile.json --videos-per-keyword 5 --max-keywords 5 --max-videos-with-comments 8 --max-comment-pages 1 --include-replies true --accounts-limit 5 --posts-per-account 8 --auto-transcript-top-n 1 --auto-transcript-provider iflytek-gateway --write-profile true
```

## 7. 日报输出

输出目录：

```text
openclaw-voc-output/douyin-speaking-daily/<project>/<YYYY-MM-DD>/
  daily-report.md
  daily-report.json
  audit.json
  runner-raw-input.json
  raw/
    keyword-videos.json
    account-videos.json
    comments.json
  transcripts/
    <aweme_id>/
      transcript.json
      transcript.txt
```

日报必须包含：

- 今日一句话判断；
- 判断口径与置信度；
- 趋势信号；
- 今日选题池；
- 每条选题的来源视频、互动数据、评论口径和逐字稿状态；
- 口播框架；
- 评论触发点；
- 风险提醒；
- 明日监听建议；
- 校准问题。

## 8. 置信度

| 条件 | 置信度 |
|---|---|
| 有互动数据、有匹配评论、有逐字稿 | 高 |
| 有互动数据、有匹配评论 | 中 |
| 只有标题/描述和互动数据 | 低 |

## 9. 后续安排

P0 已闭环。下一步：

- 增加“日报后自动生成完整可拍摄脚本”；
- 接外部定时推送渠道；
- 增加多条逐字稿批量成本控制；
- 增加历史日报对比和关键词趋势变化。