feat(monitor): 抖音 Web 接口客户端 —— 绕开爬虫子进程，直接发 HTTP
移植自 mac-agent-os 的 mediacrawler_adapter：不起子进程、不开页面，用浏览器里那份
登录态直接调抖音 Web 接口。产物键名照抄 store/douyin，所以 ingest 那条链路一个字不用改。
**目前能用的（真环境实测，非推断）**：
profile/other : 200, 7075 字节 —— 博主主页指标（粉丝/获赞/作品数/昵称）
aweme/detail : 200, 45425 字节 —— 单条作品详情（含点赞/评论/收藏/分享）
**目前不能用的：作品列表 `aweme/post`。** 两个互相独立的原因：
1. 这个接口被抖音单独升级成了真校验：不带 x-tt-argus 回 403「Uifid Not Found」，
带上 dummy 值回 200 + **空 body**。也就是说「头在不在」骗得过，「真校验」过不了。
同一套头打 profile/other 和 aweme/detail 都是通的 —— 抖音是挑着接口加保护的，
挑中的恰好是「批量拉作品列表」这个最敏感的动作。
2. 改走页面截获也不行：CDP 浏览器打开博主主页会落到「验证码中间页」（当天大量探测的
代价，过几小时要重测）。
所以现在的边界是：**已知作品的指标刷新能做，自动发现新作品做不了**。
**排查中控住变量后得到的两条事实**（都写进注释了）：
· `Accept` / `Accept-Language` / `Referer` 才是主页接口能返回真数据的原因 —— 只有
UA+client hints+Cookie 时是 200 但仅 121 字节的空壳，补上这三个头变 7074 字节。
（我先前猜的 sec-ch-ua 不是关键。）
· 因此 UA 与 client hints 必须**成套地取自同一个浏览器**，所以 BrowserIdentity 一次
从 CDP 取齐 cookie + UA + hints，而不是各自写死。
「200 + 空 body 必须当场报错」也是刻意写死的：放过去它会在下游变成「这个博主没作品」，
把一次失败伪装成一条正常结果 —— 爬虫那条路正是这么栽的，还被翻译成「账号被封」。
测试 +11：cookie 解析、请求头成套性（含 uifid 缺失/回退）、产物键名与 store 对齐、
以及 _get 的三条失败路径（空 body / 403 带网关原话 / 正常返回）。
This commit is contained in:
@@ -0,0 +1,158 @@
|
||||
# 剧本与分镜的分层标准（业界实读）
|
||||
|
||||
> 来源：`Liang80mrer/AI-Animation-Studio` 的 Skill 体系（04 剧情脚本 / 05 故事板 / 06 关键帧扩展）
|
||||
> 实读日期：2026-10-04 · 用途：**设计我们的剧本与分镜标签前先读这篇**
|
||||
|
||||
---
|
||||
|
||||
## 一、结论先行（回答「按场分还是按章分」）
|
||||
|
||||
**都不是。业界用的是「段落（段落 01 / 02 / 03…）」。**
|
||||
|
||||
| 说法 | 对不对 | 说明 |
|
||||
|:--|:--|:--|
|
||||
| 按「章节」分 | ❌ | 章节是**小说**单位，剧本不用 |
|
||||
| 按「场（Scene）」分 | ⚠️ 接近 | 传统影视用「场」（同一时间+地点）；AI 短片框架用**「段落」**（可能跨场景，一个叙事单元） |
|
||||
| 剧本分完 → 每段拆成镜头 | ✅ **完全正确** | 这正是 04 剧情脚本 → 05 故事板 的关系 |
|
||||
|
||||
**正确的三层**：
|
||||
```
|
||||
剧本（Script） = 分「段落」 每段写：剧情 / 动作 / 表情 / 情绪 / 画面重点
|
||||
↓
|
||||
故事板（Storyboard）= 把每段拆成「格」 每格写：编号 / 镜头名 / 功能 / 相机 / 画面 / 行动 / 转场 / 重点
|
||||
↓
|
||||
关键帧（Keyframe） = 复杂镜头才扩展（动作复杂 / 变形复杂 / 情绪细腻 / 跨度大）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 二、完整流程（11 步，实读）
|
||||
|
||||
```
|
||||
00 项目总控（跨 Skill 继承）
|
||||
01 故事创意 → 一句话故事 / 核心冲突 / 平台 / 时长
|
||||
02 世界观设定 → 世界规则 / 角色约束
|
||||
03 原创角色 → 角色设计（继承世界观）
|
||||
04 剧情脚本 ★ → 按「段落」写，不按最终镜头
|
||||
05 故事板 ★ → 逐格拆镜头
|
||||
06 关键帧扩展 → **不是所有镜头都要**（见下）
|
||||
07 视频提示词 → Seedance 官方语法
|
||||
08 结果质检
|
||||
09 封面方案
|
||||
10 平台发布文案
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 三、★ 最重要的发现：有「脚本模式」这一层（我们缺）
|
||||
|
||||
**04 剧情脚本阶段必须先判断：这个脚本该用哪种模式驱动镜头？**
|
||||
|
||||
| 脚本/故事板模式 | 核心驱动力 | 镜头重点 |
|
||||
|:--|:--|:--|
|
||||
| A 动作预演型 | 动作系统（水流/丝带/粒子/能量） | 空间如何被改变、每格比上格更强在哪 |
|
||||
| B 情绪表演型 | 情绪变化 | 近景/特写/慢推/呼吸停顿/手部细节/视线 |
|
||||
| C 对话 · 口播型 | 信息节奏 | 反应镜头/视线切换/前景遮挡/停顿/打断 |
|
||||
| D 产品广告型 | 痛点→机制→结果 | 问题如何被放大、机制如何可视化 |
|
||||
| E 科普解释型 | 抽象概念可视化 | 概念如何变成角色或空间 |
|
||||
| F 世界观展示型 | 世界规则 | 空间如何运作、潜在线索 |
|
||||
| G 角色出场型 | 角色第一印象 | 局部出现→完整登场→招牌动作→定格 |
|
||||
| H 封面转视频型 | 静态如何变动态 | 哪个元素先动、镜头从哪进入 |
|
||||
|
||||
**每个模式的核心公式不同**，例如：
|
||||
```
|
||||
情绪表演型：平静 → 微小破绽 → 情绪被触发 → 表情管理失败 → 情绪落点
|
||||
对话型： 抛信息 → 反应 → 信息升级 → 情绪变化 → 结论/梗/钩子
|
||||
产品型： 痛点 → 问题升级 → 解决方案出现 → 机制展示 → 结果变化 → 记忆点
|
||||
```
|
||||
|
||||
**⚠️ 对我们**：我们现有的 `shooting_style`（9 种拍摄风格）是**「怎么拍」**，
|
||||
而这里的脚本模式是**「怎么拆镜头」** —— **是两件不同的事，我们缺后者**。
|
||||
|
||||
---
|
||||
|
||||
## 四、★ 第二个发现：故事板 ≠ 关键帧（定位不同）
|
||||
|
||||
| | 故事板（05） | 关键帧（06） |
|
||||
|:--|:--|:--|
|
||||
| **目标** | 动作规划 / 镜头调度 / 空间连续性 / 节奏预演 | 成片的实际画面（要好看、要一致） |
|
||||
| **画面风格** | **粗略电影分镜、快速草图、手绘铅笔、速写体块、简化角色** | 高完成度、要求角色/场景一致 |
|
||||
| **明确禁止** | 复杂插画、精修概念艺术、重材质渲染、海报感拼贴 | — |
|
||||
| **细节级别** | 低到中等（动作可读性优先，不是材质细节） | 高 |
|
||||
|
||||
**⚠️ 对我们**：我们的「关键帧工作台」做的是**成片用的静帧**（正确），
|
||||
但**没有「故事板草图」这一层** —— 所以"镜头怎么接、动作怎么升级、空间连不连续"
|
||||
没有地方预演，直接就到生成。
|
||||
|
||||
**关键帧扩展的判断标准**（不是所有镜头都要）：
|
||||
> 建议扩展：动作复杂 · 变形复杂 · 情绪变化细腻 · 镜头跨度大 · 一个镜头含多个阶段
|
||||
|
||||
---
|
||||
|
||||
## 五、★ 第三个发现：跨阶段交接是「显式清单」
|
||||
|
||||
每个 Skill 结尾必须输出「**给下一个 Skill 的输入**」：
|
||||
|
||||
```
|
||||
04 剧本 → 05 故事板 的交接：
|
||||
故事标题 / 推荐脚本模式 / 建议故事板模式 / 核心驱动力 / 角色 / 世界观
|
||||
/ 剧情段落 / 情绪路线 / 重点镜头 / 平台 / 视频时长 / 视觉风格 / 禁忌项
|
||||
|
||||
05 故事板 → 06/07 的交接：
|
||||
故事板模式 / 核心驱动力 / 目标平台 / 目标画幅 / 目标时长 / 视觉风格
|
||||
/ 角色参考图 / 场景参考图 / 故事板参考图
|
||||
/ 镜头数量 / 镜头顺序 / 每镜头时长 / 画面内容 / 动作 / 运镜 / 情绪 / 转场接口
|
||||
/ 是否需要关键帧扩展 / 需要扩展的镜头 / 扩展原因
|
||||
/ Seedance 素材建议（含「建议素材位：@图片1」）
|
||||
```
|
||||
|
||||
**并且有一条硬规矩**：
|
||||
> 「如果某类素材不存在，必须写"无，不使用"，**不要编造素材**。」
|
||||
|
||||
**⚠️ 对我们**：这正是「Cross-Skill Inheritance」的落地方式 ——
|
||||
**显式清单**，而不是靠页面之间传 localStorage。
|
||||
|
||||
---
|
||||
|
||||
## 六、其他可直接借鉴的规则
|
||||
|
||||
**① 空间连续性（05 §10）**
|
||||
> 故事板必须发生在**统一、可连续调度的空间**。不是 12 张互不相关的漂亮图。
|
||||
> 必须输出：空间类型 / 空间功能 / 主要空间元素 / 视觉限制
|
||||
|
||||
（呼应我们的「场景 6 机位」做法 ✓）
|
||||
|
||||
**② 角色连续性（05 §11）**
|
||||
> 故事板不是重新设计角色，而是规定角色如何表演。
|
||||
> **角色像同一个演员连续表演，不要每格都像重新摆拍。**
|
||||
|
||||
**③ 平台适配（05 §16）**
|
||||
```
|
||||
抖音 → 动作预演型 / 产品广告型 / 角色出场型
|
||||
小红书 → 情绪表演型 / 封面转视频型 / 世界观展示型
|
||||
视频号 → 对话型 / 情绪型 / 科普型
|
||||
B站 → 世界观型 / 动作预演型 / 科普型
|
||||
```
|
||||
|
||||
**④ 时长结构（04 §07）**
|
||||
```
|
||||
15 秒：0-3 Hook ｜ 3-7 冲突明确 ｜ 7-12 行动升级 ｜ 12-15 结果/反转/记忆点
|
||||
30 秒：Hook → 角色目标 → 冲突升级 → 高潮 → 结尾余味
|
||||
```
|
||||
|
||||
**⑤ 排版协议（00B）**
|
||||
> 交付物是 **Pipeline 接口**，不是演示 PPT。减少空行、横排压缩、信息密度高。
|
||||
> 禁止 AI 客服腔（"以下为你整理"/"希望对你有帮助"）。
|
||||
|
||||
---
|
||||
|
||||
## 七、对我们的影响（待办）
|
||||
|
||||
| # | 缺口 | 建议 |
|
||||
|:--|:--|:--|
|
||||
| 1 | **缺「脚本模式」层** | 在剧本标签里加"脚本模式"选择（8 种），它决定分镜怎么拆 |
|
||||
| 2 | **缺「故事板草图」层** | 可选：在关键帧之前加"故事板"（草图/低完成度，只为镜头预演） |
|
||||
| 3 | **缺显式的阶段交接** | 每个标签产出时，自动写「给下一阶段的输入」到项目对象 |
|
||||
| 4 | 剧本应按**段落**组织 | `project.script.paragraphs[]`，每段含 剧情/动作/表情/情绪/画面重点 |
|
||||
| 5 | 分镜应记录**镜头功能** | `Shot` 已有 `shot_contract`，但缺"镜头功能/转场接口/重点" |
|
||||
| 6 | 平台适配 | 可做成"目标平台"选项，自动推荐脚本模式与镜头倾向 |
|
||||
Reference in New Issue
Block a user