butubb
2112c1a870
移植自 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 带网关原话 / 正常返回）。
7.4 KiB
剧本与分镜的分层标准（业界实读）
来源：
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 | 平台适配 | 可做成"目标平台"选项，自动推荐脚本模式与镜头倾向 |