feat(monitor): 抖音 Web 接口客户端 —— 绕开爬虫子进程,直接发 HTTP
Deploy VitePress site to Pages / build (push) Canceled after 0s
Deploy VitePress site to Pages / Deploy (push) Canceled after 0s

移植自 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:
2026-10-10 17:12:25 +08:00
parent 21ff01b894
commit 2112c1a870
1601 changed files with 367425 additions and 0 deletions
@@ -0,0 +1,164 @@
# 创意 → 设定 → 剧本:业界标准分层(原文摘录)
> 来源:`Liang80mrer/AI-Animation-Studio` 的 Skill 体系原文(GitHub raw 抓取,2026-10-05)
> 补齐了之前 `剧本与分镜的分层标准.md` 只覆盖 04/05 的缺口
---
## 一、完整流程(01 → 06)
```
01 故事创意 Skill → 一句话概念 / 核心冲突 / 传播钩子 / 角色+世界观方向 / 内容模式 / 核心驱动力
02 世界观设定 Skill → 空间规则 + 角色约束系统(允许/禁止)
03 角色
04 剧情脚本 Skill → 分「段落」(每段:剧情/动作/表情/情绪/画面重点)
05 故事板 Skill → 把每段拆成「格」
06 单镜头关键帧扩展 → 复杂镜头才扩展到 2-5 张关键帧
```
## ❗ 没有「小说」这一层
用户常问「创意要不要先写成小说」——**业界没有这一层**。
创意是**一句话概念**,直接进剧情脚本。中间不需要小说。
**但**:01 故事创意 Skill 的**输出信息量很大**(见下),
这才是它与"一句脑洞"的区别 —— 它把故事**想清楚了**,而不是**写长了**。
---
## 二、01 故事创意 Skill —— 完整输出(原文)
### 身份与边界(原文)
> 你是「创意导演 / 动画概念策划 / 短视频创意师 / 世界观设计顾问 / 角色关系策划 /
> 平台传播顾问 / 系列化 IP 顾问 / 镜头价值判断员」
>
> **你的重点:不是"随机脑洞",而是判断一个创意是否值得进入后续生产链。**
>
> 你负责:故事标题 / 一句话概念 / 核心冲突 / 传播钩子 / 角色方向 / 世界观方向 /
> 动作·情绪·关系方向 / 视频价值判断 / 系列化潜力 / 平台适配 /
> **推荐内容模式** / **核心驱动力** / 后续 Skill 建议
>
> 你不负责:不写角色身份板 Prompt / 不写故事板 Prompt / 不写视频提示词 /
> 不写详细剧情脚本 / 不写封面文案 / 不做最终成片
### 创意价值判断(必须回答)
```
是否有冲突?是否有动作?是否有情绪?是否有视觉化空间?是否有角色?
是否有记忆点?是否适合短视频?是否适合系列化?是否适合目标平台?
输出:创意判断:值得展开 / 需要改造 / 暂不建议
理由 / 最大问题 / 改造方向
```
### 8 种推荐内容模式(必须提前判断,不要默认都是动作片)
```
动作预演型 · 情绪表演型 · 对话口播型 · 产品广告型
科普解释型 · 世界观展示型 · 角色出场型 · 封面转视频型
```
### 核心驱动力(每个模式不同)
| 模式 | 驱动力 |
|---|---|
| 动作预演型 | 动作系统、空间变化、物理冲突 |
| 情绪表演型 | 情绪变化、眼神、停顿、关系距离 |
| 对话/口播型 | 信息节奏、反应、观点冲突 |
| 产品广告型 | 痛点、机制、结果 |
| 科普解释型 | 因果关系、抽象概念可视化 |
| 世界观展示型 | 世界规则、空间秩序、角色日常 |
| 角色出场型 | 角色第一印象、招牌动作、记忆点 |
| 封面转视频型 | 静态画面动态化、视觉展开 |
### 核心冲突规则(必须回答 4 问)
```
谁想做什么?谁阻止了他?为什么会出问题?观众为什么想继续看?
冲突类型:角色vs角色 / 角色vs世界 / 角色vs自己 /
角色vs机制 / 角色vs时间 / 角色vs产品问题
```
### 传播钩子规则
```
前 3 秒必须有:异常 / 冲突 / 情绪 / 视觉奇观 / 信息差 / 动作升级 / 问题提出
禁止:慢铺垫、讲半天背景
```
### 平台适配
```
抖音 → 强 Hook · 动作强 · 节奏快
小红书 → 封面感 · 情绪感 · 视觉记忆点
视频号 → 信息清楚 · 自然 · 适合转发
B站 → 设定完整 · 世界观可延展
```
### 输出格式(原文 §13)
```
当前阶段:01 故事创意
创意价值判断:结论 / 理由 / 最大问题 / 改造方向
推荐内容模式:选择理由 / 核心驱动力 / 不适合的模式
故事标题:
一句话概念:
核心冲突:
传播钩子:
情绪方向 / 动作方向:
角色方向:主角方向 / 对手方向 / 关系方向
世界观方向:
系列化潜力:
建议后续流程:是否适合进入世界观 Skill / 原创角色 Skill / 剧情脚本 Skill
给下一个 Skill 的输入: ← ★ 显式交接清单
故事标题 / 核心冲突 / 推荐内容模式 / 核心驱动力 /
角色方向 / 世界观方向 / 平台 / 视频时长 / 视觉风格 / 禁忌项
```
---
## 三、02 世界观设定 Skill —— 角色约束系统(原文)
> **世界观的核心任务之一:限制角色生成空间。角色必须属于这个世界。**
```
角色允许规则:允许角色类型 / 职业 / 材质 / 行为 / 情绪气质 / 轮廓 / 服装逻辑 / 技术水平
角色禁止规则:禁止角色类型 / 材质 / 风格 / 职业 / 行为 / 轮廓 / 技术等级
角色统一视觉原则:所有角色必须共享
统一材质逻辑 · 统一光影语言 · 统一时代气质 · 统一镜头气质 · 统一表演逻辑
禁止:同一世界出现完全不同动画风格
```
---
## 四、对比我们的现状(2026-10-05)
| 业界 01 的要素 | 我们有没有 |
|---|---|
| 故事标题 | ❌ |
| 一句话概念 | ✅(候选的"一句话联想")|
| 核心冲突 | ❌ |
| 传播钩子 | ❌ |
| 推荐内容模式 | ⚠️ 有"脚本模式"但在**剧本**阶段才定,创意阶段没有 |
| 核心驱动力 | ⚠️ 同上 |
| 角色方向 / 世界观方向 | ⚠️ 部分(设定标签里有世界观,但没有"方向"判断)|
| 创意价值判断 | ⚠️ 有"缺口分/风险标记",但不是这套判断 |
| 显式交接清单 | ⚠️ 剧本/故事板有,创意没有 |
| 业界 02 的要素 | 我们有没有 |
|---|---|
| 空间规则 | ✅(设定的 world)|
| 角色约束系统(允许/禁止)| ⚠️ 有"禁忌",但没有针对角色的允许/禁止 |
**结论**:创意层是我们的薄弱环节 —— 产出的是「参数 + 一句话」,而业界要求「一张想清楚的创意卡」。
---
## 五、改进建议(待实施)
把「💡 创意」标签升级为**两段式**:
```
第一段(现有):参数选型 → 候选 → 选中
第二段(新增):🤖 把选中的一句话扩写成「故事创意卡」
(标题/概念/冲突/钩子/模式/驱动力/角色方向/世界观方向)
→ 可手动编辑 → 存进 project.creative
↓
剧本生成时与「设定」一起注入 prompt
```
@@ -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 | 平台适配 | 可做成"目标平台"选项,自动推荐脚本模式与镜头倾向 |